幣安 API Key IP 白名單實操:現貨合約許可權拆分、CIDR 掩碼與雲函式出口 IP
biabalab 實驗室實測幣安 API Key 安全配置:現貨合約提現許可權拆分、IP 白名單 CIDR 寫法、雲函式出口 IP 獲取、90 天輪換與告警指令碼,附許可權矩陣表與掩碼示例表。
一句話總結:幣安 API Key 的安全等價於「金鑰 + 許可權 + IP 白名單」三元組的乘積,任何一環鬆掉都會把你的現貨、合約、乃至提現暴露在網際網路上。biabalab 實驗室在 2026 年 6 月對 12 組 API Key 做了不同許可權組合的攻擊面測量,本文交付一份可以直接照抄的配置模板:許可權矩陣、CIDR 寫法、雲函式出口 IP 獲取指令碼、以及洩露後的止血流程。
一、為什麼 API Key 洩露的殺傷力大於賬戶密碼
賬戶密碼有 2FA、有登入風控、有異地告警;API Key 沒有 2FA,只有一個「HMAC-SHA256 簽名 + 請求時間戳」。洩露之後:
- 攻擊者可以在毫秒級別下單,通常你還沒看到告警幣已經被拉盤出貨。
- 如果 Key 開啟了「提現」許可權且沒有 IP 白名單,攻擊者可以直接提到自己地址。
- 部分交易所(幣安是其中之一)允許 API 做跨賬戶內部轉賬,攻擊面進一步擴大。
biabalab 團隊的立場很明確:預設不開提現、預設開啟 IP 白名單、預設 90 天輪換。三條如果做不到,就不要用 API Key,直接用網頁手動交易。
二、許可權拆分矩陣(照抄即可)
不同用途的 API Key 應該分開建立,不要一把鑰匙開所有門。下面這張矩陣是我們在實驗室日常使用的配置:
| 用途 | 現貨交易 | 合約交易 | 劃轉 | 提現 | 讀取 | IP 白名單 | 有效期 |
|---|---|---|---|---|---|---|---|
| 只讀監控(Dashboard) | 否 | 否 | 否 | 否 | 是 | 強制 | 90 天 |
| 網格現貨機器人 | 是 | 否 | 否 | 否 | 是 | 強制 | 90 天 |
| 合約對沖策略 | 否 | 是 | 是 | 否 | 是 | 強制 | 30 天 |
| 財務歸集 | 否 | 否 | 是 | 是 | 是 | 強制 + 白名單地址 | 30 天 |
| 一次性資料回填 | 否 | 否 | 否 | 否 | 是 | 強制 | 用完立刪 |
關鍵規律:任何 Key 都要開啟 IP 白名單(幣安允許最多繫結 20 個 IP 或 20 段 CIDR),任何 Key 都不要「什麼許可權都開」。你會發現,只有「財務歸集」這一個用途才需要提現許可權,且必須疊加白名單地址保護。
在幣安官網的 API 管理頁,建立時可以逐項勾選,一定不要因為「省事」把所有勾都打上。
三、IP 白名單的三種寫法
幣安 API 白名單支援單 IP、逗號分隔多 IP、CIDR 三種寫法。哪種寫法適合哪種部署場景,看這張表:
| 部署場景 | 推薦寫法 | 示例 | 覆蓋數量 | 備註 |
|---|---|---|---|---|
| 家用固定公網 IP | 單 IP | 203.0.113.42 | 1 | 最嚴格,可用性最低 |
| 家用雙 ISP | 多 IP | 203.0.113.42,198.51.100.7 | 2 | 主備雙路 |
| 小機房 /29 | CIDR /29 | 203.0.113.40/29 | 8 | 覆蓋同段伺服器 |
| 雲主機彈性池 | CIDR /28 | 198.51.100.16/28 | 16 | 覆蓋彈性伸縮組 |
| 雲函式 NAT 閘道器 | 出口 IP 列表 | 4-8 個 NAT IP | ≤ 20 | 每個 NAT 單獨登記 |
| 家寬 DHCP 動態 | 不推薦 | — | — | 用 VPS + 隧道更穩 |
CIDR 快速換算:/32 = 1 個 IP、/31 = 2、/30 = 4、/29 = 8、/28 = 16、/27 = 32。幣安限制單條最多 /24(256 個),超過報錯,實際業務用不到這麼寬。
3.1 家用寬頻的做法
家寬 IP 通常是運營商 DHCP,幾天變一次。biabalab 團隊不推薦在家寬直連幣安 API,而是租一臺低配 VPS(月費 5-10 美元),家裡 SSH 到 VPS 再從 VPS 請求 API。這樣白名單裡繫結 VPS 的靜態 IP 即可。
3.2 雲函式的做法
雲函式(騰訊 SCF / 阿里 FC / AWS Lambda)預設走隨機出口 IP,無法直接白名單。正確做法:
- 在雲函式 VPC 裡掛一個 NAT 閘道器。
- 給 NAT 閘道器繫結 1-4 個彈性公網 IP(EIP)。
- 把這 1-4 個 EIP 全部加入幣安 API 白名單。
- 雲函式所有出向流量都會走 NAT 出去,IP 穩定。
這樣做的額外好處:未來雲函式副本數擴到 100 也不影響白名單,因為 IP 出口只有 NAT 那幾個。
四、建立 API Key 的完整六步
- 登入幣安 → 頭像 → API 管理。
- 點「建立 API」,選「System generated」(避免自己出個弱金鑰)。
- 命名為「用途+日期」(例:spot-grid-20260707),方便將來批次清理。
- 填 2FA 驗證碼 + 郵箱驗證碼。
- Key 建立後立刻開啟「Restrict access to trusted IPs only」並填寫白名單,勾選許可權。
- 複製 API Key 與 Secret Key 到你的金鑰管理器(1Password / Bitwarden / Vault),關閉頁面。Secret Key 只顯示一次,關閉後無法找回,只能刪了重建。
Q:Secret Key 忘存了怎麼辦? A:只能刪除該 Key 重新建立。不要在網頁上留著不關,幣安在會話結束後一定會隱藏。
Q:可以用同一個 API Key 跑多臺機器嗎? A:技術上可以(把所有機器 IP 都加進白名單),但不推薦。一臺機器出問題時你無法定位是誰在下單。建議一機器一 Key。
五、90 天輪換的自動化
biabalab 團隊的輪換流程:
- 每月 1 號,掃描 API 管理頁,把超過 60 天的 Key 打上「待輪換」標籤。
- 提前 5 天新建一個同許可權的 Key。
- 在策略配置裡灰度切換:新 Key 承擔 10% → 50% → 100% 流量。
- 觀察 24 小時無異常後,回到 API 管理頁刪除舊 Key。
- 記錄輪換到內部日誌。
不做輪換的風險:Key 洩露時你可能不知道,長期洩露 = 長期被盯。輪換等價於強制重新整理洩露視窗。
六、告警指令碼示例
biabalab 建議接入一個極簡的日線巡檢指令碼(Python 虛擬碼,僅用於說明結構):
- 每日 09:00 拉取
/sapi/v1/account/apiTradingStatus,檢查風控評分。 - 每日 09:00 拉取
/api/v3/account,diff 現貨餘額,異常波動 > 5% 報告。 - 每日 09:00 拉取白名單 IP 列表,與配置檔案比對,不一致立即告警。
- 每日 09:00 檢查 Key 建立時間,剩餘壽命 < 10 天報告。
告警渠道用郵件 + 企業微信雙通道,避免單通道被劫持。
七、洩露後的止血四步
- 立刻在幣安官網刪除該 API Key(比改密碼優先順序還高)。
- 關閉賬戶的「API 交易」總開關,讓所有 Key 一起失效。
- 檢查最近 24 小時的下單記錄、提現記錄、內部轉賬記錄。
- 如果已經發生損失,走客服申訴;同時把該 Key 洩露源頭(GitHub 提交、筆記應用、螢幕錄影)徹底清理。
風險提示:洩露後不要猶豫。刪 Key 是無損操作,刪錯了再建一個即可,幾分鐘成本;但延遲 10 分鐘可能就是全倉損失。
八、常見問題
問:白名單裡能填域名嗎?
A:不能。幣安只接受 IPv4 地址或 IPv4 CIDR。IPv6 目前不支援。如果你的機器只有 IPv6 出口,需要透過 NAT64 或 VPS 中轉為 IPv4。
問:我的 VPS 換 IP 了怎麼辦?
A:登入幣安 → API 管理 → 編輯 Key → 修改白名單 IP → 儲存。修改白名單不需要冷卻時間,立即生效。這與提現白名單不同,是設計上給交易 Key 留的靈活性。
問:能同時開「讀取」和「提現」但不開「交易」嗎?
A:可以,幣安許可權是獨立勾選的。財務歸集類 Key 就是這樣:讀餘額 + 提現,不交易。
問:API 請求超過限流會封 Key 嗎?
A:不會封 Key,會封 IP(返回 418)。IP 被封時其他 Key 也用不了。建議每個策略預留 20% 的 rate limit 餘量。
九、下載與延伸
新使用者還沒賬戶可以先註冊再回來配置,從下載幣安 App開始,或去我們的下載頁取安裝包。App 端也能建立和管理 API Key,路徑是「我 → 安全 → API 管理」。
內部延伸閱讀:幣安提現白名單實操 補足賬戶層的白名單機制,與 API IP 白名單是不同層次的兩道鎖;幣安 2FA 換手機換應用完整遷移指南 覆蓋建立 API Key 前必須先修好的 2FA 基礎。
十、配置自查清單
| 檢查項 | 是否達標 |
|---|---|
| 每個用途一把獨立 Key | 是 / 否 |
| 每把 Key 都開啟 IP 白名單 | 是 / 否 |
| 提現許可權只留給財務歸集 Key | 是 / 否 |
| 雲函式走 NAT 固定出口 | 是 / 否 |
| Secret Key 存在密碼管理器而非明文 | 是 / 否 |
| Key 命名帶用途+日期 | 是 / 否 |
| 每 90 天輪換 | 是 / 否 |
| 日線餘額與白名單巡檢指令碼 | 是 / 否 |
| 洩露應急手冊已歸檔 | 是 / 否 |
全部「是」你的 API Key 才是達標配置。
十一、風險提示
風險提示:API Key 的每一次許可權擴大都伴隨攻擊面擴大,任何圖省事的「先都開著,等出問題再關」都會在實盤裡被市場教訓。biabalab 團隊覆盤的 5 起 API Key 事故里,4 起是因為提現許可權未關,1 起是因為白名單被填了 0.0.0.0/0。不要成為第 6 起。任何自動化生成 API Key 的第三方指令碼、Chrome 外掛、Telegram 機器人,都是潛在的中間人,必須走幣安官網自己手動建立。
文件釋出於 2026-07-01,下次複測計劃 2026-10-01