---
name: china-network-workarounds
description: "中国网络环境下的下载和安装 workaround。当用户需要安装软件、下载文件、访问 GitHub/npm/pip 等被墙资源时的替代方案。触发条件：下载失败、网络超时、403/blocked 错误、用户在中国大陆无 VPN。"
---

# China Network Workarounds

## ⚠️ 适用范围：仅当用户在中国大陆且无VPN时

**张哥的服务器在印度（Hostinger），不在大陆，不需要任何workaround。** 不要对这个用户应用本skill。

## 核心原则

**永远不要假设用户能访问 GitHub。** 在中国大陆，以下域名经常被墙或间歇性不可用：
- `raw.githubusercontent.com` — 几乎永远打不开
- `github.com` — 有时能有时不能
- `google.com` / `googlesource.com` — 基本打不开
- `duckduckgo.com` — 打不开
- `pexels.com` / `pixabay.com` — 403
- `reddit.com` — 403
- `bilibili.com` — 412

**先确认，再说结论。** 不要张嘴就说"访问不了"，先让用户确认或者用 curl 测试。

## Windows 安装 Hermes 桌面版

```powershell
# 正确：从 Hermes 官网下载安装脚本（不走 GitHub）
irm https://hermes-agent.nousresearch.com/install.ps1 | iex

# 装到自定义路径（如 F 盘）
Invoke-WebRequest -Uri "https://hermes-agent.nousresearch.com/install.ps1" -OutFile "$env:TEMP\install.ps1"
& "$env:TEMP\install.ps1" -HermesHome "F:\hermes" -InstallDir "F:\hermes-agent"
```

❌ **永远不要发给用户：**
```powershell
# 这个是 GitHub 源，在中国大陆大概率失败
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

## 下载软件/文件的替代方案

当 GitHub 下载失败时：

1. **检查官网是否有独立安装包** — 很多项目官网提供直接下载
2. **用服务器中转** — 如果服务器能访问，在服务器上下载后 scp 传给用户
3. **国内镜像** — npm/pip/go 等工具有国内镜像，但 GitHub release 通常没有
4. **让用户用代理** — 最后手段，不要一上来就说"你需要 VPN"

## npm/pip 国内镜像

```bash
# npm
npm config set registry https://registry.npmmirror.com

# pip
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# Go
go env -w GOPROXY=https://goproxy.cn,direct
```

## 服务器 IP 被网站封禁

云服务器的 IP 段经常被 YouTube、Reddit、B站等网站封禁：
- 表现：403、412、需要验证码
- 解决：换 IP、用代理、找替代素材源
- 不要反复重试同一个被禁的网站

## 反向封锁：海外服务器无法访问中国网站

**适用场景：服务器在海外但需要下载中国网站内容（如素材、视频）。**

中国视频平台（CCTV、Bilibili、腾讯视频等）对海外IP限制严重：
| 平台 | 表现 | 原因 |
|------|------|------|
| **CCTV (sports.cctv.com)** | you-get能识别格式，下载403 | 网宿海外CDN + WSSE认证 + Geo-block |
| **Bilibili** | HTTP 412 | Cloudflare / 地区限制 |
| **腾讯视频(v.qq.com)** | 连接超时 | 海外路由限速 |

**解决方案：**
1. **国内代理/VPS中转** — 最可靠，通过国内服务器代理请求
2. **检测是否被墙在前** — 先用curl确认网站可访问性再尝试下载
3. **CCTV API探测内容是否存在** — 即使不能下载，先用API确认内容存在：
   ```bash
   curl -sL "https://api.cntv.cn/video/videoinfoByGuid?guid=<GUID>&serviceId=pcsports"
   ```
4. **YouTube作为备选** — 如果服务器在海外且中国网站全不可用，可降级用YouTube（需cookies文件绕过bot检测）
5. **不要把视频剪辑任务部署在海外服务器** — 如果有选择，把涉及中国视频源的工作放在国内VPS上执行

### 雨燕直播/YYZB系（2026-06-13新增）

**雨燕直播(yuyanzb4.net)** 是典型的中文体育直播平台，使用自有Cloudflare CDN(gtr-cloudflare.net)封锁海外IP。

**已知域名生态：**
| 域名 | 可访问性 | 内容 |
|------|---------|------|
| yuyanzb4.net | ❌ Cloudflare封锁 | 实际直播 |
| yuyantv.cn | ❌ Cloudflare封锁 | 实际直播 |
| yyzb1.tv | ❌ Cloudflare封锁 | 实际直播 |
| yuyanzb5.net | ❌ Cloudflare封锁 | 实际直播 |
| zh-front-yuyantv.com | ✅ 200但仅SEO页 | 菠菜推广，无直播内容 |
| downloads-yuyantv.com | ✅ 200但仅SEO页 | 菠菜推广，无直播内容 |
| cn-yyzb.com | ✅ 200仅落地页 | 菠菜推广，iframe加载无直播 |
| yuyan-aw.com | ✅ 200仅落地页 | 菠菜推广，无直播内容 |

**特征：**
- 主站 → Cloudflare CDN封锁海外IP → HTTP 000 (连接拒绝)
- SEO站 → 可访问但无实际流内容 → 纯菠菜推广落地页
- 实际直播流通过内嵌播放器在封锁域上播放
- 域名常换但可用Yahoo Japan搜索找到最新域名

**解决方案（优先级排序）：**
1. **国内VPS中转** — 通过国内服务器代理请求，最可靠
2. **用Dailymotion/CCTV/腾讯替代** — 如果只是为了找比赛视频，这些站已经够用
3. **用户本地机器中转** — 用户在China的Windows PC上运行转发工具
4. **尝试其他直播平台** — 企鹅直播(qie.tv)、龙珠直播(longzhu.com)等可能用不同CDN