用途与实际影响
这项功能怎样使用
为什么需要它
只结束进程会留下失效代理配置，只改配置又不能关闭卡住的监听。因此先核对并停止本次目标，确认端口关闭后才清对应引用；进程结束不能撤销，设置修改则按本轮原值有条件回退，两类结果分别说明。
举个实际例子
“我想关飞鸟，保留另一个代理。”首页若只见飞鸟便直接显示预览；有多个客户端时先选飞鸟。确认后先正常退出，仍未退出时另看强制范围。相关端口全关且身份未变，才一次清理飞鸟留下的设置。
最后我会得到什么
分别看到客户端是否退出、相关端口是否关闭、配置是否回读、微软基础网页是否可访问。旧版在清理 Windows 和用户代理设置时可能写入失败；当前正式源码已修复并通过隔离回归，真实使用仍以当次回读为准。其他客户端、PAC、活 TUN 和应用独立代理保留，不能宣布所有流量直连。
正常时
所选客户端与辅助服务退出、相关端口关闭并完成设置回读后，才报告已处理的范围；2026-09-22 的隔离验证不等于本站关闭了本人当前代理。
发现问题时
正常退出不完整时先停止设置清理并展示强制关闭范围；客户端重启、端口换主人、进程身份变化或配置冲突时不沿用旧预览继续清理。
入口不可用或证据不足时
受保护进程或服务需要 UAC 时保留客户端选择，管理员窗口重新检查并要求再确认；仍无法安全识别时不结束未知进程。
从哪里开始
在 ProxyClean 首页选择“关闭代理，恢复普通上网”；若发现多个客户端，先选具体客户端，再看预览并确认。单端口维护走独立维护窗口。
需要准备什么
- 想关闭的代理客户端
- 正常退出失败时是否允许另行强制关闭
从开始到拿到结果
- 1
选准客户端
首页列出可识别目标；多客户端先选一个，管理员窗口会重新核对同一身份。
- 2
分段关闭
先请求正常退出；仍未退出时另给强制关闭预览，不能把两次选择合并。
- 3
只清相关引用
端口确实不再由目标占用后才清其系统引用；重启、接管或核对失败时停止并保留其他代理。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
客户端关停后的设置写入缺陷已修并有隔离回归；本站未关闭本人当前真实代理关键规则与设计选择
技术端口入口的地址门接受 127.0.0.1、::1、0.0.0.0 与 ::；只绑定特定局域网地址的监听不处理，但通配监听覆盖所有接口，仍需用户先确认端口身份。
首页按客户端动态识别进程与多个端口，不依赖旧固定端口表；技术端口脚本仍仅在显式 ExtraProcessName 时追加所列进程。
仅移除已确认目标端点，混合映射中的其他协议或远程端点保留，不整串清空。
受保护进程/服务需要提权时保留客户端选择；新窗口重新检查并再确认，不在 UAC 后立刻断开。
首页先正常退出再单独确认强制关闭；同客户端多个端口相关引用合为一次可恢复配置操作。技术端口入口不会在处理后调用通用主清理。
本模块用到的名词
- Client Group（客户端归组）
- 日常关闭按实际进程父子关系把控制器、核心和辅助服务归于同一客户端；同名 GUI 恰好在运行不构成归组证据，多个端口的引用在一次可恢复配置操作中处理。
- Sequenced Port Cleanup（顺序端口清理）
- 进程停止与配置修复是两种效果：设置有本轮原值和条件撤销，进程不能自动复活；最终分别核对而非合称原子成功。
- Listen Address Gate（监听地址门）
- 只采纳回环或通配监听，拒绝只绑定特定局域网地址的服务；通配地址不是回环，不能替代用户对目标端口身份的确认。
专业定义
按客户端预览、正常退出与独立强制确认；身份或端口变化就停止设置清理
解决什么
防止代理客户端挂死后难以精确定位进程，防止杀掉进程后留下指向死端口的系统代理导致立即断网。
当前怎样实现
- ProxyClean.Clients.ps1 按可识别客户端及实际父子关系归组控制器、核心和辅助服务；动态发现端口，不把另一个恰好运行的 GUI 误认作核心父进程。
- Get-PCClientClosePreview 保存当前进程、端口和所选客户端；Invoke-PCClientClose 先请求窗口/服务正常退出，剩余进程须新的强制预览与确认。
- 临效果复核进程身份、端口与配置；重启、接管或查询失败即停止清理。多个端口对应设置合成一次受 DPAPI 保护的可恢复事务。
- Stop-ProxyPort.ps1 保留技术端口级预览，旧快捷方式只操作名称中的端口并核对预期客户端；不会调用全机通用清理。
执行流程
- 1
首页发现一个已识别客户端时直接进入其预览；多个时先选一个，未识别时引导检查设置。
- 2
确认后先请所选客户端和辅助服务正常退出；未完全退出时保留设置，另行展示强制关闭范围。
- 3
明确再确认后才结束重新核实身份的剩余进程；端口换主人或客户端重启即停止后续设置清理。
- 4
相关端口确认关闭后，一次清理仅指向它们的设置并回读，另测微软基础网页；PAC、活 TUN、其他客户端及应用独立代理列为保留范围。
- 5
技术维护按明确端口可单独预览和关闭；进程不能由配置撤销复活，设置冲突与恢复待处理分别报告。
边界
- 若监听进程的 PID 等于当前脚本自身 PID，自动跳过防止自杀。
- 只绑定在局域网特定地址上的服务不处理；0.0.0.0/:: 通配监听仍会处理，因为它也是源码的现行地址门。
- 旧 18090、18091 与 7892 端口快捷方式已移入旧版入口；日常关闭使用按客户端动态发现的首页流程。维护窗口或 PowerShell 可显式指定其他端口。
- 首页只处理所选客户端及其已核实端口；技术端口入口只处理所选端口的监听者与对应引用，额外进程仅来自显式 ExtraProcessName。两者都不默认关闭其他客户端或清空混合字符串。
失败与恢复
- 正常退出后仍有成员在运行，或端口被占用
- 不清理可能仍在使用的设置；先显示未完成范围，另行预览并确认强制关闭，仍不成功就返回客户端自身退出指引。
- 进程身份、端口或配置在预览后变化
- 停止沿用旧预览，保留后续修改，重新检查所选客户端；已退出进程不会由配置恢复记录重新启动。
- 未能停止一个监听 PID 或附加进程
- 报告哪个目标未能关闭，保留当前真实监听与设置结果；配置失败按前像恢复，不把继续运行的监听者冒称已结束。
- 查询后进程自行退出或端口原本没有监听
- 报告没有监听或原本关闭，不结束旧映射客户端；仅执行仍明确授权的目标配置计划，其他端点和路由保持。
- 用户给出的通配监听端口属于非代理服务
- 源码无法从地址门证明身份；因此产品入口要求用户先确认端口所属进程，网页不会建议盲目试端口。
真实入口
Stop-ProxyPort.ps1维护时的指定端口预览、身份复核与精确关闭入口；不承担首页客户端归组。
ProxyClean.Clients.ps1 / ProxyClean.Workflow.ps1 / ControlCenter.ps1日常客户端归组、正常/强制分步关闭、配置事务和结果显示
如何验证
- ProxyClean.test.ps1 验证回环、通配、特定局域网地址的采纳边界和多 PID 去重。
- 源 2026-09-24 变更记录载明客户端关停后的注册表写入缺陷已修并有新增隔离回归；9 月 22 日正常与强制关停隔离验证保留原日期。本站未关闭本人当前代理，不把隔离结果称为真实网络恢复。
与其他模块的关系
日常关闭代理的客户端级流程；Stop-ProxyPort.ps1 是维护时针对明确端口的独立技术入口。配置撤销不能复活进程。