Secure Pipes 入门

在 macOS 上创建第一个 SSH 隧道，了解各个页面，并掌握连接前的检查要点。

开始之前

Secure Pipes 是适用于 macOS 12 或更高版本的菜单栏 SSH 连接管理器。您需要一台可访问的 SSH 服务器、服务器地址和端口、获准连接的账户，以及密码或合适的私钥。Secure Pipes 不提供 SSH 服务器或代理订阅。

从 secure-pipes.app 下载应用，打开磁盘映像，将 Secure Pipes 拖入“应用程序”文件夹并启动。透明代理需要系统扩展授权，普通的高位端口 SSH 隧道则不需要。

本指南的截图使用英文界面和示例设置。ssh.example.com 只是示例地址，并非可用的服务。 请替换为自己的服务器。截图用于展示配置步骤，并不代表已成功连接到示例服务器。

认识主要页面

页面	主要用途
连接	保存主机，配置本地/远程隧道和SOCKS代理，打开控制台和SFTP
代理	管理路由服务器、DNS、规则和活动代理连接
自动化	查看并复制 AppleScript 和 spcli 示例
通用	选择语言和外观、设置应用锁、导出备份
日志	过滤事件并检查连接问题
许可证	查看免费版/专业版限制、试用资格和激活状态
信息	检查版本、网站和问题报告链接

关闭主窗口后，仍可通过菜单栏操作。关闭窗口不会退出应用；退出应用则会停止活动连接。

创建可重用的主机

1. 打开 连接，单击 +，然后选择 新增预设主机...。
2. 为主机填写便于辨认的名称、SSH 服务器地址、SSH 端口及用户名。
3. 输入密码或选择 私钥 并选择您的密钥文件。也可以暂不保存凭据，连接时再输入。
4. 保存主机后，即可在预设主机中找到它。

有关密钥、跳板主机和服务器信任，请参阅SSH 主机和身份验证。

创建您的第一个隧道

对于在 SSH 服务器上监听端口 5432 的数据库：

1. 选择 + → 新增本地转发…，将连接命名为 Database Tunnel。
2. 选择您的预设主机，或直接填写 SSH 详细信息。
3. 设置本地监听为127.0.0.1，端口15432。
4. 将远程 TCP 地址设为 127.0.0.1，端口设为 5432。此处的远程地址以 SSH 服务器所在网络为准。
5. 添加连接配置并单击 连接。如果询问，请提供缺少的身份验证信息。
6. 首次使用时，请将服务器指纹与服务器管理员提供的可信值进行比较，然后再接受。
7. 连接后，将数据库客户端指向 127.0.0.1:15432。

有关逐字段解释和多个映射，请参阅本地端口转发。

检查结果

保存了连接配置并不代表已经连接。先检查连接状态，再用实际要使用的客户端测试。即使 SSH 会话已连接，目标端口仍可能拒绝访问，服务器也可能限制转发。

使用完毕后点击断开。除非需要让其他设备访问，否则请保持监听环回地址。批量调整连接前，先导出加密备份。

选择正确的连接类型

• 本地转发: 从本地端口到达特定的远程 TCP 服务或远程 Unix 套接字。
• 远程转发: 让 SSH 服务器通过服务器端监听器到达 Mac 上的服务。
• SOCKS 代理： 为支持代理的应用提供本地 SOCKS 接入点，目标地址由该应用选择。
• 透明代理: 在安装并批准系统扩展后，根据规则路由支持的 Mac 应用程序流量。
• 局域网共享： 让支持代理的设备通过 HTTP/SOCKS 接入点使用已有的透明代理路由配置。

对于面向任务的示例，请打开使用场景。

组织和管理连接

对仅因目的地或环境而异的连接配置使用清晰的名称。要重复使用设置，请从连接配置的操作中选择“复制”，然后在连接之前编辑副本的名称、监听器和目标。当两个连接配置运行时，复制的监听器端口可能会与原始监听器端口发生冲突。

在编辑器的 标签: 字段中添加标签，然后使用工具栏中的 连接分组 查看按标签分组的连接。标签也是AppleScript和spcli使用的组名称。在发出组命令之前检查成员。可用标签容量取决于当前许可证。

列表选项菜单包括新增分类、一次只展开一组、显示条目副标题和显示条目数量（如果适用）。类别组织连接列表；不要假设类别名称是自动化标签。

对于本机 SSH 配置下的条目，复制为预设主机从选定的 SSH 配置条目创建应用程序管理的预设。这不会编辑原始 SSH 配置文件。稍后更改预设时请记住这一区别。

使用断开来停止隧道；删除其保存的连接配置是一个单独的操作。如果菜单显示取消重试，则连接配置正在等待重新连接。在更改您正在诊断的设置之前取消重试。