Skip to main content

​
前置要求

Docker

Docker 20.10+

Docker Compose

Docker Compose V2+

Git

用于克隆仓库

​
快速开始

1

克隆仓库

git clone https://github.com/zhongruan0522/AntiHub-ALL.git
cd AntiHub
2

配置环境变量

复制示例配置文件并修改：
cp .env.example .env
请务必修改所有 please-change-me 的默认值，尤其是密码和密钥！
3

生成加密密钥

PLUGIN_API_ENCRYPTION_KEY 必须是有效的 Fernet Key：
python AntiHub-Backend/generate_encryption_key.py
将生成的密钥填入 .env 文件。
4

启动服务

docker compose up -d
首次启动会自动拉取镜像、初始化数据库并创建管理员账号。
5

访问服务

服务地址
Web 前端http://127.0.0.1:3000
Backend APIhttp://127.0.0.1:8000
生产环境建议使用 Nginx/Caddy 反向代理并配置 HTTPS。

​
环境变量说明

变量默认值说明
IMAGE_OWNERzhongruan0522镜像仓库 Owner
IMAGE_TAGlatest镜像标签
变量默认值说明
WEB_PORT3000Web 前端端口（请在这里修改端口）
BACKEND_PORT8000Backend API 端口（请在这里修改端口）
POSTGRES_PORT5432PostgreSQL 端口
变量默认值说明
POSTGRES_USERantihub主数据库用户名
POSTGRES_PASSWORD-主数据库密码
POSTGRES_DBantihub主数据库名
PLUGIN_DB_NAMEantigravityPlugin 数据库名
PLUGIN_DB_USERantigravityPlugin 数据库用户
PLUGIN_DB_PASSWORD-Plugin 数据库密码
变量说明
JWT_SECRET_KEYJWT 签名密钥，建议 32 位以上随机字符串
PLUGIN_ADMIN_API_KEYPlugin 管理 API 密钥
PLUGIN_API_ENCRYPTION_KEYFernet 加密密钥（使用脚本生成）
变量默认值说明
ADMIN_USERNAMEadmin管理员用户名
ADMIN_PASSWORD-管理员密码

​
常用命令

docker compose up -d

​
常见问题

  1. 确认 PostgreSQL 容器已启动：docker compose ps
  2. 检查 DATABASE_URL 格式是否正确
  3. 首次启动请等待数据库初始化完成（约 10-30 秒）
在 .env 中覆盖相应变量即可然后可以使用 docker-compose.core.yml 仅启动三件套（web/backend/plugin）。