admin-valentin/AIClient-2-API
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
AIClient-2-API/README.Docker.md
hex2077 5f0cd6ad83 feat(docker): 添加Docker支持和部署指南 
新增Dockerfile、.dockerignore和健康检查脚本，支持通过Docker部署服务。添加了详细的部署文档和自动化脚本，便于在不同环境下快速启动和配置服务。同时优化了系统提示词应用逻辑，移除了调试日志输出。
2025-07-30 19:46:12 +08:00

1.9 KiB
Raw Blame History

Docker部署指南

本指南将帮助您使用Docker部署GeminiCli2API服务。

构建Docker镜像

在项目根目录下执行以下命令来构建Docker镜像：

docker build -t gemini-cli2api .

运行容器

基本运行

docker run -d -p 3000:3000 --name gemini-cli2api gemini-cli2api

通过ARGS环境变量配置服务

服务支持通过ARGS环境变量来配置，例如：

docker run -d \
  -p 3000:3000 \
  -e ARGS="--api-key 123456 --host 0.0.0.0" \
  --name gemini-cli2api \
  gemini-cli2api

使用Base64编码的凭据

项目包含两个脚本用于自动处理Base64编码的凭据：

  • run-docker.bat (Windows)
  • run-docker.sh (Linux/Unix)

这些脚本会自动生成包含凭据的ARGS环境变量：

# Windows
run-docker.bat

# Linux/Unix (首次使用需要授予权限)
chmod +x run-docker.sh
./run-docker.sh

挂载配置文件和日志目录

# 挂载配置文件
docker run -d \
  -p 3000:3000 \
  -v /path/to/your/config.json:/app/config.json \
  --name gemini-cli2api \
  gemini-cli2api

# 挂载日志目录
docker run -d \
  -p 3000:3000 \
  -v /path/to/your/logs:/app/logs \
  --name gemini-cli2api \
  gemini-cli2api

访问服务

容器启动后，您可以通过以下URL访问服务：

http://localhost:3000

可用端点

  • POST /v1/chat/completions - OpenAI兼容聊天完成端点
  • GET /v1/models - OpenAI兼容模型列表端点
  • POST /v1beta/models/{model}:generateContent - Gemini兼容内容生成端点
  • GET /v1beta/models - Gemini兼容模型列表端点
  • GET /health - 健康检查端点

故障排除

如果容器无法启动，请检查以下内容：

  1. 确保端口3000未被其他进程占用
  2. 检查环境变量配置是否正确
  3. 查看容器日志以获取更多信息：
docker logs gemini-cli2api