开源大模型管理利器：OneAPI 保姆级部署教程（Docker版）

📅 2026年03月04日 | 🏷️ 开源工具 / OneAPI / Docker / AI 生态

OneAPI 部署封面图

🌟 为什么你需要 OneAPI？

在 AI 应用爆发的今天，开发者面临着多个大模型服务商（OpenAI, Claude, Gemini, DeepSeek, 硅基流动等）各自为政的尴尬局面。API 格式不统一、Key 难以管理、多项目消耗不透明等问题接踵而至。

OneAPI（由 GitHub 开发者 songquanpeng 创作）正是为此而生的神级项目。它能将所有主流大模型的 API 封装成统一的 OpenAI 接口格式，让你只需管理一个接口、一个 Key，即可调用全世界的 AI 力量。

OneAPI Hub 概念图

核心优势：

格式统一：不管后端是 Anthropic 还是百度文心，前端统一用 OpenAI 格式调用。
多渠道负载均衡：一个模型可以配多个 Key，自动轮询，提高稳定性。
额度管理：可以为不同的子用户、不同的项目分配不同的额度。
单文件部署：极其轻量，支持 SQLite 和 MySQL。

🛠️ 环境准备

在开始之前，请确保你的服务器已安装：

Docker
Docker Compose（可选，但强烈推荐）

🚀 部署步骤：两分钟搞定

Docker 部署概念图

方法一：Docker 一键启动（最快）

如果你只是想快速测试，直接运行下面这行命令：

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

方法二：Docker Compose 部署（推荐）

为了更方便地管理和持久化数据，建议使用 Docker Compose。

创建工作目录：
```
mkdir -p ~/one-api && cd ~/one-api
```

创建 docker-compose.yml 文件：

version: '3.4'
services:
  one-api:
    image: justsong/one-api:latest
    container_name: one-api
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - ./data:/data
      - ./logs:/app/logs
    environment:
      - TZ=Asia/Shanghai
      # 如果需要使用外部 MySQL，请取消下面注释并配置
      # - SQL_DSN=username:password@tcp(localhost:3306)/oneapi