ctf-docker-template - Deployment template for docker target machine in c

项目说明

CTF 动态靶机模板

!ctf-docker-template

About

ctf-docker-template 是一个用于支持动态 Flag 的Docker容器模板项目，支持主流的各类CTF平台

项目存有一定局限性，但已可适用于绝大多数初中级别题目的命题需求

本仓库内的Docker容器模板支持的 FLAG 注入类型如下：

三种动态flag部署方式，支持GZCTF、CTFd、安恒DASCTF等支持Docker动态部署题目靶机的平台

> 一般情况下，CTF题目动态FLAG使用环境变量注入的方式来实现:
>
> docker run -dtP -e FLAG=HelloCTF{This1sFl4g} [imagesName:Tag]
>
> 而上面所说的注入类型 "$xxx" xxx就是FLAG的变量名。

有问题请开issue，好用请点star，有问题的话欢迎通过 CTF-Archives售后快速服务群 联系维护人员寻求帮助

常见问题

no_socket with crypto

no_socket指的是源代码中没有引入socket相关的库，当希望达到的效果是类似于当用户通过特定端口连接到靶机时，就运行python代码，并将代码的运行界面转发给用户。

如果已经引入了socket相关的库，请直接使用如python app.py这类语句启动python程序，并让程序自行监听特定端口。

软件源换源

环境中涉及软件包处理的情形，如apt、yum，均已换源为ustc源，如不处于中国大陆网络环境/启用了全局代理环境，请自行修改相关换源语句，避免由于换源带来的负优化。

日志sh文件错误

由于DOS/Windows 和 Linux/Unix的文件换行回车格式不同，从而造成Linux的Docker出现下面的报错：

> [!NOTE]
> DOS/Windows 的文本文件在每一行末尾有一个 CR（回车）和 LF（换行），而 UNIX 文本只有一个LF（换行）

解决方案如下:

即通过正则匹配，直接替换掉 \r 字符，不过此方案不一定能完全解决问题。

建议直接在linux下执行 git clone 操作，或者直接从github下载zip版本的源码，避免一些奇奇怪怪的编码问题。

> [!WARNING]
> 请注意，sed指令在unix（macos）下的预期执行效果与linux下的预期执行效果不同。

Detail

每个容器模板均为独立封装，您可以在每个容器模板文件夹中找到对应的 README 文件，请在使用前仔细阅读，如有任何疑问请加入项目中的 CTF-Archives售后快速服务群 联系维护人员获取帮助。

当然，我们也在 Hello-CTF 命题部分 页面提供命题相关的教程，也附带本项目的所有文档，欢迎访问查阅。

> [!NOTE]
>
> 在无特殊声明的情况下，完成使用中提及对应模板的必要步骤后,执行后续操作：
>
>
>
> 开始编译镜像。
>
> 也可以在安放好相关项目文件之后，直接使用 ./docker/docker-compose.yml 内的 docker-compose 文件实现一键启动测试容器。
>
>
>
> 特别注意！！
>
> 对于Python相关环境，如使用了 第三方库，请先在 ./Dockerfile 内补充 pip 安装语句。
>
> 大部分项目对SRC文件中需求的 程序 / 脚本 文件有特定命名要求，请仔细阅读您所用模板的 README 文件。

Crypto

#### python_3.8/3.10-no_socket / with_socket

环境：

提供 Python 3.8 / Python 3.10 的基础环境，并已经添加 pycryptodome 库，并基于项目本身实现相关接口。

*实现*：当选手连接到对应服务端口（由项目自行定义）的时候，运行 .py项目

with_socket 适用于项目中引入了 socket 等库，需要镜像做到：

no_socket 适用于项目中没有引入 socket 等库，需要镜像做到：

使用：

将py文件/项目放入 ./src 目录后执行后续操作，文件名建议使用 main.py ，便于环境识别，如需更改文件名，请在 ./service/docker-entrypoint.sh 内更改。

sagemath_9.6

环境：

提供 SageMath 9.6 + Python 3.10.3 的基础环境，并已经添加 pycryptodome + gmpy2 库，并基于 socat 实现服务转发，默认暴露端口位于9999

实现：当选手连接到对应端口（默认为9999端口，默认选手使用 netcat ）的时候，运行 .py项目，并将会话转发至选手的连接

此环境适用于项目中没有引入 socket 等库，并依赖于 SageMath 核心，需要镜像做到：

使用：

直接将SageMath文件/项目放入 ./src 目录后执行后续操作，文件名建议使用 main.sage ，便于环境识别，如需更改文件名，请在 ./service/docker-entrypoint.sh 内更改

KOH（NSSCTF_Only）

KOH题目是基于HTTP服务与后端评判系统进行交互的,故题目容器需要启动一个标准的HTTP服务，并对外暴露HTTP服务端口。

为了确保题目能够正常与后端进行交互，HTTP服务需要包含以下路由并进行相应处理：

upload:

该路由负责接收用户上传的数据。数据将以表单数据的形式进行上传，参数名为file。

例如，后端向容器内的HTTP服务发送请求的代码如下，其中超时时间为5秒：

如果HTTP服务在5秒内正常处理该路由，并且没有异常发生，应返回以下JSON数据：

如果遇到异常（例如服务异常、连接异常、超时异常、返回值异常），则直接判定此次结果为错误。

（一般情况下，200以外的任何返回代码，我们都记为 错误 ）

check:

当后端完成对/upload路由的访问且没有异常时，将访问/check路由。访问示例代码如下：

超时时间为10秒。靶机需要在此时间内评估用户上传内容的得分情况，并返回JSON结果，例如：

如果遇到异常（例如服务异常、连接异常、超时异常、返回值异常），则直接判定此次结果为错误。如果以上过程没有异常，判断过程结束，并将得到的score更新为用户的得分。

DockerFile文件说明:

该题为文件上传KOH题，故只需要完成保存文件 比较文件即可判断得分，如果需要进行代码执行，可以参考app.py中注释代码中使用subprocess建立chroot沙盒的方式进行执行。

注意为了安全起见，在Dockerfile中删除了一些包，如有使用需要请手动更改。

该靶机为python3靶机，如需使用其他环境，关于chroot部分依然可以参考Dockerfile中对/home/ctf的改造方法（/home/ctf即为沙盒环境根目录）

MISC

#### pyjail-python_3.10-socat / xinetd

感谢 师傅对此模板的贡献

环境：

提供 Python 3.10 的基础环境，并已经添加 pycryptodome 库，并基于 socat / xinetd 实现服务转发，默认暴露端口位于9999

实现：当选手连接到对应端口（默认为9999端口，默认选手使用 netcat ）的时候，运行 server.py，并将会话转发至选手的连接

镜像做到：

使用：

将程序文件放入 ./src 目录后执行后续操作，文件名请修改为 server.py 作为文件名，便于镜像定位程序位置

如果需要更改为自己的文件名，需要在 ./config/ctf.xinetd、./Dockerfile 和 ./service/docker-entrypoint.sh 中进行修改

PWN

#### ubuntu_16.04 /18.04 / 20.04 /22.04

环境：

提供 Ubuntu 16.04 GLIBC 2.23 / Ubuntu 18.04 GLIBC 2.27 / Ubuntu 20.04 GLIBC 2.31 / Ubuntu 22.04 GLIBC 2.35 的基础环境，并已经添加 lib32z1 + xinetd 软件包，并基于 xinetd 实现服务转发，默认暴露端口位于9999

实现：当选手连接到对应端口（默认为9999端口，默认选手使用 netcat ）的时候，运行 程序文件，并将会话转发至选手的连接

镜像做到：

使用：

将程序文件放入 ./src 目录即可，文件名请修改为 attachment 作为文件名，便于镜像定位程序位置

如果需要更改为自己的文件名，需要在 ./config/ctf.xinetd、./Dockerfile 和 ./service/docker-entrypoint.sh 中进行修改

Web

#### flask-python_3.8 / 3.10

提供 Python 3.8 + Flask / Python 3.10 + Flask 的基础环境，默认暴露端口位于8080

直接将Flask文件/项目放入 ./src 目录即可，Flask项目主文件请使用 app.py 作为文件名，便于环境识别Flask项目位置

如使用了 pycryptodome 等第三方库，请在 ./Dockerfile 内补充pip安装语句

#### ja

提供 Openjdk 1.8.0 的基础环境，默认服务暴露端口由程序决定

适用于基于 jar 程序包部署环境的需求

直接将 jar 程序包放入 ./src 目录即可，jar程序包请使用 app.jar 作为文件名，便于环境识别 jar 程序包

#### jetty-jdk8

提供 Jetty 9.4.49 Openjdk 1.8.0 的基础环境，默认服务暴露端口由程序决定

适用于基于 war 程序包部署环境的需求

直接将 war 程序包放入 ./src 目录即可，war程序包请使用 root.war 作为文件名，便于环境识别 war 程序包

#### tomcat-jdk8

提供 Tomcat 9.0.78 Openjdk 1.8.0 的基础环境，默认服务暴露端口由程序决定

适用于基于 war 程序包部署环境的需求

直接将 war 程序包放入 ./src

#### LAMP-php80 / LNMP-php73 / nginx-php73

> 部分容器参考 CTF Training 感谢 陌竹 - mozhu1024 师傅 和 赵总 - glzjin 师傅做出的贡献

Apache2 +PHP 8.0.30+10.5.21-MariaDB 的基础环境，默认暴露端口位于 80

Nginx +PHP 7.3.33+10.6.14-MariaDB 的基础环境，默认暴露端口位于 80

Nginx +PHP 7.3.33 的基础环境，默认暴露端口位于 80

直接将 PHP 项目放入 ./src 目录后执行后续操作。

> [!CAUTION]
>
> 注意！！
>
> 模板默认会将 flag 保存在 数据库中，如果 需要改变flag在数据库中的存放位置，请在./service/docker-entrypoint.sh 中修改相关操作语句

A little ad

某 Randark-JMT 可以无偿为CTF平台搭建、题目打包提供一定帮助，欢迎联系😘

参考与鸣谢

感谢glzjin-赵总和mozhu1024-陌竹师傅们的项目，根据上述仓库，此项目才有了雏形，感谢他们为CTF事业做出的巨大贡献

qsnctf / qsnctf_base_docker_images 青少年CTF基础Docker镜像

感谢 末心 师傅对相关模板作出的建议与努力

项目信息

开发语言：Dockerfile

Star 数：417

技术要点

该项目属于CTF思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Deployment template for docker target machine in ctf for CTFd and other platforms that support dynamic flags展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

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

使用与学习建议

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

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

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

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

免责声明

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