跳到正文

API 代理固定 IP:定时数据同步、接口 IP 白名单专用

给每个定时任务一条固定 IP:接口可以加白名单,频率限制也不和别的任务共用。

为什么定时调用 API 需要固定 IP

越来越多的 API 按调用方 IP 控制访问。Stripe 允许把密钥限制在指定的 IPv4 地址上——它建议「服务器有固定 IP」时这样做——高级策略还能拦截住宅代理、公共代理、VPN 和 Tor。跑在笔记本、Serverless 函数或轮换代理上的任务,没有可以加白名单的固定地址。

CI 也帮不上忙:GitHub 明确不建议把 GitHub 托管运行器的 IP 段拿来做白名单(数量太多),建议改用带固定 IP 段的大型运行器或自托管运行器。

频率限制也常按 IP 计算:GitHub REST API 对未认证请求每个来源 IP 每小时 60 次,并用 retry-after 或 x-ratelimit-reset 告诉你何时重试。同一出口下的任务共用这份额度;每个任务一条静态机房 IP,限额和白名单都互不影响。国内网络无法直接连接海外代理,本机运行先打开 控制台 → 连接工具 → 辅助工具。

API 同步推荐配置

可使用方向键横向滚动,阅读完整内容。

API 同步推荐配置
比较项目选择原因
产品静态机房代理租期内固定一条 IP,按 IP 计费,方便加白名单
买几条 IP一个任务或一个 API 账号一条频率限制和白名单条目各管各的
国家靠近 API 或对方期望的地区:美国、加拿大、英国、德国、荷兰、日本、韩国、新加坡有些 API 除了 IP 还按国家过滤
协议HTTPhttpx、requests、curl 和大多数 HTTP 客户端都支持
IP 会变吗租期内不变,到期前续费IP 一变,白名单就失效
住宅代理不要用于 API 调用有些 API 允许账号拥有者拦截住宅代理流量

下面的按钮会打开「静态机房代理」并选好「AI 与自动化」场景,付款前选好地区、租期、协议和「数量」(一次最多 100 个 IP)。

买哪种 Proxy302 代理

可使用方向键横向滚动,阅读完整内容。

买哪种 Proxy302 代理
比较项目静态 ISP动态住宅机房(数据中心)
你得到什么一条独享的家庭宽带 IP,租期内一直归你真实家庭宽带 IP:可轮换出口,也可在指定国家或城市保持粘性会话速度快的固定机房 IP,支持 HTTP / SOCKS5
价格按 IP 和租期,下单页实时报价低价线路 US$1.50/GB(100 GB 套餐 US$1.35/GB);优质线路 US$5.00/GB按 IP 和租期,单 IP 成本最低
最适合 API 同步要求家庭宽带 IP 的合作方后台采集拦截服务器 IP 的公开网站有白名单的 API、定时任务、CI、Webhook

价格以美元计。钱包充值一次,各类线路都从钱包付款;不会自动续费,想保留 IP 请在「我的资产」里续费。

5 步给 API 任务配好固定 IP

  1. 选 IP

    点下面的按钮,打开「静态机房代理」(按 IP 和租期),场景已选「AI 与自动化」。选「地区」和「租期」,「协议」选 HTTP,「数量」按任务或 API 账号数填(一次最多 100 个),点「确认费用并生成」。

  2. 把 IP 加进白名单

    在「我的资产」记下每条 IP,加到对方 API 的白名单或访问策略里;第一次运行成功之前,先别删旧服务器 IP。

  3. 给任务配代理

    在「我的资产」点「复制」得到「地址:端口:用户名:密码」,把 PROXY_URL = http://用户名:密码@地址:端口 和 API 令牌存成定时任务或 CI 的密钥。

  4. 定时运行

    用下面的代码配合 cron、Windows 任务计划或 CI:逐页拉取,遇到 429 按 Retry-After 等待,拿到空页就结束。

    预期结果 输出类似「synced N rows from M pages」,对方 API 看到的是代理 IP。

  5. 到期前续费

    自动续费暂未开放,请在到期前到「我的资产」续费,白名单上的地址才能保持不变。

经固定 IP 分页同步 API 数据(Python httpx)

可使用方向键横向滚动,阅读完整内容。

# pip install httpx   then schedule it, e.g. cron:  */30 * * * *  python sync.py
import os
import time
import httpx

API = "https://api.example.com/v1/orders"
proxy = os.environ["PROXY_URL"]  # static datacenter IP: http://USER:PASS@HOST:PORT (allowlist this IP)
headers = {"Authorization": f"Bearer {os.environ['API_TOKEN']}"}

rows, page, waits = [], 1, 0
with httpx.Client(proxy=proxy, headers=headers, timeout=30) as client:
    while True:
        r = client.get(API, params={"page": page, "per_page": 100})
        if r.status_code == 429 and waits < 5:  # after 5 waits in a row, fail the run instead of looping
            waits += 1
            retry_after = r.headers.get("Retry-After", "")
            time.sleep(int(retry_after) if retry_after.isdigit() else 60)
            continue  # ask for the same page again
        r.raise_for_status()
        waits = 0
        batch = r.json()
        if not batch:
            break
        rows.extend(batch)
        page += 1
print(f"synced {len(rows)} rows from {page - 1} pages")

2026-10-18 用 httpx 0.28.1 对本地分页 API 实测:接口先返回一次 429 和 Retry-After,任务等待后重新请求同一页,从 3 页同步了全部 5 条数据;接口一直返回 429 时,等待 5 次后报错退出,不会无限循环。

常见问题速查

改走代理后 API 返回 403

检查 代理 IP 加进对方的白名单或访问策略了吗?

处理 把「我的资产」里显示的 IP 加进去;运行稳定后再删旧服务器 IP。

返回 429 Too Many Requests

检查 有没有遵守 Retry-After 或 x-ratelimit-reset?是不是好几个任务共用一条 IP?

处理 按 API 的要求等待;重的任务单独用一条 IP。

任务跑了一个月突然失败

检查 IP 的租期是不是到了?

处理 到期前在「我的资产」续费;自动续费暂未开放。

本地能跑,CI 里失败

检查 CI 里配置了 PROXY_URL 和令牌密钥吗?允许访问代理端口的出站连接吗?

处理 把密钥加进流水线,并放行到代理地址和端口的出站连接。

API 代理常见问题

API 请求为什么要走代理?

让定时任务有一条固定的来源 IP,方便对方加白名单;同时让每个任务的频率限制和办公室网络、其他任务分开。

能买到用于 API 白名单的固定 IP 吗?

可以。静态机房 IP 租期内不变;到期前续费就能继续用同一条。

API 调用用住宅还是机房?

用机房。动态住宅 IP 会轮换,而且像 Stripe 这样的平台允许账号拥有者拦截住宅代理流量。

GitHub Actions 里的任务需要吗?

如果对方 API 按 IP 加白名单,就需要:GitHub 不建议把托管运行器的 IP 段做白名单,建议用带固定 IP 的大型运行器或自托管运行器;让任务经一条静态机房 IP 出去,也能得到固定地址。

「api 代理」和大模型 API 中转是一回事吗?

不是。本页说的是给你的程序调用第三方 API 提供一条固定出口 IP;大模型账号与订阅的使用场景见 AI 订阅相关页面。

来源与验证

7
  1. Stripe 文档:API 密钥访问策略(IP 地址、住宅代理)

    官方文档 · 核对于:

  2. GitHub 文档:REST API 速率限制

    官方文档 · 核对于:

  3. GitHub 文档:GitHub 托管运行器的 IP 地址与白名单

    官方文档 · 核对于:

  4. Proxy302 价格页

    产品观察 · 核对于:

    动态住宅按 GB 价格以价格页和控制台为准(低价线路 US$1.50/GB,100 GB 套餐 US$1.35/GB;优质线路 US$5.00/GB;1 PTC = 1 美元)。静态 ISP 和机房 IP 按数量和租期实时报价。

  5. Proxy302 控制台 — 静态机房代理

    产品观察 · 核对于:

    选项名称、计费方式与限制以 2026-10-18 线上控制台为准:线路(优质 / 低价)、出口模式、地区、州 / 省、城市、协议(HTTP / SOCKS5)、数量(1–500)、租期、自动续租 IP(暂未开放),我的资产 → 复制 / 轮换 / 续费 / 复制给 AI。动态住宅入口为 proxy.proxy302.com:2222(HTTP)和 :3333(SOCKS5)。 2026-10-18 只读核对生产目录:静态机房 IP 在售 8 个国家——美国、加拿大、英国、德国、荷兰、日本、韩国、新加坡。

  6. 本地代理夹具实测

    本地示例 · 核对于:

    2026-10-18 在本地带密码的 HTTP 代理夹具上运行了本段代码(凭据错误时返回 407);httpx 0.28.1 对本地分页 API 实测:接口要求 Bearer 令牌,第 2 页先返回一次 429 和 Retry-After: 1;任务等待后重新请求同一页,最终从 3 页同步了全部 5 条数据,每次请求都带了令牌。接口一直返回 429(Retry-After: 0)时,任务重试 5 次后以 HTTP 错误退出。

    本地实测只证明配置写法和认证路径正确,不代表能访问任何具体网站、国家或平台。

  7. Proxy302 控制台 → 连接工具 → 辅助工具

    产品观察 · 核对于:

    控制台「连接工具」页提供辅助工具(Windows / macOS 全局代理);「我的资产 → 复制给 AI」生成的说明写明:在中国大陆使用代理前需先打开辅助工具或已连上 VPN。

准备好接入了吗?

注册账号、一次充值,即可选择动态住宅、静态 ISP 或数据中心出口。动态住宅覆盖 195+ 国家与地区。