One API 部署教程（上）：本地部署完整指南

前言

One API 是一个开源的 AI API 聚合管理平台，可以让你用一个统一的接口调用多个 AI 平台的 API（如 OpenAI、DeepSeek、通义千问等）。

为了让大家能全面了解 One API，我决定写一个系列教程：

• One API 部署教程（上）：本地部署完整指南（本文）
• One API 部署教程（中）：Render 免费部署全攻略(待发布)
• One API 部署教程（下）：使用指南(待发布)

本文将详细介绍如何在本地部署 One API，包括 Docker 和 Docker Compose 两种部署方式。整个过程大概半小时就能搞定，跟着步骤来就行。

后续我可能还会继续尝试部署 New API、FastGPT 等其他平台，敬请期待。

方法一：Docker 部署（推荐）

这是最简单、最推荐的部署方式，适合绝大多数用户。

准备工作

首先需要安装 Docker：

Windows/Mac：

• 下载并安装 Docker Desktop
• 启动 Docker Desktop

Linux：

# 验证安装docker--version

Step 1: 拉取镜像

从 Docker Hub 拉取最新镜像：

dockerpull justsong/one-api

提示：如果上面的镜像无法拉取，可以尝试使用 GitHub 的 Docker 镜像：ghcr.io/songquanpeng/one-api

Step 2: 运行容器

使用 SQLite（适合个人使用）

SQLite 是最简单的选择，不需要额外配置数据库：

# 运行容器dockerrun--nameone-api\-d\--restartalways\-p3000:3000\-e