gztime/gzctf

GZ::CTF

镜像概述与主要用途

GZ::CTF是基于ASP.NET Core开发的开源CTF竞赛平台，旨在为CTF赛事组织者提供一站式解决方案。该平台支持多种挑战类型配置、动态评分机制、容器化环境管理及实时赛事监控，可满足从小型练习赛到大型正式竞赛的搭建与管理需求。

重要提示：使用前请仔细阅读官方文档：[***]
自2024年1月1日起，develop镜像的数据库结构与旧版本不兼容，若需使用请切换至v0.17版本。新功能快速开发阶段，不建议使用develop镜像进行生产部署，数据库结构变更可能导致数据丢失。

核心功能与特性

高度自定义的挑战管理

• 多类型挑战支持：
  • 静态附件：共享附件，接受任意配置的flag
  • 动态附件：flag与附件数量需至少等于队伍数，按队伍分配
  • 静态容器：共享容器模板，无动态flag，接受任意配置的flag
  • 动态容器：通过容器环境变量自动生成并分发flag，每队flag唯一
• 动态评分机制：
  • 评分曲线：
    $$f(S, r, d, x) = \left \lfloor S \times \left[r + ( 1- r) \times \exp\left( \dfrac{1 - x}{d} \right) \right] \right \rfloor $$
    其中$S$为原始分数，$r$为最低分比例，$d$为难度系数，$x$为提交次数，前三项可自定义以满足多数动态评分需求
  • 首解奖励：首三个解出者分别获得当前分数的5%、3%、1%奖励
• 竞赛中动态管理：可随时启用/禁用挑战、发布新挑战
• 安全机制：动态flag共享检测、可选flag模板、leet flag功能

赛事与团队管理

• 队伍评分时间线、排行榜，支持队伍分组
• 基于Docker或K8s的动态容器分发、管理及多端口映射
• 基于SignalR的实时竞赛通知、赛事事件与flag提交监控、日志监控
• 团队审核、邀请码、注册***限制（可选）

安全与权限控制

• SMTP邮件验证，基于Google ReCaptchav3的***注册防护
• 用户封禁功能，三级用户权限管理
• 特定用户封禁机制

竞赛辅助功能

• Writeup收集、评审及批量下载
• 排行榜导出、提交记录导出
• 竞赛期间提交记录与重大事件日志监控
• 基于TCP over WebSocket代理的挑战流量转发，支持配置流量捕获

技术架构

• Redis集群缓存，PostgreSQL数据库存储后端
• 全局配置自定义（平台标题、记录信息等）

使用场景与适用范围

适用于各类CTF竞赛场景，包括：

• 高校/企业内部CTF练习赛
• 区域性/全国性CTF竞赛
• 网络安全培训与技能评估赛事
• 安全团队内部技术对抗赛

已被多所高校及赛事采用，如THUCTF 2022、ZJUCTF 2022/2023、SUSCTF 2022/2023等（完整案例列表见官方文档）。

部署与配置说明

环境依赖

• 数据库：PostgreSQL
• 缓存：Redis
• 容器管理：Docker或K8s集群（用于动态容器挑战）
• 网络：支持WebSocket的环境（用于实时通知与流量转发）

部署建议

1. 版本选择：生产环境推荐使用稳定版本（如v0.17），避免develop分支
2. 数据备份：定期备份PostgreSQL数据库，防止结构变更导致数据丢失
3. 扩展配置：大规模竞赛建议配置Redis集群以提升缓存性能，使用K8s管理容器以提高稳定性

官方文档与支持

• 完整部署与配置指南：[***]
• 社区支持：群组（[]
• 国际化支持：翻译工作进行中，详情见[***]

关于项目

• 开源协议：遵循MIT许可证
• 开发状态：持续迭代中，欢迎贡献代码或反馈（GitHub地址：https://github.com/GZTimeWalker/GZCTF%EF%BC%89