Имена и порты
| Команда | Что делает |
|---|---|
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) ' |
пусто: порты свободны |
Сеть и каталоги
| Команда | Что делает |
|---|---|
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 файл не примет |
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 не подставляет переменные»).
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' |
пусто |
Каталоги стеков
| Команда | Что делает |
|---|---|
sudo mkdir -p /opt/whoami /opt/memos |
по каталогу на стек |
whoami.example.orgservices:
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
memos.example.org, порт 5230services:
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 |
Со своего компьютера, не с сервера: так запрос идёт тем же путём, что у посетителя. 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 закрыт |
закрыт |
Если не работает
dig +short ничего не печатает
- Причина
- A-записи ещё нет, или DNS не успел обновиться: новая запись видна через минуты, изменённая — после TTL старой.
- Делаем
- Сверяем запись у регистратора и ждём; дальше не идём — без DNS Let's Encrypt не выдаст сертификат.
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.
В логе про acme.json — is a directory
- Причина
- Файла не было при первом запуске, и Docker создал на его месте каталог («Несуществующий путь в томе»).
- Делаем
sudo docker compose down,sudo rmdir data/acme.json, сноваtouchиchmod 600из этапа 2,sudo docker compose up -d.
В логе permissions 644 for /acme.json are too open, please use 600
- Причина
- Файл создан с правами по умолчанию.
- Делаем
sudo chmod 600 /opt/traefik/data/acme.jsonиsudo docker compose restart traefik.
curl к новому имени ничего не печатает, а curl -v пишет про сертификат: TRAEFIK DEFAULT CERT
- Причина
- Traefik ещё получает сертификат: первый запрос к новому имени ждёт его 10–30 с.
- Делаем
- Повторяем через полминуты. Дольше —
sudo docker logs traefik 2>&1 | grep -i acmeи случай этапа 4.
404 page not found на whoami или memos
- Причина
- Нет
traefik.enable=true, опечатка в имени вHostили контейнер не запущен. - Делаем
sudo docker ps --filter name=memosи сверяем лейблы с файлом этапа 3.
Gateway Timeout секунд через 30
- Причина
- Контейнер не в сети
proxy: в его compose нет блокаnetworks. - Делаем
- Добавляем сеть, как в файлах этапа 3, и
sudo docker compose up -d.
Сертификат не выпускается, в логе ошибка acme с connection или timeout
- Причина
- Let's Encrypt не достучался до порта 80: его закрывает фаервол провайдера или правило на сервере.
- Делаем
- С телефона по мобильному интернету открываем
http://whoami.example.org— должен прийти редирект. Порт 80 открыть нельзя — DNS-challenge («Traefik и Let's Encrypt»).
В логе too many failed authorizations recently
- Причина
- Пять неудачных проверок на имя за час — дальше Let's Encrypt отказывает, пока не пройдёт час.
- Делаем
- Ищем причину по случаю выше и ждём час. На время опытов — тестовый сервер:
caServer: https://acme-staging-v02.api.letsencrypt.org/directoryвtraefik.yml(«Traefik с нуля»).
Порт 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.