跳转到内容
Octoboard 文档

通过 SSH 连接

通过 SSH,在这台电脑的桌面应用或浏览器中使用 Linux 服务器或另一台电脑上的 Octoboard。SSH 会在两台设备之间建立加密直连,无需中转或云服务。

不确定该用哪种方式?选择连接方式对比了这种方式和不需要 SSH、只用浏览器的几种方式。

这台电脑上的桌面应用 · 通过 SSH 转发访问的浏览器 ⟷ SSH ⟷ Linux 服务器或另一台电脑

新手须知
  • 主机:运行 Octoboard、你要连过去的那台机器,可以是 Linux 服务器,也可以是另一台 Mac 或 Windows 电脑。
  • 服务器:这里指通过网络登录的 Linux 机器,通常是租来的,没有自己的屏幕。
  • SSH:一种通用的加密方式,用来登录另一台机器并在上面输入命令。macOS、Windows 和 Linux 都自带。
  • 终端:输入命令的窗口,macOS 上是“终端”,Windows 上是 PowerShell。
  • SSH 转发:一条 SSH 命令,让主机上的东西出现在你自己的电脑上,浏览器就能在本机打开它。
  • 指纹(主机密钥):标识一台机器 SSH 身份的一串短码。核对一次,就能确认连上的是正确的机器。
  • 密钥文件:代替密码登录用的文件。有些服务器提供商会给你一个。
  • 能用 SSH 登录主机。如果主机是 Linux 服务器,地址和用户名由服务器提供商给出。可以先试一下:打开“终端”(macOS)或 PowerShell(Windows),用你的用户名和服务器地址运行下面的命令。第一次连接时,它会问是否信任这台服务器,输入 yes。

    Terminal window
    ssh <you>@<server>

    如果主机是 Mac 或 Windows 电脑,需要在它的系统设置里开启 SSH 登录,方法见用另一台电脑作为主机。

  • 如果主机是 Linux 服务器,需要先在上面安装并启动 Octoboard。方法见安装 › Linux 服务器。Octoboard 的服务器程序 octoboardd,应用里称为“守护进程”。

  • 这台电脑上的 Octoboard 应用(macOS 或 Windows 版)。只用浏览器的话可以不装。

  1. 用运行 Octoboard 的账号通过 SSH 登录服务器,运行这条命令,复制以 octoboard+ssh:// 开头的那一行。这就是连接信息,桌面应用靠它知道连到哪里、怎么连。

    Terminal window
    octoboardd connection

    如果这台电脑访问服务器时用的是另一个地址或 SSH 端口,请在命令里加上 --host 或 --ssh-port,以生成正确的连接信息。

    它同时输出的二维码包含相同的一行文字,目前还没有应用支持扫码。

  2. 在这台电脑的 Octoboard 应用中,点击左侧栏的远程设备,或在 macOS 菜单栏中选择远程连接 › 远程设备。在 Windows 上,也可以从窗口的系统菜单或任务栏图标的跳转列表中选择远程设备。

  3. 点击添加远程守护进程,再点击连接信息旁的粘贴,自动填好各项。

  4. 在认证方式中,如果你用账号密码登录,选密码;如果服务器提供商给的是密钥文件(文件名常像 id_ed25519,或以 .pem 结尾),选密钥文件,并填写它在这台电脑上的位置。

  5. 点击保存,再点击连接。如果要求输入密码,请输入。

    如果你粘贴了连接信息,其中已经带有服务器的身份(指纹),应用会替你核对。如果你是手动填写的地址,第一次连接时应用会显示一个指纹。为了确认连上的是正确的机器,请把它和在服务器上运行下面这条命令得到的指纹比对,一致时再连接:

    Terminal window
    ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub

看到一个独立的 Octoboard 窗口打开,显示服务器上的项目和会话,就说明成功了。

你也可以连到另一台运行 Octoboard 应用的 Mac 或 Windows 电脑。

  1. 在你要连过去的电脑上,打开 Octoboard 的设置 › 远程访问。
  2. 点击那里的打开系统设置(macOS)或打开设置(Windows),按该行给出的路径开启远程登录(macOS)或 OpenSSH 服务器(Windows),让这台电脑接受 SSH 登录。这一步需要管理员权限。回到 Octoboard,该行会显示已开启。
  3. 开启允许远程访问,点击允许确认,并保持 Octoboard 运行,退出后远程访问会随之中断。
  4. 在Octoboard 应用标签页点击复制连接信息,再通过邮件或聊天工具发到另一台电脑。
  5. 在你要用来工作的电脑上,按连接 Linux 服务器的第 2 到 5 步添加这台主机,粘贴你发过去的信息。用主机上的用户名和密码登录。

看到一个独立的窗口打开,显示主机上的项目和会话,就说明成功了。

  1. 获取 SSH 转发命令:

    • 主机是 Mac 或 Windows 电脑时,先完成用另一台电脑作为主机的第 1 到 3 步。然后在浏览器标签页找到第 1 步:SSH 转发。点击命令中的地址,选择另一台电脑访问这台电脑所用的地址(或选择自行输入地址,稍后自己替换 <server>),然后点击复制转发命令。再在第 2 步:浏览器地址处点击复制地址。

    • 主机是 Linux 服务器时,在服务器上运行这条命令。它会先输出浏览器地址,再输出要运行的 SSH 命令。

      Terminal window
      octoboardd address

      把命令中的 <server> 换成服务器地址。

  2. 在用来浏览的电脑上,打开“终端”(macOS)或 PowerShell(Windows),运行这条 SSH 命令。窗口可能会要求输入密码,之后就不再显示任何内容,这是正常的。使用期间请不要关闭它,关闭后浏览器就会断开。

  3. 在浏览器中打开以 http://127.0.0.1: 开头的浏览器地址。

看到 Octoboard 在浏览器标签页中打开,而且没有要求你登录,就说明成功了。

只有能通过 SSH 转发访问 Octoboard 的人才能使用这个地址。请保管好它:地址里的密钥可以完全控制 Octoboard,它会留在浏览器的历史记录和书签里,开启同步后还会同步到你的其他设备。

  • 提示“无法连接到服务器”,或 SSH 命令提示“Connection refused”、超时:主机上的 SSH 登录没有开启,或地址、SSH 端口不对。请确认远程登录或 OpenSSH 服务器已开启,并且能用上面的 ssh 命令登录。
  • 提示“无法登录”或“Permission denied”:用户名、密码或密钥文件不对。
  • 提示“主机密钥不匹配”:应答的机器不是你之前连过的那台。服务器重装后会这样,但也可能是出了问题。弄清原因之前请不要继续。
  • 浏览器页面打不开:SSH 窗口被关掉了,或其中的命令已停止。请重新运行它,再刷新页面。
  • 不额外开放端口:Octoboard 只接受来自主机本机的连接,所以要从另一台电脑连接,需要先通过 SSH 登录主机。这就是为什么需要 SSH,或者某种第三方中转。
  • 核对主机身份:首次成功连接后,应用会记住主机的身份标识(主机密钥),以后标识变了就拒绝连接并提醒你。
  • 不保存密码:首次用密码或自己的密钥文件登录后,应用会为这台电脑设置一把专用 SSH 密钥,供以后登录使用。
  • 随时收回权限:在主机允许登录的 SSH 密钥列表中(Linux 和 macOS 上是 ~/.ssh/authorized_keys 文件)删掉这台电脑对应的一行,这把密钥就不能再登录了;已经建立的连接不受影响,直到它自行断开。
  • 每个 SSH 连接目标一个窗口:用户名、主机或 SSH 端口不同的连接,各自打开独立的窗口,项目、会话和通知互不混在一起。
  • 一眼看到连接状态:点开 macOS 菜单栏或 Windows 通知区域里的应用图标,每条连接都有自己的标签页。
  • 远程网页在本机打开:智能体在主机上启动网站后,点击它给出的 localhost 链接,应用会经由 SSH 在这台电脑上打开该网站。
  • 远程文件在本机打开:你可以在远程窗口中直接查看文件,也可以下载一份副本,用这台电脑的默认应用打开。
  • 断线自动重连:网络中断后,窗口会一直尝试重新连接,直到连上或你关闭窗口。