Cline Desktop 新功能：SSH 支持！应用运行在您的笔记本电脑上，而 Cline 则在例如开发服务器、树莓派等设备上工作……

X AI KOLs Following 工具
ssh remote-development cline-desktop dev-tools linux macos windows

摘要

Cline Desktop 新增了 SSH 支持，可实现远程开发：应用本地运行在笔记本电脑上，同时处理远程设备（如开发服务器或树莓派）上的文件和工具。

Cline Desktop 新功能：SSH 支持！ 应用运行在您的笔记本电脑上，而 Cline 则在例如开发服务器、树莓派、Docker 容器或任何可通过 SSH 访问的设备上工作。 文档（包含部分视频和 SSH 入门指南）： https://t.co/b6bjWA7MaZ https://t.co/QAHAV440KJ
查看原文
查看缓存全文

缓存时间: 2026/09/25 18:47

Cline桌面版新功能：SSH支持！应用程序保留在你的笔记本电脑上，而Cline可以操作例如开发服务器、树莓派、Docker容器等任何你能通过SSH连接的设备。文档（包含一些视频和SSH入门指南）：https://t.co/b6bjWA7MaZ https://t.co/QAHAV440KJ — # 基于SSH的远程开发 - Cline 来源：https://docs.cline.bot/usage/cline-desktop-ssh

  1. 使用方式
  2. Cline桌面版
    通过SSH连接开发机、构建服务器或云虚拟机来运行Cline桌面版。应用程序保留在你的电脑上；而代理程序、工具集和你的代码都存储在远程机器上。Cline桌面版可以运行在非其安装设备的机器上。你只需添加一次SSH主机，从环境选择器中选取，之后每次启动的会话都将在该主机上运行：文件编辑、终端命令、Git操作和MCP服务器都在远程执行，而聊天界面、审批流程和实时输出则保留在你电脑的应用中。你无需在远程机器上安装任何东西。首次连接时，Cline会复制一个小型自包含助手程序到主机的~/.cline/remote/目录，启动它，并通过SSH隧道与其通信。无需apt、npm、root权限或开放端口。

前提条件

  • Cline桌面版：支持macOS、Windows或Linux系统。
  • SSH客户端：你的电脑需要安装SSH客户端。macOS、Linux和Windows 10/11已内置；打开终端运行ssh -V即可确认。
  • 运行Linux（x64或arm64）或macOS的远程机器：需能通过网络访问，且拥有有效账户。连接Mac主机时，需要在Mac上运行Cline桌面版。不支持Windows主机和32位树莓派操作系统。
  • 基于密钥的登录：需要使用密钥登录，且主机需已被你的SSH客户端信任。下文将详细说明这两点设置。

两分钟掌握SSH

SSH是一种在其他计算机上安全运行命令的方式。Cline使用前必须确保两点：Cline在后台运行ssh时无法响应提示符，因此必须提前从普通终端完成设置。

步骤1：在Cline中添加主机

打开设置 → 远程，点击新建主机。填写表单：点击测试连接。Cline将通过SSH登录并报告主机平台信息。绿色的已通过徽章表示你的密钥和主机信任设置正确。测试成功后主机会被保存到左侧列表。

步骤2：连接并打开项目

返回新建会话界面。环境选择器是工作区选择器左侧的小型笔记本电脑图标，默认显示本地。点击它，在远程选项下选择你的主机。首次连接需要几秒钟时间，Cline会上传助手程序到主机。连接成功后图标变为服务器样式，工作区选择器将显示远程主目录。打开工作区选择器，选择打开文件夹…浏览远程机器并选择项目，然后点击使用此文件夹。Cline会为每个主机单独记忆最近的工作区，后续连接时项目将出现在选择器列表中。

步骤3：正常使用

像本地一样启动会话。所有工具调用都以SSH用户身份在远程机器的选定文件夹中运行。在主机上执行的操作包括：

  • 读取、搜索和编辑文件，以及使用@提及文件
  • 终端命令和Git操作，包括切换分支
  • 该机器上配置的MCP服务器和其他工具（助手程序会获取远程登录shell的PATH，因此账户下安装的工具都可见）
  • 会话历史记录（存储在主机上）

保留在你电脑上的内容：

  • 聊天界面、审批流程和实时流式输出
  • 提供商设置。当前的API密钥或访问令牌会通过认证隧道发送到主机用于会话，不会写入远程机器的提供商设置文件

要返回本地机器，打开环境选择器选择本地。这将断开连接，停止主机上的助手程序，并将其保留在~/.cline/remote/目录以便快速重连。

限制条件

  • 仅支持密钥登录：不会显示密码提示符，因此纯密码账户无法连接。
  • 主机必须预先信任：Cline会拒绝未知或变更的主机密钥，不会提示确认。请先通过终端登录一次完成信任。
  • 远程主机支持：Linux x64和arm64系统，以及在Mac上运行Cline桌面版时连接的macOS系统。不支持Windows主机。
  • 同时仅能连接一个主机：切换主机会断开当前连接。
  • 远程会话暂不支持：从电脑附加文件、在本地编辑器中打开远程文件等功能。
  • 网络断开时，隧道会在约45秒后关闭，需重新选择主机进行连接。

故障排除

Cline会在环境状态面板中显示SSH客户端本身的错误信息。常见问题包括：

工作原理

（面向想了解技术细节的用户）：

  1. Cline使用BatchMode=yes和StrictHostKeyChecking=yes参数运行系统ssh命令，如填写了相关信息还会加上-i和-p参数。它从不存储密码或私钥内容；主机设置保存在~/.cline/data/settings/remote-environments.json，仅所有者可访问。
  2. 连接时会检查主机操作系统和架构，然后上传匹配的自包含Cline助手程序到~/.cline/remote/（Linux版本约30MB，每个Cline版本只上传一次并缓存）。
  3. 助手程序启动绑定到主机回环接口的Cline Hub。Cline通过ssh -L将其转发到本地随机端口，因此主机无任何端口暴露在网络中。
  4. 仅Cline认证协议通过隧道传输。工具执行和会话存储发生在主机端；应用程序只是客户端。如果远程账户已运行Cline CLI，其状态不会被影响；桌面版助手使用独立的隔离Hub。
  • Cline桌面版 (https://docs.cline.bot/usage/cline-desktop)
  • Cline CLI (https://docs.cline.bot/usage/cli-overview)

相似文章