Как это работает
панель провайдера: поле «User data» / «Cloud-init»
│ при создании сервера
▼
первая загрузка: cloud-init читает файл → модули по порядку:
users, ssh, write_files, swap, package_update/upgrade, packages, runcmd, перезагрузка
│
▼
/var/log/cloud-init-output.log — вывод всех команд
cloud-init стоит во всех облачных образах Ubuntu. Файл выполняется один раз, при первой загрузке.
Повторный запуск — только с sudo cloud-init clean --reboot, и это переустановит всё, что в файле.
Поддерживает ли провайдер user data — смотрим в его панели: поле называется «User data», «Cloud-init» или «Скрипт при создании». Если поля нет — настраиваем руками, по шагам набора («Новый сервер на Ubuntu»).
Файл по блокам
#cloud-configПервая строка — обязательный признак формата. Без неё cloud-init примет файл за скрипт или пропустит.
hostname: web1
timezone: Europe/Berlin # своя зонаИмя и часовой пояс — как в «Первый вход на сервер». Часовой пояс решает, когда наступает «4:00» для автоматической перезагрузки.
users:
- name: example-user
groups: [sudo]
shell: /bin/bash
lock_passwd: false
hashed_passwd: "$6$Qm…$…"
ssh_authorized_keys:
- ssh-ed25519 AAAAC3Nza… laptop-2026
- ssh-ed25519 AAAAC3Nza… desktop-2026Свой пользователь с sudo и двумя ключами — с разных устройств. Пароль задаём хэшем: он нужен для sudo и входа через консоль провайдера, но по SSH им не войти. Хэш — на компьютере: openssl passwd -6, сам пароль в файл не попадает. lock_passwd: false — пароль не заблокирован.
по умолчанию:lock_passwd trueshell /bin/sh
ssh_pwauth: false
disable_root: truessh_pwauth: false — cloud-init пишет PasswordAuthentication no в свой 50-cloud-init.conf. disable_root: true — ключи root заменяются на подсказку «входите как example-user». Пароль root не задан вовсе.
по умолчанию:ssh_pwauth как в образе провайдераdisable_root true
write_files:
- path: /etc/ssh/sshd_config.d/00-hardening.conf
content: |
PasswordAuthentication no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
PermitRootLogin no
AllowUsers example-user
MaxAuthTries 3
LoginGraceTime 30
X11Forwarding no
AllowAgentForwarding no
ClientAliveInterval 300
ClientAliveCountMax 2Свой файл sshd — тот же, что в «sshd_config». write_files выполняется до пакетов и runcmd, поэтому к первой перезагрузке настройки уже на месте.
- path: /etc/apt/apt.conf.d/52unattended-upgrades-local
content: |
Unattended-Upgrade::Automatic-Reboot "true";
Unattended-Upgrade::Automatic-Reboot-Time "04:00";
Unattended-Upgrade::Automatic-Reboot-WithUsers "true";
Unattended-Upgrade::Remove-Unused-Kernel-Packages "true";
Unattended-Upgrade::Remove-New-Unused-Dependencies "true";
Unattended-Upgrade::Remove-Unused-Dependencies "true";
Unattended-Upgrade::AutoFixInterruptedDpkg "true";
- path: /etc/systemd/journald.conf.d/00-size.conf
content: |
[Journal]
SystemMaxUse=500M
SystemKeepFree=1G
- path: /etc/sysctl.d/99-swappiness.conf
content: |
vm.swappiness=10Автообновления с перезагрузкой («unattended-upgrades»), предел журнала и swappiness («Swap, журнал и время») — тоже файлами.
swap:
filename: /swapfile
size: 2GПодкачка — встроенным модулем: он создаёт файл, ставит права и пишет строку в /etc/fstab.
package_update: true
package_upgrade: true
package_reboot_if_required: true
packages:
- ncdu
- htopОбновления при создании и перезагрузка, если обновилось ядро. Пакеты — то, что пригодится в первый час: ncdu для диска, htop для памяти.
по умолчанию:package_update falsepackage_upgrade false
runcmd:
- ufw default deny incoming
- ufw default allow outgoing
- ufw allow OpenSSH
- ufw allow 80,443/tcp
- ufw --force enable
- sysctl --system
- systemctl restart sshФаервол — как в «Фаервол ufw»: правило SSH раньше enable. --force — без вопроса y/n. Последней строкой перезапускаем sshd, чтобы прочитался наш файл.
- curl -fsSL https://get.docker.com | shDocker и CrowdSec сюда тоже можно добавить командами runcmd, но ошибку в них видно только в логе. Пока шагов немного, их делаем руками после первого входа («Docker на Ubuntu», «CrowdSec против перебора SSH»).
Чего здесь нет
| Что | Почему |
|---|---|
пароль открытым текстом (passwd, chpasswd) |
user data хранится у провайдера и читается с сервера по адресу метаданных 169.254.169.254 любым процессом |
| ключи API, токены | по той же причине: секреты кладём на сервер после создания («Секреты в Docker-стеках») |
| настройки, которые будут меняться | файл выполняется один раз; живые конфиги — в git («Конфиги серверов в git») |
Если не работает
Сервер создан, а ничего из файла не применилось
- Причина
- Первая строка не
#cloud-config— без неё файл не считается конфигом. Или ошибка YAML: cloud-init пропускает весь файл. - Делаем
- На сервере:
sudo cloud-init schema --system --annotateпокажет ошибку со строкой; лог —/var/log/cloud-init.log.
Вход как example-user работает, а sudo просит пароль, которого нет
- Причина
- У пользователя
lock_passwd: trueи нетhashed_passwd: пароля нет, аsudoего требует. - Делаем
- Задаём
hashed_passwd(хэш изopenssl passwd -6) иlock_passwd: false— или через консоль провайдераpasswd example-userот root.
Одна из команд runcmd не сработала, а остальные — да
- Причина
runcmdне останавливается на ошибке: каждая строка выполняется сама по себе.- Делаем
- Смотрим
/var/log/cloud-init-output.log— там вывод каждой команды по порядку; исправленную команду выполняем руками.
Через минуту после создания SSH не пускает никого
- Причина
- cloud-init ещё работает: ставит обновления и перезагружает сервер (
package_reboot_if_required). - Делаем
- Ждём 3–5 минут. Статус —
cloud-init status --waitчерез консоль провайдера.
Как проверить
Через 3–5 минут после создания, с компьютера:
ssh [email protected] 'cloud-init status --long'
# status: done
# extended_status: done
# boot_status_code: enabled-by-generator
# detail: DataSourceNoCloud …
# errors: []
errors: [] — все модули отработали. Дальше — проверка снаружи, тоже с компьютера:
# open — только 22; у 80 и 443 — closed: ufw их пропускает, но на них пока никто не слушает;
# остальные порты — filtered
nmap -Pn --top-ports 1000 203.0.113.10
# root не пускают
ssh [email protected]
# [email protected]: Permission denied (publickey).
# подкачка есть, у журнала предел, часы синхронизированы
ssh [email protected] 'swapon --show; journalctl --disk-usage; timedatectl show -p NTPSynchronized --value'