幣安 API Key IP 白名單實操:現貨合約許可權拆分、CIDR 掩碼與雲函式出口 IP

biabalab 實驗室實測幣安 API Key 安全配置:現貨合約提現許可權拆分、IP 白名單 CIDR 寫法、雲函式出口 IP 獲取、90 天輪換與告警指令碼,附許可權矩陣表與掩碼示例表。

發佈於 2026-07-08 · 約 9 分鐘 · 安全設定

一句話總結:幣安 API Key 的安全等價於「金鑰 + 許可權 + IP 白名單」三元組的乘積,任何一環鬆掉都會把你的現貨、合約、乃至提現暴露在網際網路上。biabalab 實驗室在 2026 年 6 月對 12 組 API Key 做了不同許可權組合的攻擊面測量,本文交付一份可以直接照抄的配置模板:許可權矩陣、CIDR 寫法、雲函式出口 IP 獲取指令碼、以及洩露後的止血流程。

一、為什麼 API Key 洩露的殺傷力大於賬戶密碼

賬戶密碼有 2FA、有登入風控、有異地告警;API Key 沒有 2FA,只有一個「HMAC-SHA256 簽名 + 請求時間戳」。洩露之後:

  1. 攻擊者可以在毫秒級別下單,通常你還沒看到告警幣已經被拉盤出貨。
  2. 如果 Key 開啟了「提現」許可權且沒有 IP 白名單,攻擊者可以直接提到自己地址。
  3. 部分交易所(幣安是其中之一)允許 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,無法直接白名單。正確做法:

  1. 在雲函式 VPC 裡掛一個 NAT 閘道器。
  2. 給 NAT 閘道器繫結 1-4 個彈性公網 IP(EIP)。
  3. 把這 1-4 個 EIP 全部加入幣安 API 白名單。
  4. 雲函式所有出向流量都會走 NAT 出去,IP 穩定。

這樣做的額外好處:未來雲函式副本數擴到 100 也不影響白名單,因為 IP 出口只有 NAT 那幾個。

四、建立 API Key 的完整六步

  1. 登入幣安 → 頭像 → API 管理。
  2. 點「建立 API」,選「System generated」(避免自己出個弱金鑰)。
  3. 命名為「用途+日期」(例:spot-grid-20260707),方便將來批次清理。
  4. 填 2FA 驗證碼 + 郵箱驗證碼。
  5. Key 建立後立刻開啟「Restrict access to trusted IPs only」並填寫白名單,勾選許可權。
  6. 複製 API Key 與 Secret Key 到你的金鑰管理器(1Password / Bitwarden / Vault),關閉頁面。Secret Key 只顯示一次,關閉後無法找回,只能刪了重建。

Q:Secret Key 忘存了怎麼辦? A:只能刪除該 Key 重新建立。不要在網頁上留著不關,幣安在會話結束後一定會隱藏。

Q:可以用同一個 API Key 跑多臺機器嗎? A:技術上可以(把所有機器 IP 都加進白名單),但不推薦。一臺機器出問題時你無法定位是誰在下單。建議一機器一 Key。

五、90 天輪換的自動化

biabalab 團隊的輪換流程:

  1. 每月 1 號,掃描 API 管理頁,把超過 60 天的 Key 打上「待輪換」標籤。
  2. 提前 5 天新建一個同許可權的 Key。
  3. 在策略配置裡灰度切換:新 Key 承擔 10% → 50% → 100% 流量。
  4. 觀察 24 小時無異常後,回到 API 管理頁刪除舊 Key。
  5. 記錄輪換到內部日誌。

不做輪換的風險:Key 洩露時你可能不知道,長期洩露 = 長期被盯。輪換等價於強制重新整理洩露視窗。

六、告警指令碼示例

biabalab 建議接入一個極簡的日線巡檢指令碼(Python 虛擬碼,僅用於說明結構):

  1. 每日 09:00 拉取 /sapi/v1/account/apiTradingStatus,檢查風控評分。
  2. 每日 09:00 拉取 /api/v3/account,diff 現貨餘額,異常波動 > 5% 報告。
  3. 每日 09:00 拉取白名單 IP 列表,與配置檔案比對,不一致立即告警。
  4. 每日 09:00 檢查 Key 建立時間,剩餘壽命 < 10 天報告。

告警渠道用郵件 + 企業微信雙通道,避免單通道被劫持。

七、洩露後的止血四步

  1. 立刻在幣安官網刪除該 API Key(比改密碼優先順序還高)。
  2. 關閉賬戶的「API 交易」總開關,讓所有 Key 一起失效。
  3. 檢查最近 24 小時的下單記錄、提現記錄、內部轉賬記錄。
  4. 如果已經發生損失,走客服申訴;同時把該 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