Tp0t OJ

demo站服务器到期暂时下线,正在寻找新服务器

延续老版本的Tp0t OJ，前端继承并优化了视觉效果，后端从JAVA切换为Golang，定位也从一个面向校内的持续性训练平台，转向于一个比CTFd更好用的CTF比赛平台

欢迎非盈利性质的比赛使用我们的平台，比如各大学校的校赛等，也欢迎大家提PR和ISSUE

特别提醒盈利性质的赛事服务提供商（通过提供CTF比赛服务来获取酬金）如果使用本平台提供服务同样需要遵循AGPL开源

我们的特性

特性	Tp0t OJ	CTFd	dasctf
K8s集群 -> 一键部署题目环境	✔️	❌	✔️
题目定义与实例分离 -> 原生支持动态Flag	✔️	❌	✔️
预构建单执行文件 -> 无其他依赖，平台一键启动	✔️	❌	❌
提供WriteUp的上传和下载通道	✔️	❌	✔️
动态积分+一二三血	✔️	❌	❌
容器调度，避免算力浪费	✔️	❌	❌
合理的动态积分曲线	✔️	❌	❌

平台部署指南

环境准备

官方推荐Ubuntu20.04 AMD64与 Ubuntu22.04 AMD64，release中的版本支持linux/amd64，但是未在众多的linux发行版上完成测试，如果有完成其他发行版的测试，请提交issue让我们知道其他系统和架构请按照编译指南自行编译，目前已经不需要依赖CGO

因为题目image build依赖于docker，所以需要先安装好和本机网段无冲突的Docker，我们在测试过程中发现部分云服务提供商默认Docker网段和本机局域网网段冲突，导致build镜像的时候无法正常访问网络

Install Docker Engine | Docker Documentation

如果需要调整网段，在/etc/docker/daemon.json中配置bip字段，参考如下，网段可更改

{
    "bip": "192.168.100.1/24"
}

然后重启docker服务

sudo systemctl daemon-reload
sudo systemctl restart docker

请确保当前系统中有systemd环境什么是systemd

当前用户需要在 sudo 组

部署流程

由于SQLite对于多并发读写并不友好，所以在完成优化和测试前不再推荐使用SQLite，默认数据库更换为PostgresSQL

根据系统架构在release页面获取 ojtool 二进制文件，如果所用系统架构没有对应的release，请参照contribution自行build

./ojtool prepare -MasterIP xxx.xxx.xxx.xxx --postgres
INSTALL_K3S_MIRROR=cn ./ojtool prepare -MasterIP xxx.xxx.xxx.xxx --postgres #for CHINA

中国用户请使用Mirror的参数执行

执行ojtool prepare 会在当前目录下生成配置文件目录resources，安装完成后目录应该如下所示，其中https.crt、https.key 文件不会默认生成。平台启动时会自动检测这两个文件，如果存在，就自动启用https模式，否则采用http模式

home.html为提供了主页面定制化的功能，在前后端一体化的单文件模式下，如果平台resources 目录中存在home.html 会将其作为平台主页展示

.
├── agent-install.sh        #「在从节点服务器上使用」从节点安装文件
├── OJ                      #平台二进制文件
├── ojtool                  #命令行工具二进制文件
├── resources               #配置文件目录
│   ├── ca.crt              #镜像仓库自签名根证书备份
│   ├── config.yaml         #「平台启动前请修改」平台配置文件模板
│   ├── docker-registry     #镜像仓库相关目录
│   │   ├── auth            #镜像仓库授权文件目录
│   │   │   └── htpasswd    #授权文件
│   │   ├── certs           #镜像仓库证书目录
│   │   │   ├── tls.crt     #镜像仓库证书
│   │   │   └── tls.key     #镜像仓库私钥
│   │   └── data            #镜像仓库数据存储目录
|   ├── [postgres]          #postgres数据目录
│   ├── [https.crt]         #「非自动生成」网站TLS证书
│   ├── [https.key]         #「非自动生成」网站TLS私钥
│   ├── k3s.yaml            #自动生成的k3s配置文件，不需要修改
|   ├── [home.html]         #「非自动生成」如果存在，会加载该网页做为主页面
|   ├── [timeline.save]     #「启动后生成」排行榜历史数据存储文件
|   ├── [emails]            #「非自动生成」邮件模板目录
│   │   ├── [reset.html]    #「非自动生成」密码重置邮件模板
│   │   └── [welcome.html]  #「非自动生成」导入账户初始化邮件模板
│   ├── tls.crt             #镜像仓库公私钥备份
│   └── tls.key             #镜像仓库公私钥备份
├── [writeup]               #「启动后生成」writeup存储目录
└── start.sh                #「配置完毕后启动」启动脚本

然后使用 start.sh启动平台

agent-install.sh是自动生成的从节点安装文件，从节点为平台集成k8s的从节点，由随平台部署的主节点进行管理，该脚本在需要部署的从节点服务器上运行！

将该文件拷贝到从节点服务器上，执行

./agent-install.sh xxx.xxx.xxx.xxx #从节点服务器公网IP
INSTALL_K3S_MIRROR=cn ./agent-install.sh xxx.xxx.xxx.xxx #对于中国用户

如果需要卸载k3s，参考官网

To uninstall K3s from a server node, run:

/usr/local/bin/k3s-uninstall.sh

To uninstall K3s from an agent node, run:

/usr/local/bin/k3s-agent-uninstall.sh

平台配置说明

server:                                 #平台服务器的配置参数
  host: 127.0.0.1                       #设置为Host，用于重置密码和CORS等（仅hostname部分不含协议端口和路径）
  username: Tp0t                        #默认admin用户名
  password: password                    #默认admin账号密码
  mail: admin@example.com               #默认admin账号邮箱
  port: 0                               #0时自动选择80/443，非0指定端口
  salt: "xxxxxxxxxx"                    #用于密码保护的salt，自动生成
  behaviorLog: false                    #用于记录选手关键行为，默认不开启
  debug:                                #debug相关功能，生产环境请勿开启
    dockerOpDetail: false               #开启可以查看容器构建和下发的问题
    noOriginCheck: false                #开启禁用orgin检查，禁用csrf检查，禁用CSP
    dbOpDetail: false                   #开启查看所有数据库请求
  cookieExpiresSeconds: 3600            #cookie过期秒数，0表示不会过期，-1表示在关闭浏览器时过期
email:                                  #邮件服务配置
  host: smtp.example.com                #邮件服务提供商服务器
  username: exampleUsername             #邮件发送账号
  password: examplePassword             #邮件发送账号密码（可能为授权码）
challenge:                              #题目分数控制参数
  firstBloodReward: 0.1                 #一血分数奖励比例
  secondBloodReward: 0.08               #二血分数奖励比例
  thirdBloodReward: 0.05                #三血分数奖励比例
  halfLife: 20                          #题目分值减半所需解题人数
kubernetes:                             #k8s集群配置参数
  portAllocBegin: 30000                 #自动分配端口范围起点
  portAllocEnd: 31000                   #自动分配端口终点
  username: xxxxxxxx                    #「不可修改」镜像仓库用户名
  password: xxxxxxxx                    #「不可修改」镜像仓库密码
  registryHost: xxx.xxx.xxx.xxx:5000    #「不可修改」镜像仓库地址（与平台一致）
database:                               #数据库连接参数
  dsn: "..."                            #数据库连接配置，自动生成
timelineFile: "resources/timeline.save" #「不建议修改」排行榜历史数据存储文件路径

邮件服务配置为必要配置，用户重置和修改密码依赖于邮件服务，未配置邮件服务将导致用户无法修改密码

题目分数曲线公式：

$$k=\frac{1.8414\cdot(N_{solved}-1)}{HalfLife}$$

$$RealScore=\left\lfloor\frac{BaseScore}{k+e^{-k}}\right\rfloor$$

题目分数曲线示例：

基础分数1000，减半人数20，不含奖励分数情况下动态积分曲线

平台使用指南

题目flag支持

单flag
多flag
正则flag
动态随机flag

配置参考config_demos

需要使用k8s集群的基本就是PWN题和WEB题

Pwn_demo1

镜像编译

在镜像编译页面上传镜像，需要上传包含Dockerfile的tar包，注意tar包没有额外目录层级，需要直接能获取到Dockerfile

对于PWN题，推荐使用xinetd作为守护进程

Dockerfile示例

新手请严格按照demo编写题目Dockerfile

注意对于所有需要执行的文件，附加执行权限，否则镜像会build成功，但是用户申请创建实例的时候会失败

对于singleton的题目（所有选手共用一个容器实例），请严格注意权限管控

FROM ubuntu:20.04
RUN sed -i "s/http:\/\/archive.ubuntu.com/http:\/\/mirrors.ustc.edu.cn/g" /etc/apt/sources.list
RUN apt-get update
RUN apt-get -y upgrade
RUN apt-get install -y apt-utils lib32z1 xinetd
RUN useradd -u 8888 -m pwn
COPY share/libunicorn.so.1 /usr/local/lib/libunicorn.so.1
RUN chmod 755 /usr/local/lib/libunicorn.so.1
RUN ldconfig
COPY share/easiestpwn /home/pwn/easiestpwn
RUN chmod 755 /home/pwn/easiestpwn
RUN rm /etc/xinetd.d/*
COPY xinetd /etc/xinetd.d/xinetd
COPY entrypoint.sh /home/pwn/entrypoint.sh
ENTRYPOINT ["/home/pwn/entrypoint.sh"]
EXPOSE 8888

`entrypoint.sh`示例

对于动态flag的题目，必须具备entrypoint.sh文件，因为平台会将生成的随机flag通过entrypoint.sh的第一个参数的形式传入

#!/bin/sh
echo $1 > flag #动态FLAG的必须行，用于平台将生成的FLAG写入，也可自行调整写入位置
/usr/sbin/xinetd -dontfork #启动守护进程

守护进程`xinetd`示例

service pwn 
{
    disable = no
    type        = UNLISTED
    wait        = no
    server      = /bin/sh
    # replace helloworld to your program
    server_args = -c cd${IFS}/home/pwn;exec${IFS}./easiestpwn
    socket_type = stream
    protocol    = tcp
    user        = pwn 
    port        = 8888
    # bind        = 0.0.0.0
    # safety options
    flags       = REUSE
    per_source    = 10 # the maximum instances of this service per source IP address
    rlimit_cpu    = 1 # the maximum number of CPU seconds that the service may use
    #rlimit_as  = 1024M # the Address Space resource limit for the service
    #access_times = 2:00-9:00 12:00-24:00
    nice        = 18
}

打包示例

打包可以使用gz、xz压缩，但是推荐使用tar直接打包，打包不能包含当前文件夹

举个例子，如果Dockerfile等文件都放在/home/pwn/example下，需要运行以下指令打包

cd /home/pwn/example
tar -cvf ../example.tar ./*

题目部署

yaml文件用于上一键导入题目信息以及配置题目所属的K8S节点，需要使用节点部署的题只能通过导入config的形式添加

name: dynamic_flag              # challenge name
category: PWN                   # support [MISC|RE|PWN|WEB|CRYPTO|HARDWARE|RW]
score:
  baseScore: 1000               # base score
  dynamic: true                 # if the score change with solved number
flag: 
  value: xxxxxxxxxx             # means that random dynamic flag length is 10
  type: 3                       # 0-Single 1-Multiple 2-Regexp 3-Dynamic
description: "description" 
externalLink: ["http://link"]
singleton: false                # false means this challenge will give every ctfer a container

# below is no need for singleton challenge
nodeConfig:
  - name: "pwn1"                # give this name same as your uploaded image
    image: "pwn1"               # give this name same as your uploaded image
    servicePorts:               # default & DON'T CHANGE IT
      - name: http              # default & DON'T CHANGE IT
        protocol: TCP           # default & DON'T CHANGE IT
        external: 8888          # default & DON'T CHANGE IT
        internal: 8888          # default & DON'T CHANGE IT
        pod: 0                  # default & DON'T CHANGE IT

数据库导出或备份

命令行工具ojtool提供导出功能（需要在平台启动后使用）

./ojtool export [-dir <export folder>]

通过 -dir 指定导出到的目录，默认导出到data目录

用户批量导入

命令行工具ojtool提供从csv文件批量导入用户的功能（需要在平台启动后使用）

./ojtool load -welcome=<true/false> <csv file>

welcome参数用于指定在导入用户后是否向用户发送初始化邮件
<csv file>为包含需要导入的用户数据的csv文件，格式为<mail>,<username>，不含表头

开发指南

前端

请在app目录下打开vscode
npm相关命令，请在app目录下运行
总之请将app做为工作目录

后端

使用Goland将server作为工作目录

接口相关

GraphQL的schema文件定义在server/services/schema.graphql目录下
请求成功返回message 为空字符串（没有消息就是好消息）

构建

前端环境准备：依赖latest版本的npm和nodejs，在app目录下执行

npm install #必要情况下可以删除package-lock.json

如需要参与开发（向公开的git提交代码），请配置好自动lint，即在app目录下执行

npm run prepare

构建命令行工具和前后端一体化可执行文件：依赖golang，在server目录下执行

go run build.go --postgres  #postgres版本
go run build.go --sqlite    #sqlite版本暂时弃用

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Tp0t OJ

我们的特性

平台部署指南

环境准备

部署流程

平台配置说明

平台使用指南

镜像编译

Dockerfile示例

`entrypoint.sh`示例

守护进程`xinetd`示例

打包示例

题目部署

数据库导出或备份

用户批量导入

开发指南

前端

后端

接口相关

构建

Files

README.md

Latest commit

History

README.md

File metadata and controls

Tp0t OJ

我们的特性

平台部署指南

环境准备

部署流程

平台配置说明

平台使用指南

镜像编译

Dockerfile示例

entrypoint.sh示例

守护进程xinetd示例

打包示例

题目部署

数据库导出或备份

用户批量导入

开发指南

前端

后端

接口相关

构建

`entrypoint.sh`示例

守护进程`xinetd`示例