basforge

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

    EN

    Сервис по HTTPS: Traefik и первый сервис

    Поднимаем Traefik отдельным стеком и открываем через него memos по имени с сертификатом Let's Encrypt. Почему так — в мануалах, ссылка у каждого этапа.

    Начинаем ссервера после уровня 2 «Защита»: вход по ключу, ufw пропускает SSH, 80 и 443, Docker стоит с пределом логов.

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

    интернет ── 80, 443 ──▶ Traefik ─┬─▶ whoami.example.org   проверочный: показывает, что дошло
                                     └─▶ memos.example.org    заметки; данные — /opt/memos/data
    /opt/traefik/    стек прокси: compose, traefik.yml, acme.json
    /opt/whoami/     проверочный сервис
    /opt/memos/      первый настоящий сервис
    • ПонадобитсяДомен: A-записи whoami.example.org и memos.example.org на адрес сервера 203.0.113.10, без прокси Cloudflare (серое облако)
    • ПонадобитсяПочта для аккаунта Let's Encrypt: [email protected]

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

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

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

    Шаги

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

    DNS и порты

    Почему так — «Traefik с нуля»
    Имена и порты
    Команда Что делает
    dig +short whoami.example.org куда смотрит имя проверочного сервиса
    dig +short memos.example.org куда смотрит имя memos
    sudo ss -tlnp | grep -E ':(80|443) ' кто занял порты 80 и 443
    Готово, если
    Команда Что должно быть
    dig +short memos.example.org 203.0.113.10 — адрес сервера; у whoami — тот же
    sudo ss -tlnp | grep -E ':(80|443) ' пусто: порты свободны
    Не так — «Если не работает», случаи этапа .

    Traefik: сеть, каталоги, конфиг, запуск

    Почему так — «Traefik с нуля»
    Сеть и каталоги
    Команда Что делает
    sudo docker network create proxy общая сеть прокси и сервисов, одна на сервер
    sudo mkdir -p /opt/traefik/data/dynamic /opt/traefik/data/logs каталоги стека
    sudo touch /opt/traefik/data/acme.json файл сертификатов — до запуска, иначе Docker создаст на его месте каталог
    sudo chmod 600 /opt/traefik/data/acme.json с правами шире Traefik файл не примет
    /opt/traefik/data/traefik.ymlстатический конфиг; почта — для аккаунта Let's Encrypt
    global:
      checkNewVersion: false
      sendAnonymousUsage: false
    
    log:
      level: INFO
    
    accesslog:
      format: json
      filePath: /logs/access.log
    
    entryPoints:
      http:
        address: ":80"
        http:
          aliasHeadersStrategy: delete
          redirections:
            entryPoint:
              to: https
              scheme: https
      https:
        address: ":443"
        http:
          aliasHeadersStrategy: delete
          tls:
            certResolver: letsencrypt
    
    providers:
      docker:
        exposedByDefault: false
        network: proxy
      file:
        directory: /dynamic/
        watch: true
    
    certificatesResolvers:
      letsencrypt:
        acme:
          email: [email protected]
          storage: acme.json
          httpChallenge:
            entryPoint: http

    Почту пишем буквами: ${…} в этом файле не подставляется («traefik.yml не подставляет переменные»).

    /opt/traefik/docker-compose.yamlстек прокси
    services:
      traefik:
        image: traefik:v3.7
        container_name: traefik
        restart: unless-stopped
        security_opt:
          - no-new-privileges:true
        ports:
          - 80:80
          - 443:443
        volumes:
          - /var/run/docker.sock:/var/run/docker.sock:ro
          - ./data/traefik.yml:/traefik.yml:ro
          - ./data/acme.json:/acme.json
          - ./data/dynamic/:/dynamic/:ro
          - ./data/logs/:/logs/
        networks:
          - proxy
    
    networks:
      proxy:
        external: true
    Запуск
    Команда Что делает
    cd /opt/traefik && sudo docker compose up -d запускает стек
    sudo docker logs traefik 2>&1 | grep -E 'ERR|WRN' ошибки и предупреждения в логе
    Готово, если
    Команда Что должно быть
    curl -sI http://whoami.example.org | head -1 HTTP/1.1 308 Permanent Redirect: редирект на HTTPS работает, хотя whoami ещё нет
    sudo docker logs traefik 2>&1 | grep -E 'ERR|WRN' пусто
    Не так — «Если не работает», случаи этапа .

    whoami и memos по имени

    Почему так — «Лейблы Traefik»
    Каталоги стеков
    Команда Что делает
    sudo mkdir -p /opt/whoami /opt/memos по каталогу на стек
    /opt/whoami/docker-compose.yamlпроверочный сервис на whoami.example.org
    services:
      whoami:
        image: traefik/whoami
        container_name: whoami
        restart: unless-stopped
        labels:
          - "traefik.enable=true"
          - "traefik.http.routers.whoami.rule=Host(`whoami.example.org`)"
          - "traefik.http.routers.whoami.entrypoints=https"
        networks:
          - proxy
    
    networks:
      proxy:
        external: true
    /opt/memos/docker-compose.yamlmemos на memos.example.org, порт 5230
    services:
      memos:
        image: neosmemo/memos:stable
        container_name: memos
        restart: unless-stopped
        volumes:
          - ./data:/var/opt/memos
        labels:
          - "traefik.enable=true"
          - "traefik.http.routers.memos.rule=Host(`memos.example.org`)"
          - "traefik.http.routers.memos.entrypoints=https"
          - "traefik.http.services.memos.loadbalancer.server.port=5230"
        networks:
          - proxy
    
    networks:
      proxy:
        external: true

    У сервисов нет ports:: снаружи они видны только через Traefik, по сети proxy.

    Запуск
    Команда Что делает
    cd /opt/whoami && sudo docker compose up -d запускает проверочный сервис
    cd /opt/memos && sudo docker compose up -d запускает memos
    Готово, если
    Команда Что должно быть
    curl -s https://whoami.example.org | grep -E '^(Host|X-Forwarded-Proto):' Host: whoami.example.org и X-Forwarded-Proto: https
    curl -s -o /dev/null -w '%{http_code}\n' https://memos.example.org 200
    Не так — «Если не работает», случаи этапа .

    Проверка снаружи

    Почему так — «Traefik с нуля»

    Со своего компьютера, не с сервера: так запрос идёт тем же путём, что у посетителя. openssl на Windows есть в Git Bash.

    Снаружи
    Команда Что делает
    curl -sI http://whoami.example.org | head -3 HTTP уводит на HTTPS
    echo | openssl s_client -connect whoami.example.org:443 -servername whoami.example.org 2>/dev/null | openssl x509 -noout -issuer -enddate кто выдал сертификат и до какого числа он действует
    curl -m 5 -s http://203.0.113.10:5230 || echo закрыт открыт ли порт memos напрямую
    Готово, если
    Команда Что должно быть
    curl -sI http://whoami.example.org | head -3 308 Permanent Redirect и Location: https://whoami.example.org/
    echo | openssl s_client -connect whoami.example.org:443 -servername whoami.example.org 2>/dev/null | openssl x509 -noout -issuer -enddate в issuer — Let's Encrypt, notAfter — около 90 дней от сегодня
    curl -m 5 -s http://203.0.113.10:5230 || echo закрыт закрыт
    Не так — «Если не работает», случаи этапа .

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

    Этап 1

    dig +short ничего не печатает

    Причина
    A-записи ещё нет, или DNS не успел обновиться: новая запись видна через минуты, изменённая — после TTL старой.
    Делаем
    Сверяем запись у регистратора и ждём; дальше не идём — без DNS Let's Encrypt не выдаст сертификат.
    Этап 1

    ss показывает на :80 или :443 nginx или apache

    Причина
    Порты заняты, и контейнер Traefik не поднимется: Bind for 0.0.0.0:80 failed: port is already allocated.
    Делаем
    sudo systemctl disable --now nginx (или apache2), потом снова ss.
    Этап 2

    В логе про acme.json — is a directory

    Причина
    Файла не было при первом запуске, и Docker создал на его месте каталог («Несуществующий путь в томе»).
    Делаем
    sudo docker compose down, sudo rmdir data/acme.json, снова touch и chmod 600 из этапа 2, sudo docker compose up -d.
    Этап 2

    В логе permissions 644 for /acme.json are too open, please use 600

    Причина
    Файл создан с правами по умолчанию.
    Делаем
    sudo chmod 600 /opt/traefik/data/acme.json и sudo docker compose restart traefik.
    Этап 3

    curl к новому имени ничего не печатает, а curl -v пишет про сертификат: TRAEFIK DEFAULT CERT

    Причина
    Traefik ещё получает сертификат: первый запрос к новому имени ждёт его 10–30 с.
    Делаем
    Повторяем через полминуты. Дольше — sudo docker logs traefik 2>&1 | grep -i acme и случай этапа 4.
    Этап 3

    404 page not found на whoami или memos

    Причина
    Нет traefik.enable=true, опечатка в имени в Host или контейнер не запущен.
    Делаем
    sudo docker ps --filter name=memos и сверяем лейблы с файлом этапа 3.
    Этап 3

    Gateway Timeout секунд через 30

    Причина
    Контейнер не в сети proxy: в его compose нет блока networks.
    Делаем
    Добавляем сеть, как в файлах этапа 3, и sudo docker compose up -d.
    Этап 4

    Сертификат не выпускается, в логе ошибка acme с connection или timeout

    Причина
    Let's Encrypt не достучался до порта 80: его закрывает фаервол провайдера или правило на сервере.
    Делаем
    С телефона по мобильному интернету открываем http://whoami.example.org — должен прийти редирект. Порт 80 открыть нельзя — DNS-challenge («Traefik и Let's Encrypt»).
    Этап 4

    В логе too many failed authorizations recently

    Причина
    Пять неудачных проверок на имя за час — дальше Let's Encrypt отказывает, пока не пройдёт час.
    Делаем
    Ищем причину по случаю выше и ждём час. На время опытов — тестовый сервер: caServer: https://acme-staging-v02.api.letsencrypt.org/directory в traefik.yml («Traefik с нуля»).
    Этап 4

    Порт 5230 отвечает снаружи

    Причина
    В compose memos появился блок ports:: Docker публикует порт мимо ufw («Порты Docker идут мимо цепочки input»).
    Делаем
    Убираем ports: и cd /opt/memos && sudo docker compose up -d.

    Как убрать

    cd /opt/memos && sudo docker compose down
    cd /opt/whoami && sudo docker compose down
    cd /opt/traefik && sudo docker compose down
    sudo docker network rm proxy
    sudo rm -r /opt/memos /opt/whoami /opt/traefik

    Последняя строка удаляет и заметки memos, и сертификаты. Нужны заметки — сначала копия /opt/memos/data.

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