网络连通性

多数网络环境可以直接访问 shuro.vip。本章只针对少数特殊网络环境的连通性配置。

你需要看这一章吗

现象	是否要看
Shuro 主页打不开	✅ 看
claude.ai/install.sh 下载失败或返回 HTML	✅ 看
npm install -g 拉包慢	✅ 看
一切正常	❌ 跳过

安装阶段的网络问题

curl install.sh | bash 在某些网络环境下会静默失败：脚本打 ✅ 但实际没装上。

详细见 区域访问问题。简单总结：改用 npm 安装路线：

# 不依赖 claude.ai 的 CDN
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
npm install -g @anthropic-ai/claude-code

# 加 PATH
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
exec $SHELL

npm registry 一般不受影响。

运行时连通性

如果你公司网络要求所有出站流量经过特定网关：

zsh / bash

export HTTPS_PROXY="http://corp-gateway:port"
export HTTP_PROXY="http://corp-gateway:port"
export NO_PROXY="localhost,127.0.0.1"

claude

fish

set -Ux HTTPS_PROXY "http://corp-gateway:port"
set -Ux HTTP_PROXY "http://corp-gateway:port"

claude

PowerShell

$env:HTTPS_PROXY = "http://corp-gateway:port"
$env:HTTP_PROXY = "http://corp-gateway:port"

claude

具体网关地址请咨询你的网络管理员。

NPM 加速

国内 npm 拉包慢可以换源：

# 临时
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 永久
npm config set registry https://registry.npmmirror.com

TLS / 证书问题

某些企业网络中转了 HTTPS 流量，需要信任企业 CA：

# 加企业 CA 到 trust store
export NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem
claude

不要长期开

export NODE_TLS_REJECT_UNAUTHORIZED=0   # ⚠️ 跳过 TLS 验证

只在排错时临时用，正式环境别开。

DNS

如果 nslookup shuro.vip 解析慢/失败：

# 用公共 DNS 测一下
nslookup shuro.vip 1.1.1.1
nslookup shuro.vip 8.8.8.8

如果用公共 DNS 能解析但默认 DNS 不行 → 联系网络管理员或换 DNS。

故障速查

错误信息	可能原因
Could not resolve host: shuro.vip	DNS 解析问题
Connection timed out	网络出口被限制
SSL certificate problem	企业 CA 中间件
npm ERR! network ETIMEDOUT	npm 源访问问题

如确认网络层正常但仍连不通，向 Shuro 反馈（TODO/VERIFY：Shuro 反馈渠道待确认），附上：

• curl -sS -v https://shuro.vip 2>&1 | head -30 的输出
• 你所在的网络环境描述（公司内网 / 家庭 / 移动网络等）