代理退出后,只修理失效设置
现在
常用
截至 11 月 4 日 · 项目源码

代理异常退出后,不必先重启电脑:脚本会把死本地端口和不能继续工作的配置指出来,只在实际条件满足时执行相应清理。

当前情况:已发布图形入口提供检查、中文修复预览、确认后修改与基础网页检查。仍工作的代理会保留;这次只核对了源码、现有说明和一次本机只读状态,没有查看截图,也没有对当前网络执行修复或删路由。

这页内容按北京时间 2026-10-11 的源码写定(当时最后一次提交在 10 月 6 日 05:52),11 月 4 日再对照现行来源,没发现要改的;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

代理退出后,只修理失效设置
现在
常用
截至 11 月 4 日 · 项目源码

代理异常退出后,不必先重启电脑:脚本会把死本地端口和不能继续工作的配置指出来,只在实际条件满足时执行相应清理。

当前情况:已发布图形入口提供检查、中文修复预览、确认后修改与基础网页检查。仍工作的代理会保留;这次只核对了源码、现有说明和一次本机只读状态,没有查看截图,也没有对当前网络执行修复或删路由。

这页内容按北京时间 2026-10-11 的源码写定(当时最后一次提交在 10 月 6 日 05:52),11 月 4 日再对照现行来源,没发现要改的;具体测试保留各自日期,页面不实时探测运行状态。

项目源码:公开仓库

这项功能怎样使用
为什么需要它

系统代理、环境变量、Git 与路由表各自保存状态。只修其中一处可能仍然断网;盲目删默认路由又可能雪上加霜。因此主入口先判断活监听与 TUN,再对每类配置分别决定保留、清理或拒绝动作。

举个实际例子

“代理退了,网页还报连接旧代理失败。”我在首页点检查并修复,先看到失效设置的中文预览;确认后才关闭指向死端口的系统代理并清理相关用户/Git 设置。界面分别显示配置回读与基础网页检查结果(不走显式代理,用 IPv4 依次请求百度和微软的连通性测试页);旧终端可能要重开。

最后我会得到什么

窗口逐项告诉我哪些失效代理设置已清、哪些仍在工作的设置被保留、旧网络路线是否因为缺少安全退路而没有动,以及基础网页是否打开。任一测试页正常返回就算打开;全部因为域名解析失败才报“域名解析失败”,其他情况报“未确认能上网”。这一项通过不代表海外网站或 AI 服务可用,也不证明绕开了 TUN。

这项功能怎样使用
为什么需要它

系统代理、环境变量、Git 与路由表各自保存状态。只修其中一处可能仍然断网;盲目删默认路由又可能雪上加霜。因此主入口先判断活监听与 TUN,再对每类配置分别决定保留、清理或拒绝动作。

举个实际例子

“代理退了,网页还报连接旧代理失败。”我在首页点检查并修复,先看到失效设置的中文预览;确认后才关闭指向死端口的系统代理并清理相关用户/Git 设置。界面分别显示配置回读与基础网页检查结果(不走显式代理,用 IPv4 依次请求百度和微软的连通性测试页);旧终端可能要重开。

最后我会得到什么

窗口逐项告诉我哪些失效代理设置已清、哪些仍在工作的设置被保留、旧网络路线是否因为缺少安全退路而没有动,以及基础网页是否打开。任一测试页正常返回就算打开;全部因为域名解析失败才报“域名解析失败”,其他情况报“未确认能上网”。这一项通过不代表海外网站或 AI 服务可用,也不证明绕开了 TUN。

结果怎么看
正常时

确认失效的本机设置已清,仍在工作的代理保持原样;设置与网页测试分别报告,旧终端可能要重开。

发现问题时

找不到可靠的物理上网路线时,所有默认路线都保持原样;其他可安全处理的设置仍按预览逐项说明。

入口不可用或证据不足时

需要删除系统路线时,保持同一用户的身份核对,需要时自动提权;自动提权失败则停止这一步并明确报错。

结果怎么看
正常时

确认失效的本机设置已清,仍在工作的代理保持原样;设置与网页测试分别报告,旧终端可能要重开。

发现问题时

找不到可靠的物理上网路线时,所有默认路线都保持原样;其他可安全处理的设置仍按预览逐项说明。

入口不可用或证据不足时

需要删除系统路线时,保持同一用户的身份核对,需要时自动提权;自动提权失败则停止这一步并明确报错。

从哪里开始

双击根目录“00-打开 ProxyClean.vbs”,在首页点“检查并修复上网问题”,读中文预览后才点“开始修复”。

需要准备什么
  • 网页或命令行出现的故障
  • 是否还需要正在运行的代理
  • 预览后是否同意执行
从开始到拿到结果
1先检查
窗口读取系统代理、端口和路由;仍活着的代理路径会保留。
2预览后修复
只对预览中符合失效条件的配置保存原值并修改;没有可修项时不强行清理。
3回读并试网页
回读实际设置并做基础网页检查(百度、微软测试页);想逐站点看海外、AI 和 IPv6,另到维护工具点“检查联网情况”。失败或其他应用仍断网时看明确未处理范围,必要时用撤销恢复本轮可逆设置。
从哪里开始

双击根目录“00-打开 ProxyClean.vbs”,在首页点“检查并修复上网问题”,读中文预览后才点“开始修复”。

需要准备什么
  • 网页或命令行出现的故障
  • 是否还需要正在运行的代理
  • 预览后是否同意执行
从开始到拿到结果
1先检查
窗口读取系统代理、端口和路由;仍活着的代理路径会保留。
2预览后修复
只对预览中符合失效条件的配置保存原值并修改;没有可修项时不强行清理。
3回读并试网页
回读实际设置并做基础网页检查(百度、微软测试页);想逐站点看海外、AI 和 IPv6,另到维护工具点“检查联网情况”。失败或其他应用仍断网时看明确未处理范围,必要时用撤销恢复本轮可逆设置。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

物理默认路由保护已修复;隔离回归通过,真实网络未改动

关键规则与设计选择
1
不写入新的代理端点。默认只清失效本地项,Direct也仅处理手动WinINET、用户代理变量、来源明确的通用全局Git代理和满足物理回退条件的IPv4残留路由。
2
删除候选默认路由前必须至少看到一条 HardwareInterface=true、Up、NextHop 非零且非 fake-ip 的物理默认路由;否则本轮不删除任何路由。
3
系统代理仅在指向的本地端口已死或显式传 -Direct 时才关闭;活代理只在默认模式交由客户端维护。
4
PInvoke(平台调用)广播 WM_SETTINGCHANGE(超时 200ms)与 InternetSetOption 负责通知配置变化;已经运行的进程仍可能需要重开才能取得新的用户环境变量。
当前怎样实现
  • ProxyClean.Notifications 组件声明 SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 'Environment', timeout(等待超时)=200ms)。
  • 同一组件声明 InternetSetOption(SETTINGS_CHANGED 39, REFRESH 37)。
  • Get-PCListenerState 严格检验回环、通配地址和地址族的监听状态;监听集合改由 Get-PCTcpListener 的原生监听者专表提供,快照和 Test-LocalProxyDead 都换了这个入口。读不到时仍保留 unknown,不把未知端口当死端口。11 月 6 日 05:16 只读观察,没有执行清理。
  • Test-PCPhysicalRoute 检查网卡 Status 为 Up 且 NextHop 非 0.0.0.0 且非 198.18/198.19 fake-ip 网段。
技术实现与依据(一)

这里保留实现、关键条件、精确入口、历史记录和验证结果。

物理默认路由保护已修复;隔离回归通过,真实网络未改动

关键规则与设计选择
1
不写入新的代理端点。默认只清失效本地项,Direct也仅处理手动WinINET、用户代理变量、来源明确的通用全局Git代理和满足物理回退条件的IPv4残留路由。
2
删除候选默认路由前必须至少看到一条 HardwareInterface=true、Up、NextHop 非零且非 fake-ip 的物理默认路由;否则本轮不删除任何路由。
3
系统代理仅在指向的本地端口已死或显式传 -Direct 时才关闭;活代理只在默认模式交由客户端维护。
4
PInvoke(平台调用)广播 WM_SETTINGCHANGE(超时 200ms)与 InternetSetOption 负责通知配置变化;已经运行的进程仍可能需要重开才能取得新的用户环境变量。
当前怎样实现
  • ProxyClean.Notifications 组件声明 SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, 'Environment', timeout(等待超时)=200ms)。
  • 同一组件声明 InternetSetOption(SETTINGS_CHANGED 39, REFRESH 37)。
  • Get-PCListenerState 严格检验回环、通配地址和地址族的监听状态;监听集合改由 Get-PCTcpListener 的原生监听者专表提供,快照和 Test-LocalProxyDead 都换了这个入口。读不到时仍保留 unknown,不把未知端口当死端口。11 月 6 日 05:16 只读观察,没有执行清理。
  • Test-PCPhysicalRoute 检查网卡 Status 为 Up 且 NextHop 非 0.0.0.0 且非 198.18/198.19 fake-ip 网段。
技术实现与依据(二)
1
读取 WinINET 注册表与 Get-NetAdapter,检测系统代理发布端口与处于 Up 状态的 fake-ip TUN 路由。
2
依据现场判定目标:默认模式若有 WinINET 活端口或活动 TUN 就保留活路径,仅清死项;两者同时存在只告警。传 -Direct 则清空列出的代理设置,但仍不结束客户端进程或切 TUN。
3
执行默认路由条件扫描:备用候选少于 1 条就跳过全部删除;否则处理已消失/Down 网卡路由与直连目标下的 fake-ip 默认路由。
4
逐项审计用户环境变量与 Git 代理,判定为本地死端口则清空为直连,调用 User32 广播变更。
5
审计 WinINET 系统代理:若开着却指向死端口,则将 ProxyEnable 置 0 关停恢复直连。
  • Test-LocalProxyDead 解析代理端点,仅在全部端点为本地回环且无活跃监听时才断定为死代理。
  • Test-PCPhysicalRoute 在删除前与删除后共同检查 HardwareInterface=true;信息未知不充当物理路由证据。
  • ProxyClean.Operations.ps1 在效果前把原值和步骤写进本机 %LOCALAPPDATA%\ProxyClean\last-operation.json(UTF-8 JSON,原样保存恢复值,不另加密,靠当前 Windows 账户的文件权限),用主文件与 .previous 两个位置轮流保存:保留最近一份有效记录,把新记录写进另一份,强制落盘并读回核对后才退役旧槽,所以不会覆盖唯一的恢复文件;兼容 EFS 加密目录。预览不创建记录。以前用 DPAPI(Windows 自带的按账户加密)保护的 last-operation.dpapi 及其 .previous 仍能读来恢复,单纯读取不迁移格式;下次保存时先完整写好并回读 JSON 双槽,再退役旧槽。临写比较原值,写后回读,失败逆序恢复。外来修改保留为 recovery_required 并阻止新配置写入;只处理当前轮可撤销对象,文件不是跨设备恢复包。
执行流程
技术实现与依据(二)
1
读取 WinINET 注册表与 Get-NetAdapter,检测系统代理发布端口与处于 Up 状态的 fake-ip TUN 路由。
2
依据现场判定目标:默认模式若有 WinINET 活端口或活动 TUN 就保留活路径,仅清死项;两者同时存在只告警。传 -Direct 则清空列出的代理设置,但仍不结束客户端进程或切 TUN。
3
执行默认路由条件扫描:备用候选少于 1 条就跳过全部删除;否则处理已消失/Down 网卡路由与直连目标下的 fake-ip 默认路由。
4
逐项审计用户环境变量与 Git 代理,判定为本地死端口则清空为直连,调用 User32 广播变更。
5
审计 WinINET 系统代理:若开着却指向死端口,则将 ProxyEnable 置 0 关停恢复直连。
  • Test-LocalProxyDead 解析代理端点,仅在全部端点为本地回环且无活跃监听时才断定为死代理。
  • Test-PCPhysicalRoute 在删除前与删除后共同检查 HardwareInterface=true;信息未知不充当物理路由证据。
  • ProxyClean.Operations.ps1 在效果前把原值和步骤写进本机 %LOCALAPPDATA%\ProxyClean\last-operation.json(UTF-8 JSON,原样保存恢复值,不另加密,靠当前 Windows 账户的文件权限),用主文件与 .previous 两个位置轮流保存:保留最近一份有效记录,把新记录写进另一份,强制落盘并读回核对后才退役旧槽,所以不会覆盖唯一的恢复文件;兼容 EFS 加密目录。预览不创建记录。以前用 DPAPI(Windows 自带的按账户加密)保护的 last-operation.dpapi 及其 .previous 仍能读来恢复,单纯读取不迁移格式;下次保存时先完整写好并回读 JSON 双槽,再退役旧槽。临写比较原值,写后回读,失败逆序恢复。外来修改保留为 recovery_required 并阻止新配置写入;只处理当前轮可撤销对象,文件不是跨设备恢复包。
执行流程
技术实现与依据(三)
6
仅在命令行显式 -FlushDns 或维护窗口明确选择时刷新 DNS;普通修复不会自动执行。配置变更仍通知 WinINET。
7
GUI 已确认修复后回读配置,再做基础网页检查:不走显式代理,用 IPv4 依次请求百度和微软连通性测试页,任一 2xx 即算可访问。逐站点(国内、海外、AI,分 IPv4/IPv6)检查和公网出口比较各按维护入口另行选择,网页成功不证明所有应用直连。
技术实现与依据(三)
6
仅在命令行显式 -FlushDns 或维护窗口明确选择时刷新 DNS;普通修复不会自动执行。配置变更仍通知 WinINET。
7
GUI 已确认修复后回读配置,再做基础网页检查:不走显式代理,用 IPv4 依次请求百度和微软连通性测试页,任一 2xx 即算可访问。逐站点(国内、海外、AI,分 IPv4/IPv6)检查和公网出口比较各按维护入口另行选择,网页成功不证明所有应用直连。
名词和入口
本模块用到的名词
名词意思
Orphan Route Precondition(孤儿路由前置条件)在删除候选默认路由前,源码要求至少存在一条 HardwareInterface=true、Up、NextHop 非零且非 fake-ip 的物理默认路由;它明确要求 Windows 标记为物理接口,仍不等于主动测得网关或公网可达。
Direct Mode(强制直连模式)显式 -Direct 会关闭 WinINET、清空列出的用户代理变量并 unset Git 代理,即使值仍活跃或指向远程;它不结束客户端进程或切 TUN。
Loopback Dead Discrimination(本地死端口鉴别)严格区分 127.0.0.1 本地回环与远程代理服务器,只清已死的本地端口,避免误伤正常的远程代理配置。
专业定义

区分本地死端口、活代理与远程配置;PInvoke(平台调用)负责通知,清理后分别回读路由和连通性

名词和入口
本模块用到的名词
名词意思
Orphan Route Precondition(孤儿路由前置条件)
意思:
在删除候选默认路由前,源码要求至少存在一条 HardwareInterface=true、Up、NextHop 非零且非 fake-ip 的物理默认路由;它明确要求 Windows 标记为物理接口,仍不等于主动测得网关或公网可达。
Direct Mode(强制直连模式)
意思:
显式 -Direct 会关闭 WinINET、清空列出的用户代理变量并 unset Git 代理,即使值仍活跃或指向远程;它不结束客户端进程或切 TUN。
Loopback Dead Discrimination(本地死端口鉴别)
意思:
严格区分 127.0.0.1 本地回环与远程代理服务器,只清已死的本地端口,避免误伤正常的远程代理配置。
专业定义

区分本地死端口、活代理与远程配置;PInvoke(平台调用)负责通知,清理后分别回读路由和连通性

出问题时

解决什么

防止代理崩溃后因残留系统代理和孤儿 fake-ip 路由导致全机断网,防止网络修复工具误删物理路由引发二次灾难。

边界
  • 若当前没有符合源码谓词的备用默认路由,无论是否指定 -Direct,本轮都不删除任何路由条目。
  • Direct不是所有应用直连保证:PAC、WinHTTP、机器变量、URL专属/含糊Git配置、Docker与其他应用不隐式修改;混合映射中的其他端点保留。
  • NO_PROXY 环境变量包含用户白名单配置,脚本绝对不碰、不清空。
  • 普通用户权限下无法修改系统内核路由表,必须提升为管理员才能执行路由删除动作。
失败与恢复
  • 现场没有符合条件的备用默认路由: 脚本打印黄色警告并跳过全部路由删除,提示先确认 WLAN 或以太网;其余代理配置清理仍按各自条件继续。
  • 系统代理指向的端口正在正常监听: 脚本认定为活动代理,不关闭系统代理,仅提示交由客户端维护,保持现场不动。
  • 默认模式下 Git 代理同时包含有效远程代理与本地死端口: 默认保留无法安全定位的配置,Direct也不越过Git来源边界;先明确可写的通用全局配置,不删除含糊或URL专属项。
  • WinINET 活端口与活动 fake-ip TUN 同时存在: 默认模式只告警多路径,不替用户选择或关闭客户端;用户先决定保留哪一条,或明确选择 -Direct。
出问题时

解决什么

防止代理崩溃后因残留系统代理和孤儿 fake-ip 路由导致全机断网,防止网络修复工具误删物理路由引发二次灾难。

边界
  • 若当前没有符合源码谓词的备用默认路由,无论是否指定 -Direct,本轮都不删除任何路由条目。
  • Direct不是所有应用直连保证:PAC、WinHTTP、机器变量、URL专属/含糊Git配置、Docker与其他应用不隐式修改;混合映射中的其他端点保留。
  • NO_PROXY 环境变量包含用户白名单配置,脚本绝对不碰、不清空。
  • 普通用户权限下无法修改系统内核路由表,必须提升为管理员才能执行路由删除动作。
失败与恢复
  • 现场没有符合条件的备用默认路由: 脚本打印黄色警告并跳过全部路由删除,提示先确认 WLAN 或以太网;其余代理配置清理仍按各自条件继续。
  • 系统代理指向的端口正在正常监听: 脚本认定为活动代理,不关闭系统代理,仅提示交由客户端维护,保持现场不动。
  • 默认模式下 Git 代理同时包含有效远程代理与本地死端口: 默认保留无法安全定位的配置,Direct也不越过Git来源边界;先明确可写的通用全局配置,不删除含糊或URL专属项。
  • WinINET 活端口与活动 fake-ip TUN 同时存在: 默认模式只告警多路径,不替用户选择或关闭客户端;用户先决定保留哪一条,或明确选择 -Direct。
依据与来源
真实入口
  • ProxyClean.ps1: 命令行清理入口,预览、修复、撤销都调用与图形首页相同的共享流程(ProxyClean.Common.psm1、ProxyClean.Operations.ps1 等),实现死端口鉴别、候选孤儿默认路由条件处理与系统广播
  • ProxyClean.test.ps1: 测试执行入口,先检查全部脚本能否解析,再运行 tests/ 下 15 个测试文件
如何验证
  • 早先单文件测试验证过本地/远程/混合代理解析、活/死本地端口、隔离 Git 配置和只读状态 JSON;现在测试拆到 tests/ 下 15 个文件,共展开 385 个用例(北京时间 11 月 4 日 08:35 只做发现计数,没有运行;10 月 11 日数出的是 317 个),全套运行结果未知。
  • 2026-09-24 当时的变更记录载明 12 项新增注册表回归及整仓 193 项通过(该记录文件 9 月 26 日已从仓库删除,可在 Git 历史查到);9 月 25 日版本 277 项在两版 PowerShell 通过也是历史记录;9 月 22 日隔离客户端流程验证保留原日期。这些都未在本人当前网络关闭代理,也不证明公网或所有应用恢复。
  • 源 857b110 的新增回归包含 9 个判定场景与 3 个实际清理条件分支:只有虚拟备用时零删除、活动 TUN 保留、Direct 模式下符合条件的孤儿清理。旧实现先失败,新实现双 PowerShell 通过。
与其他模块的关系

首页“检查并修复上网问题”的配置修复核心,也是命令行默认清理与显式直连的技术依据;普通修复不自动刷新 DNS。

依据与来源
真实入口
  • ProxyClean.ps1: 命令行清理入口,预览、修复、撤销都调用与图形首页相同的共享流程(ProxyClean.Common.psm1、ProxyClean.Operations.ps1 等),实现死端口鉴别、候选孤儿默认路由条件处理与系统广播
  • ProxyClean.test.ps1: 测试执行入口,先检查全部脚本能否解析,再运行 tests/ 下 15 个测试文件
如何验证
  • 早先单文件测试验证过本地/远程/混合代理解析、活/死本地端口、隔离 Git 配置和只读状态 JSON;现在测试拆到 tests/ 下 15 个文件,共展开 385 个用例(北京时间 11 月 4 日 08:35 只做发现计数,没有运行;10 月 11 日数出的是 317 个),全套运行结果未知。
  • 2026-09-24 当时的变更记录载明 12 项新增注册表回归及整仓 193 项通过(该记录文件 9 月 26 日已从仓库删除,可在 Git 历史查到);9 月 25 日版本 277 项在两版 PowerShell 通过也是历史记录;9 月 22 日隔离客户端流程验证保留原日期。这些都未在本人当前网络关闭代理,也不证明公网或所有应用恢复。
  • 源 857b110 的新增回归包含 9 个判定场景与 3 个实际清理条件分支:只有虚拟备用时零删除、活动 TUN 保留、Direct 模式下符合条件的孤儿清理。旧实现先失败,新实现双 PowerShell 通过。
与其他模块的关系

首页“检查并修复上网问题”的配置修复核心,也是命令行默认清理与显式直连的技术依据;普通修复不自动刷新 DNS。

数字截至 2026 年 11 月 6 日

复制 AI 续作说明

项目:代理退出后,只修理失效设置;仓库:wlyaaaaa/ProxyClean;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。

把“目标”换成这次要做的事,整段复制给 AI。