服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- A 与 AAAA 记录只能说明 DNS 返回哪些地址,不能证明实际连接路线。
- 无凭据请求返回 404 只证明请求到达 HTTP 层,不验证身份或资源权限。
- 仅对当前 PowerShell 进程临时追加 IPv4 优先,finally 按原样恢复 NODE_OPTIONS。
- Wrangler 4.158.0 下的一次恢复观察,不代表所有 Windows/Node 网络都有相同原因。
先将网络阶段与身份阶段分开
Windows 上 Wrangler 4.158.0 请求 API 失败时,先确认 Node 与 Wrangler 版本、失败发生在名称解析、TLS 握手还是 HTTP 响应阶段。静态网站加载正常不能证明 API 路由正常;而收到 401、403 或 404 已表示请求到达某个 HTTP 响应,但不说明登录、权限或资源有效。
保存脱敏后的状态码、时间和工具版本即可。不要复制访问令牌、OAuth 授权码、账户 ID、邮箱、请求头或包含私有主机信息的完整日志。
检查 A 与 AAAA,并记录实际 Node 版本
分别查询目标公共 API 主机的 A 与 AAAA 记录,确认 DNS 返回 IPv4、IPv6 中的哪些地址。两种记录都存在并不表示客户端会依次尝试,也不能证明某个地址可连接;解析结果只是一项 DNS 证据。
记录 Node 与 Wrangler 版本。这里讨论的是 Windows 上 Wrangler 4.158.0 的一个有界观察;Node 的 DNS 默认顺序会随版本和启动选项变化。只有当当前 Node 版本支持 Node 官方文档中的 dns-result-order 选项时,才考虑下面的进程级检查。
无凭据的 404 只用于确认 HTTP 层
对官方文档明确的只读路径发出不带令牌的请求,可以区分 DNS/TLS/连接失败与 HTTP 响应。若收到 404,它只说明请求到达 HTTP 服务器并且该路径未匹配;不能证明 Cloudflare 身份、token 作用域或部署权限正常。
如果响应前发生超时、证书校验或名称解析错误,分别检查连接路径、系统证书和 DNS。不要关闭 TLS 验证,也不要把无凭据 404 当成 API 修复或账户验证。
无凭据检查 HTTP 可达性
powershellcurl.exe --connect-timeout 10 --max-time 20 --silent --show-error --output NUL --write-out "%{http_code}\n" "https://REPLACE_WITH_PUBLIC_API_HOST/REPLACE_WITH_DOCUMENTED_READ_ONLY_PATH"
查询公共 API 主机的 A 与 AAAA 记录
powershell$publicApiHost = "REPLACE_WITH_PUBLIC_API_HOST"
Resolve-DnsName -Name $publicApiHost -Type A
Resolve-DnsName -Name $publicApiHost -Type AAAA
验证身份与作用域时保护输出
网络层收到响应后,再用 Wrangler 的只读身份检查确认当前授权上下文,并由账户所有者核对目标资源和最小必要作用域。命令输出可能含邮箱、组织或账户信息,应仅在可信终端查看,支持请求只提供脱敏成功/失败状态。
环境变量或本地登录态的来源不明确时,不要同时设置多种 token,也不要重用同事的 OAuth 身份。若确需轮换,先确认调用方、必要权限和旧凭据撤销计划,再按 Cloudflare 官方安全流程办理。
仅对一个子进程临时测试 IPv4 优先
若 A 与 AAAA 均返回地址,且故障证据指向该 Node 进程的解析顺序,可在当前 PowerShell 进程中保存 NODE_OPTIONS 原先是否存在及其原值,再追加 dns-result-order=ipv4first 并运行一次只读 whoami。finally 必须按原样恢复变量:原来未设置就移除,原来存在则恢复精确原值。
此做法只影响由当前进程启动的 Wrangler 子进程,不写用户或系统级环境。它不会禁用 IPv6,也不能证明哪条网络路径是根因;用完立即恢复,不要将临时值写入配置文件或长期 shell profile。
当前进程追加并恢复 NODE_OPTIONS
powershell$nodeOptionsWasSet = [Environment]::GetEnvironmentVariables('Process').Contains('NODE_OPTIONS')
$previousNodeOptions = [Environment]::GetEnvironmentVariable('NODE_OPTIONS', 'Process')
try {
$dnsOption = '--dns-result-order=ipv4first'
if ([string]::IsNullOrWhiteSpace($previousNodeOptions)) {
[Environment]::SetEnvironmentVariable('NODE_OPTIONS', $dnsOption, 'Process')
} else {
[Environment]::SetEnvironmentVariable('NODE_OPTIONS', "$previousNodeOptions $dnsOption", 'Process')
}
wrangler whoami
}
finally {
if ($nodeOptionsWasSet) {
[Environment]::SetEnvironmentVariable('NODE_OPTIONS', $previousNodeOptions, 'Process')
} else {
[Environment]::SetEnvironmentVariable('NODE_OPTIONS', $null, 'Process')
}
}
把一次观察限制在当前环境
此处说明的观察范围是 Windows、Node.js 与 Wrangler 4.158.0 下的一次 API 检查。IPv4 优先后某请求成功,只能确认当时这一请求的结果;不能证明所有 Cloudflare API、账户、网络或 Node 版本都会因此恢复,也不能据此确认之前的故障是 IPv6、DNS 或代理造成。
如果临时测试没有改变结果,按 finally 还原后继续分别核对身份、资源权限、代理与官方服务状态。若结果改变,也应还原变量并用相同的只读请求复核一次;不确定的远端业务操作不要盲目重试。
资料来源
常见问题
API 根路径返回 401 或 404,是否说明网络不通?
不一定。收到 HTTP 状态通常表示 DNS、TLS 和 HTTP 已经到达响应阶段;它不代表认证或指定 API 路由有效。
wrangler whoami 可以把结果发到工单吗?
不要发原始输出。它可能包含邮箱、组织和账户信息;只提供脱敏的成功/失败状态和必要错误类别。
更换 token 时可以先加上所有权限试试吗?
不可以。由有权限的所有者按当前任务所需的最小权限范围检查,并记录旧 token 的撤销计划。