appsettings.json 文件是 GZCTF 的核心配置文件,通过挂载入容器内的方式进行配置。本篇将介绍配置文件的各个字段的含义。
appsettings.json 的每次更新都需要重启 GZCTF 服务才能生效。
此处给出一个完整的配置文件示例:
此处配置连接字符串
Database必填参数。
GZCTF 使用 PostgreSQL 作为后端数据库和数据持久化。
此连接字符串的一般格式为:
请将 <Database Password> 替换为你的 PostgreSQL 数据库密码 (通常是通过 POSTGRES_PASSWORD 环境变量设置)
更多参数可以参考 Npgsql 连接字符串参数文档
PostgreSQL 要求初始密码需要有一定复杂度并且在初始化后不支持再通过环境变量修改密码
GZCTF 仅支持 PostgreSQL 作为数据库,不支持 MySQL 等其他数据库。请在配置文件中填写正确的数据库连接字符串。
RedisCache可选参数。
GZCTF 使用 Redis 作为缓存和消息队列。单实例部署的情况下 Redis 不是必须的,可以直接采用 GZCTF 的内存缓存;多实例部署的情况下,Redis 是必须的,用作共享缓存和 SignalR 的 Scale-Out 广播。
在 v1.0 后支持使用 Garnet 作为缓存服务。
Storage可选参数。
GZCTF 支持两种类型的存储提供商:
本地磁盘存储(默认)
disk://path=./files
path:可选。本地文件存储路径(默认值:./files)S3 兼容存储 (AWS S3、MinIO、DigitalOcean Spaces 等)
s3://accessKey=...;secretKey=...;bucket=...;region=...
或使用特定的协议头以方便使用:
aws.s3://... (等同于 s3://...)minio.s3://... (等同于 s3://...)参数:
accessKey:可选。Access Key IDsecretKey:可选。Secret Access Keybucket:Bucket 名称region:区域 (例如 us-east-1)endpoint:可选。自定义端点 URL(用于 MinIO 或其他 S3 兼容服务)useHttp:可选。是否使用 HTTP 而不是 HTTPS(默认值:false)forcePathStyle:可选。是否使用路径风格 URL 而不是虚拟托管风格(默认值:false)更多详细内容,请查阅:
此处可以配置日志级别和范围,此外,GZCTF 还支持将日志发送到 Loki 服务器。
可用的日志级别:Trace, Debug, Information, Warning, Error, Critical, None。
GZCTF 支持测量和分布式追踪。您可以配置您想要使用的提供商。
Prometheus: Prometheus 支持。
_total 后缀。OpenTelemetry:将测量和追踪数据导出到 OpenTelemetry。
Grpc 或 HttpProtobuf。AzureMonitor:将测量和追踪数据导出到 ApplicationInsights。
Console:将追踪数据导出到控制台。
此处配置邮件发送相关信息,若采用邮箱注册和其他相关邮件功能,此处为必填项。
由于部分云服务厂家限制,可能无法采用 465 端口发送邮件。此时请尝试使用 587 端口。
此处配置加密密钥,用于加密数据库中比赛的私钥信息,可为任意长度的任意字符串。
此处配置容器后端,为比赛动态创建容器的必填项。
Docker 或 Kubernetes。Default 或 PlatformProxy。PortMappingType 设置为 PlatformProxy 时可用。若开启,将会记录流量于 /app/files/capture 目录下。由于 Docker Swarm 已不是一个活跃的项目,相关安全性功能相较于 k8s 有很大距离,不推荐使用。
Uri: Docker API Server 地址
/var/run/docker.sock 挂载入容器对应位置ChallengeNetwork: 指定题目容器所在的网络,若不指定,将会使用默认网络。
UserName, Password: Docker API Basic Auth 用户名和密码,可选项。
gzctf-challengeskube-config.yaml默认行为请将集群连接配置放入 kube-config.yaml 文件中,并将其挂载到 /app 目录下。实验功能若非了解行为请勿更改。
请注意更改 kube-config.yaml 文件中的 server 字段,将其指向集群的 API Server 地址。集群默认地址一般为 https://127.0.0.1:6443,需要更改为集群实际地址。
为了满足网络策略,GZCTF 会在题目的 Namespace 下创建名为 gzctf-policy 的 NetworkPolicy,以限制访问。GZCTF 会自动检测此 NetworkPolicy 是否已经存在,若存在则不会再次创建,因此你可以通过创建或编辑此 NetworkPolicy 来自定义网络策略。
此处配置是否开启请求日志记录,若开启,将会在日志中输出每个请求的详细信息。此处输出不包括静态文件的请求。
此配置项会记录请求的具体信息,大幅影响 日志文件大小及平台并发性能,请仅在调试时开启。
此处配置是否开启请求频率限制,若开启,将会根据预设规则限制每个 IP 和 API 的请求频率。
此配置为平台安全性基础,在非测试环境下关闭后果自负。
在绝大多数正确配置的情况下,不存在用户能够达到速率限制的情况。若在正常使用过程中出现频繁触发速率限制、后端日志的 IP 信息异常(如大量来自同一 IP 的请求),请检查 反向代理中可信代理相关配置。
在此项配置启用的情况下,GZCTF 可以使用极少的资源防止数十倍于正常请求的恶意请求,保障平台的正常运行。
此配置项即将被弃用,请使用 Registries 配置项进行配置。
此处配置 Docker Registry 的用户名和密码,用于比赛动态创建容器时拉取镜像的验证,可选项。
请确保密码中不包含特殊字符(如 ":@ 等,但是可以使用 _),否则可能导致模板注入问题,导致 Secret 创建失败。
此处配置验证码相关信息,用于注册、找回账号和登录时的验证码验证,可选项。
None、HashPow 或 CloudflareTurnstile为确保安全性、避免平台被恶意注册、消耗邮件额度等问题,强烈建议开启验证码功能。
建议首选 CloudflareTurnstile 验证码提供商,相关文档。
配置 HashPow 验证码的相关信息,可选项。
安全上下文: 此项功能仅在一些支持的浏览器的安全上下文(HTTPS)中可用。
由于上游依赖缺少维护,此功能已弃用,并将从 v1.2.2 开始删除。
请使用 CloudflareTurnstile 作为验证码提供商。
配置 Google Recaptcha v3 的相关信息,可选项。
此处配置反向代理的相关信息,用于获取真实 IP 地址,可选项。
7,详情请见 ForwardedHeaders 枚举若想要忽略反向代理的信任列表,允许任意 IP 地址访问,请参考转发 Linux 和非 IIS 反向代理的方案,设置环境变量 ASPNETCORE_FORWARDEDHEADERS_ENABLED 为 true。
其他字段请参考官方文档描述:配置 ASP.NET Core 以使用代理服务器和负载均衡器 及 ForwardedHeadersOptions 类
Kestrel 为 GZCTF 自带并使用的 Web 服务器。
利用此配置可以自行控制 Kestrel 的行为,例如指定 HTTP 协议、修改请求大小上限等等。
可配置字段请参照官方文档中 KestrelServerOptions 类的属性:KestrelServerOptions 类