basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    cloud-init: сервер настроен уже при создании

    Файл user-data в формате cloud-config вставляем в панели провайдера при создании сервера — и при первой загрузке он делает то же, что мануалы набора: пользователь с ключом, вход только по ключу, обновления с перезагрузкой, подкачка, фаервол. На сервер входим уже как example-user.

    Как это работает

    панель провайдера: поле «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»).

    Файл по блокам

    user-data
    #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: true

    ssh_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 | sh

    Docker и 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'