幣安 API Key 建立與 IP 白名單繫結實操

從零建立幣安 API Key 並繫結 IP 白名單的完整流程:許可權勾選、IPv4 段 203.0.113.0/24 寫法、90 天到期輪換機制以及金鑰洩露時的應急步驟,全部一次講透。

發布於 2026-07-13 · 約 10 分鐘 · 真偽辨識

在幣安建立 API Key 的正確順序是:先登入並完成 2FA、進入「賬戶 → API 管理」頁面 → 新建 API 並命名 → 立即勾選 IP 白名單並填入你的固定出網 IPv4 段(例如 203.0.113.0/24)→ 按需勾選只讀 / 現貨交易 / 提現許可權(預設建議只勾只讀)→ 儲存 API Secret 並妥善離線備份。每一把新建立的 API Key 有 90 天有效期,到期後必須輪換。

從網頁開發者視角看,API Key 是把賬戶能力開放給程式指令碼、交易機器人或資料看板的一把「實體鑰匙」,一旦洩露就等於把賬戶的一部分權力交出去。把許可權收緊到最小、把 IP 白名單綁到最嚴、把輪換週期設到最短,是三條鐵律。下面把整個流程拆開來講,並把 IPv4 段書寫規則、許可權層級、洩露應急一次說清楚。

建立 API Key 前的準備

網路出口 IP 必須先摸清

繫結 IP 白名單的前提是——你或你的程式有一個穩定的出口 IPv4,否則每次 IP 變了都要回來改白名單。三種典型情況:

  • 家用寬頻:多數為動態 IP,需要 DDNS 或 VPN 固定;不推薦直接綁家寬 IP
  • 雲伺服器:出口 IP 通常固定,直接使用雲廠商分配的公網 IPv4
  • 辦公網路:需要與網管確認出口是單 IP 還是 NAT 池

如果暫時沒有固定 IP,可以先建立 API Key 但不啟用交易許可權,僅開只讀,綁 IP 後再逐步放權。

命名與用途要一一對應

不同用途的指令碼用不同 API Key,避免一把鑰匙對應多個場景。參考命名:

Key 名稱 用途 許可權 備註
read-only-portfolio 資產看板拉取餘額 只讀 每小時輪詢
spot-bot-btc-usdt 現貨網格機器人 現貨交易 單交易對
data-export 每天匯出成交記錄 只讀 只跑一次
treasury-withdraw 定時批次提現到冷錢包 提現 嚴禁開交易

分開的好處是——某一把洩露,只需吊銷單條,不影響其他指令碼,也方便審計每把 Key 的最後呼叫時間。

提前準備好 2FA 與郵箱驗證

建立、編輯、刪除 API Key 的每一步都要求 2FA 驗證碼 + 郵箱確認。如果最近做過 2FA 遷移(見 /posts/biabaweb-2fa-migration/),請先確認新驗證器已經穩定。

許可權層級怎麼勾

幣安 API Key 的許可權從上到下分為幾檔,建議按最小許可權原則勾選。

許可權層級速查

許可權 能做什麼 風險 推薦勾選場景
只讀 查餘額、查訂單、查成交 低 資料看板、稅務匯出
現貨交易 下單、撤單 中 網格 / 套利機器人
合約交易 開倉、平倉、調槓桿 高 合約策略
槓桿借幣 借款、還款 高 槓桿策略
提現 發起鏈上提幣 極高 財務出款指令碼
萬能錢包 複合許可權 極高 不建議

只讀許可權的預設動作

只勾只讀時,API Key 只能執行 GET 類介面。這類 Key 即使洩露,攻擊者也只能看到你的餘額和歷史,無法動資金,配合白名單幾乎沒有資產損失風險。任何做資料分析的場景都應該止步於此。

提現許可權的額外要求

一旦勾選提現許可權,幣安會強制要求:必須先繫結 IP 白名單;必須搭配賬戶級提現白名單(見 /posts/biabaweb-withdrawal-whitelist/);單筆和 24 小時限額與賬戶級提現限額共享。任何指令碼要走「自動提現」,都必須兩個白名單同時啟用。

Q:可以先勾只讀,跑通後再改成交易嗎? A:可以,也強烈推薦這個順序。先用只讀跑一週,觀察 IP 是否變化、指令碼是否穩定,一切正常後再逐檔放權。放權時會再次要求 2FA + 郵箱確認。

Q:一把 Key 同時勾只讀和現貨交易,兩者是疊加還是替換? A:疊加。只讀許可權預設對所有 Key 都開放,勾選交易許可權相當於在只讀之上疊加下單能力。

IP 白名單的寫法

IP 白名單支援逗號分隔的多個條目,格式包括單個 IP、多個 IP 或 CIDR 段。

常見寫法示例

  • 單個 IPv4:203.0.113.55
  • 多個 IPv4:203.0.113.55,203.0.113.56
  • IPv4 網段:203.0.113.0/24(表示 203.0.113.0 至 203.0.113.255)
  • 小段:203.0.113.0/29(表示 8 個連續 IP)

寫法上要注意:

  1. 段掩碼越大(數字越小)覆蓋 IP 越多,越危險,一般不超過 /24
  2. 不支援 IPv6 白名單填 IPv4,反之亦然,需要按實際出口協議填
  3. 不支援域名或 DDNS 主機名,必須是數值 IP
  4. 段之間用英文逗號分隔,中間不要留空格

雲伺服器出口如何確認

如果部署在雲伺服器,登入 SSH 後用一個第三方 IP 探測服務確認公網出口,例如訪問一個純文字 IP 回顯介面。切勿依賴控制檯顯示的「公網 IP」,因為有些雲的出口和入口 IP 分開分配。

CIDR 段的選擇建議

優先使用宿主的 /32(單個 IP)或 /29(8 個 IP,供雲廠商彈性伸縮);避免使用 /24 除非確實有大規模伸縮場景;永遠不要用 0.0.0.0/0 或不填 IP 白名單——不填等於允許所有 IP 呼叫,是極高風險。

校驗白名單是否生效

繫結完成後,在白名單外的機器上用 API Key 呼叫任意介面,應該收到明確的 -2015 或類似「Invalid API-key, IP, or permissions」錯誤。收到這個錯誤說明白名單已經生效;如果仍然能呼叫,說明配置未儲存或 IP 未綁。

90 天到期與輪換

從 2023 年起,幣安對啟用交易或提現許可權的 API Key 強制施加 90 天有效期。到期後 Key 會自動被降級為只讀,需要使用者手動續期或輪換。

輪換的正確姿勢

  1. 到期前 7 天,建立一把新的 API Key,許可權、IP、備註保持一致
  2. 把新 Key 的 Access Key / Secret Key 部署到指令碼,切換環境變數
  3. 觀察 24 小時,確認新 Key 正常工作
  4. 到期後立即刪除舊 Key,不要留著「以防萬一」

這樣做的好處:新舊 Key 有 24 小時並行期,切換不會中斷;舊 Key 一到期立即銷燬,減少洩露面。

不要靠自動續期

儘管幣安提供了「延長有效期」按鈕,但依賴自動續期意味著 Key 的 Access Key / Secret Key 永遠不變,一旦歷史上任何一次洩露都會成為長期風險源。定期輪換才是最有效的秘鑰衛生。

與提現白名單結合

如果這把 Key 涉及提現,則輪換 Key 時不需要重新做提現白名單——賬戶級的地址簿與 Key 無關。但要重新做一次全流程演練:新 Key + 已有白名單地址走一次小額提現,確認鏈路無誤後再放量。

金鑰洩露應急

發現或懷疑 API Key 洩露時,按下面順序執行,5 分鐘內可以把損失降到最低。

  1. 開啟「賬戶 → API 管理」,刪除疑似洩露的 Key
  2. 登出所有會話(登入頁勾選「登出其他裝置」)
  3. 立即修改賬戶登入密碼
  4. 檢查「安全 → 登入歷史」與「安全 → 操作日誌」有無異常
  5. 檢查「資金流水」有無未授權交易或提現
  6. 重置 2FA(可選,如果懷疑賬戶被侵入)
  7. 透過前往幣安官網提交工單說明情況
  8. 一週內做一次完整的安全巡檢:白名單、2FA、API、繫結郵箱

事後覆盤

Key 是怎麼洩露的?常見渠道:

  • 提交到 GitHub 公開倉庫
  • 寫在配置檔案而配置檔案被上傳到聊天工具
  • 部署指令碼包含 Key 且部署到多臺機器
  • 員工離職未回收許可權
  • 使用了帶截圖 / 日誌上傳功能的開發工具

對每一次洩露做根因分析,改進流程,避免下一次。

風險提示:所有社交平臺上主動加你、聲稱能幫你「代做 API 網格」的賬號都是釣魚。任何要你把 Access Key 或 Secret Key 私信傳送的行為,都是無一例外的詐騙。下載幣安 App只從官方入口進行,同樣適用於識別真偽的規則詳見 /posts/binance-anti-phishing-real-fake/。

常見問題

一個賬戶最多能建立幾把 API Key?

主賬號目前支援最多建立 30 把 API Key,子賬號獨立計數。實際推薦同時活躍的 Key 不超過 5 把,多餘的定期清理,減少運維壓力。

子賬號能不能獨立建立 API Key?

可以。子賬號獨立管理 API 列表和 IP 白名單,許可權與主賬號完全隔離。做機構級隔離時非常有用:一個子賬號跑一個策略,一把 Key 對應一個 IP。

忘記 Secret Key 怎麼辦?

無法找回。API Secret Key 只在建立時顯示一次,幣安不儲存明文,遺失只能刪除重建。這也提醒建立時一定要立即寫入密碼管理器或加密檔案。

API Key 能被別人的 IP 使用嗎?

不能,只要綁了 IP 白名單。攻擊者即使拿到 Access Key + Secret Key,在白名單外的機器上呼叫也會立即失敗。這是 IP 白名單的核心價值。

到期後想繼續用舊 Key 行不行?

行,但會被降級為只讀。想恢復交易或提現許可權,需要手動點「延期」並重新做 2FA 驗證。生產環境不建議這樣做,應該主動輪換新 Key。

API 請求速率限制會因白名單變化嗎?

不會。速率限制基於賬戶級配額,與 IP 白名單無關。如果頻繁觸發限流,需要最佳化呼叫頻率或申請提高配額,不是透過多綁 IP 能解決的。

白名單裡能填 CIDR 段嗎?

能。寫法如 203.0.113.0/24。但網段越大越危險,能寫 /32 就不寫 /24,能寫 /29 就不寫 /24。

我在多個雲區域部署,如何管理白名單?

推薦每個區域一把獨立的 API Key,繫結該區域的出口 IP。這樣切換區域時只需操作對應的 Key,出問題定位也更快。不建議一把 Key 綁多雲段——出問題排查困難,還會擴大攻擊面。


文件釋出於 2026-07-01,下次複測計劃 2026-10-01。