【教程6】New API 部署实战 — Docker Compose 一键搭建你的API中转站

lpf2026

搞定了服务器和 Docker，现在到了最关键的一步——部署 New API，让你的中转站真正跑起来。本文提供完整的 docker-compose.yml 配置，从数据库到应用一条龙部署。

一、New API 是什么？

New API（原名 One API）是目前最流行的开源 API 中转管理系统，GitHub 10k+ Star。核心功能：

• 对接 OpenAI / Anthropic / Google / Azure 等 100+ 模型
  
• 用户注册、Key管理、额度充值、日志统计
  
• 多上游负载均衡、自动故障切换
  
• 支持 OpenAI、Anthropic 等标准 API 格式转发
  
• 内置 Web 管理面板和用户前台
  

二、准备工作

• 一台安装了 Docker 和 docker compose 的服务器（参考教程5）
  
• 一个域名已经解析到服务器（参考教程2）
  
• 至少一个可用的 OpenAI / Anthropic API Key（参考教程3）
  

三、创建部署目录结构

1. # SSH 连接到服务器后
2. mkdir -p /opt/new-api && cd /opt/new-api
3. mkdir -p data

复制代码

四、编写 docker-compose.yml

1. # 创建配置文件
2. nano /opt/new-api/docker-compose.yml

复制代码

以下是最小化但生产可用的配置：

1. version: "3.8"
3. services:
4.   # MySQL 数据库
5.   mysql:
6.     image: mysql:8.0
7.     container_name: newapi-mysql
8.     restart: always
9.     environment:
10.       MYSQL_ROOT_PASSWORD: your_mysql_password  # 改成强密码！
11.       MYSQL_DATABASE: new_api
12.     volumes:
13.       - ./data/mysql:/var/lib/mysql
14.     command: --default-authentication-plugin=mysql_native_password
15.     networks:
16.       - newapi-net
18.   # Redis 缓存
19.   redis:
20.     image: redis:7-alpine
21.     container_name: newapi-redis
22.     restart: always
23.     volumes:
24.       - ./data/redis:/data
25.     networks:
26.       - newapi-net
28.   # New API 主程序
29.   new-api:
30.     image: calciumion/new-api:latest
31.     container_name: newapi-app
32.     restart: always
33.     ports:
34.       - "3000:3000"
35.     environment:
36.       - SQL_DSN=root:your_mysql_password@tcp(mysql:3306)/new_api
37.       - REDIS_CONN_STRING=redis://redis:6379
38.       - SESSION_SECRET=your_random_secret_here  # 改成随机字符串
39.       - TZ=Asia/Shanghai
40.     volumes:
41.       - ./data/upload:/app/upload
42.     depends_on:
43.       - mysql
44.       - redis
45.     networks:
46.       - newapi-net
48. networks:
49.   newapi-net:
50.     driver: bridge

复制代码

注意：将 your_mysql_password 和 your_random_secret_here 替换为你自己的值。SESSION_SECRET 可用 openssl rand -hex 32 生成。

五、启动服务

1. cd /opt/new-api
3. # 拉取最新镜像
4. docker compose pull
6. # 启动所有服务（-d 后台运行）
7. docker compose up -d
9. # 查看启动状态
10. docker compose ps
12. # 查看日志，确认没有报错
13. docker compose logs -f new-api

复制代码

看到类似 Server started on port 3000 的日志，说明启动成功！

六、初始化配置

• 浏览器访问 http://你的服务器IP:3000
  
• 首次访问会自动跳转到注册页面
  
• 注册第一个账号（自动成为管理员）
  
• 登录后进入管理面板，开始配置
  

七、管理面板快速设置

7.1 添加渠道（上游API）

• 左侧菜单「渠道」→「添加渠道」
  
• 选择类型（如 OpenAI / Anthropic）
  
• 填入你获取的 API Key（教程3中获取的）
  
• 设置模型列表（勾选你要提供的模型）
  
• 保存后测试连通性
  

7.2 设置价格

• 「价格」→「模型价格管理」
  
• 为每个模型设置对外售价（通常是上游成本的 1.5-3 倍）
  
• 支持按 token 定价或按次数定价
  

7.3 用户管理

• 「用户」→ 查看所有注册用户
  
• 可以手动为用户充值额度
  
• 设置用户分组和权限
  

八、使用外部 MySQL 数据库（可选）

如果你想用服务器上已安装的 MySQL 而不是容器化的 MySQL：

1. version: "3.8"
2. services:
3.   new-api:
4.     image: calciumion/new-api:latest
5.     container_name: newapi-app
6.     restart: always
7.     ports:
8.       - "3000:3000"
9.     environment:
10.       - SQL_DSN=root:password@tcp(host.docker.internal:3306)/new_api
11.       - REDIS_CONN_STRING=redis://redis:6379
12.       - SESSION_SECRET=your_random_secret
13.       - TZ=Asia/Shanghai
14.     extra_hosts:
15.       - "host.docker.internal:host-gateway"
16.     networks:
17.       - newapi-net
18.   redis:
19.     image: redis:7-alpine
20.     restart: always
21.     networks:
22.       - newapi-net
23. networks:
24.   newapi-net:
25.     driver: bridge

复制代码

九、版本更新

1. cd /opt/new-api
3. # 拉取最新镜像
4. docker compose pull new-api
6. # 重新创建容器
7. docker compose up -d new-api
9. # 清理旧镜像
10. docker image prune -f

复制代码

十、常见部署问题

问题	解决
MySQL 连接失败	等 MySQL 容器完全启动（约30秒），查看 mysql 日志
端口 3000 被占用	修改 ports 映射："3001:3000" 将外部端口改为 3001
页面空白/加载不出来	按 F12 查看控制台报错；检查 SESSION_SECRET 是否设置
容器无限重启	docker compose logs new-api 查看错误原因
数据库初始化失败	检查 MySQL 密码是否正确，数据库是否已创建

十一、安全提示

• 不要用默认密码！数据库、管理员账号都要用强密码
  
• 当前 New API 运行在 HTTP 上（端口3000），下一步教程用 Nginx 配置 HTTPS
  
• 部署完成后，用 UFW 或云防火墙关闭不必要的端口（如 3306 MySQL）
  
• 定期备份 /opt/new-api/data 目录
  

参考来源：New API GitHub 仓库 (github.com/Calcium-Ion/new-api)；Docker Compose 官方文档；New API Wiki 部署指南