cloudos справочник

установка cloudos 1.0 на x86_64.

1. о cloudos

cloudos это минимальный linux, который ты собираешь сам. после установки в системе только консоль.

1.1 что нужно

цифры примерные, жёстких проверок нет.

1.2 что внутри stage 3

stage 3 собран с нуля по lfs 12.4 (sysv-вариант) и дополнен всем, что нужно для установки и сборки пакетов. версии указаны для cloudos 1.0.

1.3 чего в системе нет

• графики и окружений рабочего стола. после установки только консоль
• man-страниц. справка это этот справочник и ключ --help
• ssh-сервера и фаервола
• sudo. вместо него doas
• пользователей кроме root, локалей и swap. их создаёшь сам
• загрузчика и ядра. ядро собираешь, загрузчик ставишь через пакетный менеджер

1.4 порядок установки

1. загрузись с live iso, проверь сеть и режим загрузки
2. размеч диск и создай файловые системы
3. скачай и распакуй stage 3
4. зайди в chroot и настрой сборку
5. собери ядро
6. сделай initramfs, fstab и поставь limine
7. задай пароль, включи службы и перезагрузись
8. настрой систему после первой загрузки

1.5 как пользоваться справочником

в левой панели сверху переключатель uefi и bios. выбери свой режим, и в справочнике останутся только нужные команды. выбор запоминается в браузере.

поиск открывается кнопкой в шапке или клавишами ctrl + k. у каждого блока с командой справа сверху кнопка копирования.

в командах встречаются заглушки, их надо заменить на свои значения:

2. подготовка

загрузись с live iso cloudos и проверь сеть.

dhcpcd
ping -c1 github.com

определи режим загрузки.

[ -d /sys/firmware/efi ] && echo uefi || echo bios

2.1 дата и время

если дата в системе неверная, https-сертификаты не пройдут проверку и скачивание будет падать с непонятными ошибками. проверь дату:

date

если она сильно отличается от настоящей, выставь вручную (формат год-месяц-день час:минуты:секунды):

date -s "YYYY-MM-DD HH:MM:SS"

2.2 диски

посмотри диски и разделы. нужное имя диска дальше подставляется везде вместо /dev/sda.

lsblk -f

sata и usb диски называются sda, sdb, nvme это nvme0n1, виртуальные vda. узнать, какой из них флешка с live iso, можно по размеру.

2.3 сеть

проверь, что интерфейс виден и получил адрес:

ip link
ip addr

если адреса нет, запусти dhcpcd ещё раз для нужного интерфейса (имя смотри в ip link):

dhcpcd eth0

из коробки настроена только проводная сеть. wifi в live iso не настраивается.

2.4 если сайты не открываются

github, kernel.org и некоторые зеркала могут быть недоступны из твоей сети. тогда скачай файл на другом устройстве и перенеси на флешку:

mkdir -p /mnt/usb
mount /dev/sdb1 /mnt/usb
ls /mnt/usb

вместо /dev/sdb1 подставь раздел своей второй флешки из lsblk. для ядра есть зеркала, смотри 7.3.

3. диск и файловые системы

3.1 разметка

cfdisk /dev/sda

3.2 файловые системы

mkfs.fat -F32 /dev/sda1

mkfs.fat -F32 /dev/sda1

корневой раздел форматируй в ext4:

mkfs.ext4 /dev/sda2

или в btrfs:

mkfs.btrfs /dev/sda2

3.3 монтирование

mkdir -p /mnt/cloudos
mount /dev/sda2 /mnt/cloudos
mkdir -p /mnt/cloudos/boot
mount /dev/sda1 /mnt/cloudos/boot

3.4 пример схемы

если нужен swap-раздел, сделай его третьим, а не первым. подробнее про swap в 10.7. swap можно сделать и файлом уже после установки, тогда отдельный раздел не нужен.

3.5 проверка

убедись, что всё смонтировано как надо:

lsblk -f
findmnt /mnt/cloudos
findmnt /mnt/cloudos/boot

корень должен быть на втором разделе, /boot на первом. если одна из команд ничего не вывела, раздел не смонтирован.

4. stage 3

stage 3 это готовая базовая система cloudos без ядра и загрузчика. файлы лежат в разделе releases репозитория.

github.com/wh1laye/cloudos-repo/releases

cloudos-stage3-1.0-x86_64.tar.xz
cloudos-stage3-1.0-x86_64.tar.xz.sha256

4.1 проверка(можно пропустить)

sha256sum -c cloudos-stage3-1.0-x86_64.tar.xz.sha256

4.2 распаковка

tar xpvf cloudos-stage3-1.0-x86_64.tar.xz --xattrs-include='*.*' --numeric-owner -C /mnt/cloudos

4.3 скачивание

скачивай прямо на корневой раздел, в live-системе мало места в памяти:

cd /mnt/cloudos
curl -LO https://github.com/wh1laye/cloudos-repo/releases/download/cloudos/cloudos-stage3-1.0-x86_64.tar.xz
curl -LO https://github.com/wh1laye/cloudos-repo/releases/download/cloudos/cloudos-stage3-1.0-x86_64.tar.xz.sha256

потом сделай проверку из 4.1 и распаковку из 4.2. распаковку запускай из той же папки, где лежит архив.

4.4 после распаковки

архив больше не нужен, удали его, чтобы не занимал место:

rm /mnt/cloudos/cloudos-stage3-1.0-x86_64.tar.xz*
ls /mnt/cloudos

в списке должны быть bin, boot, etc, usr, var и другие системные папки. если папка пустая, архив распаковался не туда.

5. вход в chroot

mount --types proc /proc /mnt/cloudos/proc
mount --rbind /sys /mnt/cloudos/sys
mount --make-rslave /mnt/cloudos/sys
mount --rbind /dev /mnt/cloudos/dev
mount --make-rslave /mnt/cloudos/dev
cp --dereference /etc/resolv.conf /mnt/cloudos/etc/
chroot /mnt/cloudos /bin/bash
source /etc/profile

5.1 что делают команды

5.2 приглашение

чтобы не забыть, что ты в chroot, поменяй приглашение:

export PS1="(cloudos chroot) $PS1"

5.3 войти повторно

если ты перезагрузил live iso или вышел из chroot, снова смонтируй разделы и повтори вход. архив заново распаковывать не нужно:

mount /dev/sda2 /mnt/cloudos
mount /dev/sda1 /mnt/cloudos/boot
mount --types proc /proc /mnt/cloudos/proc
mount --rbind /sys /mnt/cloudos/sys
mount --make-rslave /mnt/cloudos/sys
mount --rbind /dev /mnt/cloudos/dev
mount --make-rslave /mnt/cloudos/dev
cp --dereference /etc/resolv.conf /mnt/cloudos/etc/
chroot /mnt/cloudos /bin/bash
source /etc/profile

так же заходишь в систему для починки, если она перестала грузиться, смотри 14.9.

5.4 выход

exit
umount -R /mnt/cloudos

если размонтирование пишет target is busy, закрой все окна терминала, где ты был в chroot, и повтори.

6. настройка сборки

флаги сборки задаются в одном файле, /etc/cloudpkg/make.conf:

CC="gcc"
CFLAGS="-O2 -march=native"
MAKEOPTS="-j$(nproc)"
USE=""

для clang поставь CC="clang". потом обнови список рецептов:

cloudpkg sync

6.1 локали

echo "en_US.UTF-8 UTF-8" > /etc/locale.gen
localedef -i en_US -f UTF-8 en_US.UTF-8
echo "LANG=en_US.UTF-8" > /etc/locale.conf

6.2 флаги сборки

если собираешь на той же машине, где будешь работать, оставь -march=native. если потом перенесёшь диск на другой компьютер, замени на -march=x86-64. сам stage 3 собран с универсальными флагами.

6.3 параллельная сборка

-j$(nproc) запускает столько задач, сколько у процессора потоков. при малом объёме озу сборка может упасть с сообщением killed. тогда уменьши число:

MAKEOPTS="-j2"

6.4 gcc 15 и ошибки сборки

gcc 15 по умолчанию использует стандарт c23, и некоторые старые пакеты с ним не собираются. типичные признаки: ошибки про bool, true, false или объявления функций без аргументов. в этом случае верни прежний стандарт:

CC="gcc -std=gnu17"

меняй значение CC в /etc/cloudpkg/make.conf и повтори установку пакета.

7. ядро

ядро берётся с kernel.org и настраивается вручную

cd /usr/src
curl -LO https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.18.10.tar.xz
tar xf linux-6.18.10.tar.xz
cd linux-6.18.10
make menuconfig
make -j$(nproc)
make modules_install
cp arch/x86/boot/bzImage /boot/vmlinuz-6.18.10

7.1 что включить в menuconfig

в make menuconfig поиск открывается клавишей /, там можно найти любую опцию по имени. ядро без нужных драйверов не загрузится, поэтому проверь хотя бы эти пункты. звёздочка [*] значит встроено в ядро, M значит модуль.

удобный старт: если live iso собран с поддержкой /proc/config.gz, возьми его конфиг за основу и дополни:

zcat /proc/config.gz > .config
make olddefconfig
make menuconfig

7.2 что делают команды сборки

сохрани конфиг и карту символов, они пригодятся при обновлении ядра:

cp .config /boot/config-6.18.10
cp System.map /boot/System.map-6.18.10

7.3 зеркала ядра

если cdn.kernel.org не открывается, скачай тот же архив с зеркала:

curl -LO https://mirrors.aliyun.com/linux-kernel/v6.x/linux-6.18.10.tar.xz
curl -LO https://mirrors.ustc.edu.cn/kernel.org/linux/kernel/v6.x/linux-6.18.10.tar.xz

пути на зеркалах иногда меняются. если ссылка не работает, открой каталог зеркала в браузере и найди файл вручную.

7.4 другая версия ядра

во всех командах замени 6.18.10 на свою версию. имена файлов в /boot, в initramfs и в limine.conf должны совпадать.

8. загрузчик

8.1 initramfs

cloudpkg install dracut
dracut --kver 6.18.10 /boot/initramfs-6.18.10.img

8.2 fstab

uuid разделов покажет blkid. файл /etc/fstab для uefi:

UUID=ROOT_UUID  /      ext4  defaults  0 1
UUID=ESP_UUID   /boot  vfat  defaults  0 2

для bios:

UUID=ROOT_UUID  /      ext4  defaults  0 1
UUID=BOOT_UUID  /boot  vfat  defaults  0 2

если корень на btrfs, замени ext4 в первой строке на btrfs.

8.3 limine

cloudpkg install limine

файл /boot/limine.conf одинаковый для uefi и bios:

timeout: 5

/CloudOS
    protocol: linux
    path: boot():/vmlinuz-6.18.10
    cmdline: root=UUID=ROOT_UUID rw
    module_path: boot():/initramfs-6.18.10.img

mkdir -p /boot/EFI/BOOT
cp /usr/share/limine/BOOTX64.EFI /boot/EFI/BOOT/BOOTX64.EFI

cp /usr/share/limine/limine-bios.sys /boot/
limine bios-install /dev/ (твое имя диска /dev/sda1 /dev/sdb1 /dev/nvme0n1)

8.4 проверка перед перезагрузкой

посмотри, что лежит в /boot:

ls -l /boot

сверь uuid в конфигах с настоящими:

blkid
grep UUID /etc/fstab /boot/limine.conf

uuid корневого раздела в limine.conf и в fstab должны совпадать с выводом blkid. большинство неудачных первых загрузок из-за опечатки здесь.

8.5 запись в nvram (только uefi, по желанию)

efibootmgr --create --disk /dev/sda --part 1 --loader '\EFI\BOOT\BOOTX64.EFI' --label CloudOS

8.6 несколько ядер

перед обновлением ядра добавь второй пункт в /boot/limine.conf, а старый не удаляй. если новое ядро не загрузится, выберешь старое в меню:

timeout: 5

/CloudOS
    protocol: linux
    path: boot():/vmlinuz-NEW
    cmdline: root=UUID=ROOT_UUID rw
    module_path: boot():/initramfs-NEW.img

/CloudOS (старое ядро)
    protocol: linux
    path: boot():/vmlinuz-OLD
    cmdline: root=UUID=ROOT_UUID rw
    module_path: boot():/initramfs-OLD.img

вместо NEW и OLD подставь версии ядер.

8.7 grub вместо limine

если хочешь grub, поставь его вместо limine (внутри chroot, после установки ядра и initramfs):

cloudpkg sync
cloudpkg install sys-boot/grub

grub-install --target=x86_64-efi --efi-directory=/boot --boot-directory=/boot --removable

grub-install --target=i386-pc --boot-directory=/boot /dev/sda

конфиг пишется вручную в /boot/grub/grub.cfg:

set timeout=5
menuentry "CloudOS" {
    search --no-floppy --fs-uuid --set=root ESP_UUID
    linux /vmlinuz-6.18.10 root=UUID=ROOT_UUID rw
    initrd /initramfs-6.18.10.img
}

9. завершение

включи сеть и журнал, задай пароль root:

cloudpkg install dhcpcd
cloudpkg install syslog-ng
rc-update add dhcpcd default
rc-update add syslog-ng default
passwd

выйди из chroot, размонтируй и перезагрузись:

exit
umount -R /mnt/cloudos
reboot

9.1 проверка служб

перед перезагрузкой убедись, что службы добавлены:

rc-update show

в списке должны быть dhcpcd и журнал в уровне default.

9.2 первая загрузка

после перезагрузки вытащи флешку и выбери диск в меню загрузки, если он не выбрался сам. появится приглашение login: на tty1. введи root и пароль, который задал командой passwd.

дальше настрой систему, это описано в главе 10.

10. первая загрузка

после установки в системе только консоль и root. эта глава про то, что стоит сделать сразу.

10.1 вход

на приглашении login: введи root и пароль, который задал в главе 9. если не задал, пароль пустой, задай его сразу командой passwd.

10.2 пользователь и doas

работать под root постоянно небезопасно. создай обычного пользователя и разреши группе wheel пользоваться doas:

grep wheel /etc/group || groupadd wheel
useradd -m -G wheel -s /bin/bash имя
passwd имя
echo "permit :wheel" > /etc/doas.conf
chmod 0400 /etc/doas.conf

вместо имя подставь своё. дальше команды от root выполняются так:

doas cloudpkg install nano

если не хочешь вводить пароль каждый раз, замени правило на permit nopass :wheel. это удобнее, но безопаснее с паролем.

10.3 имя компьютера

echo "cloudos" > /etc/hostname
echo 'hostname="cloudos"' > /etc/conf.d/hostname
rc-update add hostname boot

если служба hostname уже включена, последняя команда сообщит об этом и ничего не изменит. вместо cloudos можно написать любое имя латиницей.

10.4 часовой пояс

ls /usr/share/zoneinfo
ln -sfv /usr/share/zoneinfo/Europe/Moscow /etc/localtime

вместо Europe/Moscow выбери свой пояс из списка. проверь результат командой date.

10.5 сеть

dhcpcd получает адрес и dns автоматически. проверь:

ip addr
ping -c1 github.com

если нужен постоянный адрес, добавь в /etc/dhcpcd.conf (имя интерфейса смотри в ip link):

interface eth0
static ip_address=192.168.1.50/24
static routers=192.168.1.1
static domain_name_servers=1.1.1.1 8.8.8.8

потом перезапусти службу: rc-service dhcpcd restart.

10.6 службы openrc

уровни: boot для того, что нужно на раннем этапе (например имя компьютера), default для обычных служб.

10.7 swap

swap не обязателен, но помогает при сборке больших пакетов на малом объёме озу. проще всего файлом.

для ext4:

dd if=/dev/zero of=/swapfile bs=1M count=4096 status=progress
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

для btrfs (подходит и для ext4):

btrfs filesystem mkswapfile --size 4g /swapfile
swapon /swapfile

чтобы swap включался сам, добавь строку в /etc/fstab:

/swapfile  none  swap  defaults  0 0

swap-раздел делают так: mkswap /dev/sda3, swapon /dev/sda3 и строка в fstab с UUID=... вместо /swapfile.

11. пакеты и cloudpkg

все пакеты в cloudos собираются из исходников. этим занимается менеджер cloudpkg. рецепты для него берутся из gentoo.

11.1 команды

11.2 как проходит установка

1. читается рецепт пакета и список его зависимостей
2. исходники скачиваются через curl
3. проверяется sha256
4. пакет собирается с твоими флагами из /etc/cloudpkg/make.conf
5. результат ставится в систему

сборка занимает время и место на диске. большие пакеты вроде компиляторов собираются долго, это нормально.

11.3 примеры

cloudpkg sync
cloudpkg install limine
cloudpkg install dracut
cloudpkg install nano

11.4 если пакет не собрался

1. прочитай последние строки с error
2. если ошибка про стандарт си, поставь CC="gcc -std=gnu17", смотри 6.4
3. если сборка падает с killed, уменьши -j в MAKEOPTS
4. попробуй cloudpkg sync и повтори, возможно рецепт уже исправлен
5. напиши на форум в раздел с вопросами, приложив последние 10-15 строк вывода

12. обслуживание

12.1 обновление пакетов

cloudpkg sync
cloudpkg upgrade
cloudpkg clean

12.2 обновление ядра

новую версию ставят рядом со старой. старое ядро не удаляй, пока не убедишься, что новое загружается.

1. скачай и распакуй новое ядро в /usr/src, как в главе 7
2. возьми старый конфиг за основу и подтяни новые опции:

cd /usr/src/linux-НОВАЯ
cp /boot/config-СТАРАЯ .config
make olddefconfig

3. собери и установи:

make -j$(nproc)
make modules_install
cp arch/x86/boot/bzImage /boot/vmlinuz-НОВАЯ
cp .config /boot/config-НОВАЯ
dracut --kver НОВАЯ /boot/initramfs-НОВАЯ.img

4. добавь второй пункт в /boot/limine.conf, как в 8.6, и перезагрузись
5. если всё работает, старые файлы можно удалить:

rm /boot/vmlinuz-СТАРАЯ /boot/initramfs-СТАРАЯ.img /boot/config-СТАРАЯ
rm -r /lib/modules/СТАРАЯ

вместо НОВАЯ и СТАРАЯ подставь версии, например 6.18.10.

12.3 резервная копия

полная копия системы одним архивом с теми же ключами, что и при распаковке stage 3. сохраняй её на другой диск или флешку:

tar cpf /mnt/usb/cloudos-backup.tar.xz --xattrs-include='*.*' --numeric-owner --one-file-system -I xz /

для btrfs есть снимки, они быстрее и занимают меньше места, смотри приложение б.

12.4 очистка места

df -h
cloudpkg clean
du -sh /usr/src/* /var/* 2>/dev/null

старые папки ядер в /usr/src можно удалять, если у тебя сохранены их конфиги в /boot.

13. что дальше

cloudos ставится минимальным. всё остальное ты добавляешь по мере необходимости.

13.1 другие локали

в главе 6.1 создана одна локаль. чтобы добавить ещё, например русскую:

localedef -i ru_RU -f UTF-8 ru_RU.UTF-8
echo "LANG=ru_RU.UTF-8" > /etc/locale.conf

в консоли ядра кириллица может отображаться некорректно без отдельного шрифта, поэтому для консоли безопаснее оставить en_US.UTF-8.

13.2 помощь и обратная связь

• вопросы и обсуждение на форуме
• новые версии и образы на странице релизов
• ошибки и предложения в issues на github

14. ошибки и решения

нажми на текст ошибки, чтобы увидеть причину и что делать. если твоей ошибки нет в списке, воспользуйся поиском.

14.1 live iso, сеть и время

ip link
dhcpcd eth0

14.2 разметка и файловые системы

14.3 скачивание и распаковка

14.4 chroot

14.5 сборка пакетов

14.6 ядро

14.7 загрузка

14.8 после загрузки

14.9 аварийный вход в систему

если система не загружается, почти всегда её можно починить из live iso:

1. загрузись с live iso и проверь сеть
2. смонтируй разделы и войди в chroot по 5.3
3. исправь конфиг, пересобери initramfs командой dracut --kver 6.18.10 /boot/initramfs-6.18.10.img --force или поправь limine.conf
4. выйди из chroot, размонтируй и перезагрузись

14.10 как сообщить об ошибке

чтобы тебе быстро помогли, приложи:

• какую главу справочника ты выполнял и на какой команде всё упало
• строки с error или последние 10-15 строк вывода
• режим загрузки (uefi или bios), имя диска (sda или nvme) и файловую систему корня
• вывод dmesg | tail -50, если ошибка после загрузки

14.11 мастер установки и grub

lsblk
partprobe /dev/sda

bash /root/cloudos-s1.sh

ls /usr/share/limine
command -v grub-install

ls /sys/firmware/efi
mountpoint /mnt/cloudos/boot

ls
set root=(hd0,msdos1)
set prefix=(hd0,msdos1)/grub
insmod normal
normal

ls
set root=(hd0,msdos1)
linux /vmlinuz-6.18.10 root=/dev/sda2 rw
initrd /initramfs-6.18.10.img
boot

ls /boot
nano /boot/grub/grub.cfg

14.12 cloudpkg и portage

cloudpkg sync
cloudpkg doctor

ln -sfn /var/db/repos/gentoo/profiles/default/linux/amd64/23.0 /etc/portage/make.profile

python3 -m pip install --force-reinstall --index-url https://mirrors.aliyun.com/pypi/simple/ portage

doas cloudpkg install имя

cloudpkg search имя
cloudpkg install категория/имя

cloudpkg install -t категория/имя

echo "sys-libs/glibc-2.42" >> /etc/portage/profile/package.provided
cloudpkg install -p имя

cloudpkg clean
cloudpkg install имя

tail -n 30 /var/tmp/portage/категория/имя/temp/build.log

15. шпаргалка

15.1 диски

15.2 сеть

15.3 система

15.4 файлы и архивы

15.5 btrfs

15.6 cloudpkg

службы openrc собраны в таблице 10.6.

16. вопросы и ответы

приложение а. имена дисков

имя раздела зависит от типа диска. у nvme перед номером раздела добавляется буква p.

если ты ставишь на nvme, замени /dev/sda1 на /dev/nvme0n1p1 и /dev/sda2 на /dev/nvme0n1p2 во всех командах.

приложение б. btrfs с подтомами

необязательно. подтома позволяют делать быстрые снимки системы и откатываться. описано для схемы из 3.4.

б.1 создание подтомов

mkfs.btrfs /dev/sda2
mount /dev/sda2 /mnt/cloudos
btrfs subvolume create /mnt/cloudos/@
btrfs subvolume create /mnt/cloudos/@home
umount /mnt/cloudos

б.2 монтирование

mount -o subvol=@ /dev/sda2 /mnt/cloudos
mkdir -p /mnt/cloudos/boot /mnt/cloudos/home
mount /dev/sda1 /mnt/cloudos/boot
mount -o subvol=@home /dev/sda2 /mnt/cloudos/home

б.3 fstab и загрузчик

UUID=ROOT_UUID  /      btrfs  subvol=@,noatime      0 0
UUID=ROOT_UUID  /home  btrfs  subvol=@home,noatime  0 0
UUID=ESP_UUID   /boot  vfat   defaults              0 2

в /boot/limine.conf в строке cmdline добавь параметр подтома:

cmdline: root=UUID=ROOT_UUID rootflags=subvol=@ rw

б.4 снимок системы

mkdir -p /mnt/top
mount -o subvolid=5 /dev/sda2 /mnt/top
btrfs subvolume snapshot -r /mnt/top/@ /mnt/top/@-snap-1
umount /mnt/top

снимок лежит рядом с подтомом @ и не занимает места, пока данные не изменятся.

приложение в. словарь