# AI 换装后端部署指南 本文档说明如何把 `backend/`(GoFrame v2 后端)部署到**你自己的服务器**。 ## 一、前置条件 - 一台能访问对应服务商的服务器(调国外模型需能访问 OpenAI / Google,用豆包等国内模型则只需能访问国内网络即可) - 服务器已安装 Go 1.18+ 或 Docker - 已申请 API Key(按需,用哪个模型就配哪个;若使用本地 ComfyUI 则完全不需要申请 Key): - OpenAI GPT-Image:`sk-...`(https://platform.openai.com) - 豆包(火山方舟):`ARK...`(https://console.volcengine.com/ark) - Google Gemini:`AIza...`(https://aistudio.google.com) - 其他:通义万相、智谱 CogView、硅基流动等 OpenAI 兼容服务均可接入 - ComfyUI 本地离线部署:若主机拥有独立显卡,支持直接接入本地 ComfyUI(优先 Qwen-Image-Edit-2511 4步极速生图,兼容 MiniMax H3),无需任何云端 API 费用。详见 `README.MD`。 ## 二、推荐部署方式(优先 Docker) ### 方式 A:Docker Compose(首选推荐,最省事) ```bash cd backend # 1. 复制环境变量示例文件 cp .env.example .env # 2. 编辑 .env 文件,填入你使用的模型 API Key(按需填写,国内优先推荐豆包 ARK_API_KEY) # 例如:ARK_API_KEY=xxxx # 3. 一键构建并启动后台容器(内置开箱即用自动兜底,默认监听 8000 端口) docker compose up -d # 查看日志 docker compose logs -f ``` > 说明:系统默认自动加载配置模板并绑定 `:8000` 端口。若需深度定制模型或路由,可复制配置:`cp manifest/config/config.example.yaml manifest/config/config.yaml`。 ### 方式 B:Docker Run 单命令运行 ```bash # 1. 在 backend 目录构建镜像 cd backend docker build -f manifest/docker/Dockerfile -t costume-tryon . # 2. 运行容器,通过环境变量注入 Key(按需填写,豆包用 ARK_API_KEY) docker run -d --name costume-tryon \ -p 8000:8000 \ --restart unless-stopped \ -e OPENAI_API_KEY="sk-你的key" \ -e ARK_API_KEY="你的豆包ArkKey" \ -e GEMINI_API_KEY="AIza你的key" \ costume-tryon ``` ### 方式 C:直接编译运行(无 Docker) ```bash cd backend # 编译 Linux 可执行文件(如在本机 Windows 交叉编译) GOOS=linux GOARCH=amd64 go build -o main . # 上传 main 到服务器,设置环境变量后运行 export OPENAI_API_KEY="sk-你的key" export ARK_API_KEY="你的豆包ArkKey" export GEMINI_API_KEY="AIza你的key" ./main ``` > 服务默认监听 `:8000`。可用环境变量 `GF_GCFG_FILE` 指定配置文件路径,或用 `--gf.gcfg.file` 参数。 ## 二点五、模型与 Key 配置说明 所有模型的 **API Key、Base URL、模型名** 都在 `manifest/config/config.yaml` 的 `llm.models` 下配置,均可自由修改: ```yaml llm: models: gpt-image: # 前端请求用的别名 provider: openai # 协议:openai(OpenAI Images 兼容)/ gemini apiKey: "" # 直接填 Key,或留空用环境变量 envKey: "OPENAI_API_KEY" # 环境变量名(优先于 apiKey) baseURL: "https://api.openai.com/v1" model: "gpt-image-2" doubao: # 豆包(火山方舟),国内可用 provider: doubao # 火山方舟协议(复用 images/generations,但请求体为火山格式) envKey: "ARK_API_KEY" baseURL: "https://ark.cn-beijing.volces.com/api/v3" model: "doubao-seedream-3-0-t2i-250415" gemini: provider: gemini envKey: "GEMINI_API_KEY" baseURL: "https://generativelanguage.googleapis.com/v1beta" model: "gemini-3.1-flash-image" ``` **接入任意 OpenAI 兼容的国内生图模型**(通义万相、智谱 CogView、硅基流动、各类中转站),只需新增一个条目: ```yaml qwen: # 通义万相示例 provider: openai envKey: "DASHSCOPE_API_KEY" baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1" model: "wanx2.1-t2i-turbo" comfyui: # 本地 ComfyUI 离线方案(默认 Qwen 优先,自动回退 H3) provider: comfyui baseURL: "http://127.0.0.1:8188" model: "qwen-image-edit-2511" workflowPath: "workflows/comfyui_qwen_image_edit_2511_api.json" ``` > 关键点: > - `provider: openai` 表示走标准的 `POST {baseURL}/images/generations` + `input` 数组协议(OpenAI 官方 GPT-Image、通义万相、智谱 CogView、多数中转站)。把 baseURL 换成服务商地址、model 换成其模型 ID 即可。 > - `provider: doubao` 走火山方舟协议(同样是 `/images/generations`,但请求体用 `prompt` + `image[]` 多图生图,返回 `url`),适配豆包 Seedream 换装。 > - `provider: gemini` 走 Google 原生 `generateContent` 协议。 > 前端模型下拉框在 `index.html` 的 `