# 网站打不开

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

## 1. helodata 是否有响应？

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

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

返回 IP 说明网关链路正常，继续下一步。否则查 [407](/helodata-zh/gu-zhang-pai-cha/407.md) 或 [522](/helodata-zh/gu-zhang-pai-cha/522.md)。

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

用失败请求的 request\_id，或直接测：

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

看响应状态与头：

* **`200` 但 body 为空** — 目标需 JS 渲染，跳到第 4 步
* **来自 helodata 的 `403`**（`X-Helodata-Error-Code: restricted-category-*`） — 目标在 [受限清单](/helodata-zh/chan-pin/overview/restricted-targets.md)
* **来自目标的 `403`**（无 `X-Helodata-Error-Code`，`Server: cloudflare`） — IP 信誉问题，见 [验证码](/helodata-zh/gu-zhang-pai-cha/captchas.md)
* **`5xx`** — 见 [522](/helodata-zh/gu-zhang-pai-cha/522.md) 或 [SSL 错误](/helodata-zh/gu-zhang-pai-cha/ssl-errors.md)

## 3. 目标是 SPA 吗？

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

**修复** — 改用真浏览器：

* [Playwright](/helodata-zh/ji-cheng-zhi-nan/pa-chong-gong-ju/playwright.md) 或 [Puppeteer](/helodata-zh/ji-cheng-zhi-nan/pa-chong-gong-ju/puppeteer.md)
* 反检测浏览器（[AdsPower](/helodata-zh/ji-cheng-zhi-nan/fan-jian-ce-liu-lan-qi/adspower.md)、[Multilogin](/helodata-zh/ji-cheng-zhi-nan/fan-jian-ce-liu-lan-qi/multilogin.md)）

[Web Unblocker](/helodata-zh/chan-pin/overview-4.md) 上线后会透明处理。

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

对比代理与直连：

```bash
curl --proxy http://USER:PASS@gate.helodata.io:7777 https://example.com -o through-proxy.html
curl https://example.com -o direct.html
diff <(head -200 through-proxy.html) <(head -200 direct.html)
```

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

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

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

## 6. 撞 Cloudflare 挑战了吗？

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

* 试粘性会话 + 与浏览器对齐的头——见 [验证码](/helodata-zh/gu-zhang-pai-cha/captchas.md)
* 用真浏览器（Playwright/Puppeteer + stealth）
* 换出口 IP，信誉不同

## 7. 是否重定向死循环？

```bash
curl -L --max-redirs 10 --proxy http://USER:PASS@gate.helodata.io:7777 https://example.com
```

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

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

## 8. 最后手段——开工单

```
- 目标 URL：
- 子账号：
- 两个失败请求的 X-Helodata-Request-Id：
- 已经尝试过的步骤：
```

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helodata.com/helodata-zh/gu-zhang-pai-cha/website-wont-load.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.