basforge

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

    EN
    Путь · Свой сервер

    Профиль сервера

    Рецепты пути пишутся по этим правилам, поэтому уровни сходятся: бэкап знает, где лежат данные и сертификаты, мониторинг — какие сервисы проверять, а git на уровне «Переезд» забирает те же пути.

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

    Подставляются в команды этой страницы и всех рецептов пути; хранятся только в этом браузере.
    Почта
    [email protected]условное
    Домен
    example.orgусловное
    Адрес сервера
    203.0.113.10условное
    Пользователь
    example-userусловное
    Имя сервера
    web1условное
    Адрес сервера бэкапов
    198.51.100.20условное

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

    Где что лежит

    /opt/                               стеки, по каталогу на стек
      traefik/                          прокси: единственный, кто слушает 80 и 443
        docker-compose.yaml
        data/traefik.yml                статический конфиг
        data/dynamic/                   общие middleware, TLS-опции
        data/acme.json                  сертификаты Let's Encrypt (600, не в git)
        data/logs/access.log            журнал запросов всех сайтов
      memos/                            сервис по адресу memos.example.org
        docker-compose.yaml
        .env                            переменные с секретами, если без них никак (600, не в git)
        data/                           всё, что сервис пишет
      scripts/                          скрипты всего сервера
    /srv/secrets/<стек>/                секреты файлами: каталог 700, файл 400, владелец root
    
    сеть proxy — общая: в ней Traefik и сервисы, которые он открывает
    наружу — только 22, 80 и 443
    входит example-user по ключу, root по SSH не входит

    Правила

    Стек
    /opt/<стек>/docker-compose.yaml — свой каталог на каждый сервисИмя каталога — имя проекта compose: перенесённый стек без name: получит новые пустые тома («Имя проекта compose»), поэтому место выбирают один раз. На уровне «Переезд» /opt становится git-репозиторием, и стеки уходят в него как есть («Конфиги серверов в git»).
    Имя
    одно на всё: каталог /opt/memos, контейнер memos, роутер Traefik memos, адрес memos.example.orgПо имени из лога находим каталог, контейнер и адрес, не открывая compose. Имя роутера пишем одинаково во всех лейблах: опечатка ошибки не даёт, Traefik молча создаёт второй роутер («Middleware на несуществующем роутере»).
    Данные
    /opt/<стек>/data/, в compose — ./data:…Всё, что стек пишет, лежит рядом с его compose, и бэкапу на уровне «Резервирование» не нужно знать про каждый сервис: он забирает data/ всех стеков. Именованный том живёт в /var/lib/docker под именем проекта; где без него не обойтись — у тома явное name: («Имя проекта compose»).
    Секреты
    файлом в /srv/secrets/<стек>/ (Docker secret) или в /opt/<стек>/.env с правами 600; в git — только .env.example с именами/srv/secrets лежит вне /opt, поэтому секреты не попадают ни в git-репозиторий, ни в панель управления, куда смонтирован /opt («Секреты в Docker-стеках»). В браузер тоже: пароли и токены создаёт команда на сервере, полей для них в «Своих значениях» нет.
    Сеть
    proxy, внешняя: создаём один раз, в ней Traefik и все сервисы, которые он открываетСеть создана отдельно от стеков (external: true), поэтому пересозданный Traefik не отцепляет сервисы. К контейнеру Traefik ходит через proxy, даже если у того есть своя сеть: так задано в traefik.yml («Traefik с нуля»).
    Наружу
    только 22, 80 и 443; у сервисов нет ports:, они открываются через Traefik по имениПорт, опубликованный Docker, идёт мимо ufw («Порты Docker идут мимо цепочки input»): строка ports: в compose сервиса открыла бы его всему интернету. Порт, нужный только серверу, — на 127.0.0.1 («Порт только для хоста — на 127.0.0.1»), к нему — SSH-туннель («Туннели SSH»). SSH остаётся на 22: смена порта убирает шум из лога, но не защищает («Порт 22»).
    Пользователь
    example-user с sudo, вход по ключу; root по SSH не входит; команды рецептов — с sudoВ группу docker пользователя не добавляем: через docker.sock она даёт root без пароля («Docker на Ubuntu»). Поэтому sudo стоит и перед docker, и между украденным ключом SSH и root остаётся пароль.
    Журнал запросов
    /opt/traefik/data/logs/access.log, JSONОдин файл на все сайты сервера: его читают CrowdSec («CrowdSec с Traefik за Cloudflare») и сбор логов («Логи Traefik»). Логи контейнеров — в docker logs, их размер ограничен в daemon.json («Docker на Ubuntu»).
    Скрипты
    для всего сервера — /opt/scripts/, для одного стека — в его каталогеСкрипт лежит рядом с тем, что он обслуживает, и уходит в git вместе со стеком («Конфиги серверов в git»).

    Сервер собран не по рецептам

    Эти команды показывают, где свой сервер устроен иначе. Отличие — не ошибка, но рецепты пути рассчитаны на эти пути и имена: команды из них придётся править.

    sudo docker compose ls -a→ у каждого стека в CONFIG FILES — /opt/<стек>/docker-compose.yaml
    sudo docker network inspect proxy --format '{{range .Containers}}{{.Name}} {{end}}'→ traefik и сервисы, которые открываются по имени
    sudo grep -l "^ *ports:" /opt/*/docker-compose.yaml→ только /opt/traefik/docker-compose.yaml; у других ports: — на 127.0.0.1
    sudo ss -tlnH | awk '{print $4}' | grep -v -e '^127\.' -e '^\[::1\]'→ слушают снаружи только :22, :80 и :443
    sudo find /opt -maxdepth 2 -name .env ! -perm 600→ пусто: у каждого .env права 600
    sudo sshd -T | grep -E '^(permitrootlogin|passwordauthentication) '→ permitrootlogin no и passwordauthentication no
    getent group docker→ docker:x:<число>: — после последнего двоеточия пусто, в группе никого
    К карте пути