如何配置Bybit API存取IP白名單？

Bybit API IP白名單設定概述

1. Bybit對生產環境中使用的所有API金鑰都要求嚴格的網路層級授權。每個 API 金鑰必須與一組已定義的 IPv4 位址關聯，以限制請求來源點。

2. 在進行任何身份驗證或權限檢查之前，IP 白名單在交易所的網關層強制執行。來自非白名單 IP 的請求會立即收到 HTTP 403 Forbidden 回應。

3、Bybit不支援IPv6白名單；設定期間僅接受 IPv4 位址或 CIDR 表示法（例如 203.0.113.42/32 或 192.0.2.0/24）。

4. 單一 API 金鑰最多可容納 20 個不同的 IPv4 條目，包括單獨的位址和子網路範圍，但重疊的 CIDR 區塊在提交時會被拒絕。

5. IP白名單的變更將在30秒內生效，無需重新產生金鑰或重新啟動服務。

透過 Bybit Web 介面逐步設定白名單

1. 使用官方網域www.bybit.com登入您的 Bybit 帳戶，驗證頒發給 Bybit Limited 的 SSL 證書，並確保雙重認證處於活動狀態。

2. 導覽至帳戶設定 → 安全性 → API 管理並找到目標 API 金鑰條目。

3. 點選按鍵旁的鉛筆圖示開啟編輯模式，然後展開「IP 白名單」部分。

4. 輸入一個或多個 IPv4 位址或 CIDR 區塊，並以換行符號分隔 - 不允許使用逗號或分號。

5. 使用電子郵件驗證和 Google 驗證器程式碼確認變更；任一步驟失敗都會恢復整個更新。

白名單驗證和故障排除

1. 儲存後，使用curl或Postman以正確的標頭和簽章啟動對/v5/account/info的測試呼叫。

2. 如果回應包含retCode: 10004 ，則表示原始 IP 不在核准清單中 - 即使憑證有效。

3. 使用ip138.com或curl ifconfig.me確認託管交易機器人或腳本的電腦的公共 IP 位址。

4. 在雲端基礎架構上部署時，檢索彈性 IP 或 NAT 閘道位址（而非私人 VPC 位址），因為僅評估面向大眾的 IP。

5. 避免使用動態住宅 IP，除非與可靠的 DDNS 服務配對，該服務可透過 Bybit 的 API 自動更新白名單。

白名單配置錯誤的安全性影響

1. 將白名單留空會停用所有訪問，無論金鑰有效性如何，從而有效鎖定合法流量。

2. 輸入0.0.0.0/0或類似的寬遮罩違反了 Bybit 的安全政策，並導致自動系統立即停用金鑰。

3. 如果一台主機受到威脅，在多個伺服器上重複使用相同的 API 金鑰而不更新白名單會使憑證暴露於橫向移動。

4. 基礎設施遷移後未能輪調 IP 會導致持續出現 403 錯誤，即使憑證保持完整且權限不變。

5. 在不加密的版本控製設定檔中儲存白名單 IP 會增加程式碼稽核或儲存庫洩漏期間意外暴露的風險。

常見問題解答

Q1：我可以使用Bybit IP白名單中的localhost或127.0.0.1嗎？ Bybit 完全拒絕環回位址。本機開發必須透過公用可路由 IP 進行路由，或使用停用白名單的 Bybit 測試網路環境。

問題 2：Bybit 是否允許通配符網域或基於主機名稱的白名單？不可以。僅接受數位 IPv4 位址和 CIDR 區塊。驗證期間不執行 DNS 解析。

問題 3：如果我的伺服器的公共 IP 發生變化而白名單保持不變，會發生什麼情況？在使用目前位址手動更新白名單之前，來自新 IP 的所有 API 請求都會失敗並顯示錯誤代碼 10004。

Q4：有沒有辦法使用Bybit的REST API以程式方式更新IP白名單？ Bybit 不公開用於修改 API 金鑰設定的端點。白名單編輯需要透過 Web 介面或行動應用程式進行互動式身份驗證。