One API 部署与配置指南

技术文档：One API 部署与配置指南

概述

One API 是一个多功能的 API 管理平台，支持自定义设置、用户管理、多种登录注册方式、主题切换等。本文档提供了详细的部署和配置指南，帮助用户快速搭建和使用 One API。

部署

基于 Docker 部署

Docker 是一种流行的容器化技术，可以简化部署过程。以下是使用 Docker 部署 One API 的步骤：

1. 拉取镜像：

   docker pull justsong/one-api
   

2. 运行容器：

   • 使用 SQLite：

     docker run --name one-api -d --restart always -p 3000:3000 -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api
     

   • 使用 MySQL：

     docker run --name one-api -d --restart always -p 3000:3000 -e SQL_DSN="root:123456@tcp(localhost:3306)/oneapi" -e TZ=Asia/Shanghai -v /home/ubuntu/data/one-api:/data justsong/one-api
     

3. 配置 Nginx：
   Nginx 可以作为反向代理服务器，提高性能和安全性。以下是一个基本的 Nginx 配置示例：

   server {server_name openai.justsong.cn;location / {proxy_pass http://localhost:3000;proxy_set_header Host $host;proxy_set_header X-Forwarded-For $remote_addr;}
   }
   

4. 启用 HTTPS：
   使用 Let’s Encrypt 提供的 certbot 工具，可以自动化地获取和配置 SSL 证书。

   sudo certbot --nginx
   

基于 Docker Compose 部署

Docker Compose 允许用户通过 YAML 文件定义多个容器的应用。以下是一个基本的 docker-compose.yml 文件示例：

version: '3'
services:one-api:image: justsong/one-apiports:- "3000:3000"volumes:- ./data:/dataenvironment:- TZ=Asia/Shanghai

配置

环境变量

环境变量提供了一种灵活的配置方式，以下是一些常用的环境变量：

• REDIS_CONN_STRING：连接 Redis 缓存。
• SESSION_SECRET：设置会话密钥。
• SQL_DSN：数据库连接字符串。
• THEME：设置主题。

命令行参数

除了环境变量，One API 还支持通过命令行参数进行配置：

• --port：设置监听端口。
• --log-dir：设置日志目录。

使用方法

添加 API Key

在 One API 的管理界面中添加您的 API Key，以便在应用程序中使用。

生成访问令牌

在令牌页面生成访问令牌，用于 API 调用的身份验证。

API 调用

使用生成的令牌调用 One API，调用方式与 OpenAI API 一致。

常见问题

数据库连接问题

如果遇到数据库连接问题，确保 SQL_DSN 环境变量正确配置，并且数据库服务运行正常。

部署问题

如果部署后访问出现空白页面，检查 Nginx 配置和容器日志，确保服务正常运行。

相关项目

• FastGPT：基于 LLM 的知识库问答系统。
• ChatGPT Next Web：跨平台的 ChatGPT 应用。

---

以上是对原始文档的补充和扩展，增加了关联知识点和更详细的配置说明，以帮助用户更好地理解和使用 One API。