如何配置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 界面或移动应用程序进行交互式身份验证。