0成本OJ系统

smadoge · 2026-06-26 21:33:35 · 科技·工程

这是一个由 Cloudflare Workers 实现前后端、GitHub Actions 提供评测的 0 成本 OJ 系统。（其实需要一个域名）

demo 地址

项目地址

部署

你需要什么

一个 Cloudflare 账号
一个 GitHub 账号（注册教程自行搜寻）
本地电脑 Node.js 环境（可以使用中文镜像站）
一个自己的域名（域名解析服务器转到 Cloudflare）

如何绑定域名至 Cloudflare 可以参考官网的说明

1. 配置本地环境

1. 下载项目：

git clone https://github.com/wanwusangzhigit/eoj.git
cd eoj

2. 安装依赖：

cd frontend
npm i
cd ..
cd backend
npm i
cd ..

3. 全局安装 Cloudflare CLI 并登录

npm i -g wrangler
wrangler login

2. 部署前的准备

1. 创建 Cloudflare D1 数据库

wrangler d1 create oj-database

执行后会输出 database_id，记录下来。

2. 创建 GitHub OAuth App（无需 GitHub 授权登录的无需配置）

前往 GitHub Developer Settings 创建 OAuth App：

字段	值
Application name	OJ System
Homepage URL	`https://你的域名`
Authorization callback URL	`https://你的域名/api/v1/auth/github/callback`

记录 Client ID 和 Client Secret。

3. 创建 CPOAUTH APP（无需 CPOAUTH 授权登录的无需配置）

前往 cpoauth

CALLBACK URL：https://你的域名/api/v1/auth/cpoauth/callback

4. 前往 Cloudflare 创建 Workers（在构建下的 Workers 和 Pages 栏中）

创建 Workers，命名 oj-backend，并在域中绑定域名

5. 前往 GitHub 创建评测仓库

在 GitHub 创建私有仓库（如 your-username/oj-judge）
将 judge-repo 文件夹下的文件上传至仓库
在仓库 Settings > Secrets and variables > Actions 中添加：

Secret	值
`WORKER_API`	Worker 完整 URL（如 `https://oj.your-domain.com`）
`CALLBACK_SECRET`	随机生成并记录

6. 创建 GitHub Token

前往 GitHub，创建 Tokens（classic），并记录（至少需要代码读写、GitHub Actions 读写、GitHub Workflow 读写等权限）

7. 配置 wrangler.toml

编辑 backend/wrangler.toml，填入你的配置：

name = "oj-backend"
main = "src/index.ts"
compatibility_date = "2024-01-01"
account_id = "你的 Cloudflare Account ID"

[[d1_databases]]
binding = "DB"
database_name = "oj-database"
database_id = "上一步获取的 database_id"

[assets]
directory = "./public"
binding = "ASSETS"
not_found_handling = "single-page-application"

[vars]
GITHUB_CLIENT_ID = "你的 GitHub OAuth Client ID"
GITHUB_CLIENT_SECRET = "你的 GitHub OAuth Client Secret"
CPOAUTH_CLIENT_ID = "你的 CpOAuth Client ID"
CPOAUTH_CLIENT_SECRET = "你的 CpOAuth Client Secret"
JWT_SECRET = "用 openssl rand -base64 32 生成的密钥"
CALLBACK_SECRET = "你记录的 CALLBACK_SECRET"
GITHUB_TOKEN = "你的 GitHub Token（需 repo 权限，用于触发评测）"
JUDGE_REPO = "your-username/oj-judge"
FRONTEND_URL = "https://你的域名"
REGISTRATION_OPEN = "true"

3. 部署项目

1. 编译数据库

cd backend
npx wrangler d1 migrations apply oj-database --remote
cd ..

2. 构建前端

cd frontend
npm run build:site
cd ..

3. 部署后端

cd backend
npx wrangler deploy

至此部署完成！

4. 部署后的工作

你需要前往你的 OJ 创建账户
访问 https://你的域名/__seed 初始化数据库并将第一位注册用户设置为超级管理员。

站点设置（管理页面）

部署后，管理员可在后台 站点设置 标签页配置：

设置项	说明	默认值
开启注册（后端 wrangler.toml 配置）	关闭后新用户无法注册	开启
强制填写邮箱（网站设置）	注册时邮箱为必填项	关闭
邮箱后缀限制（网站设置）	允许的邮箱后缀（逗号分隔），留空不限制	空

站点自定义（前端 config.yaml 设置）

编辑 frontend/config.yaml：

site:
  name: "My OJ"              # 站点名称
  short_name: "MyOJ"          # 站点简称
  description: "My Online Judge"
  icon: "default"             # "default" 使用内置图标，或填入图标 URL
  favicon: "/favicon.svg"

footer:
  enabled: true
  text: ""                    # 自定义页脚文本（支持 HTML），为空则显示 © 年份 站点名
  links:                      # 页脚链接
    - name: "GitHub"
      url: "https://github.com/your-org"

login:
  hero_title: ""              # 登录页大标题，为空使用默认
  hero_subtitle: ""           # 登录页副标题，为空使用默认
  show_github: true           # 是否显示 GitHub 登录按钮
  show_cpoauth: true          # 是否显示 CpOAuth 登录按钮

home:
  title: ""                   # 首页标题，为空使用默认