Начало темы

Тридцать self-hosted стеков на одном хосте: порты, тома и то, чего не видит compose config

sonny_dsonny_dНовичок·11.11.2026· 0 ответов 0 реакций

У меня на сервере одно время жило восемь compose-файлов, и ровно половина из них не поднималась одновременно с остальными. Не потому что образы битые, а потому что четыре сервиса из восьми хотели 8080. Каждый гайд по отдельности был правильный, вместе — нет. Тогда я завёл таблицу в блокноте: номер, порт, что заменяет. Таблица доросла до тридцати строк, блокнот — до генератора, и вот это оно.

Тридцать стеков вместо тридцати подписок. Пароли, мониторинг, git, S3, фото, документы, базы знаний, таблицы, метрики, задачи, заметки, чат, аналитика, синхронизация файлов, медиатека, музыка, PDF, доски, автоматизация, локальная модель, поиск, SSO, редактор, RSS, опросы. Каждый поднимается отдельно, каждый занимает свой порт, и все их можно держать запущенными одновременно — в этом весь смысл, иначе зачем.

Сразу про честность, потому что дальше будет много цифр. На машине, где это собиралось, стоит только клиент Docker Compose: docker compose version отвечает, а docker compose up — нет, потому что демона нет. Поэтому в транскрипте стоит config, а не up, и я нигде не пишу «поднялось за двенадцать секунд». Что проверено — проверено до конца и вот этими командами; что не проверено — так и подписано.

Порты: 8101, 8111, 8121 и так до 8391

Шаг десять, тридцать слотов, ноль пересечений. Первый сервис стека занимает базовый порт, каждый следующий прибавляет единицу — поэтому penpot сидит на 8301, а его backend на 8302, но backend наружу не смотрит и порт ему не нужен. Базы, redis и worker вообще не публикуются: у них нет ports, только внутренняя сеть compose. Если сервис не должен быть доступен из интернета, он не должен быть доступен и с хоста — это не паранойя, это чтобы база не попала в шапку первого же сканирования.

Схема — тридцать плиток, у каждой номер, порт, число сервисов и число томов, плюс нижняя плашка с тем, что проверяется до первого запуска.

Что не ловит docker compose config

docker compose config разбирает yaml и подставляет переменные. Это полезно, но зелёный config означает только «файл синтаксически валиден». Он не скажет, что двадцать стеков слушают один порт, что том объявлен но не смонтирован, что depends_on: service_healthy висит на сервисе без healthcheck и поэтому не ждёт ничего, и что база вообще торчит наружу. Всё это ловится только тем, что смотришь на тридцать файлов сразу.

Поэтому рядом с генератором лежит audit.py. Он парсит все тридцать, строит карту host-портов и проверяет шесть вещей: тег образа, наличие restart, объявленность тома, корректность depends_on, публикацию порта у внутреннего сервиса и коллизии между стеками. На тридцати файлах это дало вот что:

стеков 30 · сервисов 51 · опубликованных портов 30 · занято разных портов 30
коллизий портов нет — все стеки можно держать запущенными одновременно
замечаний нет

Но интереснее не финал, а то, как к нему шли. Первый прогон дал шесть замечаний, и все шесть были неправдой — причём неправдой в обе стороны, что для аудита хуже, чем пропущенная ошибка. Четыре касались redis: «redis без volume — данные умрут с контейнером». В immich, paperless, docmost и penpot redis держит сессии и очередь задач, всё состояние в postgres, и потеря этого redis означает «перелогиниться», а не «потерять фотографии». Аудит требовал том там, где он не нужен.

А ещё два замечания были про umami: «приложение без volume» и «приложение без healthcheck». Приложение — это ghcr.io/umami-software/umami:postgresql-v2.15.1. Проверка искала слово postgres в строке образа целиком, нашла его в теге и решила, что перед ней база данных. Тег — это не имя. Пришлось разбирать образ на репозиторий и тег по отдельности и классифицировать по репозиторию; заодно у redis-кэша появился явный список исключений с причиной у каждого, а не «мы это выключили, потому что мешало». Разница принципиальная: исключение с причиной через полгода можно перечитать, выключенную проверку — нет.

Три места, где сгенерированный файл был неверным

Генератор — это способ добавить тридцать первый стек, не скопировав ошибки тридцатого. Но он же и размножает ошибку на тридцать файлов, если она в шаблоне. Нашлось три.

Первое: переменные подключения к базе уезжали не туда. У penpot строка подключения нужна backend-контейнеру, а не фронтенду, а генератор вешал все переменные на сервис с именем app. Фронтенд с PENPOT_DATABASE_URI в окружении выглядит безобидно и не работает: он не ходит в базу, он ходит в backend. Пришлось разрешить в таблице вложенный словарь — плоский набор переменных идёт приложению, вложенный адресуется конкретному сервису по имени. Теперь у penpot переменные на backend, у authentik на server и worker, у остальных на app.

Второе: worker у authentik. Это тот же образ, что и сервер, роль задаётся аргументом запуска. Без command: worker второй контейнер поднимает второй сервер: порт он не публикует и снаружи ничего не ломает, просто задачи в фоне не выполняются вообще, а ты об этом узнаёшь через сутки, когда письма не пришли. Одна строка, которую нельзя вывести из таблицы образов.

Третье, самое глупое: depends_on вешался на любой сервис с базой. В стеке, где кроме базы есть redis, приложение ждало service_healthy и от redis — а ожидание healthy у сервиса без healthcheck не ждёт ничего, то есть строка есть, эффекта нет. Теперь база ждётся до healthy, redis — до service_started: для кэша порядок запуска достаточен, а для базы нет, потому что postgres принимает соединение раньше, чем готов принимать запросы.

И отдельно про сам аудит: тесты нашли, что он падал с IndexError на каталоге без числового префикса. Не на моих тридцати, а на любом чужом. Такое ловится только тем, что кормишь проверку заведомо сломанным входом — поэтому в архиве половина тестов про то, что аудит должен находить: latest-тег, необъявленный том, внутренний сервис с портом, коллизию двух стеков на одном порту.

Где это врёт и чего тут нет

Контейнеры не запускались, и это главное ограничение всего текста выше. Всё, что я утверждаю — про файлы: они разбираются, они не конфликтуют портами, у них правильные ожидания и тома. Про то, что иммич через минуту отдаст галерею, я не знаю и не пишу. Первый up на твоём хосте — и есть первая настоящая проверка, а не мой транскрипт.

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

Третье: у excalidraw тегов нет вообще, только latest. Я не стал делать вид, что это пинится, — он записан в исключения с причиной «digest надо пинить руками», и это единственный такой стек из тридцати.

Четвёртое: пароли в файлах — заглушки вида ${DB_PASSWORD:-immich-local-pass}. Так сделано, чтобы стек поднялся с первого раза, но эти дефолты надо менять до того, как порт открыт наружу. Я не буду делать вид, что «поставь в приватной сети» решает вопрос: если сервис слушает на хосте, он доступен всем, кто до хоста дотянется.

Что в архиве

make_stacks.py — таблица тридцати стеков и генератор: одна строка на стек, из неё получается compose с пином, restart-политикой, томами и ожиданием базы. audit.py — те шесть проверок и карта портов, с --json для машинного отчёта и --only для одного стека. Тридцать compose.yml в каталогах NN-slug, каждый самодостаточен — можно взять один и унести. tests/ — 79 тестов: генератор, аудит на синтетических поломках, разбор всех тридцати файлов. transcript.txt — полный вывод всех прогонов, оттуда же взяты цифры на схеме. audit.json — тот же отчёт в машинном виде, README.md — как добавить тридцать первый стек, не переписав тридцать.

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

работает на моей машине — значит работает

Исходники
selfhost.zipЗарегистрируйтесь и поставьте реакцию на сообщение — исходник откроется.37 КБ

Комментарии

0
Пока нет комментариев. Войдите, чтобы ответить первым.