如何快速部署 New API：新一代大模型网关与AI资产管理系统完整指南 🚀

New API 是基于 One API 二次开发的新一代大模型网关与 AI 资产管理系统，专为开发者打造高效、灵活的 API 管理解决方案。本文将带你快速掌握部署技巧，零基础也能轻松上手！

🌟 为什么选择 New API？核心功能亮点

New API 凭借强大的功能和友好的界面，成为开发者管理 AI 接口的首选工具。以下是它的核心优势：

New API 功能架构示意图，展示多模型集成与流量管理能力

• 🎨 全新 UI 界面：直观易用的控制台，数据可视化一目了然
• 🌍 多语言支持：覆盖中文、英文、日文等主流语言
• 💰 灵活计费系统：支持按次收费、渠道加权随机分配
• 🔄 兼容 One API 数据库：无缝迁移历史数据，降低切换成本
• 🔒 安全权限管理：令牌分组、模型访问限制，保障 API 安全

扩展能力：支持 Midjourney、Suno 等第三方模型，兼容 OpenAI Realtime API 和 Claude Messages 格式，满足多样化场景需求。

📋 部署前必备：环境与资源准备

部署 New API 前，请确保你的服务器满足以下条件：

🔧 硬件要求

• CPU：2核及以上
• 内存：4GB RAM（推荐8GB）
• 存储：至少 20GB 可用空间

📦 软件依赖

• Docker 环境（推荐使用 Docker Compose 简化部署）
• MySQL 5.7.8+ 或 PostgreSQL 9.6+（可选，默认使用 SQLite）

服务器配置检查清单，确保部署环境符合要求

🚀 3 种部署方式：从新手到专家

1️⃣ 宝塔面板一键部署（推荐新手）

步骤 1：安装宝塔面板 9.2.0+ 版本，在应用商店搜索「New-API」
步骤 2：点击「安装」，等待自动配置完成
步骤 3：访问服务器 IP:3000，使用默认账号密码登录

详细图文教程：docs/installation/BT.md

2️⃣ Docker Compose 部署（推荐生产环境）

# 克隆仓库
git clone https://gitcode.com/gh_mirrors/ne/new-api.git
cd new-api

# 编辑配置文件（可选）
nano docker-compose.yml

# 启动服务
docker-compose up -d

关键配置项：

• ports: 端口映射（默认 3000:3000）
• volumes: 数据持久化挂载（必填 /data 目录）
• environment: 环境变量（如 SESSION_SECRET 用于多机部署）

3️⃣ 手动编译部署（开发者适用）

# 安装 Go 1.21+
go mod download
go build -o new-api main.go

# 启动服务
./new-api --config config.yaml

Docker Compose 部署流程图，清晰展示容器启动流程

⚙️ 核心配置：解锁高级功能

🔑 环境变量设置

变量名	作用	默认值
GENERATE_DEFAULT_TOKEN	新用户自动生成令牌	false
REDIS_CONN_STRING	Redis 缓存连接地址	空（禁用）
CRYPTO_SECRET	Redis 数据加密密钥	空
ERROR_LOG_ENABLED	启用错误日志记录	false

安全提示：多机部署时必须设置 SESSION_SECRET 和 CRYPTO_SECRET，避免登录状态异常和数据泄露。

📊 数据看板配置

通过 config.yaml 自定义控制台显示项：

dashboard:
  show_usage_trend: true
  show_channel_status: true
  refresh_interval: 30 # 秒

🧩 功能模块解析：目录结构速览

new-api/
├── common/        # 通用工具函数
├── controller/    # HTTP 请求处理
├── model/         # 数据模型定义
├── relay/         # 模型中继服务
├── router/        # 路由配置
└── web/           # 前端界面

• 核心模块：relay/channel/ 封装了各模型适配逻辑，如 gemini/、claude/
• 配置中心：setting/operation_setting/ 管理计费、限流等运营参数

❓ 常见问题与解决方案

🚫 服务启动失败

• 检查日志：docker logs new-api 查看错误信息
• 端口冲突：修改 docker-compose.yml 中的 ports 映射

📈 性能优化建议

• 启用 Redis 缓存：设置 REDIS_CONN_STRING 提升响应速度
• 数据库索引：对 tokens 和 usage 表添加索引优化查询

🛡️ 安全加固

• 定期更新镜像：docker pull calciumion/new-api:latest
• 限制容器权限：通过 docker-compose.yml 的 cap_drop 移除不必要能力

New API 故障排除流程图，快速定位常见问题

🎯 总结：开启 AI 网关高效管理之旅

New API 作为 One API 的增强版，不仅继承了原版的稳定可靠，更通过全新 UI、多模型支持和灵活计费系统，成为 AI 资产管理的理想选择。无论是个人开发者还是企业团队，都能通过本文的部署指南快速搭建属于自己的 API 网关。

立即行动：

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/ne/new-api.git
2. 参考部署步骤启动服务
3. 访问 docs/official.md 获取更多高级配置教程

让 New API 助力你的 AI 应用开发，轻松管理各类模型资源！ 🚀