Docker 部署

前置要求

Docker

Docker 20.10+

Docker Compose

Docker Compose V2+

Git

用于克隆仓库

快速开始

克隆仓库

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

配置环境变量

复制示例配置文件并修改：

cp .env.example .env

请务必修改所有 please-change-me 的默认值，尤其是密码和密钥！

生成加密密钥

PLUGIN_API_ENCRYPTION_KEY 必须是有效的 Fernet Key：

python AntiHub-Backend/generate_encryption_key.py

将生成的密钥填入 .env 文件。

启动服务

docker compose up -d

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

访问服务

服务	地址
Web 前端	`http://127.0.0.1:3000`
Backend API	`http://127.0.0.1:8000`

生产环境建议使用 Nginx/Caddy 反向代理并配置 HTTPS。

环境变量说明

镜像配置

变量	默认值	说明
`IMAGE_OWNER`	`zhongruan0522`	镜像仓库 Owner
`IMAGE_TAG`	`latest`	镜像标签

端口映射

变量	默认值	说明
`WEB_PORT`	`3000`	Web 前端端口（请在这里修改端口）
`BACKEND_PORT`	`8000`	Backend API 端口（请在这里修改端口）
`POSTGRES_PORT`	`5432`	PostgreSQL 端口

数据库配置

变量	默认值	说明
`POSTGRES_USER`	`antihub`	主数据库用户名
`POSTGRES_PASSWORD`	-	主数据库密码
`POSTGRES_DB`	`antihub`	主数据库名
`PLUGIN_DB_NAME`	`antigravity`	Plugin 数据库名
`PLUGIN_DB_USER`	`antigravity`	Plugin 数据库用户
`PLUGIN_DB_PASSWORD`	-	Plugin 数据库密码

安全密钥（必填）

变量	说明
`JWT_SECRET_KEY`	JWT 签名密钥，建议 32 位以上随机字符串
`PLUGIN_ADMIN_API_KEY`	Plugin 管理 API 密钥
`PLUGIN_API_ENCRYPTION_KEY`	Fernet 加密密钥（使用脚本生成）

管理员账号

变量	默认值	说明
`ADMIN_USERNAME`	`admin`	管理员用户名
`ADMIN_PASSWORD`	-	管理员密码

变量	默认值	说明
`COOKIE_HTTP`	`HTTPS`	Cookie 协议模式

常用命令

启动
停止
查看日志
更新镜像

docker compose up -d

docker compose down

docker compose logs -f
# 查看单个服务
docker compose logs -f backend

docker compose pull
docker compose up -d

常见问题

数据库连接失败

确认 PostgreSQL 容器已启动：docker compose ps
检查 DATABASE_URL 格式是否正确
首次启动请等待数据库初始化完成（约 10-30 秒）

如何使用外部数据库/Redis？

在 .env 中覆盖相应变量即可然后可以使用 docker-compose.core.yml 仅启动三件套（web/backend/plugin）。

部署教程

功能介绍

前置要求

Docker

Docker Compose

Git

快速开始

环境变量说明

常用命令

常见问题

​前置要求

Docker

Docker Compose

Git

​快速开始

​环境变量说明

​常用命令

​常见问题

前置要求

快速开始

环境变量说明

常用命令

常见问题