如何用 portless clean 从机器上彻底移除 portless：它清理了什么、保留什么

如何用 portless clean 从机器上彻底移除 portless它清理了什么、保留什么【免费下载链接】portlessReplace port numbers with stable, named local URLs. For humans and agents.项目地址: https://gitcode.com/GitHub_Trending/por/portless当你不再想在某台机器上使用 portless或者想把它的代理状态、本地 CA 和 hosts 改动全部撤掉时官方提供的清理入口是portless clean。它一次完成四件事停止正在运行的代理、卸载开机启动服务、从系统信任库移除 portless 自签的本地 CA、删除状态目录下的已知文件并移除/etc/hosts中的 portless 代码块。执行完这条命令portless 在本机留下的系统级痕迹就被清掉了。本文基于 README.md、命令文档 和 clean 实现 中的描述整理适用于 macOS、Linux 和 Windows。环境要求与 portless 本身一致Node.js 24。它清理了什么portless clean没有参数也不接受其他子选项portless clean --help之外的参数会直接报Error: Unknown argument。它的执行顺序是卸载开机启动服务如果安装过。portless service install写入 launchd、systemd 或 Task Scheduler 的服务会被自动移除macOS/Linux 上可能需要 sudo 提权。停止正在运行的代理。如果 proxy 正在跑clean 会先把它停掉。清理共享注册。与残留路由绑定的 Tailscale serve/funnel 注册会被注销ngrok 隧道会被停止。从系统信任库移除本地 CA前提是这份 CA 是 portless 安装的。删除状态目录下的已知文件然后移除 hosts 文件中的 portless 代码块。第 5 步覆盖的状态目录有三个~/.portless当前所有状态的所在地、遗留系统状态目录Linux 上是/tmp/portlessWindows 上是临时目录下的portless以及设置了PORTLESS_STATE_DIR时对应的自定义目录。删除是按文件名白名单进行的目前白名单为见 clean-utils.tsroutes.json、routes.lock、proxy.pid、proxy.port、proxy.log、proxy.tls、 proxy.custom-cert、proxy.tld、proxy.tlds、proxy.lan、ca.trusted、 ca.trust-refresh-pending、ca-key.pem、ca.pem、server-key.pem、 server.pem、server.csr、server-ext.cnf、ca.srl外加整个host-certs子目录按主机名缓存的证书就在这里。执行步骤portless cleanmacOS / Linux如果代理、信任库或/etc/hosts需要更高权限portless 会自动请求 sudo 提示/etc/hosts更新失败时它会提示你手动运行sudo portless clean。Windows如需提权以管理员身份运行即可无 sudo 流程。命令末尾输出Clean finished.表示主流程走完。过程中会逐项打印结果例如Removed startup service.、Removed local CA from the system trust store.、Removed portless state files from known state directories.。它保留什么以下几点是portless clean明确不会做的事自定义证书不动。你曾经用--cert/--key传给portless proxy start的证书和私钥文件永远不会被删除。状态目录只删白名单文件。~/.portless等目录下不属于上述白名单的其他文件原样保留目录本身不会被递归清空。信任库移除失败时保留 CA 身份文件。如果系统信任库里的 CA 没删掉常见于权限不足portless 会故意保留ca.pem、ca-key.pem和ca.trust-refresh-pending并提示Retained CA identity files so trust removal can be retried safely.让你之后可以用更高权限重试而不是留下一个删不掉的孤儿证书。此时文档给出的处理是sudo portless cleanLinux或手动删除证书。验证清理结果清理后可以用portless doctor复核。它是只读检查不改变状态覆盖 Node.js 版本、状态目录、代理存活、路由条目、CA 信任、主机名解析等项并打印建议的修复项。代理已被停止、状态文件已删除时doctor 的报告应反映这些项已不存在而不是继续显示运行中的代理。portless clean portless doctor如果还装过开机服务portless service status也可以确认服务已不在。边界说明portless clean只处理 portless 自己写入的系统状态服务、CA 信任、状态文件、hosts 块。README 的 Uninstall/reset 章节把它的范围描述为~/.portless下的代理状态、系统状态目录、由 portless 安装的本地 CA、以及/etc/hosts中的 portless 块。清理与PORTLESS_STATE_DIR有关如果你把状态写到了自定义目录例如PORTLESS_STATE_DIR~/.portless-lanclean 会连同该目录一起清理不需要另外处理。清理前如果有开发服务器还挂在 portless 路由下clean 停止代理后这些应用将不再有https://name.localhost入口它不会去终止这些子进程孤儿进程需要的话用portless prune单独处理。完成清理并验证后如果机器上还有 portless 的 npm 全局安装按常规npm uninstall -g portless移除包本身即可——这一步不在 clean 的职责范围内。【免费下载链接】portlessReplace port numbers with stable, named local URLs. For humans and agents.项目地址: https://gitcode.com/GitHub_Trending/por/portless创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考