OneAPI 部署指南

OneAPI 是一个强大的接口管理与分发系统，专为简化和优化用户与大模型 API 的交互而设计。本文将详细介绍如何部署 OneAPI，包括安装、配置和使用的每一个步骤，以帮助用户轻松上手并发挥其最大优势。

什么是 OneAPI

OneAPI 是一个开源项目，旨在提供一个统一的平台来管理和调控用户与各种大模型 API 的交互。通过 OneAPI，用户可以轻松地接入多个主流 AI 模型接口，如 OpenAI、Azure、Anthropic Claude、Google PaLM 等。这一系统不仅支持多种模型的整合，还提供了丰富的管理功能，如请求监控、权限管理、接口测试等。

功能与优势

OneAPI 的主要优势在于其多模型支持和开箱即用的特性。通过 Docker 镜像形式，用户可以快速部署 OneAPI，降低使用门槛。此外，OneAPI 采用 Go 语言开发，确保了高性能运行，并不断更新，以支持最新的 API 规范和功能。

环境准备与安装

在开始部署 OneAPI 之前，确保系统已经安装了 Docker 和 Docker Compose。这两个工具将帮助您快速部署和管理 OneAPI 的容器环境。

Docker 和 Docker Compose 安装

检查安装版本：
```
docker --version

docker-compose --version
```
如果未安装，请使用以下命令安装：

安装 Docker：

sudo apt-get update

sudo apt-get install docker-ce docker-ce-cli containerd.io

安装 Docker Compose：

sudo curl -L "https://github.com/docker/compose/releases/download/v2.3.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

创建与配置项目目录

在进行部署之前，我们需要为 OneAPI 创建一个项目目录，并编写 Docker Compose 文件。

创建项目目录

mkdir one-api
cd one-api

编写 Docker Compose 文件

在项目目录中创建一个名为 docker-compose.yml 的文件，并添加以下内容：

version: '3.4'

services:
  one-api:
    image: "docker.io/justsong/one-api:latest"
    container_name: one-api
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data/oneapi:/data
      - ./logs:/app/logs
    environment:
      - SQL_DSN=oneapi:123456@tcp(db:3306)/one-api
      - REDIS_CONN_STRING=redis://redis
      - SESSION_SECRET=random_string
      - TZ=Asia/Shanghai
    depends_on:
      - redis
      - db

  redis:
    image: "docker.io/redis:latest"
    container_name: redis
    restart: always

  db:
    image: "docker.io/mysql:8.2.0"
    container_name: mysql
    volumes:
      - ./data/mysql:/var/lib/mysql
    ports:
      - '3306:3306'
    environment:
      - MYSQL_ROOT_PASSWORD: 'OneAPI@justsong'
      - MYSQL_USER: oneapi
      - MYSQL_PASSWORD: '123456'
      - MYSQL_DATABASE: one-api