gpt_image_playground

环境要求

• 已安装 Docker（支持 docker run / docker compose）
• 已获取 OpenAI 兼容接口的 API Key
• 准备一个可用的 API 基础地址，如 https://api.openai.com/v1
• 服务器可访问 ghcr.io 拉取镜像

安装与启动步骤

1. 1拉取并启动容器

   用官方镜像启动服务，把容器 80 端口映射到宿主机 8080；DEFAULT_API_URL 填入你的 API 基础地址。

   docker run -d -p 8080:80 -e DEFAULT_API_URL=https://api.openai.com/v1 ghcr.io/cooksleep/gpt_image_playground:latest

   复制

2. 2改用 Compose 编排

   若习惯 Compose，可写入 docker-compose.yml 后一键启动，并设置 restart 策略自动重启。

   docker compose up -d

   复制

3. 3挂载自定义配置

   需要多个预置配置时，把本地 JSON 挂载进容器并让 DEFAULT_API_URL 指向该路径。

   docker run -d -p 8080:80 -v ./gpt-image-config.json:/config/gpt-image-config.json:ro -e DEFAULT_API_URL=/config/gpt-image-config.json ghcr.io/cooksleep/gpt_image_playground:latest

   复制

4. 4开启同源 API 代理

   浏览器直连被 CORS 拦截时，开启 Nginx 同源代理，请求经 /api-proxy/ 转发到 API_PROXY_URL。

   docker run -d -p 8080:80 -e DEFAULT_API_URL= -e API_PROXY_URL=https://real-api.example.com/v1 -e ENABLE_API_PROXY=true -e LOCK_API_PROXY=true ghcr.io/cooksleep/gpt_image_playground:latest

   复制

5. 5修改端口

   默认监听 0.0.0.0:80，端口冲突时通过 PORT 变量改到其他端口。

   docker run -d -p 8080:80 -e PORT=28080 ghcr.io/cooksleep/gpt_image_playground:latest

   复制

6. 6浏览器打开并配置 Key

   访问 http://localhost:8080 ，在页面里为预置配置补充 API Key 后即可开始生图。

关键配置

如何确认成功

容器启动后用 docker ps 确认运行中，浏览器访问 http://localhost:8080 能打开页面即成功。

常见问题

注意事项

• 旧版环境变量 API_URL 已拆分为 DEFAULT_API_URL 和 API_PROXY_URL，容器启动时自动兼容，但建议尽早迁移。
• DEFAULT_API_URL 指向 JSON 文件或容器内路径时，宿主机文件需通过 volume 挂载，容器启动时会读取并内嵌到页面。
• 预置配置提供三种写法：直接填 API 地址、API 地址加查询参数、JSON 文件路径或导入链接，末尾带 / 时直接拼接接口不补 /v1。
• LOCK_PRESET_CONFIG_PARAMS 与 PREVENT_PRESET_CONFIG_DELETION 等限制项可按需组合使用，未开启时预置配置可拖动和删除。