new-api 本机 Docker 部署：只在 127.0.0.1 上，用官方 Key 统一管理自己的几家 API

数据来自官方和社区，未经本站实测。

手上同时有智谱、硅基流动、DeepSeek 等几家的 API Key，每个工具里都要分别填地址、填 Key、记模型名，换一家就得改一遍配置。new-api 是一个开源的自托管 AI 网关，可以把这几家收进同一个入口：工具里只填一个本机地址和一把本地密钥，后面接哪家、用哪个模型，在 new-api 的控制台里改。

这篇只写一种用法：在自己电脑上用 Docker 跑，端口只绑 127.0.0.1，只接自己在各家官方平台申请的 API Key，只给自己用。 其他用法本文不涉及。

先看几个基本信息

README 开头写明，这个项目只面向合法授权的场景，使用者必须合法取得上游 API Key，并遵守上游服务条款；面向公众提供服务的，要先完成备案、实名等一整套合规义务。本文的用法是自己的 Key 给自己用，不涉及这些。

第一步：用 Docker 启动，只监听本机

先装好 Docker。README 的「本地体验」命令用 SQLite 启动单个容器，只监听本机端口：

mkdir -p data
docker run --name new-api -d --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/data:/data" \
  calciumion/new-api:latest

几点说明：

• -p 127.0.0.1:3000:3000 不要改。前面的 127.0.0.1 表示只有这台电脑自己能访问。官方文档的 Docker 部署页和仓库里的 Compose 配置写的是 3000:3000，那样会监听所有网卡；本文的用法一律加上 127.0.0.1。
• 版本最好写死。README 提醒 latest 会随发布变化，建议从发布页选一个明确的版本。按 2026-11-12 的发布页，可以把最后一行换成 calciumion/new-api:v1.0.0-rc.49。
• 数据在 data 目录。SQLite 数据库就存在挂载的 data 目录里，删掉容器重建也不会丢。
• 时区：TZ 只影响容器里显示的时间，按自己所在地区改就行，比如首尔是 Asia/Seoul。

确认容器在跑：

docker ps --filter name=new-api
docker logs --tail 50 new-api

官方文档写明，SQLite 适合本地体验和临时测试，正式的多人使用推荐 PostgreSQL。自己一个人在本机用，SQLite 就够了。

第二步：初始化管理员账号

浏览器打开 http://127.0.0.1:3000，按初始化向导创建管理员账号和密码。只有第一次安装需要这一步。

因为端口只绑在 127.0.0.1，别的设备打不开这个页面。系统设置里还有「允许新用户注册」这类登录注册选项，只自己用的话可以不开。

第三步：添加渠道，只填各家官方 Key

new-api 里，一条「渠道」对应一家服务商的一个 API Key。按渠道管理文档：

1. 用管理员账号登录，左侧导航点「渠道」，再点「添加渠道」。
2. 选择服务商类型，填渠道名称和 API Key。
3. 在模型列表里勾选这条渠道要用的模型，或者点「填入默认模型」。
4. 点「提交」保存，然后在列表里点「测试」，看响应时间和是否成功。

选类型时注意两点：

• 按官方平台选类型。仓库源码里内置了智谱（v4 接口）、硅基流动、阿里、DeepSeek、火山引擎、Moonshot 等类型，并带着它们的官方接口地址，选对类型一般不用改地址。类型列表里也有一些第三方转发平台，本文只用各家官方平台对应的类型。控制台里各类型显示的中文名称，以界面为准。
• Key 去官方平台申请。比如智谱的免费模型 GLM-4.7-Flash，在智谱开放平台创建标准 API Key，选智谱类型，模型填 glm-4.7-flash。怎么拿 Key、哪些模型免费，见文末的站内推荐。

第四步：模型价格和本地额度

这一步最容易卡住。new-api 自带一套内部记账：每次调用会按模型的倍率换算成「配额点数」扣减，文档写明 1 美元记 500,000 点。这只是 new-api 在本机记的账，和你在各家官方平台的实际扣费是两回事。官方免费模型在官方那边照样不收钱，收不收费以各家官方定价页为准。

• README 的第一次请求步骤里写着：先配置模型价格，并确保调用的用户有可用额度。
• 没设置倍率的模型，倍率设置文档写的是：自用模式下按默认倍率 37.5 记账；计费模式下会提示「倍率或价格未配置」。
• 自用模式在控制台哪里打开，文档没有写清楚，待核实。也可以直接在倍率设置里，给要用的模型设一个倍率。
• 管理员账号初始化后默认有多少本地额度，文档没写，待核实。

第五步：创建本地密钥，在工具里使用

工具里填的不是各家官方 Key，而是 new-api 自己签发的密钥。按 API 密钥文档：

1. 左侧导航点「API 密钥」，点「创建 API 密钥」。
2. 填一个名称，按用途区分，比如「写作工具」「本地脚本」。
3. 按需设置额度、过期时间和模型限制。只给某个工具用的密钥，可以把模型限制成它要用的那几个。
4. 保存后在列表里复制完整密钥。

文档提醒，这把密钥等同于密码，不要提交到代码仓库、截图或聊天记录里；怀疑泄露就删掉重建。

把它放进环境变量，先查一下能用哪些模型：

export NEW_API_KEY="new-api 里创建的密钥"
curl --fail-with-body http://127.0.0.1:3000/v1/models \
  -H "Authorization: Bearer ${NEW_API_KEY}"

再发一次对话请求（模型名换成你在渠道里启用的模型）：

curl --fail-with-body http://127.0.0.1:3000/v1/chat/completions \
  -H "Authorization: Bearer ${NEW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"model":"glm-4.7-flash","messages":[{"role":"user","content":"你好"}]}'

支持 OpenAI 兼容接口的工具，基础地址填 http://127.0.0.1:3000/v1，密钥填 new-api 签发的这把。README 列出的入口还包括 Responses、Anthropic Messages 和 Gemini 格式，不同格式之间能不能完整互转，README 写明取决于渠道、上游模型和转换路径。

升级和备份

升级：按系统更新文档，先备份数据，再看发布说明，然后拉新镜像、删旧容器、用相同的参数重新启动：

docker pull calciumion/new-api:latest
docker stop new-api
docker rm new-api
docker run --name new-api -d --restart unless-stopped \
  -p 127.0.0.1:3000:3000 \
  -e TZ=Asia/Shanghai \
  -v "$(pwd)/data:/data" \
  calciumion/new-api:latest

如果启动时写死了版本号，把两处 latest 都换成新版本号。重新启动时要在原来的目录下执行，保证挂载的还是原来那个 data 目录。

备份：数据都在 data 目录。v1.0.0-rc.49 的发布说明写明，SQLite 开启了 WAL，数据库旁边会有 -wal 和 -shm 两个文件，备份时要和数据库一起复制。建议先停掉容器，再整个复制 data 目录。

停用：不想用了，docker stop new-api 停掉；彻底删除用 docker rm new-api，再自己处理 data 目录。

许可证

new-api 用的是 AGPL-3.0。站内的 new-api 对比文是这样理解的：只改配置、不改源码，自己在本机用，一般不涉及额外义务；修改源码后通过网络向别人提供服务，才需要公开修改后的源码。这只是简要说明，不构成法律意见，具体以协议原文为准。

小结

• new-api 是开源的自托管 AI 网关，2026-11-12 读到的最新发布是 v1.0.0-rc.49（候选版），许可证 AGPL-3.0，以协议原文为准。
• 本机用 README 的 Docker 命令，端口写成 127.0.0.1:3000:3000，只有自己这台电脑能访问；版本建议写死。
• 渠道只填各家官方平台申请的 Key，选对应的官方类型；工具里填的是 new-api 签发的本地密钥。
• 内部记账和官方扣费是两回事；没设倍率的模型可能报「倍率或价格未配置」，自用模式开关位置待核实。
• 升级前先备份，用相同参数重建容器；备份时连同 -wal、-shm 文件一起复制。

站内推荐

• 不用云端 API、在自己电脑上跑模型：Ollama、LM Studio、llama.cpp 怎么选：在自己电脑上跑大模型的三个工具对比
• 智谱哪些模型免费、怎么拿官方 Key：智谱免费模型 API 怎么调（2026）：GLM-4.7-Flash、视觉 Flash 和生图生视频
• 硅基流动标「免费」的模型清单：硅基流动免费模型有哪些（2026）：文本、生图、向量一张表
• 各家免费文本模型一张表：国内大模型 API 免费额度一张表（2026）
• 免费额度用完会不会扣费：免费额度用完会扣费吗：百炼「用完即停」、火山「安心体验」怎么开
• 更多本地部署文章：部署与实验