hackergame-challenge-docker - nc 类题目的 Docker 容器资源限制、动态 flag、网页终端

项目说明

Hackergame nc 类题目的 Docker 容器资源限制、动态 flag、网页终端

快速入门

配置密钥

密钥用于验证用户 Token。请确保这里的公钥文件（pubkey）与 Hackergame 平台 配置的私钥相匹配，这样 Hackergame 平台为每个用户生成的 Token 才可以通过这里的用户验证。

如果你仅仅想测试一下，可以使用 dynamic_flag/pubkey 自带的公钥，以及这个 Token：

c7e810a06ac7f9c6d1a4cde75e8a04e7460dcef13095a318ada4bd97311513c00cadb5719b5f6e2be5d1e87233ca83b6f64b1f4b1cd9c6cd6ca0231

在生产环境中，请运行 generate_key.py 自己生成密钥。

配置题目

如果你仅仅想测试一下示例题目，那么可以跳过此步骤。

本项目的目录结构设计为可以被 Hackergame 平台的题目导入命令 直接导入。

dynamic_flag 目录中包含了题目容器化、连接限制、动态 flag 相关的逻辑。

web_netcat 目录中包含了网页终端的逻辑。

如果仅仅是使用本项目，那么以上两个目录中的内容都不需要修改，它们也不会被 Hackergame 平台导入（因为没有 README.md 文件）。

示例题目在 example 目录中，其中的 example/docker-compose.yml 中引用了以上两个目录中的内容。你可以把 example 目录复制多份为不同的名字，它们在被导入到 Hackergame 平台后会显示为多道题目。

题目是 Docker 化的，注意每次运行题目 Docker 时 只启动一个题目的实例，通过标准输入输出交互，你的题目不需要监听端口，也不需要做任何资源限制。 参见 example/Dockerfile 和 example/example.py。

你需要修改 example/.env 文件，针对题目的情况进行配置，包括 nc 的端口（port）、网页终端的端口（web_port）、运行时间和资源限制、flag 文件位置、动态 flag 规则、题目的容器名称等。动态 flag 的生成方法可以由你自己决定，可以使用类似 'flag{prefix_' + sha256('secret'+token)[:10] + '}' 的方案，示例中使用了 Python 的 f-string。对于多个 flag 的情况，flag_path 中路径和 flag_rule 中 Python 表达式都用 , 分隔即可。容器名称（challenge_docker_name）是 docker-compose 自动命名的，请设置为目录名 + "_challenge"。对于每一个连接，如果 Token 合法并且连接频率没有超过限制，那么你的题目容器会以指定的资源限制启动，动态生成的 flag 会被挂载到指定的路径，选手的 TCP 连接将会被连接到容器的标准输入输出上。如果你的题目需要获得用户 Token，直接读取 hackergame_token 环境变量即可。

example/README.md 是用于导入 Hackergame 平台的，里面配置的 flag 需要与 .env 中配置的 flag 相同，端口也需要进行相应修改。

运行题目

在 example 目录中运行 docker-compose up --build 即可，然后你可以通过 nc 127.0.0.1 10000 来连接，也可以使用 的网页终端。

本项目的背景

与很多 CTF 比赛类似，USTC Hackergame 需要运行选手与服务器交互的 nc 类题目。然而 CTF 比赛中常见的做法有以下问题：

因为以上提到的原因，我在 Hackergame 2019 前开发了这套系统，并且在 Hackergame 2020 前进行了一些改进，但是这部分代码一直没有开源。

如今，我把这份代码以 MIT 协议开源出来，欢迎大家测试、使用和改进。

本项目的功能

本项目的限制

本项目只适用于每个连接启动一个进程的题目，包括 pwn 题和其他的 nc 连接服务器类题目。

如果你的题目是一个一直运行的应用，例如 flask app，那么请自己进行 Token 的验证和动态 flag 生成。

Token 是一个 libsodium 签名，每个用户确定性对应一个 Token。libsodium 在很多语言中都有库，Python 验证方法见 dynamic_flag/front.py 中的 函数。由于 Token 是非对称签名，所以公钥和验证代码完全可以公开。

已知问题

项目信息

开发语言：Python

Star 数：75

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕nc 类题目的 Docker 容器资源限制、动态 flag、网页终端展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

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

使用与学习建议

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

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

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

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

免责声明

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