Sub2API 部署教程：搭建 AI API 中轉站服務器

先說結論

如果你想自己搭一個可用的中轉站，Sub2API 這類開源項目通常就夠用了。最核心的流程很簡單：先準備一臺 Linux 服務器，再把服務部署上去，完成數據庫和管理員初始化，最後把對外的 Base URL 和 API Key 發給使用者。

適合什麼場景

Sub2API 更適合這幾類人：

• 想把多個上游賬號統一管理
• 想給團隊成員分發統一的 API Key
• 想自己控制充值、權限和轉發規則
• 想先跑一個可用的私有中轉，而不是立刻上覆雜平臺

如果你只是想臨時測試一個接口，也可以先用它的演示環境理解流程，但正式使用還是建議自己部署。

部署前準備

部署前先準備三樣東西：

1. 一臺 Linux 雲服務器，推薦 AMD64 或 ARM64 架構
2. PostgreSQL 和 Redis，或者直接用 Docker Compose 一起帶上
3. 一個能正常解析到服務器的域名，方便後續接證書和訪問面板

如果你打算反向代理到 Nginx，記得在 http 段開啟 underscores_in_headers on;，否則某些多賬號場景會出問題。

推薦部署方式

Sub2API 官方文檔裡更推薦兩種方式：

• 一鍵腳本安裝：適合快速上線，腳本會自動下載二進制、創建服務和初始化目錄
• Docker Compose：適合你想更清楚地控制數據目錄、遷移和備份

如果你是第一次搭，Docker 方式通常更直觀；如果你偏生產環境和 systemd 管理，腳本安裝也很順手。

方式一：Docker 部署

大致流程是：

mkdir -p sub2api-deploy && cd sub2api-deploy
curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/docker-deploy.sh | bash
docker compose up -d

腳本通常會幫你準備：

• docker-compose.local.yml
• .env
• 安全密鑰
• 本地數據目錄

這樣後續遷移服務器時，也更容易把整套數據一起打包走。

如果你想看運行狀態，可以繼續執行：

docker compose logs -f sub2api

方式二：腳本安裝

如果你更習慣直接跑 systemd 服務，可以用官方的一鍵安裝腳本。它會把程序裝到服務器上，再創建服務和初始化嚮導。

curl -sSL https://raw.githubusercontent.com/Wei-Shaw/sub2api/main/deploy/install.sh | sudo bash

裝完後通常會在 http://服務器IP:8080 打開初始化頁面，繼續配置數據庫、Redis 和管理員賬號。

初始化時要看什麼

初始化面板裡，優先確認這幾件事：

• 數據庫是否連通
• Redis 是否正常
• 管理員賬號是否創建成功
• 端口是否對外開放
• 域名和反代是否已經接好

如果你打算給別人一起用，最好在初始化階段就把管理員和普通用戶的邊界想清楚，別後面再返工。

接入使用者

面板跑起來之後，你就可以把這兩個東西交給使用者：

• Base URL
• API Key

使用者在 Claude Code、Codex、Cursor 或其他兼容工具裡填上這兩個信息，就能把請求打到你的中轉站，再由中轉站轉發到上游服務。

這類中轉站的本質

你可以把它理解成一個“中間層”：

用戶先把請求發給你的中轉站，中轉站再根據你配置的上游賬號、模型和規則，把請求轉出去。這樣你就能統一管理賬號、權限、計費和分發方式。

常見坑

• Nginx 頭被吞：如果用了反向代理，注意保留下劃線請求頭
• 數據庫或 Redis 沒起：初始化面板能打開，不代表後端依賴都正常
• 域名沒配好：面板能訪問，不代表對外 API 地址也能正確調用
• 賬號授權失敗：通常先檢查瀏覽器、代理和回調地址，再看上游賬號狀態

結尾

如果你是第一次搭中轉站，別一開始就把結構做得很複雜。先跑通一個最小可用版本，確認面板、賬號、轉發和調用都正常，再慢慢補域名、證書、代理和更多上游賬號。