告別各大AI平臺APIKey！星哥教你用一鍵搭建AI模型聚合中心

你是不是也跟我一樣：玩AI大模型久了，電腦備忘錄和NAS里塞滿了千問、智譜、DeepSeek、硅基流動……各個平臺的 API Key？

每次想換個模型測試，都要切后臺、找密鑰、復制粘貼，不僅繁瑣，還容易泄露或搞混。

直到星哥在 GitHub 上挖到了這款神器——New-API。 今天手把手教你，用 Docker 在 NAS 上搭建屬于自己的"AI模型聚合網(wǎng)關(guān)"。一個 Key，打通全網(wǎng)大模型，調(diào)用效率直接翻倍！跟星哥之前搭建的Sub2api有區(qū)別的,

New-API 是個啥？

簡單說，它就是一個"AI接口中轉(zhuǎn)站"。

作為國內(nèi)開源社區(qū)（QuantumNous 團隊）的熱門項目，New-API 支持將各家大模型的原始接口，統(tǒng)一轉(zhuǎn)換為OpenAI / Claude / Gemini 兼容格式。無論是個人玩家還是小團隊，都能把它當成集中管理密鑰、分配額度、監(jiān)控調(diào)用的超級面板。

? 一個入口，調(diào)用多平臺模型

? 統(tǒng)一密鑰格式，無縫對接主流 AI 客戶端

? 自帶用量統(tǒng)計、渠道測試、權(quán)重分配等實用功能

數(shù)據(jù)看板如下圖

一、部署方案

官方文檔提供多種的部署方案，Docker Compose 部署、Docker 部署、1Panel 面板部署、寶塔面板部署等等。

可以按照實際的情況部署，星哥用Docker Compose 部署、寶塔來演示

二、Docker 一鍵部署（NAS/服務(wù)器通用）

只要你的設(shè)備安裝了 Docker 和 Compose 組件，就能直接跑。下面以星哥常用的 NAS 環(huán)境為例，全程不到 5 分鐘。

1.創(chuàng)建目錄結(jié)構(gòu)

在 Docker 工作區(qū)新建一個new-api文件夾，內(nèi)部再建三個子目錄，方便后續(xù)數(shù)據(jù)持久化：

mkdir -p new-api/mysql_data
mkdir -p new-api/data
mkdir -p new-api/logs

文件夾目錄作用

new-api/
├── mysql_data/   # 數(shù)據(jù)庫文件
├── data/         # 應用配置
└── logs/         # 運行日志

打開 Docker 管理面板 → 新建項目 → 路徑指向new-api文件夾 → 粘貼以下代碼（星哥已優(yōu)化注釋，開箱即用）：

# 下載項目源碼
git clone https://github.com/QuantumNous/new-api.git

 # 進入項目目錄
cd new-api

 # 根據(jù)需要編輯 docker-compose.yml 文件
# 使用nano編輯器
nano docker-compose.yml
# 或使用vim編輯器
# vim docker-compose.yml

星哥提醒：SESSION_SECRET、CRYPTO_SECRET 及數(shù)據(jù)庫密碼建議替換為自定義強密碼，生產(chǎn)環(huán)境更安全。確認無誤后點擊部署，喝杯咖啡的功夫（約2分鐘），服務(wù)即啟動完成。

項目

要求

寶塔面板

≥ 9.2.0 版本

推薦系統(tǒng)

CentOS 7+、Ubuntu 18.04+、Debian 10+

服務(wù)器配置

至少 1 核 2G 內(nèi)存

2.安裝寶塔面板

1. 1. 前往 寶塔面板官網(wǎng)下載適合您系統(tǒng)的安裝腳本

2. 2. 運行安裝腳本安裝寶塔面板

3. 3. 安裝完成后，使用提供的地址、用戶名和密碼登錄寶塔面板

1. 1. 登錄寶塔面板后，在左側(cè)菜單欄找到并點擊Docker

2. 2. 首次進入會提示安裝 Docker 服務(wù)，點擊立即安裝

3. 3. 按照提示完成 Docker 服務(wù)的安裝

打開寶塔應用商店

在寶塔面板 Docker 功能中，點擊應用商店，搜索并找到New-API

點擊安裝

1. 1. 配置以下基本選項：

• ?容器名稱：可自定義，默認為new-api

• ?端口映射：默認為3000:3000

• ? 環(huán)境變量：

• • ?SESSION_SECRET：會話密鑰（必填，多機部署時必須一致）

• ?目錄映射：確保將/data目錄映射到主機目錄

2. 點擊確認開始安裝

等待安裝完成后，使用域名訪問，或者使用http://您的服務(wù)器IP:3000（端口要放開）即可使用

5.申請SSL證書

點擊管理網(wǎng)站、SSL、免費證書，申請證書即可。

6.首次配置New API

這里配置數(shù)據(jù)庫檢查、管理員賬號、使用模式、完成初始化

搭建完成

四、環(huán)境變量配置 必要環(huán)境變量

變量名

是否必填

SESSION_SECRET

會話密鑰，多機部署必須一致

必填CRYPTO_SECRET

加密密鑰，使用 Redis 時必填

條件必填

SQL_DSN

數(shù)據(jù)庫連接字符串（使用外部數(shù)據(jù)庫時）

可選

REDIS_CONN_STRING

Redis 連接字符串

可選

生成隨機密鑰

# 生成 SESSION_SECRETopenssl rand -hex 16# 或使用 Linux 命令head -c 16 /dev/urandom | xxd -p

1. 1. 檢查服務(wù)器防火墻是否開放 3000 端口

2. 2. 在寶塔面板安全中放行 3000 端口

3. 3. 檢查云服務(wù)器安全組是否開放端口

確保設(shè)置了SESSION_SECRET環(huán)境變量，且值不為空。

3.數(shù)據(jù)如何持久化

使用 Docker 卷映射數(shù)據(jù)目錄：

volumes:  - ./data:/data

# 拉取最新鏡像docker pull calciumion/new-api:latest# 使用 Docker Compose 重啟docker-compose down && docker-compose up -d# 或使用寶塔容器管理重啟容器

左側(cè)菜單進入【渠道管理】→【添加渠道】。以硅基流動為例：

• ? 類型選擇SiliconCloud

• ? 填入對應平臺的 API Key

• ? 點擊獲取模型列表，勾選你想接入的模型（建議先挑 2~3 個輕量模型測試）

• ? 提交保存

自定義模型名稱，

模型可以到硅基流動的模型廣場中復制

deepseek-ai/DeepSeek-V4-Flash
Pro/moonshotai/Kimi-K2.6
等等

右側(cè)渠道列表會出現(xiàn)新記錄，點擊測試。看到狀態(tài)全綠，說明接口已調(diào)通！

2.令牌管理

配置令牌，相當于就是APIKey，點擊左側(cè)的令牌管理，填好名稱，直接提交令牌就生成就好了。

七、使用

模型接好了，怎么讓其他 AI 軟件識別？答案在【令牌管理】。

1. 
   

   1. 點擊左側(cè)【令牌管理】→ 新建令牌 → 填寫名稱 → 提交。

2. 2. 系統(tǒng)會生成一段連接信息，格式如下：

{
  "_type": "newapi_channel_conn",
  "key": "sk-xxxxxx",
  "url": "http://localhost:3000"
}

1. 3. ??關(guān)鍵一步：將url中的端口3000替換為你實際映射的端口（如星哥用的3000）。修改后如下：

{
  "_type": "newapi_channel_conn",
  "key": "sk-xxxxxx",
  "url": "我的域名接口"
}

現(xiàn)在，這組key+url就是你的"AI萬能鑰匙"。
打開任意支持 OpenAI 格式的客戶端（如 NextChat、Chatbox、OpenClaw 等），填入自定義 API 地址和 Key，即可自由切換不同大模型。

星哥實測：在終端運行 openclaw models list，所有接入的模型瞬間列隊待命。切換模型無需改配置，體驗極其絲滑。

我這里使用Cherry Studio，試試能不能用。

Pro/moonshotai/Kimi-K2.6

配置

總結(jié)

除了基礎(chǔ)的路由轉(zhuǎn)發(fā)，New-API 還內(nèi)置了對話面板、渠道負載均衡、額度限制、請求日志等進階玩法，足夠你慢慢折騰。

對于喜歡追蹤各家新模型、又嫌密鑰管理麻煩的 AI 玩家來說，絕對是提升幸福感的"基建型"工具。

• ? New-API GitHub: https://github.com/QuantumNous/new-api

你的 NAS 里還缺哪個實用容器？或者部署時遇到端口沖突、數(shù)據(jù)庫連不上等坑？ 歡迎在評論區(qū)留言，星哥幫你在線排雷。

點贊 + 關(guān)注【星哥玩云】，下期帶你解鎖更多 云服務(wù)與 AI 的硬核聯(lián)動玩法！