For the complete documentation index, see llms.txt. This page is also available as Markdown.

网站打不开

页面空白、半加载、或一直转圈。按以下顺序逐项排查。

1. helodata 是否有响应?

用同一凭证跑一个已知良好的请求:

curl -v --proxy http://USER:PASS@gate.helodata.io:7777 https://ipv4.icanhazip.com

返回 IP 说明网关链路正常,继续下一步。否则查 407522

2. 该出口 IP 是否能到达目标?

用失败请求的 request_id,或直接测:

curl -v --proxy http://USER:PASS@gate.helodata.io:7777 https://example.com

看响应状态与头:

  • 200 但 body 为空 — 目标需 JS 渲染,跳到第 4 步

  • 来自 helodata 的 403X-Helodata-Error-Code: restricted-category-*) — 目标在 受限清单

  • 来自目标的 403(无 X-Helodata-Error-CodeServer: cloudflare) — IP 信誉问题,见 验证码

  • 5xx — 见 522SSL 错误

3. 目标是 SPA 吗?

用不走代理的浏览器打开目标,若 DevTools 显示初始 HTML 之后大量 XHR / fetch,那就是 SPA。requests 只能拿到空壳。

修复 — 改用真浏览器:

Web Unblocker 上线后会透明处理。

4. 目标是否对你 IP 国家返回不同内容?

对比代理与直连:

差异说明目标做地理个性化。这对 region-de 请求是正常的——确认是你想要的结果即可。

5. 页面送出但资源被屏蔽?

curl --includeContent-Security-PolicyX-Frame-Options、或重定向到 captcha 挑战。某些 script-src 被屏蔽时浏览器会显示空白页。

6. 撞 Cloudflare 挑战了吗?

HTML 含 cf_chl_opt 或响应有 cf-mitigated: challenge 头说明被 Cloudflare 挑战。处理:

  • 试粘性会话 + 与浏览器对齐的头——见 验证码

  • 用真浏览器(Playwright/Puppeteer + stealth)

  • 换出口 IP,信誉不同

7. 是否重定向死循环?

-L 跟随重定向。触发 --max-redirs 说明目标在两个 URL 间反复跳,依赖某个 cookie/header。

修复 — 抓取并重放每跳期望的 cookie,或改用真浏览器。

8. 最后手段——开工单

邮件 support@helodata.com。我们可在服务端回放请求,告诉你问题在我们、目标、还是你的客户端。

最后更新于

这有帮助吗?