Giter Club home page Giter Club logo

tp0toj's Introduction

Tp0t OJ

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

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

盈利性质的赛事服务提供商（通过提供CTF比赛服务来获取酬金）需要获取商业授权

我们的特性

特性 Tp0t OJ CTFd
K8s集群 -> 一键部署题目环境 ✔️ ❌
题目定义与实例分离 -> 原生支持动态Flag ✔️ ❌
预构建单执行文件 -> 无其他依赖，平台一键启动 ✔️ ❌
提供WriteUp的上传和下载通道 ✔️ ❌

平台部署指南

环境准备

因为题目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 组

部署流程

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

./prepare -MasterIP xxx.xxx.xxx.xxx

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

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

.
├── agent-install.sh     #「在从节点服务器上使用」从节点安装文件
├── OJ                   #平台二进制文件
├── prepare              #部署器二进制文件
├── resources            #配置文件目录
│   ├── ca.crt           #镜像仓库自签名根证书备份
│   ├── config.yaml      #「平台启动前请修改」平台配置文件模板
│   ├── docker-registry  #镜像仓库相关目录
│   │   ├── auth         #镜像仓库授权文件目录
│   │   │   └── htpasswd #授权文件
│   │   ├── certs        #镜像仓库证书目录
│   │   │   ├── tls.crt  #镜像仓库证书
│   │   │   └── tls.key  #镜像仓库私钥
│   │   └── data         #镜像仓库数据存储目录
│   ├── [https.crt]      #「非自动生成」网站TLS证书
│   ├── [https.key]      #「非自动生成」网站TLS私钥
│   ├── k3s.yaml         #自动生成的k3s配置文件，不需要修改
|   ├── [home.html]      #「非自动生成」如果存在，会加载该网页做为主页面
│   ├── tls.crt          #镜像仓库公私钥备份
│   └── tls.key          #镜像仓库公私钥备份
└── start.sh             #「配置完毕后启动」启动脚本

然后使用 start.sh启动平台

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

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

./agent-install.sh xxx.xxx.xxx.xxx #从节点服务器公网IP

平台配置说明

server:                              #平台服务器的配置参数
  host: 127.0.0.1                    #不用更改
  username: Tp0t                     #默认admin用户名
  password: admin                    #默认admin账号密码
  mail: [email protected]            #默认admin账号邮箱
  port: 0                            #0时自动选择80/443，非0指定端口
  salt: "xxxxxxxxxx"                 #用于密码保护的salt，自动生成
  debug: false                       #无用参数
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 #「不可修改」镜像仓库地址（与平台一致）

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

题目分数曲线公式：

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

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

题目分数曲线示例：

curve.svg

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

平台使用指南

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

Pwn_demo1_

镜像编译

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

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

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: pwn1 #challenge页面显示的题目名称
category: PWN #题目类型
score:
  baseScore: 1000 #基本分数，动态积分和奖励根据基本分数的一定比例计算
  dynamic: true #是否开启动态积分
flag: 
  value: flag{test} #对于开启动态flag的题目value字段没用，flag由平台随机生成
  dynamic: true #是否开启动态积分
description: "this is a test pwn"
externalLink: [http://cloud.lordcasser.com/s/DkxtK] #题目附件链接
singleton: false #true时题目所有用户都是同一个环境/flag，false时每人一个环境
nodeConfig:
  - name: "pwn1" #节点名称，要求[a~z 0~9]且必须有一个字母
    image: "pwn1" #题目使用镜像的名称，需要提前上传好所使用的镜像
    servicePorts:
      - name: http #不用更改
        protocol: TCP #不用更改
        external: 8888 #指定docker对外暴露的端口
        internal: 8888 #指定docker容器内端口
        pod: 0 # 集群pod对外的端口，也是用户实际访问的端口，0为自动分配

开发指南

前端

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

后端

  • 使用Goland将server作为工作目录

接口相关

  • GraphQL的schema文件定义在server/src/resources/schema目录下

  • 请求成功返回message 为空字符串（没有消息就是好消息）

构建

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

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

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

go run build.go

tp0toj's People

Contributors

azurity avatar lordcasser avatar houwenda avatar dependabot[bot] avatar zenisltz avatar anxq avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.