guiding-star - Project Guiding Star -- A CTF contest platform by

项目说明

Project Guiding Star

A CTF competition platform aiming at maximized possibility of customization and a fluid experience for users and de.

This platform hosts the GeekGame 2025 competition with 22 challenges (45 flags), ≥2000 registered users (max online users ≥450), and ≥10000 submissions. Our ser a load_5 of ≤0.2 at the peak period with all features turned on.

Project Index

Backend (in Python) → PKU-GeekGame/gs-backend

Frontend (in React) → PKU-GeekGame/gs-frontend

Challenge Docker → PKU-GeekGame/geekgame-challenge-docker

Live demo → geekgame.pku.edu.cn

Misc files → This repo

Architecture

O backend architecture:

!architecture

Case study: when a user submits a flag

!submit_flag

Setup

Set up the backend: refer to README from gs-backend

Set up the frontend: refer to README from gs-frontend

Start the backend processes. We use systemd: example configuration for reducer and worker processes.

Use a reverse proxy (we use nginx) to proxy requests to backend or frontend: an example configuration file. Remember to also set a large value for both worker_rlimit_nofile and worker_connections in nginx.conf, because each online user will has a websocket connection to the backend.

To register the first user manually, visit /service/auth/manual?identity=<your_name>.
Manual login should be disabled in production en by configuring MANUAL_AUTH_ENABLED = False in src/secret.py in the backend codebase.

Visit admin panel at /<ADMIN_URL>.
ADMIN_URL and IS_ADMIN can be configured in src/secret.py in the backend codebase.

License

Both backend and frontend is distributed under MIT License. See their LICENSE files for more information.

项目信息

开发语言：未知

Star 数：64

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Project Guiding Star -- A CTF contest platform by PKU GeekGame Team展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。