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

93 lines
No EOL
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Docker部署指南
本指南将帮助您使用Docker部署GeminiCli2API服务。
## 构建Docker镜像
在项目根目录下执行以下命令来构建Docker镜像
```bash
docker build -t gemini-cli2api .
```
## 运行容器
### 基本运行
```bash
docker run -d -p 3000:3000 --name gemini-cli2api gemini-cli2api
```
### 通过ARGS环境变量配置服务
服务支持通过`ARGS`环境变量来配置,例如:
```bash
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`环境变量:
```bash
# Windows
run-docker.bat
# Linux/Unix (首次使用需要授予权限)
chmod +x run-docker.sh
./run-docker.sh
```
### 挂载配置文件和日志目录
```bash
# 挂载配置文件
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. 查看容器日志以获取更多信息:
```bash
docker logs gemini-cli2api