# CBCTF

> CBCTF 平台部署、运维与功能使用文档

## 开始

- [介绍](/guide/start/introduction.md): 了解 CBCTF 的题型、赛事管理能力、动态靶机和附件生成，选择适合的部署方式。
- [快速上手](/guide/start/quick-start.md): 从集群准备、Helm 安装到首次登录，完成 CBCTF 的可用部署并验证第一道题。

## 部署

- [K8s 集群搭建](/deploy/cluster.md): 搭建满足 CBCTF 动态附件、动态容器和 KubeVirt 靶机要求的 Kubernetes 集群。
- [Helm 部署](/deploy/helm.md): 通过 Helm Chart 安装 CBCTF，并配置镜像、Ingress、存储、数据库和 Redis。
- [配置说明](/deploy/settings.md): 说明 CBCTF 配置来源、Helm values、配置文件和数据库运行时设置。
- [工作负载调度](/deploy/workloads.md): 配置镜像预热、靶机启动、附件生成器容量和资源清理，排查等待、超时与生成失败。
- [前后端分离](/deploy/separation.md): 配置 CBCTF 前后端分离部署、反向代理、静态资源和 API 地址。
- [常见问题](/deploy/troubleshooting.md): 排查 CBCTF 部署、集群组件、容器靶机、动态附件和网络访问问题。

## 功能

- [选手操作流程](/guide/features/playing.md): 从注册、验证邮箱和加入队伍开始，使用题目附件、靶机、Flag 提交、排行榜与题解上传。
- [题目类型](/guide/features/challenge.md): 介绍 CBCTF 静态题、动态附件题、动态容器题和多 Flag 题目的配置方式。
- [Flag 规则](/guide/features/flag.md): 说明 CBCTF 的 static、leet 和 uuid Flag 类型及多队伍动态 Flag 行为。
- [计分系统](/guide/features/scoring.md): 说明 CBCTF 的静态、线性、对数计分方式，以及一血、二血、三血奖励。
- [动态附件生成](/guide/features/attachment.md): 配置动态附件生成器容器、执行入口、Flag 参数和附件输出路径。
- [动态靶机](/guide/features/container.md): 说明 CBCTF 动态容器、Pod 模式、VPC 模式、端口转发和 KubeVirt VM 靶机。
- [比赛配置](/guide/features/contest.md): 创建和配置 CBCTF 比赛时间、队伍、题目、公告、奖项和排行榜规则。
- [认证与 OAuth](/guide/features/auth.md): 配置 CBCTF 本地认证、邮箱验证、OAuth/OIDC 登录和用户组自动分配。
- [定时任务](/guide/features/cronjobs.md): 调整定时任务的运行间隔和启动执行设置，查看最近运行时间与成功、失败记录。
- [Webhook](/guide/features/webhook.md): 按实际事件列表、秒级超时与主机白名单配置 Webhook，检查投递历史和重试。

## 管理员

- [管理后台概览](/admin/overview.md): 了解 CBCTF 管理后台入口、初始管理员、常用管理流程和后台页面分工。
- [权限与角色](/admin/rbac.md): 通过用户分组和角色配置后台访问、比赛管理与选手操作权限。
- [用户与分组](/admin/users.md): 在 RBAC 页面创建和维护用户、配置分组授权、注册默认分组、邮箱验证和密码。
- [题目管理](/admin/challenges.md): 创建和测试静态题、动态附件题与容器题，管理附件并将题目发布到比赛。
- [比赛管理](/admin/contests.md): 按实际管理界面创建和发布比赛，维护比赛题目、计分、队伍、公告、预热和题解。
- [作弊检测](/admin/cheat.md): 查看和处理 CBCTF IP、跨队 Flag 和异常提交记录。
- [容器流量分析](/admin/traffic.md): 使用客户端访问证据、内网拓扑回放、CTF flag 提取和攻击线索分析靶机流量。
- [邮件配置](/admin/smtp.md): 在管理后台配置 SMTP、测试发信，并排查邮箱验证、密码找回和发送历史。
- [监控与日志](/admin/monitoring.md): 使用仪表盘、任务队列、日志和 Prometheus 指标检查平台运行状态并排查问题。