자체 호스팅 CTF: 독창적인 웹 챌린지 + 스코어보드로, GitLab CI와 GitOps 에이전트를 통해 Docker Compose로 배포됩니다. 플래그는 하나의 CI 시크릿에서 파생되며, 모든 파이프라인이 스택을 배포하고 모든 챌린지를 자동으로 해결합니다.
직접 운영할 수 있는 완전한 캡처 더 플래그(capture-the-flag) 이벤트: 네 가지 독창적인 웹 챌린지, 스코어보드, 그리고 모든 커밋마다 전체를 빌드, 스캔, 배포하고 플레이하는 GitLab CI/CD + GitOps 체계.
보여주는 것
compose.yaml이 바인드 마운트 없이 여섯 개의 강화된 컨테이너를 실행하므로, 동일한 파일이 노트북, CI Docker-in-Docker 서비스, 또는 SSH를 통한 원격 호스트에 배포됩니다.depends_on 순서, 리소스 제한, 읽기 전용 루트 파일시스템, 드롭된 기능(capabilities), 비루트 사용자, 그리고 재배포 후에도 유지되는 영구 볼륨.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 (고정된 다이제스트) | 단일 인그레스. 플래그 제출 시 클라이언트당 2 req/s, 로그인/등록 시 1 req/s, IP별 연결 수 제한, 버전 배너 없음. 업스트림을 지연 해석하므로, 한 챌린지가 교체되어도 플랫폼이 다운되지 않습니다. |
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 | 쿠키로 당신을 기억하는 직원 게시판. |
| Bookworm | 200 | 검색 상자가 있는 도서관 카탈로그. |
| Fetch Docs | 200 | 직접 만든 경로 필터가 있는 내부 문서 뷰어. |
| 챌린지 | 취약점 | 참조 익스플로잇 |
|---|---|---|
| Paper Trail | 안전하지 않은 직접 객체 참조: 인보이스가 소유권이 아닌 로그인만 확인 | 게스트로 로그인하고 인보이스 ID를 #1001까지 내려가며 탐색 |
| Cookie Jar | 서명되지 않은 클라이언트 측 세션(base64 JSON) | 쿠키를 디코딩하고 "role": "admin"을 설정한 뒤 재인코딩 |
| Bookworm | SQL 인젝션(SQLite) | sqlite_master에서 UNION SELECT로 숨겨진 테이블을 찾은 뒤 덤프 |
| Fetch Docs | 일회성 ../ 필터를 우회하는 경로 순회 | ....//가 ../로 축소됨; 플래그가 프로세스에 전달된 /proc/self/environ을 읽음 |
각 익스플로잇은 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 ...는 파생된 시크릿이 Compose의 프로세스 환경에 주입된 상태의 docker compose ...입니다. 각 컨테이너는 자신의 시크릿만 받으며, 시크릿 없이 시작된 컨테이너는 시작을 거부하므로 시드를 잊은 배포는 추측 가능한 플래그를 제공하는 대신 크게 실패합니다.
| 단계 | 작업 | 입증하는 것 |
|---|---|---|
| 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: 플래그나 시드가 커밋되지 않음; 플랫폼 코드에 대한 SAST |
| build | build-images | docker compose build + 여섯 개 이미지 모두 push, 커밋 SHA로 태그 지정 |
| scan | trivy-images, trivy-config | 수정 가능한 치명적 CVE 및 이미지 내에서 발견된 모든 시크릿에 대해 실패; Dockerfile 오구성 |
| verify | deploy-ephemeral | 푸시된 이미지를 일회용 시드와 함께 Docker-in-Docker 호스트에 배포한 후: 상태 확인, 보안 헤더, 챌린지 목록, 모든 챌린지 해결 및 점수 부여, 잘못된 플래그와 잘못된 토큰 거부, 관리자 인증, 게이트웨이 속도 제한, 격리 프로브, 그리고 데이터를 유지해야 하는 스코어보드 재생성 |
| release | promote-latest (main) | :latest를 검증된 이미지로 이동 |
| deploy | deploy-production (main, 수동) | SSH를 통한 푸시 모드 배포; DEPLOY_HOST가 구성된 경우에만 나타남 |
모든 것은 외부 자격 증명이나 서버 없이 작업 토큰을 사용하여 GitLab 공유 러너에서 실행됩니다. 머지 리퀘스트 파이프라인은 실제 시드를 절대 보지 못합니다.
docs/deploying.md를 참조하세요: 시드 처리, 호스트 준비, 풀 기반 GitOps 에이전트
(deploy/systemd/), 푸시 모드 작업, 그리고 TLS를 앞단에 두는 방법.
challenges/<id>/app.py(FLAG에서 플래그를 읽는 Flask create_app(flag=None))와
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, wheels만 사용)되고, 런타임 이미지에서 pip가 제거됩니다.cap_drop: [ALL], no-new-privileges, 비루트 사용자, 메모리/CPU/PID 제한, 로그 로테이션./run/secrets 아래의 파일로도 시크릿을 받아들입니다. Fetch Docs는 이 트레이드오프를 교훈으로 전환합니다: 프로세스의 파일을 읽을 수 있는 것은 무엇이든 그 환경도 읽을 수 있습니다.MIT, LICENSE 참조.