这种方式需要 Python + PostgreSQL。如果不想手动安装 PostgreSQL，推荐用 Docker 只启动数据库，项目本体仍用 python main.py 跑。

Windows / Linux 都一样：

git clone https://github.com/mumu-0922/GankAIGC.git
cd GankAIGC

Windows PowerShell：

Copy-Item .env.docker.example .env.docker
notepad .env.docker

Linux：

cp .env.docker.example .env.docker
nano .env.docker

在 .env.docker 里至少修改数据库密码：

POSTGRES_PASSWORD=换成你自己的数据库密码

然后只启动 PostgreSQL：

docker compose --env-file .env.docker -f docker-compose.yml -f docker-compose.local.yml up -d postgres

如果你已经自己安装了 PostgreSQL，也可以不用这一步，但需要手动创建 ai_polish 用户和 ai_polish 数据库。

Windows PowerShell：

cd package
python -m venv venv
.\venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

Linux：

cd package
python3 -m venv venv
source venv/bin/activate
python -m pip install -r requirements.txt

推荐使用 Python 3.11。

第一次运行会在 package/.env 生成配置模板：

python main.py

打开 package/.env，重点修改这些配置：

DATABASE_URL=postgresql://ai_polish:你在.env.docker里的POSTGRES_PASSWORD@127.0.0.1:5432/ai_polish
SECRET_KEY=随机长字符串
ADMIN_USERNAME=admin
ADMIN_PASSWORD=你的后台密码
ENCRYPTION_KEY=Fernet加密密钥

POLISH_MODEL=gpt-5.5
POLISH_API_KEY=你的API密钥
POLISH_BASE_URL=https://api.openai.com/v1

ENHANCE_MODEL=gpt-5.5
ENHANCE_API_KEY=你的API密钥
ENHANCE_BASE_URL=https://api.openai.com/v1

EMOTION_MODEL=gpt-5.5
EMOTION_API_KEY=你的API密钥
EMOTION_BASE_URL=https://api.openai.com/v1

如果你在 Windows 一键包或本机源码运行时使用 cliproxy、new-api 这类本地代理， Base URL 请使用 http://127.0.0.1:8317/v1 这种 HTTP 地址，并同时满足：

SERVER_HOST=127.0.0.1
ALLOW_LOCAL_MODEL_PROXY=true
POLISH_BASE_URL=http://127.0.0.1:8317/v1

修改 SERVER_HOST 或 ALLOW_LOCAL_MODEL_PROXY 后建议重启服务；本地代理安全边界按服务启动时的绑定地址判断。

不要把本机代理写成 https://127.0.0.1:8317/v1。本地代理模式只放行 http://127.0.0.1:端口/v1、http://localhost:端口/v1、http://[::1]:端口/v1 或本地 Docker 场景的 http://host.docker.internal:端口/v1。

本地 Docker 访问宿主机代理时，Base URL 可写成 http://host.docker.internal:8317/v1。公网或 VPS 部署不要开启本地代理模式； SERVER_HOST=0.0.0.0 时系统会拒绝本地 HTTP 代理，必须使用公网 HTTPS 代理地址，例如 https://proxy.example.com/v1。

生成密钥示例：

python -c "import secrets; print(secrets.token_urlsafe(32))"
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

第一个填 SECRET_KEY，第二个填 ENCRYPTION_KEY。

python main.py

访问：

http://localhost:9800

Docker Compose 会一次启动完整服务：

• app：GankAIGC Web 应用。
• worker：后台任务处理进程。
• postgres：PostgreSQL 16 数据库。

数据库数据保存在 Docker volume postgres_data 中。重建 app / worker 容器不会删除数据。

Windows PowerShell：

git clone https://github.com/mumu-0922/GankAIGC.git
cd GankAIGC
Copy-Item .env.docker.example .env.docker
notepad .env.docker

Linux / VPS：

git clone https://github.com/mumu-0922/GankAIGC.git
cd GankAIGC
cp .env.docker.example .env.docker
nano .env.docker

至少修改：

POSTGRES_PASSWORD=换成强数据库密码
SECRET_KEY=换成随机长字符串
ADMIN_USERNAME=admin
ADMIN_PASSWORD=换成后台强密码
ENCRYPTION_KEY=换成Fernet加密密钥
ALLOWED_ORIGINS=http://localhost:9800

如果部署到 VPS，并直接用 IP 访问：

ALLOWED_ORIGINS=http://你的服务器IP:9800

如果绑定域名：

ALLOWED_ORIGINS=https://你的域名

生成密钥：

python3 -c "import secrets; print(secrets.token_urlsafe(32))"
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

Docker 会自动根据 POSTGRES_PASSWORD 拼出容器内的 DATABASE_URL，一般不要在 .env.docker 里手动添加 DATABASE_URL。

还可以在 .env.docker 中配置平台 API：

POLISH_MODEL=gpt-5.5
POLISH_API_KEY=你的API密钥
POLISH_BASE_URL=https://api.openai.com/v1

Docker/VPS 公网部署必须使用公网 HTTPS Base URL，不要开启本地代理模式：

ALLOW_LOCAL_MODEL_PROXY=false

只有本机 Docker 测试需要连接宿主机上的本地代理时，才可以把服务改成本机绑定：

SERVER_HOST=127.0.0.1
ALLOW_LOCAL_MODEL_PROXY=true
POLISH_BASE_URL=http://host.docker.internal:8317/v1

修改 SERVER_HOST 或 ALLOW_LOCAL_MODEL_PROXY 后建议重启服务；本地代理安全边界按服务启动时的绑定地址判断。

docker compose --env-file .env.docker up --build -d

docker compose --env-file .env.docker ps
curl http://127.0.0.1:9800/health

返回类似下面内容表示正常：

{"status":"healthy"}

查看日志：

docker compose --env-file .env.docker logs -f app
docker compose --env-file .env.docker logs -f worker
docker compose --env-file .env.docker logs -f backup

Docker 部署默认会启动自动数据库备份服务，备份文件保存在宿主机 backups/：

BACKUP_RETENTION_DAYS=14
BACKUP_INTERVAL_SECONDS=86400

需要立刻手动备份一次：

docker compose --env-file .env.docker run --rm -e RUN_ONCE=true backup

停止服务但保留数据库数据：

docker compose --env-file .env.docker down

更新项目：

git fetch --tags origin main
git pull --ff-only origin main
docker compose --env-file .env.docker up -d --build

进入管理后台，点击左上角版本号，可以检查 GitHub 最新 Release 并复制 SSH 升级命令。后台不会直接控制 Docker；需要 SSH 到 VPS 的项目目录手动执行上面的命令。

不要随便执行 docker compose down -v、docker volume rm gankaigc_postgres_data。这些命令会删除 PostgreSQL 数据卷，用户、邀请码、兑换码、会话和啤酒流水都会丢失。

解压后双击 start.bat 即可运行。

注意：解压路径必须全是英文，路径中不要包含中文、空格或特殊符号。

重要：一键包本地部署后，你自己就是管理员。 用户注册需要邀请码；邀请码需要登录管理后台后，在「用户管理」→「邀请码管理」里自己生成。 后台账号密码首次启动会显示在窗口里，也会保存到 logs/first-run-admin.txt。

进入 Releases，下载：

GankAIGC-Windows-OneClick.zip

使用方式：

1. 解压 GankAIGC-Windows-OneClick.zip。
2. 双击 start.bat。
3. 首次运行会自动初始化内置 PostgreSQL，并生成 .env、数据库密码、后台密码、JWT 密钥和加密密钥。
4. 后台账号密码会显示在窗口里，也会保存到 logs/first-run-admin.txt。
5. 停止服务双击 stop.bat。

注意：不要删除 data/，否则用户、邀请码、兑换码、会话等数据会丢失。

网址：https://ga.mumubuku.top

邀请码进群获得，QQ群：1071743320

SERVER_HOST=0.0.0.0
SERVER_PORT=9800
APP_ENV=development
ALLOWED_ORIGINS=http://localhost:9800

DATABASE_URL=postgresql://ai_polish:数据库密码@127.0.0.1:5432/ai_polish

ADMIN_USERNAME=admin
ADMIN_PASSWORD=replace-with-strong-password
SECRET_KEY=replace-with-random-secret
ENCRYPTION_KEY=replace-with-fernet-key

POLISH_MODEL=gpt-5.5
POLISH_API_KEY=KEY
POLISH_BASE_URL=https://api.openai.com/v1

ENHANCE_MODEL=gpt-5.5
ENHANCE_API_KEY=KEY
ENHANCE_BASE_URL=https://api.openai.com/v1

COMPRESSION_MODEL=gpt-5.5
COMPRESSION_API_KEY=KEY
COMPRESSION_BASE_URL=https://api.openai.com/v1

MAX_CONCURRENT_USERS=5
API_REQUEST_INTERVAL=6
REGISTRATION_ENABLED=true
WORD_FORMATTER_ENABLED=false
ADMIN_DATABASE_MANAGER_ENABLED=true
ADMIN_DATABASE_WRITE_ENABLED=false

关键说明：

• REGISTRATION_ENABLED=false：关闭邀请码注册，已有用户仍可登录。
• WORD_FORMATTER_ENABLED=false：不挂载 Word 排版 API，也不会出现在 OpenAPI 文档中。
• ADMIN_DATABASE_WRITE_ENABLED=false：数据库管理器保持只读，生产环境建议保持关闭。
• ENCRYPTION_KEY：用于加密用户保存的自带 API 配置，必须妥善保存。

用户管理内部分为 5 个工作区：

• 用户列表：按 ID、用户名、昵称搜索，按状态和 API 配置筛选；支持封禁/启用、充值啤酒、设置/取消无限啤酒。
• 邀请码管理：支持单个创建、批量生成 10/50/100、多选复制、CSV/TXT 导出和停用/启用。
• 兑换码：支持单个创建、批量生成 10/50/100、多选复制、CSV/TXT 导出。
• 啤酒流水：查看充值、兑换、降 AI 消耗和失败退款记录。
• API 配置：只展示用户自带 API 的 Base URL、模型名和 API Key 后四位，不展示完整密钥。

新库或升级部署时执行：

cd package/backend
python -m alembic upgrade head

如果本机安装了 pg_dump：

$env:DATABASE_URL="postgresql://ai_polish:数据库密码@127.0.0.1:5432/ai_polish"
PowerShell -NoProfile -ExecutionPolicy Bypass -File scripts/backup-postgres.ps1
Remove-Item Env:\DATABASE_URL

如果 PostgreSQL 在 Docker 容器 gankaigc-postgres 中，也可以使用容器内的 pg_dump：

New-Item -ItemType Directory -Force backups
$ts = Get-Date -Format "yyyyMMdd_HHmmss"
$file = "gankaigc_ai_polish_$ts.dump"
docker exec gankaigc-postgres pg_dump -U ai_polish -d ai_polish -F c -f "/tmp/$file"
docker cp "gankaigc-postgres:/tmp/$file" ".\backups\$file"
docker exec gankaigc-postgres rm "/tmp/$file"

备份、恢复和换机器说明见：PostgreSQL 运维指南。

关闭占用 9800 的旧进程，或修改 .env / .env.docker 中的端口配置。

优先检查：

• PostgreSQL 是否启动。
• DATABASE_URL 是否以 postgresql:// 或 postgresql+psycopg:// 开头。
• 用户名、密码、数据库名和端口是否正确。
• Docker 部署是否使用了 docker compose --env-file .env.docker ...。

确认用户已保存 Base URL、API Key 和模型名称，并且服务端配置了有效的 ENCRYPTION_KEY。

如果提示“你正在使用本地/内网模型地址”，按部署方式处理：

• Windows 一键包本机使用：后台把 SERVER_HOST 改为 127.0.0.1，打开“允许本地 HTTP 模型代理”，Base URL 填 http://127.0.0.1:端口/v1。
• 本地 Docker 测试：Base URL 填 http://host.docker.internal:端口/v1。
• 云端/VPS/公网部署：不要填 127.0.0.1、localhost、192.168.x.x、10.x.x.x 或 172.16-31.x.x，必须使用公网 HTTPS 地址，例如 https://proxy.example.com/v1。

检查 API Key、Base URL、模型名称和网络连通性。不要把真实 API Key 提交到仓库。