SSHPortForwarder Support Doc.zh Hans

🌐 English · العربية · Deutsch · Español · Français · Italiano · 日本語 · 한국어 · Nederlands · Português (BR) · Русский · ภาษาไทย · Türkçe · 简体中文 · 繁體中文

---

SSH 端口转发器支持文档

快速开始

SSH 端口转发器（SSHPortForwarder）是一款 macOS 应用，用于创建 SSH 端口转发和 SOCKS 代理。您可以配置远程主机、端口和认证方式（密码或私钥），然后启动转发，即可获得本地端口或 SOCKS 代理，无需离开终端或修改 SSH 配置。该应用可在菜单栏中运行，以便快速启动/停止。您的配置、密码（存储在钥匙串中）和密钥文件访问权限均保留在您的 Mac 上；应用不会上传您的数据。

开始使用 SSH 端口转发器

1. 下载并安装应用（从 App Store 或您的分发渠道）。
2. 启动应用。您可以使用主窗口管理配置，或通过菜单栏图标快速访问。
3. 添加或选择转发配置：
   • 输入名称、远程主机、SSH 端口（默认 22）和用户名。
   • 选择密码或私钥进行身份验证。如果使用私钥，请使用密钥路径旁边的浏览按钮选择您的密钥文件（应用在沙盒环境下访问文件需要此步骤）。
   • 选择SOCKS 代理（本地 SOCKS 代理）或本地转发（将特定远程端口转发到本地端口），并设置本地端口（以及本地转发所需的远程端口）。
4. 可选：在启动前使用测试功能验证 SSH 连接。
5. 点击启动开始转发。使用菜单栏图标可快速启动或停止转发。
6. 保存您的配置以便持久化；如果使用密码，它将存储在系统钥匙串中。

重要提示：私钥文件与重新选择

如果您使用私钥认证并在应用中选择了一个密钥文件：

• 应用通过系统书签（路径 + 文件标识）记住对该文件的访问权限。
• 如果您删除了该密钥文件，然后创建了一个同名（或同路径）的新文件，应用仍指向旧文件。 书签可能失效或指向错误的文件。
• 您必须在客户端中重新选择密钥文件： 打开配置，点击密钥路径旁边的浏览，选择新的密钥文件，然后保存。否则应用可能连接失败或显示权限错误。

故障排除

• 连接或身份验证失败

  • 检查远程主机、SSH 端口和用户名。
  • 对于密码认证：确保密码正确且已保存（钥匙串）。
  • 对于私钥：确保您通过浏览选择了密钥，密钥格式受支持（OpenSSH 或 PEM），并且如果密钥有密码短语，请在提示时输入。如果您替换了密钥文件（例如删除并重新创建了同名文件），请在应用中重新选择密钥文件并保存。

• “无权读取密钥文件”或密钥相关错误

  • 使用浏览按钮重新选择您的私钥文件，然后保存。替换密钥文件后（例如使用相同路径/名称的新密钥）也需要此操作。

• 本地端口被占用

  • 在配置中选择另一个本地端口，或停止占用当前端口的应用程序。

• 转发未启动或一直显示“连接中”

  • 运行测试以验证 SSH 连接性。检查防火墙和网络。确保远程主机允许 SSH，并且对于本地转发，远程端口正确。

• 菜单栏图标或主窗口

  • 应用可以仅通过菜单栏图标运行。使用菜单打开完整窗口进行配置或启动/停止转发。

反馈与建议

我们重视您的反馈和建议，以改进 SSH 端口转发器。
如果您有任何想法或建议，请发送至 aidoge@yeah.net。

感谢您使用 SSH 端口转发器！