主机与代理

功能概述

主机与代理（插件标识：ssh-proxy-helper）是 ZTools 极客桌面效率中枢面向 系统工具 场景打造的官方核心扩展。解析 ~/.ssh/config 一键唤起终端直连或建立端口转发隧道；一键为 Git、NPM、终端开启或关闭本地代理端口。

• 底层核心痛点：
• SSH 主机管理割裂：开发者日常维护大量云服务器、跳板机、测试服与开发机，虽然在 ~/.ssh/config 中配置了 Host，但时间一长容易遗忘别名与 IP，每次都要打开文本编辑器翻找配置文件；
• 临时端口转发繁琐：经常需要把云端内网的 MySQL (3306)、Redis (6379) 或远程 Web 端口临时映射到本地，手敲长串 ssh -L 3306:127.0.0.1:3306 user@host -N 极易输错参数；
• 开发工具链“代理断流”困境：虽然桌面端开启了代理客户端，但终端（PowerShell/Bash）、Git 命令行与 NPM 默认不走系统代理，导致 git clone 失败或 npm install 超时；开发者每次都需要翻找笔记手动拷贝 export http_proxy=http://127.0.0.1:7890 或 git config --global http.proxy ...，用完又容易忘记取消，导致内网私有仓库拉取报错。
• 脱离历史惯性设计：
• 双核合一设计：将“SSH 远程服务器检索与秒连”和“开发环境代理一键开关”两大高频运维场景收敛在一个插件中；
• 自动探测本地 Clash / V2Ray / Sing-box / Surge 常用监听端口（如 7890、10808、10809），一键同步为 Git、NPM、系统终端配置代理并一键复原；
• 自动解析 ~/.ssh/config，回车秒开终端直连，Ctrl+T 交互式建立本地端口转发隧道。

• 架构标准：@ztools/declarative-ui 声明式 UI 视图描述符 | 运行沙箱：Worker 隔离宿主 + 原生系统桥接 | 分类：系统工具

---

核心功能特性

1. Git 全局代理：一键执行 git config --global http.proxy http://127.0.0.1:<port> 与 https.proxy；
2. NPM / Yarn 代理：一键写入 npm config set proxy 与 https-proxy；
3. 终端环境变量：复制开箱即用的跨平台终端激活指令（PowerShell: $env:http_proxy=...；Bash: export http_proxy=...）。
4. 回车秒连 / 切换代理：若选中置顶代理卡片，回车切换代理开关；若选中 SSH 主机，回车立即打开终端建立连接。
5. 建立端口转发：为当前选中的主机弹出端口转发配置表单。
6. 编辑配置文件：直接在默认编辑器（VS Code / 记事本）中打开 ~/.ssh/config 源码文件。

---

典型高频使用场景

• 场景 1：聚合查看所有 SSH 主机列表、端口转发与开发环境代理状态 — 当你需要快速执行该任务时，按下 Alt+Space 输入 ssh / 主机管理 / ssh连接 / 代理管家 / git代理，回车即可直接进入 ssh-all 视图完成处理并一键复制或导出结果。
• 场景 2：一键快速切换 Git / NPM / 终端的本地代理开关 (7890/10808) — 当你需要快速执行该任务时，按下 Alt+Space 输入 切换代理 / 开启git代理 / 关闭git代理 / 终端代理，回车即可直接进入 ssh-proxy-toggle 视图完成处理并一键复制或导出结果。
• 场景 3：基于 SSH 快速建立本地至远程主机的端口转发隧道 — 当你需要快速执行该任务时，按下 Alt+Space 输入 端口转发 / ssh隧道 / 建立隧道，回车即可直接进入 ssh-tunnel 视图完成处理并一键复制或导出结果。

---

唤醒指令与全键盘快捷操作指南

在任何桌面窗口下按下 Alt + Space（macOS 为 Option + Space）呼出 ZTools 搜索框，输入以下指令词即可直达 主机与代理 的对应功能模块：

全局高频键盘快捷键

---

架构性能与安全隐私保障

• 声明式 UI 零闪烁渲染：界面严格采用 @ztools/declarative-ui 的 List / Detail / Form / ActionPanel 语义组件声明，由 ZTools 宿主统一渲染并原生适配深色（Dark）与浅色（Light）双主题。
• 最小权限与沙箱隔离：本插件在清单（plugin.json）中显式声明最小化权限集 ["fs", "shell", "clipboard"]，所有系统调用均受 ZTools 宿主桥接层与 AST 静态安全门禁严格审计。
• Local-First 本地离线原则：所有配置项、历史记录与业务数据 100% 存储在用户本地（SQLite / LocalStorage），绝不向任何第三方服务器静默上传敏感信息。

---

延伸阅读与技术内链

关联技术与效率专栏文章

• C盘又红了别乱删！用这个清爽无捆绑的空间分析器，10秒揪出偷吃硬盘的元凶
• 电脑文件太多找半天？这款免费开源神器，100万个文件也能0.03秒瞬间搜出！
• 100 万文件检索仅需 0.035ms！基于 Rust 的 NTFS MFT 裸盘索引与 USN 增量追踪实战
• 卸载电脑里臃肿的广告软件吧！这一个不到100M的开源工具箱，顶替38款日常软件

同分类热门效率插件推荐（系统工具）

• Everything 文件秒搜 插件详情与使用指南
• 软件管理与强力卸载 插件详情与使用指南
• 磁盘空间分析器 插件详情与使用指南
• 进程监控与管理 插件详情与使用指南
• 浏览 ZTools 插件市场全部扩展
• 下载 ZTools 极客桌面效率中枢（Windows & macOS）