搬瓦工 VPS 部署 New API 代理中转服务教程

New API 是基于 One API 二次开发的大模型 API 管理和代理中转平台，在原有功能基础上增加了更多实用特性。它同样提供 OpenAI 兼容的统一接口，支持将多个不同的 AI 模型提供商聚合在一起，通过单一 API 端点对外提供服务。New API 在界面美化、功能增强和稳定性方面做了大量改进。

一、New API 与 One API 的区别

New API 在 One API 基础上增加了以下特性：

界面优化：更现代化的管理界面和仪表盘。
更多渠道：支持更多模型提供商和 API 格式。
计费增强：更精细的计费策略和倍率设置。
日志改进：更详细的请求日志和错误追踪。
缓存功能：支持请求缓存减少上游调用。
模型映射：灵活的模型名称映射配置。

二、环境要求

操作系统：Ubuntu 20.04 或更高版本。
内存：至少 512MB。
Docker：需要 Docker 环境。

部署前需安装 Docker，参考 Docker 安装教程。选购 VPS 请参考全部方案。

三、Docker 部署

3.1 快速部署（SQLite）

mkdir -p /opt/new-api/data

docker run -d \
  --name new-api \
  -p 3300:3000 \
  -v /opt/new-api/data:/data \
  -e TZ=Asia/Shanghai \
  -e SQL_DSN= \
  --restart unless-stopped \
  calciumion/new-api:latest

3.2 Docker Compose 部署

mkdir -p /opt/new-api && cd /opt/new-api

cat > docker-compose.yml <<'EOF'
version: '3.8'
services:
  new-api:
    image: calciumion/new-api:latest
    ports:
      - "3300:3000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=
      - REDIS_CONN_STRING=
      - SESSION_SECRET=your_random_secret_key_here
      - MEMORY_CACHE_ENABLED=true
      - STREAMING_TIMEOUT=60
    restart: unless-stopped
EOF

docker compose up -d

3.3 使用 MySQL + Redis（生产环境）

cat > docker-compose-prod.yml <<'EOF'
version: '3.8'
services:
  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: new_api
      MYSQL_USER: newapi
      MYSQL_PASSWORD: newapi_password
    volumes:
      - mysql_data:/var/lib/mysql
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    restart: unless-stopped

  redis:
    image: redis:7-alpine
    volumes:
      - redis_data:/data
    restart: unless-stopped

  new-api:
    image: calciumion/new-api:latest
    ports:
      - "3300:3000"
    volumes:
      - ./data:/data
    environment:
      - TZ=Asia/Shanghai
      - SQL_DSN=newapi:newapi_password@tcp(mysql:3306)/new_api
      - REDIS_CONN_STRING=redis://redis:6379
      - SESSION_SECRET=your_production_secret
      - MEMORY_CACHE_ENABLED=true
    depends_on:
      - mysql
      - redis
    restart: unless-stopped

volumes:
  mysql_data:
  redis_data:
EOF

docker compose -f docker-compose-prod.yml up -d

四、初始配置

访问 http://your-ip:3300，使用默认管理员账号登录：

用户名：root
密码：123456

登录后务必修改默认密码，然后进入系统设置完成基础配置。

五、配置渠道

渠道是连接上游 API 的核心配置。在渠道管理页面添加不同的提供商：

# 本地模型渠道配置示例
类型: OpenAI
名称: Local-Llama
Base URL: http://host.docker.internal:8080
Key: not-needed
模型: 勾选或手动填写本地模型名称

# 多个渠道可以对应同一个模型，实现负载均衡和故障转移

六、令牌和用户管理

New API 提供了灵活的令牌管理功能：

创建令牌：为每个应用或用户创建独立的 API 令牌。
设置额度：为令牌设置使用额度上限。
模型权限：指定令牌可以访问哪些模型。
IP 白名单：限制令牌只能从特定 IP 地址使用。

七、模型映射

New API 支持灵活的模型名称映射，可以将自定义模型名映射到实际的上游模型：

# 在渠道设置中配置模型映射
# 当下游请求 gpt-3.5-turbo 时，实际转发到本地模型
gpt-3.5-turbo: local-model-name

八、Nginx 反向代理

cat > /etc/nginx/sites-available/new-api <<'EOF'
server {
    listen 80;
    server_name api.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:3300;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_buffering off;
        proxy_read_timeout 300;
    }
}
EOF
ln -s /etc/nginx/sites-available/new-api /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx

九、对接下游应用

# 使用 New API 令牌调用
curl https://api.yourdomain.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-new-api-token" \
  -d '{
    "model": "gpt-3.5-turbo",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": true
  }'

所有支持 OpenAI API 的客户端都可以直接对接，包括 ChatGPT Next Web、Open WebUI 和 LobeChat 等。

十、监控和日志

New API 提供了详细的日志和监控功能：

请求日志：记录每次 API 调用的详细信息。
用量统计：按用户、令牌和模型统计使用量。
渠道状态：实时监控各渠道的可用性。
错误追踪：记录失败请求的错误信息。

十一、更新和备份

# 更新 New API
cd /opt/new-api
docker compose pull
docker compose up -d

# 备份数据
cp /opt/new-api/data/one-api.db /opt/backups/new-api-$(date +%Y%m%d).db

十二、常见问题

流式输出中断

确认 Nginx 配置中关闭了 proxy_buffering，并设置了足够的超时时间。

渠道优先级

多个渠道支持同一模型时，New API 按优先级和权重进行调度。可以在渠道设置中调整优先级数值。

总结

New API 在 One API 基础上提供了更丰富的功能和更好的使用体验，是搭建 AI API 网关的优秀选择。通过搬瓦工 VPS 的海外网络优势，可以流畅地代理各种国际 AI 服务。选购搬瓦工 VPS 请查看全部方案，使用优惠码 NODESEEK2026 可享受 6.77% 的折扣，购买链接：bwh81.net。