Repository navigation
Managing Kernels pt BR
O Gerenciador de kernels MiniOS empacota, inspeciona, ativa e remove bundles de kernel para o sistema modular MiniOS live. Um kernel MiniOS é um conjunto coordenado: a imagem do kernel, seu initramfs e o01-kernel-<version>.sb módulo correspondente devem permanecer juntos.
Este fluxo de trabalho se aplica somente à arquitetura live. Uma instalação nativa usa pacotes de kernel comuns do Debian ou Ubuntu, as ferramentas padrão de initramfs e o bootloader instalado.
A interface gráfica Gerenciador de kernels MiniOS e a minios-kernel CLI usam o mesmo backend. Elas permitem:
- listar os kernels empacotados e diferenciar as versões em execução, ativas e inativas;
- empacotar um kernel de versão específica disponível nos repositórios APT configurados;
- empacotar um conjunto coerente de arquivos locais de kernel
.deb; - opcionalmente, adicionar drivers selecionados do catálogo DKMS MiniOS curado ao empacotar um kernel do repositório;
- criar o initramfs MiniOS e o módulo de kernel SquashFS correspondentes;
- preparar os bundles concluídos no repositório de kernel MiniOS;
- ativar um bundle completo para a próxima inicialização e atualizar a configuração do bootloader compatível;
- remover um kernel empacotado inativo.
O Kernel Manager não compila uma árvore de código-fonte de kernel arbitrária. Se precisar alterar os próprios parâmetros de compilação do kernel MiniOS, use o fluxo de compilação a partir do código-fonte MiniOS.
Abra-o pelo menu de aplicativos MiniOS ou execute:
minios-kernel-managerO aplicativo separa o gerenciamento dos kernels instalados do empacotamento. É possível pesquisar kernels dos repositórios pelo nome do pacote ou pela versão exibida do kernel. Os controles de pacote ficam indisponíveis quando a raiz MiniOS detectada não permite gravação.
As operações privilegiadas do backend usam PolicyKit. A minios-kernel CLI independente exige acesso root para todos os comandos, exceto help.
Selecione Repositório na tela de empacotamento e escolha um pacote de kernel de versão específica, por exemplo:
linux-image-6.12.107+deb13-amd64
Metapacotes de acompanhamento, como linux-image-amd64, não são aceitos como origem do pacote. O modo de repositório usa as fontes APT, a configuração de confiança e as listas de pacotes configuradas no sistema em execução. As dependências correspondentes de kernel dividido em pacotes com versões específicas são resolvidas automaticamente quando a distribuição as utiliza.
A interface gráfica não executa apt update apenas porque as listas de pacotes estão desatualizadas. Atualize-as explicitamente quando necessário ou use --force-update com a CLI.
O empacotamento do repositório pode adicionar drivers selecionados do MiniOS 01-kernel catálogo DKMS. A interface gráfica mostra opções compatíveis com o kernel selecionado; a CLI aceita uma opção --dkms-driver repetível:
sudo minios-kernel package \
--repo linux-image-6.12.107+deb13-amd64 \
--dkms-driver rtl8821au \
-o /tmp/kernel-outputOs drivers selecionados são compilados em um overlay/chroot isolado, com os headers correspondentes. O backend verifica se os módulos produzidos correspondem ao kernel de destino antes de incluí-los e registra a proveniência dos drivers no bundle, em /usr/share/minios/kernel-dkms/.
Este é um recurso de compatibilidade com opções selecionadas, não uma interface genérica para DKMS. Pacotes de kernel locais instalados manualmente não oferecem seleção de drivers porque não é possível inferir com segurança quais headers do repositório correspondem a eles.
Para um kernel local, forneça todos os arquivos .deb necessários da mesma compilação do kernel:
sudo minios-kernel package \
--deb linux-image.deb linux-modules.deb \
-o /tmp/kernel-outputNo Debian e no Ubuntu, um kernel pode ser dividido em vários pacotes. O backend verifica se os pacotes de imagem, módulos, base e módulos extras opcionais fornecidos formam uma versão coerente, em vez de combinar silenciosamente revisões não relacionadas.
O empacotamento gera a imagem do kernel, o initramfs e o módulo de kernel SquashFS. Os metadados dos pacotes selecionados são mantidos dentro do módulo, em /usr/share/minios/kernel-dpkg/.
A compressão SquashFS padrão é zstd. Outros métodos são oferecidos somente quando as ferramentas necessárias estão disponíveis; o suporte atual inclui lz4, lzo, gzip, lzma, xz e bzip2.
Quando uma raiz MiniOS gravável é detectada e o destino solicitado está em outro local, o bundle concluído é transferido atomicamente para:
<MiniOS-root>/kernels/<version>/
Os downloads do repositório são entradas temporárias da compilação e são removidos após uma operação de empacotamento concluída ou com falha tratada. As entradas .deb locais permanecem sob responsabilidade de quem as forneceu.
Se o initramfs MiniOS em execução anunciar suporte à persistência LUKS em camadas, o kernel substituto deverá preservar o caminho de inicialização dm-crypt. O initramfs gerado é verificado para confirmar o suporte necessário ao cryptsetup, o módulo dm-crypt e o marcador de capacidade criptográfica MiniOS.
O empacotamento falha em vez de gerar um bundle de kernel que impediria a inicialização de uma sessão com persistência criptografada.
A tela de gerenciamento diferencia:
- EM EXECUÇÃO — o kernel em execução na inicialização atual;
- ATIVO — o pacote completo selecionado para a próxima inicialização;
- DISPONÍVEL — outro pacote disponível no repositório MiniOS.
A ativação exige uma entrada completa no repositório. Ela prepara a imagem do kernel, o initramfs, o módulo SquashFS ativo, o marcador da versão ativa e as alterações no bootloader como uma única operação coordenada. A configuração do GRUB é obrigatória; a configuração nativa do SYSLINUX é atualizada quando presente. Se a ativação falhar, os arquivos de inicialização preparados serão revertidos.
A ativação altera apenas a próxima inicialização; ela não reinicia o sistema atual. Mantenha pelo menos um pacote completo que você saiba que funciona até que o substituto tenha iniciado com sucesso.
Exclua somente um kernel empacotado inativo de que você não precisa mais. Não misture manualmente uma imagem de kernel, um initramfs ou 01-kernel-*.sb de pacotes diferentes.
Os comandos mais comuns são:
sudo minios-kernel list
sudo minios-kernel info
sudo minios-kernel info <version>
sudo minios-kernel status
sudo minios-kernel activate <version>
sudo minios-kernel delete <version>Pacote de um repositório ou de arquivos locais:
sudo minios-kernel package --repo <versioned-package> -o /tmp/kernel-output
sudo minios-kernel package --repo <versioned-package> --force-update -o /tmp/kernel-output
sudo minios-kernel package --deb /path/to/kernel-image.deb /path/to/kernel-modules.deb -o /tmp/kernel-output
sudo minios-kernel package --repo <versioned-package> --sqfs-comp lz4 -o /tmp/kernel-outputAdicione --json para obter uma saída estruturada. Consulte a ajuda e o manual instalados para ver as opções exatas disponíveis na versão em execução:
minios-kernel --help
sudo minios-kernel package --help
man minios-kernelO Kernel Manager localiza a raiz de conteúdo MiniOS, sem presumir um nome específico de dispositivo de bloco. Os caminhos gerenciados são relativos a essa raiz:
<MiniOS-root>/
├── 01-kernel-<version>.sb
├── boot/
│ ├── vmlinuz-<version>
│ ├── initrfs-<version>.img
│ └── active-kernel
└── kernels/
└── <version>/
├── 01-kernel-<version>.sb
├── vmlinuz-<version>
└── initrfs-<version>.img
O caminho canônico do módulo em tempo de execução é /lib/modules/<version>. Em sistemas com usrmerge, esse caminho aponta para /usr/lib/modules/<version>; em organizações mais antigas, ele pode estar armazenado fisicamente em /lib. O empacotamento não permite que uma árvore de módulos da mesma versão já existente seja combinada com uma revisão de pacote diferente.
Se um kernel recém-ativado falhar, inicialize com um conjunto completo e confiável do kernel MiniOS, caso ainda haja um disponível. Não tente reparar a instalação copiando arquivos individuais de kernel, initramfs ou SquashFS de outra imagem: esses arquivos formam um único pacote coordenado.
Se não houver mais nenhum pacote completo e confiável, inicialize por uma mídia de recuperação confiável, preserve os dados importantes e reinstale ou restaure a instalação MiniOS afetada. Consulte Solução de problemas e Como fazer backup de MiniOS.
🌐 Languages
📋 Getting started
🚀 Installing MiniOS
- Installation methods
- Verifying downloads
- Installation tools
- Manual file-based installation
- MiniOS Installer
🖥️ Using MiniOS
⚙️ Preparing and customizing MiniOS
- Preconfiguring MiniOS
- Managing modules
- Managing kernels
- Creating custom MiniOS images
- Customizing the boot menu
🛡️ Maintenance and recovery
📖 Reference
- System architecture
- Boot process
- Boot parameters
- Configuration
- Package and edition contents
🛠️ Development
📋 Erste Schritte
🚀 MiniOS installieren
- Installationsmethoden
- Downloads verifizieren
- Installationswerkzeuge
- Manuelle dateibasierte Installation
- MiniOS-Installationsprogramm
🖥️ MiniOS verwenden
⚙️ MiniOS vorbereiten und anpassen
- MiniOS vorkonfigurieren
- Module verwalten
- Kernel verwalten
- Eigene MiniOS-Images erstellen
- Startmenü anpassen
🛡️ Wartung und Wiederherstellung
📖 Referenz
- Systemarchitektur
- Startvorgang
- Startparameter
- Konfiguration
- Paket- und Editionsinhalte
🛠️ Entwicklung
📋 Primeros pasos
🚀 Instalando MiniOS
- Métodos de instalación
- Verificación de descargas
- Herramientas de instalación
- Instalación manual basada en archivos
- Instalador de MiniOS
🖥️ Usar MiniOS
⚙️ Preparar y personalizar MiniOS
- Preconfiguración de MiniOS
- Gestión de módulos
- Gestión de kernels
- Creación de imágenes personalizadas de MiniOS
- Personalizar el menú de arranque
🛡️ Mantenimiento y recuperación
- Actualizar MiniOS
- Copia de seguridad de MiniOS
- Solución de problemas
- Seguridad
- Rendimiento
- Virtualización
📖 Referencia
- Arquitectura del sistema
- Proceso de arranque
- Parámetros de arranque
- Configuración
- Contenido de paquetes y ediciones
🛠️ Desarrollo
📋 Premiers pas
🚀 Installation de MiniOS
- Méthodes d'installation
- Vérification des téléchargements
- Outils d'installation
- Installation manuelle basée sur les fichiers
- Programme d’installation MiniOS
🖥️ Utiliser MiniOS
⚙️ Préparer et personnaliser MiniOS
- Préconfiguration de MiniOS
- Gestion des modules
- Gestion des noyaux
- Créer des images MiniOS personnalisées
- Personnaliser le menu de démarrage
🛡️ Maintenance et récupération
📖 Référence
- Architecture du système
- Processus de démarrage
- Paramètres de démarrage
- Configuration
- Contenu des paquets et éditions
🛠️ Développement
📋 Memulai
🚀 Menginstal MiniOS
- Metode instalasi
- Memverifikasi unduhan
- Alat instalasi
- Instalasi manual berbasis file
- Penginstal MiniOS
🖥️ Menggunakan MiniOS
⚙️ Menyiapkan dan menyesuaikan MiniOS
- Pra-konfigurasi MiniOS
- Mengelola modul
- Mengelola kernel
- Membuat citra MiniOS kustom
- Menyesuaikan menu boot
🛡️ Pemeliharaan dan pemulihan
📖 Referensi
- Arsitektur sistem
- Proses boot
- Parameter boot
- Konfigurasi
- Isi paket dan edisi
🛠️ Pengembangan
📋 Per iniziare
🚀 Installazione di MiniOS
- Metodi di installazione
- Verifica dei download
- Strumenti di installazione
- Installazione manuale basata su file
- Installatore MiniOS
🖥️ Usare MiniOS
⚙️ Preparare e personalizzare MiniOS
- Preconfigurazione di MiniOS
- Gestione dei moduli
- Gestione dei kernel
- Creazione di immagini MiniOS personalizzate
- Personalizzazione del menu di avvio
🛡️ Manutenzione e ripristino
- Aggiornamento di MiniOS
- Backup di MiniOS
- Risoluzione dei problemi
- Sicurezza
- Prestazioni
- Virtualizzazione
📖 Riferimento
- Architettura di sistema
- Processo di avvio
- Parametri di avvio
- Configurazione
- Contenuto di pacchetti ed edizioni
🛠️ Sviluppo
📋 Primeiros passos
🚀 Instalando o MiniOS
- Métodos de instalação
- Verificando downloads
- Ferramentas de instalação
- Instalação manual baseada em arquivos
- Instalador do MiniOS
🖥️ Usar MiniOS
⚙️ Preparando e personalizando o MiniOS
- Pré-configurando o MiniOS
- Gerenciando módulos
- Gerenciando kernels
- Criando imagens personalizadas do MiniOS
- Personalizando o menu de boot
🛡️ Manutenção e recuperação
- Atualizando o MiniOS
- Fazendo backup do MiniOS
- Solução de problemas
- Segurança
- Desempenho
- Virtualização
📖 Referência
- Arquitetura do sistema
- Processo de boot
- Parâmetros de boot
- Configuração
- Conteúdo dos pacotes e edições
🛠️ Desenvolvimento
📋 Начало работы
🚀 Установка MiniOS
- Методы установки
- Проверка загрузок
- Инструменты установки
- Ручная установка на основе файлов
- Установщик MiniOS
🖥️ Использование MiniOS
⚙️ Подготовка и настройка MiniOS
- Предварительная настройка MiniOS
- Управление модулями
- Управление ядрами
- Создание пользовательских образов MiniOS
- Настройка загрузочного меню
🛡️ Обслуживание и восстановление
- Обновление MiniOS
- Резервное копирование MiniOS
- Устранение неполадок
- Безопасность
- Производительность
- Виртуализация
📖 Справочник
- Архитектура системы
- Процесс загрузки
- Параметры загрузки
- Конфигурация
- Содержимое пакета и редакций
🛠️ Разработка