用于 API 白名单的静态 IP：合作伙伴可信赖的固定 IPv4

为什么 API 和防火墙要求静态 IP？

API 和防火墙要求静态 IP，是因为已知的来源地址是在密钥或密码之上的简单第二道校验。如果密钥泄露，来自未知地址的请求仍会被拒绝。

使用 IP 白名单的常见场景：

• 合作伙伴和供应商 API：物流、库存、批发目录和数据源。
• B2B 仪表盘，仅接受来自客户注册地址的登录。
• 云防火墙和安全组，仅向白名单 IP 开放 SSH、数据库端口或管理面板。
• 预发布和预览服务器，不应公开访问。
• SaaS 管理控制台，带有可选的“受信任 IP”设置。

家庭和办公室网络经常更换地址，云函数或 CI 运行器使用共享且不断变化的地址段。租用的 IP 为它们提供一个稳定的出口。

涉及哪两个白名单？

此配置涉及两个不同的白名单，混淆它们是客服最常见的问题。

如果您的机器地址会变化，请跳过代理白名单，改用用户名和密码。用户名和密码，或 IP 白名单（最多 10 个 IP）。

如何通过静态 IP 路由 API 调用？

通过将静态 IP 设置为调用 API 的客户端的 HTTP(S) 或 SOCKS5 代理，来通过它路由 API 调用。大多数 HTTP 库、curl 和许多工具会读取代理设置或 HTTPS_PROXY 环境变量。首先用公共回显服务确认出口地址，然后调用合作方 API。下面的地址是文档示例；你的真实 IP、端口和凭据在账户中。

# 1. The address the partner will see
curl -x http://USERNAME:[email protected]:8000 https://api.ipify.org

# 2. Same proxy for every tool in this shell
export HTTPS_PROXY=http://USERNAME:[email protected]:8000
curl -H "Authorization: Bearer $PARTNER_TOKEN" https://example.com/api/v1/orders

租期结束时允许列表会怎样？

只要您保持相同的 IP，允许列表就会继续工作，所以请在结束日期前续费。每次租用自交付起持续 30 天。请在到期日之前从您的账户续费；租用结束后不保证保留相同的 IP。

允许列表访问的安全例程：

1. 租用两个 IP，而不是一个。 给合作方两个地址。如果其中一个需要更换，另一个保持集成运行。
2. 记下结束日期，在账户中每个 IP 旁边显示，并提前几天续费。
3. 随时掌握合作方的变更流程。 了解谁更新他们的允许列表以及需要多长时间。
4. 每次续费后测试，使用上面的回显调用。

如果某个 IP 无法使用或不适用于合法用途，请联系客服：我们将修复它，或在库存允许的情况下用同一国家的 IP 替换。替换 IP 是一个新地址，因此需要新的允许列表条目。

什么时候租用的代理 IP 是错误的选择？

当您想要访问的服务在我们的阻止列表中或需要永久地址时，租用的代理 IP 是错误的选择。银行、政府和支付门户网站在每个 IP 上都被阻止，因此银行和支付 API 允许列表不是我们支持的用途。

在以下情况下也考虑其他选项：

• 您在云中运行自己的服务器：来自云提供商的静态地址，附加到您自己的 NAT 网关，将流量保持在您的基础设施内。
• 您需要 IPv6：仅支持 IPv4。暂不出售 IPv6 代理。
• 您需要同一地址多年：30 天租期可以续费，但它不是您拥有的地址分配。