❤️❤️❤️❤️❤️❤️ 我们已经正式推出微信小程序，在微信中搜索 TrendForge Pro 即可使用小程序，如果使用 Telegram 请搜索 trendforge_tg ❤️❤️❤️❤️❤️❤️
New API 5分钟快速开始
New API 是一款基于 Go 的 LLM 网关与 AI 资产管理系统，支持统一管理 OpenAI、Claude 等多模型 API，通过 Docker 快速部署，访问 http://localhost:3000 即可使用。
环境要求
支持的操作系统
运行环境
所需工具
容器编排
操作步骤
创建项目目录
在本地创建一个新目录用于存放 New API 数据。
mkdir new-api && cd new-api预期结果：：无输出，目录创建成功。
建议在用户主目录下操作。
启动 New API（使用 Docker 命令）
使用 Docker 运行 New API 容器，挂载数据目录并映射端口。
docker run -d --name new-api -p 3000:3000 -v ./data:/data calciumion/new-api:latest预期结果：：返回容器 ID（如 abc123...），表示容器已启动。
若使用 Docker Compose，可创建 docker-compose.yml 后执行 docker compose up -d。
验证容器运行状态
检查容器是否正常运行。
docker ps --filter name=new-api预期结果：：显示 new-api 容器，STATUS 为 Up 状态。
若容器未运行，使用 docker logs new-api 查看日志。
访问 Web 界面
打开浏览器访问 New API 管理后台。
预期结果：：浏览器显示 New API 登录页面。
默认账号 root，密码 123456，首次登录后请立即修改。
验证成功
成功访问 http://localhost:3000 并看到登录页面，表示部署完成。
快速提示
数据持久化：确保 -v ./data:/data 挂载正确，否则重启后数据丢失。
首次登录：默认账号 root，密码 123456，请立即修改。
添加渠道：登录后进入「渠道」页面，添加你的 OpenAI/Claude API Key。
常见问题
端口 3000 被占用
修改 -p 参数，例如 -p 3001:3000，然后访问 http://localhost:3001。
容器启动后立即退出
执行 docker logs new-api 查看错误日志，常见原因是 /data 目录权限问题，可尝试 chmod 777 ./data。
登录后页面空白或报错
检查浏览器控制台网络请求，确认后端接口是否正常；尝试清除浏览器缓存或使用无痕模式。
下一步
配置上游 API 渠道
登录后台，在「渠道」页面添加你的 OpenAI、Claude 等 API Key。
创建令牌
在「令牌」页面生成访问令牌，用于客户端调用统一 API。
查看文档
阅读官方文档了解高级功能：https://deepwiki.com/QuantumNous/new-api
相关项目推荐
ollama/ollama
开始使用OpenAI gpt-oss、DeepSeek-R1、Gemma 3及其他模型。
avelino/awesome-go
一份精选的Go语言优秀框架、库及软件列表
golang/go
Go 编程语言
kubernetes/kubernetes
生产级容器调度与管理平台
fatedier/frp
一款快速反向代理，可帮助您将NAT或防火墙后的本地服务器暴露至互联网。
gin-gonic/gin
Gin 是一个用 Go (Golang) 编写的 HTTP Web 框架。它提供了类似 Martini 的 API，但性能更优——速度提升高达 40 倍。如果您需要出色的性能，请使用 Gin。