生成结果仅保存在当前浏览器本地,不会自动存储在你的服务器或 AIOHub 服务器。清空浏览器数据会删除历史图片,请及时下载需要保留的结果。
自行部署 GIP 适合需要自定义域名、内网访问、团队统一入口或访问控制的场景。推荐使用 Docker 部署:不需要改源码,升级和回滚也更直接。
GIP 是一个浏览器图片客户端。你仍然使用 AIOHub 的模型调用 API 和 API 令牌完成鉴权、计费和日志记录。
推荐配置
| 配置项 | 值 |
|---|
| 默认 API 地址 | https://api.aiohub.org |
| API 令牌 | 你的 AIOHub sk- API 令牌 |
| API 接口 | Images API(/v1/images) |
| 模型 ID | gpt-image-2 |
| Codex CLI | codex* 分组开启;openai 分组关闭 |
| Timeout | 360-600 秒 |
Docker 启动
在服务器上安装 Docker 后运行:
docker run -d \
--name gip \
--restart unless-stopped \
-p 8080:80 \
-e DEFAULT_API_URL=https://api.aiohub.org \
ghcr.io/cooksleep/gpt_image_playground:latest
启动后访问:
打开 GIP 设置,填入 AIOHub API 令牌,选择 Images API,模型填 gpt-image-2。
DEFAULT_API_URL 只会预填 GIP 页面中的 API 地址。用户仍需要在页面中填写自己的 API 令牌。
Docker Compose
如果你用 Compose 管理服务,可以创建 docker-compose.yml:
services:
gip:
image: ghcr.io/cooksleep/gpt_image_playground:latest
container_name: gip
restart: unless-stopped
ports:
- "8080:80"
environment:
DEFAULT_API_URL: "https://api.aiohub.org"
启动:
查看日志:
更新:
docker compose pull
docker compose up -d
可选:绑定域名
如果只是自己临时使用,可以直接访问 http://你的服务器:8080,不需要绑定域名。
如果要给多人或团队长期使用,可以考虑绑定 HTTPS 域名,并通过 Nginx、Caddy 或你的服务器面板反向代理到容器端口 8080。这样更便于分享固定入口,也可以在反向代理层增加登录、IP 白名单或内网访问限制。
Nginx 示例:
server {
listen 443 ssl http2;
server_name image.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
如果只给团队内部使用,建议至少在反向代理层增加登录、IP 白名单或内网访问限制。
可选:开启同源 API 代理
默认情况下,浏览器会直接请求 https://api.aiohub.org。一般不需要开启 GIP 的同源 API 代理。
只有在你明确需要由自己的服务器转发请求时,才添加这些环境变量:
services:
gip:
image: ghcr.io/cooksleep/gpt_image_playground:latest
restart: unless-stopped
ports:
- "8080:80"
environment:
DEFAULT_API_URL: "https://api.aiohub.org"
ENABLE_API_PROXY: "true"
API_PROXY_URL: "https://api.aiohub.org"
开启同源 API 代理后,任何能访问该站点的人都可能通过你的服务器转发请求。只在有登录、IP 白名单、内网隔离或其他访问控制的环境中开启。
后续使用
部署完成后,GIP 的客户端配置方式和网站内嵌版本一致。参考 网站内嵌 GPT Image Playground (GIP) 的配置方法,填写 AIOHub API 令牌、Images API、gpt-image-2、Codex CLI 开关和超时时间。
如果开启同源 API 代理,仍需为自部署站点保留登录、IP 白名单、内网隔离或其他访问控制。