幣安 API Key 建立與 IP 白名單繫結實操
從零建立幣安 API Key 並繫結 IP 白名單的完整流程:許可權勾選、IPv4 段 203.0.113.0/24 寫法、90 天到期輪換機制以及金鑰洩露時的應急步驟,全部一次講透。
在幣安建立 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)
寫法上要注意:
- 段掩碼越大(數字越小)覆蓋 IP 越多,越危險,一般不超過 /24
- 不支援 IPv6 白名單填 IPv4,反之亦然,需要按實際出口協議填
- 不支援域名或 DDNS 主機名,必須是數值 IP
- 段之間用英文逗號分隔,中間不要留空格
雲伺服器出口如何確認
如果部署在雲伺服器,登入 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 會自動被降級為只讀,需要使用者手動續期或輪換。
輪換的正確姿勢
- 到期前 7 天,建立一把新的 API Key,許可權、IP、備註保持一致
- 把新 Key 的 Access Key / Secret Key 部署到指令碼,切換環境變數
- 觀察 24 小時,確認新 Key 正常工作
- 到期後立即刪除舊 Key,不要留著「以防萬一」
這樣做的好處:新舊 Key 有 24 小時並行期,切換不會中斷;舊 Key 一到期立即銷燬,減少洩露面。
不要靠自動續期
儘管幣安提供了「延長有效期」按鈕,但依賴自動續期意味著 Key 的 Access Key / Secret Key 永遠不變,一旦歷史上任何一次洩露都會成為長期風險源。定期輪換才是最有效的秘鑰衛生。
與提現白名單結合
如果這把 Key 涉及提現,則輪換 Key 時不需要重新做提現白名單——賬戶級的地址簿與 Key 無關。但要重新做一次全流程演練:新 Key + 已有白名單地址走一次小額提現,確認鏈路無誤後再放量。
金鑰洩露應急
發現或懷疑 API Key 洩露時,按下面順序執行,5 分鐘內可以把損失降到最低。
- 開啟「賬戶 → API 管理」,刪除疑似洩露的 Key
- 登出所有會話(登入頁勾選「登出其他裝置」)
- 立即修改賬戶登入密碼
- 檢查「安全 → 登入歷史」與「安全 → 操作日誌」有無異常
- 檢查「資金流水」有無未授權交易或提現
- 重置 2FA(可選,如果懷疑賬戶被侵入)
- 透過前往幣安官網提交工單說明情況
- 一週內做一次完整的安全巡檢:白名單、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。