# 目前支持 MySQL 启动，数据存储在 ./data/mysql 文件夹内

docker-compose up -d

# 查看部署状态

docker-compose ps

3. 手动部署

手动部署适用于需要自定义配置的用户。以下是步骤：

从 GitHub Releases 下载可执行文件或者从源码编译：

git clone https://github.com/songquanpeng/one-api.git

# 构建前端

cd one-api/web/default

npm install

npm run build

# 构建后端

cd ../..

go mod download

go build -ldflags "-s -w" -o one-api

运行：

chmod u+x one-api

./one-api --port 3000 --log-dir ./logs

访问 http://localhost:3000/ 并登录。初始账号用户名为 root，密码为 123456。

4. 多机部署

多机部署可以显著提高系统的可用性和扩展性。需要注意以下几点：

所有服务器 SESSION_SECRET 设置一样的值。必须设置 SQL_DSN，使用 MySQL 数据库而非 SQLite，所有服务器连接同一个数据库。所有从服务器必须设置 NODE_TYPE 为 slave。

三、使用方法

One API 的使用方法非常简单，只需按以下步骤操作即可：

1. 注册与登录

初始账号用户名为 root，密码为 123456。登录后可以在后台进行各种配置和管理。

2. 配置与管理

One API 提供了丰富的配置选项，用户可以根据实际需求进行调整。例如，可以在 令牌管理 中设置令牌的过期时间和额度，在 渠道管理 中批量创建渠道，在 用户管理 中设置用户登录注册方式等。

3. 调用 API

One API 采用标准的 OpenAI API 格式，用户只需按标准格式调用即可。例如，调用 ChatGPT 模型进行文本生成：

import requests

url = "http://localhost:3000/v1/completions"

headers = {

"Authorization": "Bearer YOUR_API_KEY",

"Content-Type": "application/json"

}

data = {

"model": "text-davinci-003",

"prompt": "Hello, world!",

"max_tokens": 100

}

response = requests.post(url, headers=headers, json=data)

print(response.json())

四、常见问题与解决

1. 启动失败

如果启动失败，请检查以下几点：

确认 Docker 镜像是否正确拉取。检查端口是否被占用。确认数据目录是否存在且具有写入权限。

2. 性能优化

对于高并发量的应用，建议：

使用 MySQL 数据库并设置 SQL_DSN。配置负载均衡，提高访问效率。使用 Redis 缓存，减少数据库访问延迟。

3. 安全问题

初次登录系统后，务必修改默认密码 123456。遵循 OpenAI 的使用条款以及法律法规，不得将 One API 用于非法用途。

五、结语

One API 为开发者提供了一个统一的接口，简化了多种大模型的调用流程。其强大的功能和灵活的配置选项，使得 One API 成为开发者不可或缺的工具。无论是初学者还是资深开发者，都能从中受益，快速实现大模型的调用与管理。

参考文献

One API GitHub 项目OpenAI API 文档Anthropic ClaudeGoogle PaLM2/Gemini百度文心一言