README.md

Docker 部署文件

这个目录包含了 AI Studio Proxy API 项目的所有 Docker 相关文件。

📁 文件说明

• Dockerfile - Docker 镜像构建文件
• docker-compose.yml - Docker Compose 配置文件
• .env.docker - Docker 环境配置模板
• README-Docker.md - 详细的 Docker 部署指南

🚀 快速开始

0. 准备认证文件 (重要)

Docker 模式仅支持运行已认证的会话。请确保项目根目录下存在 auth_profiles 目录，并且其中包含有效的认证文件（通常由主机直接运行程序生成）。

目录结构示例：

项目根目录/
  ├── auth_profiles/
  │   └── active/
  │       └── account_xxx.json  <-- 必需的认证文件
  └── docker/

1. 准备配置文件

cd docker
cp .env.docker .env
nano .env  # 编辑配置文件

2. 启动服务

# 构建并启动服务
docker compose up -d

# 查看日志
docker compose logs -f

3. 版本更新

# 在 docker 目录下
bash update.sh

📖 详细文档

完整的 Docker 部署指南请参见：README-Docker.md

🔧 常用命令

# 查看服务状态
docker compose ps

# 查看日志
docker compose logs -f

# 停止服务
docker compose down

# 重启服务
docker compose restart

# 进入容器
docker compose exec ai-studio-proxy /bin/bash

🌟 主要优势

• ✅ 统一配置: 使用 .env 文件管理所有配置
• ✅ 版本更新无忧: bash update.sh 即可完成更新
• ✅ 环境隔离: 容器化部署，避免环境冲突
• ✅ 配置持久化: 认证文件和日志持久化存储

⚠️ 注意事项

1. 认证文件: 必须在主机上预先获取认证文件并放入 auth_profiles/active/ 目录。
2. 端口配置: 默认占用主机端口 2048 (API) 和 3120 (Stream)。如需修改，请编辑 .env 文件中的 HOST_FASTAPI_PORT 和 HOST_STREAM_PORT。
3. 配置文件: .env 文件必须位于 docker/ 目录下，以便 Docker Compose 正确加载。
4. 脚本注入: 如需使用脚本注入功能，请参考 README-Docker.md 中的详细配置说明。