Самостоятельно размещаемый CTF: оригинальные веб-задания + таблица результатов, развёртываемые с помощью Docker Compose через GitLab CI и GitOps-агент. Флаги формируются из одного секрета CI; каждый конвейер развёртывает стек и автоматически решает каждое задание.
Полноценное мероприятие в формате capture-the-flag, которое вы можете провести сами: четыре оригинальных веб-задания, таблица лидеров и механизмы GitLab CI/CD + GitOps, которые собирают, сканируют, разворачивают и играют во всё это при каждом коммите.
Что демонстрируется
compose.yaml запускает шесть укреплённых контейнеров без bind-монтирований, поэтому
один и тот же файл разворачивается на ноутбуке, в CI-сервисе Docker-in-Docker или на удалённом хосте по SSH.depends_on, ограничения ресурсов, корневые файловые системы только для чтения,
отброшенные capabilities, пользователи без root и постоянный том, переживающий повторные развёртывания.main — это желаемое состояние. Агент с pull-моделью (ctfops reconcile, systemd
timer) разворачивает коммит только после того, как его pipeline прошёл, проверяет его и автоматически откатывается, если
он не поднялся в работоспособном состоянии. Намеренный откат — это git revert.flowchart LR
players((Players)) -->|":8000"| gw
players -->|":9001-9004"| gw
subgraph host["Docker host (compose project 'ctf')"]
gw["gateway<br/>nginx, rate limits"]
subgraph sbnet["network: scoreboard (internal)"]
sb["scoreboard<br/>Flask + SQLite"] --- vol[("scoreboard-data")]
end
subgraph c1["net-paper-trail (internal)"]
pt["paper-trail"]
end
subgraph c2["net-cookie-jar (internal)"]
cj["cookie-jar"]
end
subgraph c3["net-bookworm (internal)"]
bw["bookworm"]
end
subgraph c4["net-fetch-docs (internal)"]
fd["fetch-docs"]
end
gw --> sb & pt & cj & bw & fd
end
Только шлюз находится в маршрутизируемой сети. Каждое задание изолировано в сети internal, поэтому игрок,
получивший выполнение кода в одном задании, не может добраться ни до таблицы лидеров, ни до других заданий, ни до
интернета. ctfops verify-isolation доказывает это в CI изнутри каждого контейнера.
| Сервис | Образ | Примечания |
|---|---|---|
gateway | nginx-unprivileged (закреплённый дайджест) | Единая точка входа. 2 запроса/с на клиента при отправке флага, 1 запрос/с при входе/регистрации, ограничения соединений на IP, без баннера версии. Разрешает upstream-серверы лениво, поэтому замена одного задания никогда не роняет платформу. |
scoreboard | Python 3.13 / Flask / gunicorn | Команды, отправка флагов (HTML + JSON API), рейтинг с первыми кровями, окно события, статистика администратора. Пароли scrypt, хешированные API-токены, CSRF-токены, CSP. |
paper-trail, cookie-jar, bookworm, fetch-docs | один общий challenge.Dockerfile | Намеренно уязвимые приложения, по одному на контейнер. Эталонный солвер удаляется из образа. |
Все оригинальные. Стоимость в очках хранится в ctf.toml, единственном источнике истины для события.
| Задание | Очки | Описание |
|---|---|---|
| Paper Trail | 100 | Платёжный портал с гостевым аккаунтом. |
| Cookie Jar | 150 | Доска объявлений для сотрудников, которая запоминает вас с помощью cookie. |
| Bookworm | 200 | Библиотечный каталог с полем поиска. |
| Fetch Docs | 200 | Внутренний просмотрщик документации с самодельным фильтром путей. |
| Задание | Уязвимость | Эталонный эксплойт |
|---|---|---|
| Paper Trail | Небезопасная прямая ссылка на объект: счета проверяют вход, а не владельца | войти как гость, перебирать id счетов вниз до #1001 |
| Cookie Jar | Неподписанная клиентская сессия (base64 JSON) | декодировать cookie, установить "role": "admin", перекодировать |
| Bookworm | SQL-инъекция (SQLite) | UNION SELECT из sqlite_master, чтобы найти скрытую таблицу, затем выгрузить её |
| Fetch Docs | Обход пути через однопроходный фильтр ../ | ....// схлопывается в ../; прочитать /proc/self/environ, куда флаг был передан процессу |
Каждый эксплойт реализован в challenges/<id>/solve.py и запускается в каждом пайплайне.
Требуется Docker с плагином Compose и Python 3.11+.
pip install -r requirements-dev.txt
export PYTHONPATH=src
python -m ctfops new-seed > .ctf-seed && chmod 600 .ctf-seed # gitignored; it IS every flag
python -m ctfops compose up -d --build --wait # build and start all six containers
python -m ctfops smoke --host localhost # play the CTF end to end
Откройте http://localhost:8000, зарегистрируйте команду и начинайте взлом портов 9001-9004.
python -m ctfops compose down -v удаляет всё, включая данные табло.
ctfops compose ... — это docker compose ... с внедрёнными производными секретами в окружение
процесса Compose. Каждый контейнер получает только свой собственный секрет; контейнер, запущенный без него, отказывается стартовать,
поэтому развёртывание, забывшее seed, громко падает вместо того, чтобы отдавать угадываемый флаг.
| Этап | Задания | Что он доказывает |
|---|---|---|
| lint | python-lint, dockerfile-lint, compose-config | Ruff, Hadolint, разбор Compose; ctfops validate проверяет, что ctf.toml, compose.yaml, gateway/nginx.conf и папки челленджей описывают одну и ту же платформу, и что каждый сервис сохраняет свою защиту и изоляцию |
| test | unit-tests, secret_detection, semgrep-sast | 100+ тестов (каждый челлендж эксплуатируется в процессе своим солвером, порог покрытия >90%); GitLab Secret Detection: ни один флаг или seed не был закоммичен; SAST по коду платформы |
| build | build-images | docker compose build + push всех шести образов с тегом коммита SHA |
| scan | trivy-images, trivy-config | Падает при исправимых критических CVE и при любом секрете, найденном внутри образа; ошибки конфигурации Dockerfile |
| verify | deploy-ephemeral | Развёртывает запушенные образы на хосте Docker-in-Docker с одноразовым seed, затем: проверка работоспособности, заголовки безопасности, список челленджей, решение и начисление баллов за каждый челлендж, отклонение неверных флагов и неверных токенов, аутентификация администратора, ограничение частоты на шлюзе, проверки изоляции и пересоздание табло, которое должно сохранить свои данные |
| release | promote-latest (main) | Перемещает :latest на проверенные образы |
| deploy | deploy-production (main, вручную) | Развёртывание в push-режиме по SSH; появляется только после настройки DEPLOY_HOST |