basforge

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

    EN

    Новый сервер: первый час

    Из пустого VPS делаем сервер, который можно оставить в интернете: свой пользователь с входом только по ключу, фаервол, обновления с ночной перезагрузкой, подкачка, предел журнала и Docker. Почему так — в мануалах, ссылка у каждого этапа.

    Начинаем спустого VPS из панели провайдера: Ubuntu 24.04 или 26.04, вход под root по паролю из письма или по ключу из панели.

    Что получится

    вход         example-user по ключу; пароль и root по SSH закрыты
    снаружи      ufw: открыты 22, 80 и 443, остальное отброшено
    обновления   безопасности — каждую ночь, перезагрузка в 4:00, если нужна
    память       подкачка /swapfile на 2 ГБ
    журнал       не больше 500 МБ; часы синхронизированы
    Docker       из репозитория Docker, логи контейнера — до 30 МБ
    • ПонадобитсяАдрес сервера 203.0.113.10 и вход под root: пароль из письма провайдера или ключ из панели
    • ПонадобитсяКлюч SSH на своём компьютере («Ключи SSH»); второй — с другого устройства, на случай потери первого
    • ПонадобитсяВход в панель провайдера: в ней веб-консоль сервера («Консоль провайдера»)

    Свои значения

    Подставляются в команды и файлы этого и других рецептов пути; хранятся только в этом браузере.
    Адрес сервера
    203.0.113.10условное
    Пользователь
    example-userусловное
    Имя сервера
    web1условное

    Без скрипта в командах — условные значения: меняем их на свои.

    Шаги

    Тот же рецепт коротко: команды — из этапов, файлы — строкой. Для второго сервера и для тех, кто уже знает, что делает каждая команда.

    Первый вход: обновления, имя, часовой пояс

    Почему так — «Первый вход на сервер»

    До любых правок открываем в панели провайдера веб-консоль сервера и входим под root. Она идёт мимо сети и SSH: если запрём себя, это единственный путь на сервер («Консоль провайдера»). Команды этого этапа и начала следующего — под root, поэтому без sudo.

    Вход
    Команда Что делает
    ssh [email protected] входим; отпечаток ключа сервера сверяем в консоли: ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
    Обновления
    Команда Что делает
    apt update && apt full-upgrade -y ставит все обновления; full-upgrade ещё и удаляет пакеты, если без этого обновление не встаёт
    cat /var/run/reboot-required 2>/dev/null && reboot перезагрузка, если обновилось ядро; через минуту входим снова
    Имя и часовой пояс
    Команда Что делает
    hostnamectl set-hostname web1 имя сервера: видно в приглашении консоли, в логах и письмах
    sed -i 's/^127\.0\.1\.1.*/127.0.1.1 web1/' /etc/hosts имя в /etc/hosts, иначе каждый sudo пишет unable to resolve host
    grep -q '^127.0.1.1' /etc/hosts || echo '127.0.1.1 web1' >> /etc/hosts добавляет строку, если её не было
    timedatectl set-timezone Europe/Berlin своя зона, список — timedatectl list-timezones; по ней наступает «4:00» ночной перезагрузки
    Готово, если
    Команда Что должно быть
    cat /var/run/reboot-required 2>/dev/null || echo нет нет: перезагрузка не нужна
    hostname web1
    timedatectl | grep -E 'Time zone|synchronized' своя зона и System clock synchronized: yes
    Не так — «Если не работает», случаи этапа .

    Свой пользователь и ключ

    Почему так — «Первый вход на сервер»

    adduser спросит пароль — ставим длинный и сохраняем в менеджере паролей. По SSH им входить не будем, но он нужен для sudo и для консоли провайдера.

    Пользователь — под root
    Команда Что делает
    adduser example-user пользователь с домашним каталогом; спрашивает пароль
    Права и ключ — под root
    Команда Что делает
    usermod -aG sudo example-user право на sudo
    rsync --archive --chown=example-user:example-user /root/.ssh /home/example-user/ ключ из панели провайдера — пользователю, с правами; у root ключа нет — следующая таблица
    Ключ с компьютера — если у root его не было
    Команда Что делает
    ssh-copy-id [email protected] кладёт свой ключ, пока вход по паролю открыт; на Windows — команда для PowerShell из «Ключи SSH»

    Окно с root не закрываем («Старая сессия остаётся открытой»). Дальше — во втором окне.

    Вход пользователем — во втором окне
    Команда Что делает
    ssh [email protected] вход по ключу: спрашивают только пароль ключа
    Проверяем sudo
    Команда Что делает
    sudo -v && sudo whoami sudo работает: спросит пароль example-user и ответит root
    Готово, если
    Команда Что должно быть
    sudo whoami root после пароля example-user
    groups в списке есть sudo
    Не так — «Если не работает», случаи этапа .

    Вход только по ключу

    Почему так — «sshd_config»

    Во втором окне, под example-user. С этого этапа команды — с sudo.

    /etc/ssh/sshd_config.d/00-hardening.confвход только по ключу и только example-user; имя с 00- — чтобы прочитаться раньше 50-cloud-init.conf
    PasswordAuthentication no
    KbdInteractiveAuthentication no
    PubkeyAuthentication yes
    
    PermitRootLogin no
    
    AllowUsers example-user
    
    MaxAuthTries 3
    LoginGraceTime 30
    
    X11Forwarding no
    AllowAgentForwarding no
    
    ClientAliveInterval 300
    ClientAliveCountMax 2
    Применяем
    Команда Что делает
    sudo sshd -t && echo ok проверка синтаксиса; без ok дальше не идём
    sudo systemctl restart ssh перезапуск; открытые сессии живут

    Проверяем вход из третьего окна, и только потом закрываем окно с root. Ещё до блокировки пароля root входим в консоль провайдера как example-user: после неё туда входим только им.

    Пароль root
    Команда Что делает
    sudo passwd -l root блокирует пароль root, в том числе в консоли провайдера

    Две первые проверки — с компьютера, в новом окне.

    Готово, если
    Команда Что должно быть
    ssh -o PubkeyAuthentication=no -o PreferredAuthentications=password [email protected] Permission denied (publickey): пароль не принимается
    ssh [email protected] Permission denied (publickey): root не входит даже по ключу
    sudo passwd -S root root L …: пароль заблокирован
    Не так — «Если не работает», случаи этапа .

    Фаервол

    Почему так — «Фаервол ufw»
    Правила и включение
    Команда Что делает
    sudo ufw default deny incoming входящее запрещено; начнёт действовать при включении
    sudo ufw default allow outgoing исходящее разрешено
    sudo ufw allow OpenSSH SSH — до включения, иначе enable закроет и его
    sudo ufw allow 80,443/tcp веб: на 80 приходит проверка Let’s Encrypt и редирект на HTTPS
    sudo ufw --force enable включает; --force — без вопроса про SSH-сессии, правило для SSH уже есть

    Порты, которые публикует Docker, ufw не закрывает: они идут мимо его правил («Порты Docker идут мимо цепочки input»). Поэтому у сервисов дальше по пути нет ports:.

    Готово, если
    Команда Что должно быть
    sudo ufw status verbose | head -3 Status: active и Default: deny (incoming), allow (outgoing), deny (routed)
    ssh [email protected] 'echo ok' с компьютера, в новом окне: ok
    Не так — «Если не работает», случаи этапа .

    Обновления сами и перезагрузка в 4:00

    Почему так — «unattended-upgrades»

    Обновления безопасности в Ubuntu уже ставятся сами, но новое ядро ждёт ручной перезагрузки. Свой файл включает её и чистку старых ядер; 50unattended-upgrades из пакета не трогаем.

    /etc/apt/apt.conf.d/52unattended-upgrades-localперезагрузка в 4:00, если обновление её требует, и чистка старых ядер
    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";

    Репозитория Docker в автообновлениях нет нарочно: обновление docker-ce перезапускает все контейнеры, его ставим руками.

    Готово, если
    Команда Что должно быть
    apt-config dump | grep -E 'Automatic-Reboot(-Time)? ' Automatic-Reboot "true" и Automatic-Reboot-Time "04:00"
    sudo unattended-upgrade --dry-run --debug 2>&1 | grep 'Allowed origins' в списке — noble-security, на 26.04 — resolute-security
    systemctl list-timers 'apt-daily*' --no-pager apt-daily.timer и apt-daily-upgrade.timer со временем следующего запуска
    Не так — «Если не работает», случаи этапа .

    Подкачка, журнал, время

    Почему так — «Swap, журнал и время»
    Подкачка 2 ГБ
    Команда Что делает
    sudo fallocate -l 2G /swapfile файл подкачки; на btrfs — см. «Если не работает»
    sudo chmod 600 /swapfile в подкачку попадает память процессов, читать её может только root
    sudo mkswap /swapfile размечает файл под подкачку
    sudo swapon /swapfile включает
    echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab включать при загрузке
    sudo findmnt --verify проверка /etc/fstab: ошибка в нём останавливает загрузку
    echo 'vm.swappiness=10' | sudo tee /etc/sysctl.d/99-swappiness.conf ядро уходит в подкачку, только когда памяти не хватает
    sudo sysctl --system применяет без перезагрузки
    Каталог настроек журнала
    Команда Что делает
    sudo mkdir -p /etc/systemd/journald.conf.d свои настройки — отдельным файлом, он переживает обновление пакета
    /etc/systemd/journald.conf.d/00-size.confжурнал не больше 500 МБ; на диске остаётся не меньше 1 ГБ
    [Journal]
    SystemMaxUse=500M
    SystemKeepFree=1G
    Применяем
    Команда Что делает
    sudo systemctl restart systemd-journald предел действует на новые записи
    sudo journalctl --vacuum-size=500M удаляет лишнее сразу

    Часы настраивать не нужно: они синхронизируются сами, на 24.04 — timesyncd, на 26.04 — chrony. Проверяем только, что синхронизация идёт.

    Готово, если
    Команда Что должно быть
    swapon --show /swapfile file 2G
    cat /proc/sys/vm/swappiness 10
    journalctl --disk-usage не больше 500 МБ
    timedatectl show -p NTPSynchronized --value yes
    Не так — «Если не работает», случаи этапа .

    Docker из репозитория Docker

    Почему так — «Docker на Ubuntu»
    Репозиторий Docker
    Команда Что делает
    sudo apt-get remove -y $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1) убирает Docker из Ubuntu, если стоял; на свежем сервере удалять нечего
    snap list docker 2>/dev/null && sudo snap remove docker убирает Docker из snap, если стоял
    sudo apt-get update && sudo apt-get install -y ca-certificates curl всё, чтобы скачать ключ репозитория
    sudo install -m 0755 -d /etc/apt/keyrings каталог для ключа
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc ключ, которым apt проверяет пакеты Docker
    sudo chmod a+r /etc/apt/keyrings/docker.asc ключ читают все
    printf 'Types: deb\nURIs: https://download.docker.com/linux/ubuntu\nSuites: %s\nComponents: stable\nArchitectures: %s\nSigned-By: /etc/apt/keyrings/docker.asc\n' "$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")" "$(dpkg --print-architecture)" | sudo tee /etc/apt/sources.list.d/docker.sources >/dev/null источник пакетов Docker; версия Ubuntu и архитектура подставляются сами
    sudo apt-get update apt узнаёт о пакетах Docker
    sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin Engine и Compose; служба запускается и встаёт в автозапуск сама
    /etc/docker/daemon.jsonпредел логов: три файла по 10 МБ на контейнер
    {
      "log-driver": "json-file",
      "log-opts": {
        "max-size": "10m",
        "max-file": "3"
      }
    }
    Применяем предел
    Команда Что делает
    sudo systemctl restart docker предел действует на контейнеры, созданные после перезапуска

    В группу docker пользователя не добавляем: через docker.sock она даёт root без пароля («docker.sock»). Поэтому sudo стоит и перед docker.

    Готово, если
    Команда Что должно быть
    sudo docker run --rm hello-world | grep Hello Hello from Docker!
    docker compose version Docker Compose version v5.6.0 или новее
    sudo docker create --name logtest alpine >/dev/null && sudo docker inspect logtest --format '{{.HostConfig.LogConfig}}'; sudo docker rm logtest >/dev/null {json-file map[max-file:3 max-size:10m]}
    Не так — «Если не работает», случаи этапа .

    Если не работает

    Этап 1

    Could not get lock /var/lib/dpkg/lock-frontend. It is held by process 1234 (unattended-upgr)

    Причина
    Первые минуты после загрузки сервер сам ставит обновления безопасности.
    Делаем
    Ждём: while pgrep -x unattended-upgr >/dev/null; do sleep 5; done, потом повторяем команду. Файлы блокировки не удаляем.
    Этап 1

    Во время обновления — окно A new version of configuration file /etc/ssh/sshd_config is available

    Причина
    Файл менял провайдер или cloud-init, и пакет не знает, чью версию оставить.
    Делаем
    Выбираем keep the local version currently installed: свои настройки всё равно ляжут отдельным файлом на этапе 3 («sshd_config»).
    Этап 1

    После перезагрузки имя сервера снова vm-4821

    Причина
    cloud-init при каждой загрузке выставляет имя из настроек провайдера.
    Делаем
    echo 'preserve_hostname: true' > /etc/cloud/cloud.cfg.d/99-hostname.cfg и снова hostnamectl set-hostname.
    Этап 2

    example-user is not in the sudoers file

    Причина
    Пользователь не в группе sudo, или его добавили, а сессия старая: группы читаются при входе.
    Делаем
    Под root: usermod -aG sudo example-user, потом выходим и входим заново; проверка — groups example-user.
    Этап 2

    ssh example-user@… спрашивает пароль пользователя, а не ключа

    Причина
    Ключа нет в /home/example-user/.ssh/authorized_keys: у root его не было, и rsync скопировал пустое, или клиент предложил не тот ключ.
    Делаем
    С компьютера — ssh-copy-id из этапа 2; какой ключ ушёл, показывает ssh -v [email protected] 2>&1 | grep -E 'Offering|accepts' («Ключи SSH»).
    Этап 3

    После restart ssh новые сессии не входят: Connection refused

    Причина
    Ошибка в конфиге, и sshd не стартовал. Открытая сессия при этом живёт — у неё свой процесс.
    Делаем
    В открытой сессии: sudo sshd -t назовёт строку, правим, sudo systemctl restart ssh. Сессии нет — консоль провайдера («Консоль провайдера»).
    Этап 3

    Permission denied (publickey) у example-user, хотя до этапа 3 ключ пускал

    Причина
    В AllowUsers другое имя: пользователя завели не под тем, что стоит в «Своих значениях», или опечатка.
    Делаем
    В открытой сессии правим строку AllowUsers в /etc/ssh/sshd_config.d/00-hardening.conf, sudo sshd -t && sudo systemctl restart ssh, входим из нового окна («Старая сессия остаётся открытой»).
    Этап 4

    После ufw enable новые SSH-сессии висят и отваливаются по тайм-ауту

    Причина
    Правила для SSH не было: политика deny incoming закрыла и порт 22.
    Делаем
    В ещё открытой сессии — sudo ufw allow OpenSSH. Сессии нет — консоль провайдера и то же самое.
    Этап 5

    --dry-run ничего не ставит, в /var/log/unattended-upgrades/ пусто

    Причина
    В /etc/apt/apt.conf.d/20auto-upgrades стоит "0" или файла нет — так бывает в образах провайдера.
    Делаем
    sudo dpkg-reconfigure -plow unattended-upgrades, ответ Yes создаёт файл заново («unattended-upgrades»).
    Этап 5

    Сервер перезагрузился в 4:00 по UTC, а не по местному

    Причина
    Время в Automatic-Reboot-Time — по часовому поясу сервера, а он остался UTC.
    Делаем
    sudo timedatectl set-timezone … из этапа 1 или пишем время в UTC.
    Этап 6

    swapon: /swapfile: swapon failed: Invalid argument или skipping - it appears to have holes

    Причина
    Файловая система — btrfs или старая XFS: там fallocate создаёт файл с «дырами», и ядро его не принимает.
    Делаем
    sudo rm /swapfile, sudo dd if=/dev/zero of=/swapfile bs=1M count=2048 status=progress, дальше chmod, mkswap, swapon из этапа 6. На btrfs — btrfs filesystem mkswapfile.
    Этап 6

    timedatectl show -p NTPSynchronized --value отвечает no

    Причина
    Наружу закрыт UDP 123 — у провайдера или в фаерволе исходящих; на 26.04 ещё и TCP 4460: chrony получает по нему ключи NTS.
    Делаем
    Смотрим timedatectl timesync-status (24.04) или chronyc sources -v (26.04) и открываем исходящие порты («Swap, журнал и время»).
    Этап 7

    docker-ce : Conflicts: docker.io при установке

    Причина
    Стоит Docker из репозитория Ubuntu, а первую команду этапа пропустили.
    Делаем
    Выполняем её и ставим заново. Образы и тома в /var/lib/docker при remove остаются.
    Этап 7

    permission denied while trying to connect to the Docker daemon socket

    Причина
    Команда без sudo: пользователь не в группе docker, и так задумано.
    Делаем
    sudo docker …. Группа docker — это root без пароля («docker.sock»).

    Как убрать

    Базу не разбирают обратно: быстрее пересоздать сервер в панели провайдера, а те же шаги файлом при создании даёт cloud-init («cloud-init»). Отдельно убирается только Docker — вместе со всеми образами, контейнерами и томами:

    sudo apt-get purge -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    sudo rm -r /var/lib/docker /var/lib/containerd
    sudo rm /etc/apt/sources.list.d/docker.sources /etc/apt/keyrings/docker.asc /etc/docker/daemon.json

    Дальше по пути