自托管 CTF:原创 Web 挑战 + 记分板,通过 GitLab CI 和 GitOps 代理使用 Docker Compose 部署。Flag 由单个 CI 密钥派生;每条流水线都会部署整套环境并自动解出所有挑战。
一个你可以自行运行的完整夺旗赛活动:四个原创 Web 挑战、一个记分板,以及 GitLab CI/CD + GitOps 机制,它在每次提交时构建、扫描、部署并运行整个系统。
它展示了什么
compose.yaml 运行六个加固容器,不使用绑定挂载,因此
同一个文件可以部署到笔记本电脑、CI Docker-in-Docker 服务,或通过 SSH 部署到远程主机。depends_on 顺序、资源限制、只读根文件系统、
丢弃的能力、非 root 用户,以及一个在重新部署后仍保留的持久卷。main 是期望状态。一个拉取式代理(ctfops reconcile,一个 systemd
定时器)仅在其流水线通过后才部署提交,对其进行验证,如果
未能健康启动则自动回滚。有意回滚就是 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(固定摘要) | 单一入口。提交 flag 时每个客户端 2 req/s,登录/注册时 1 req/s,按 IP 限制连接数,不显示版本横幅。延迟解析上游,因此替换某个挑战绝不会导致平台宕机。 |
scoreboard | Python 3.13 / Flask / gunicorn | 团队、flag 提交(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) | 从 sqlite_master 执行 UNION SELECT 以找到隐藏表,然后将其导出 |
| Fetch Docs | 绕过单次 ../ 过滤器的路径遍历 | ....// 会折叠为 ../;读取 /proc/self/environ,flag 就是在那里交给进程的 |
每个利用方式都在 challenges/<id>/solve.py 中实现,并在每个流水线中运行。
需要带有 Compose 插件的 Docker 以及 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 的进程
环境中。每个容器只接收自己的密钥;没有密钥的容器会拒绝启动,
因此忘记设置种子的部署会大声失败,而不是提供一个可猜测的 flag。
| 阶段 | 作业 | 证明内容 |
|---|---|---|
| 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:没有提交 flag 或种子;对平台代码进行 SAST |
| build | build-images | docker compose build + push 全部六个镜像,使用提交 SHA 标记 |
| scan | trivy-images、trivy-config | 在可修复的严重 CVE 和镜像内发现的任何密钥上失败;Dockerfile 错误配置 |
| verify | deploy-ephemeral | 将推送的镜像部署到 Docker-in-Docker 主机,使用一次性种子,然后:健康检查、安全头、挑战列表、每个挑战被解决并计分、错误 flag 和错误令牌被拒绝、管理员认证、网关速率限制、隔离探测,以及必须保留其数据的记分板重建 |
| release | promote-latest(main) | 将 :latest 移动到已验证的镜像 |
| deploy | deploy-production(main,手动) | 通过 SSH 的推送模式部署;仅在配置了 DEPLOY_HOST 后出现 |
一切都在 GitLab 共享运行器上使用作业令牌运行:没有外部凭据或服务器。 合并请求流水线永远不会看到真实种子。
参见 docs/deploying.md:种子处理、主机准备、基于拉取的 GitOps 代理
(deploy/systemd/)、推送模式作业,以及在前端放置 TLS。
challenges/<id>/app.py(一个 Flask create_app(flag=None),从 FLAG 读取其 flag)和
challenges/<id>/solve.py(一个 solve(base_url) -> flag 参考漏洞利用)。ctf.toml 添加一个 [[challenges]] 条目,向 compose.yaml 添加一个服务和内部网络,并向
gateway/nginx.conf 添加一个监听器(以及在 gateway/Dockerfile 中添加 EXPOSE)。python -m ctfops validate:它会指出你遗漏的任何内容。打开一个合并请求;一旦合并并
通过,GitOps 代理就会发布它。ctf.toml event definition: the desired state
compose.yaml the platform as a Compose project
challenges/<id>/ app.py (vulnerable on purpose) + solve.py (reference exploit)
docker/ scoreboard and shared challenge Dockerfiles
gateway/ nginx ingress image
src/scoreboard/ scoreboard (Flask)
src/ctfops/ secrets, compose wrapper, validate, smoke, isolation, GitOps reconcile
deploy/systemd/ GitOps agent units for the CTF host
docs/deploying.md running a real event
tests/ unit and integration tests
这些挑战是故意设计为存在漏洞的。请仅在此隔离模型内运行它们,切勿与其他服务并排运行。平台有意采取以下措施:
--require-hashes,仅使用 wheel);运行时镜像中已移除 pip。cap_drop: [ALL]、no-new-privileges、非 root 用户、内存/CPU/PID 限制、日志轮转。/run/secrets 下的密钥文件,以适配会挂载密钥的编排器(Swarm、Kubernetes)。Fetch Docs 将这一权衡转化为其课程内容:任何能读取进程文件的东西都能读取其环境。MIT,参见 LICENSE。