幣安 API key 許可權鎖定|Biabafox 速查
Biabafox 把幣安 API key 的 5 類許可權(讀取/現貨/合約/槓桿/提現)拆開講清楚,給出 IP 白名單速查表 + 高危場景避坑 + 金鑰洩漏 6 步應急流程。
API key 是賬號裡最容易洩漏也最難挽回的憑據——直接答案:幣安 API key 的安全原則只有一句話,"能只讀就絕不給交易許可權,能給單一 IP 就絕不給全網訪問,絕不勾選提現許可權除非明確需要且理解風險"。Biabafox 把幣安 API 許可權的 5 大類、IP 白名單機制、7 種高危場景、6 步洩漏應急流程壓縮到一篇速查裡,讓你 30 分鐘建立可復現的 API 安全操作規範。
如果你手上還沒有 API key,可以先到 幣安官網 完成賬戶實名和 2FA,或者透過 下載頁 的 幣安官方App 走一遍安全設定,本文預設你已經完成這些前置。
場景與讀者畫像
- 適用場景:量化交易、資料分析、行情看板、跨所套利、做市
- 難度:中高(涉及許可權模型、IP 網段、簽名機制)
- 估時:單 key 建立 + 許可權規劃 15 分鐘;應急演練 30 分鐘
- 適合人群:量化使用者、開發者、機構 API 對接、行情工具作者
- 裝置:一臺穩定 IP 的伺服器 + 一臺管理用 PC
- 網路:API 端固定公網 IP;管理端能正常訪問 幣安官網
- 風險等級:高(一旦洩漏可能損失全部資產)
- 成本:0
- 替代方案:僅透過 Web/App 手動操作(安全但無法自動化)
- 常見錯誤:許可權一次給全、無 IP 白名單、把 secret 寫程式碼庫
- 校驗方法:用只讀 key 嘗試下單應報錯,用限 IP key 從其他 IP 應報錯
5 類許可權速查表
Biabafox 按幣安實際選項把許可權分為 5 類,從最弱到最強:
| 許可權 | 能做什麼 | 洩漏後損失上限 | 建議啟用場景 | 推薦配合 |
|---|---|---|---|---|
| 讀取 | 查行情、賬戶餘額、K 線 | 隱私洩漏 | 資料分析、行情看板 | 無需 IP 也可用 |
| 現貨交易 | 下單、撤單、成交 | 幣被惡意換成低流動性幣 | 現貨量化 | 必須 IP 白名單 |
| 槓桿交易 | 借幣、還幣、槓桿下單 | 觸發爆倉 | 槓桿策略 | 必須 IP 白名單 |
| 合約交易 | U 本位/幣本位合約下單 | 無風控下滿倉爆倉 | 合約量化 | 必須 IP 白名單 + 風控 |
| 提現 | 直接提現到白名單地址 | 全部資產被轉走 | 極少數託管場景 | 強制 IP + 白名單鎖定 |
A:Biabafox 反覆強調:99% 的量化使用者不需要提現許可權,把這一欄留空就能砍掉 90% 以上的資產風險。即使 secret 洩漏,攻擊者最多在你賬戶裡亂下單,無法把幣轉走。這是 API 安全的第一原則。
許可權組合的三個層次
按用途拆解常見的三種 key 組合:
- 只讀 key:僅勾選"讀取",無 IP 白名單也可用。適合行情看板、賬戶餘額顯示
- 交易 key:勾選"讀取 + 現貨/合約",必須繫結固定 IP。適合量化機器人
- 提現 key:僅在你需要機器人自動從幣安轉到冷錢包時才建,強制 IP + 強制提現白名單鎖定
IP 白名單速查
IP 白名單是 API 安全的第二道鎖,與許可權鎖定同等重要。
| IP 配置 | 支援的 API 許可權 | 有效期 |
|---|---|---|
| 不配置 IP | 僅"讀取"可用 | 90 天自動過期 |
| 配置單個 IP | 全部許可權 | 長期有效 |
| 配置多個 IP(逗號分隔) | 全部許可權 | 長期有效 |
| 配置 IP 段 | 不支援 | 無 |
| 配置 IPv6 | 支援 | 長期有效 |
常見部署場景對照
| 部署位置 | 推薦 IP 配置 | 備註 |
|---|---|---|
| 阿里雲/騰訊雲獨立公網 IP | 單個固定 IP | 最推薦 |
| AWS EIP | 單個固定 IP | 最推薦 |
| Cloudflare Workers | 走出口代理再固定 | 需中轉 |
| 家庭動態 IP | DDNS + 每日重新整理 | 不推薦生產 |
| 行動網路 | 完全不推薦 | IP 每幾分鐘變一次 |
A:Biabafox 的建議:從來不要在沒有固定 IP 的環境部署帶交易許可權的 API key。若臨時測試只需只讀許可權,讀完刪掉。寧可換到有固定 IP 的伺服器再上線,也不要圖便宜跑家裡 PPPoE 撥號 IP。
90 天過期機制
幣安從 2023 年起對無 IP 限制的 key 強制 90 天有效期:
- 首次建立後 90 天自動禁用(讀取許可權也禁)
- 到期前 7 天開始郵件提醒
- 續期時需要重新 2FA 驗證
- 加了 IP 白名單則無過期時間(推薦做法)
7 種高危場景避坑
Biabafox 覆盤社群 API 洩漏事件,最常見的 7 類:
| 場景 | 危險等級 | 修復方法 |
|---|---|---|
| 把 secret 直接寫入 Git 倉庫 | 極高 | 立即刪 key + 環境變數注入 |
| 用截圖分享程式碼時露出 API 金鑰 | 高 | 立即刪 key + 檢查歷史訊息 |
| 在公共 Discord/Telegram 群貼日誌 | 高 | 日誌脫敏 + 立即刪 key |
| 用同一 key 給多個策略共享 | 中 | 一策略一 key,方便追蹤 |
| 無 IP 白名單讓"任何 IP 可訪問" | 極高 | 立即加 IP 或刪 key |
| 勾選提現許可權用於常規量化 | 極高 | 立即取消提現許可權 |
| 交易 key 存密碼管理器"備註"欄位 | 中 | 移至加密備註 + 定期輪換 |
secret 存放的 3 條硬規則
- 絕不入程式碼倉庫(
.gitignore兜底不夠,用git-secrets掃描) - 生產環境用環境變數或金鑰管理服務(KMS、Vault)
- 本地開發用
.env檔案,且.env嚴禁 push
洩漏應急 6 步流程
一旦懷疑 secret 洩漏,Biabafox 建議按以下順序在 5 分鐘內處置:
| 步驟 | 操作 | 時間預算 |
|---|---|---|
| 1 | 登入 幣安官網 → API 管理 → 立即禁用可疑 key | 30 秒 |
| 2 | 修改賬戶密碼 + 強制所有會話下線 | 1 分鐘 |
| 3 | 檢查最近 24 小時的下單、劃轉、提現記錄 | 2 分鐘 |
| 4 | 檢查子賬戶與合約賬戶是否有異常 | 1 分鐘 |
| 5 | 若有非常規訂單,聯絡幣安客服凍結賬戶 | 手動 |
| 6 | 覆盤洩漏路徑並加固(IP 白名單、許可權收斂) | 事後 |
A:Biabafox 反覆強調:處置順序是"先禁 key 再排查",不要順序反過來。攻擊者可能正在實時操作,多猶豫 30 秒就是一筆惡意訂單。
事後覆盤的 4 個必查點
- Git commit 歷史(
git log --all -p | grep -i api) - 雲盤/郵箱附件搜尋"key"、"secret"
- 團隊協作工具(Slack、Notion)歷史
- 本地 shell history、IDE 剪貼簿快取
常見問題
Q1:只讀 key 會不會也洩漏隱私?
A:會。只讀 key 能讀到賬戶餘額、下單歷史、劃轉記錄,這些資料本身對釣魚者有價值。Biabafox 建議:即使是隻讀 key 也要加 IP 白名單。
Q2:幣安支援 HMAC-SHA256 之外的簽名方式嗎?
A:支援。2024 年後幣安推出了 Ed25519 簽名,金鑰長度更短、驗籤更快、抗量子攻擊。Biabafox 認為:新建 key 優先選 Ed25519,尤其是高頻量化場景。
Q3:子賬戶能不能單獨發 API key?
A:可以。子賬戶 API 獨立於主賬戶,許可權也可以細化到子賬戶級別。Biabafox 強烈推薦:把策略資金隔離到子賬戶裡,即使 key 洩漏損失也被限制在子賬戶餘額內。
Q4:如何檢測 API key 是否正在被非法使用?
A:幣安提供 API 呼叫日誌,可以看到最近 30 天每個 key 的呼叫來源 IP、頻率、異常錯誤。建議每週巡檢一次。若發現來源 IP 不是自己的伺服器,立即禁用。
Q5:API 提現許可權和賬戶提現白名單是什麼關係?
A:疊加關係。API 提現許可權只允許提到賬戶級別的提現白名單內的地址。所以即使給了 API 提現許可權,攻擊者也只能提到白名單地址,無法自由轉移。這是雙重鎖定的經典組合。
Q6:家裡沒有固定 IP,就完全不能跑量化了嗎?
A:不是。三種可選方案:(1)租一臺每月 5-10 美元的 VPS 用固定 IP;(2)用 Cloudflare Tunnel 中轉讓所有請求走固定出口;(3)用 DDNS + 幣安 API 定時更新 IP 白名單(幣安支援透過 API 修改 IP 白名單,但需要另一把管理 key)。Biabafox 推薦方案 1,最省心。
Q7:一個賬戶能建幾把 API key?
A:普通賬戶可以建 30 把,機構賬戶更多。Biabafox 建議:每個策略、每個團隊成員、每個用途各一把,方便審計和廢棄。用完立即刪,不要留著"以後可能用"。
Q8:洩漏後賬戶被惡意下單能追回嗎?
A:一般不能追回幣價損失。若是透過 IOC 單低於市價成交或砸盤等異常行為,幣安在 30 天內可以協助申訴,但最終能否返還取決於訂單是否符合"惡意操縱"定義。Biabafox 見過成功和失敗的案例各佔一半,最靠譜的還是提前防範。
風險提示
API key 一旦被惡意使用,損失通常在幾分鐘內完成,往往比手動操作賬戶的攻擊更快、更隱蔽。Biabafox 強烈建議:所有帶交易許可權的 key 必須繫結固定 IP、避免勾選提現許可權、每 30 天做一次巡檢、每 90 天輪換 secret。加密資產投資本身有市場波動風險,量化策略也可能因為程式 bug 造成損失,本文只解決"金鑰安全"這一環,不涉及策略盈虧。請透過 幣安官網 或 幣安官方App 的正規入口管理 API key。
內鏈導航:更多入口選擇請見 下載頁;若你還在糾結用 App 還是網頁端做 API 管理,可以先看 PC 與網頁端速選 再決定。
文件釋出於 2026-07-10,下次複測計劃 2026-10-10。