name: Caddy host-native (systemd) reverse proxy description: Reverse-proxy Caddy тепер на хості через systemd, а не в docker. Як додавати нові мінісервіси. type: reference originSessionId: 2e8e5c8b-9467-4f27-a2ca-c84e23c5a7ed

Caddy на хості — systemd (з 2026-04-19)

Де що лежить

• Бінарник: /usr/bin/caddy (v2.11.2, офіційний cloudsmith repo)
• Головний конфіг: /etc/caddy/Caddyfile — мінімальний, імпортує conf.d/*.caddy
• Per-service конфіги: /etc/caddy/conf.d/{name}.caddy (med-detective, biogaia, browser, reports)
• Systemd unit: /usr/lib/systemd/system/caddy.service (enabled, restart on-failure)
• Працює як користувач caddy (не root), через systemd capabilities для bind :80/:443

Додавання нового мінісервісу

1. Запустити сервіс на 127.0.0.1:PORT (найзручніше — systemd unit в /etc/systemd/system/)
2. Створити /etc/caddy/conf.d/{name}.caddy:

   handle /{name}/* {
       uri strip_prefix /{name}
       reverse_proxy 127.0.0.1:PORT
   }
   

   Якщо треба редірект без слеша — додай окремий handle /{name} { redir ... 301 } перед handle /*
3. caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile — перевірити синтаксис
4. systemctl reload caddy — атомарно підхопить без даунтайму

Що НЕ робити

• Не міняти upstream з 127.0.0.1 на 172.17.0.1 / 172.18.0.1 — host caddy вже на хості, docker-gateway адреси не потрібні
• Не повертати caddy в docker-compose — вся сенс міграції в тому щоб проксі не залежав від docker-демона

Старий /srv/caddy/Caddyfile

Лишається як артефакт. Не використовується. Можна видалити колись.

Troubleshooting

• systemctl status caddy + journalctl -u caddy -n 50 — статус і логи
• Порт 80 зайнятий чимось іншим? ss -tlnp | grep :80 — має бути тільки caddy
• Config не валідний? caddy validate --config /etc/caddy/Caddyfile --adapter caddyfile покаже рядок помилки