树莓派远程访问（Raspberry Pi Connect）Beta 版
简介
树莓派远程访问（Raspberry Pi Connect）可让你在世界上的任意地点，安全地访问你的树莓派。
要使用树莓派远程访问，请在你的树莓派上安装软件 Connect。然后打开 connect.raspberrypi.com，即可在浏览器窗口中访问，运行在你的树莓派上的桌面或 Shell。
Connect 使用安全的加密连接。在默认情况下，Connect 会直接在你的树莓派和浏览器之间进行通信。但是，当 Connect 无法在树莓派和浏览器间建立直接连接时，我们会使用中继服务器。在这种情况下，树莓派官方服务器也仅保留操作 Connect 所需的元数据。
Connect 目前处于 BETA 开发阶段。
注意
要使用 Connect，你的树莓派必须运行着树莓派系统 Bookworm 及更新版本。
安装
要开始安装，请打开终端。运行以下命令，更新你的系统和软件包：
在你的树莓派上，运行以下命令安装 Connect：
安装完成后，请重启你的树莓派或手动启动 Connect 服务 以使用 Connect：
在下次登录树莓派时，Connect 就会自动启动。
精简版 Connect（Connect Lite）
我们提供了 Connect 的替代 精简（Lite） 版本，仅支持远程 Shell 访问，无法进行屏幕共享。
在你的树莓派上，运行以下命令，来安装精简版 Connect：
重启你的树莓派或手动启动 Connect 服务 来使用 Connect。
考虑启用用户持久化登录，即使你的用户账户未登录，也可访问你的设备。
技巧
精简版命令与完整版 Connect 相同，都叫
rpi-connect。rpi-connect-lite只是一个软件包名称而已。
手动启动 Connect
要用命令行手动启动服务，请运行以下命令：
将树莓派绑定到树莓派 ID
现在你已在树莓派上安装了 Connect，你必须把你的树莓派绑定你的树莓派 ID，才能使用 Connect。
如果你没有树莓派 ID，创建一个。
要把你的树莓派绑定树莓派 ID，需要使用 Connect 生成一个验证网址。访问该链接并登录你的树莓派 ID，将你的树莓派添加到你的账户中。
你可以使用树莓派桌面上的 Connect 图标或命令 rpi-connect生成验证网址。
使用树莓派桌面
rpi-connect 服务开始运行后，在系统托盘中将出现Connect 的图标。
单击 Connect 图标，从下拉菜单中选择“Sign in”。
这将打开一个验证网址，你可以用它把你的树莓派绑定到你的树莓派 ID 上。
通过命令行
使用以下命令生成一个链接，将你的树莓派绑定到你的树莓派 ID上：
该命令应输出类似以下内容：
在任意设备上访问生成的验证网址，并使用你的树莓派 ID 登录，将你的树莓派绑定到树莓派 ID。
完成树莓派连接
访问上一步生成的验证 URL。
使用你的树莓派 ID 登录 Connect。
认证后，为你的树莓派起个名。请选择一个能帮助你辨识设备的名字。点击“创建设备并登录”按钮可继续。
现在你就可以远程连接到你的树莓派了。Connect 系统托盘图标会变成蓝色，代表你的树莓派已经连接至 Connect 服务。你将会收到一封电子邮件，通知你有新设备登录 Connect。
警告 | 如果你收到了一封未知设备登录 Connect 的电子邮件，请立即修改你的树莓派 ID 密码。并从 Connect 中删除设备来永久解除与你账户的绑定。考虑启用双因素身份验证来确保你的账户安全。 |
点击 Connect 系统托盘图标，打开 Connect 菜单。该菜单会显示你的当前登录状态、登出选项，以及启用或禁用远程访问方法的选项。
访问你的树莓派
现在你的树莓派会出现在 Connect 仪表板上，你可以通过浏览器在所有地方访问你的树莓派。Connect 提供了多种远程交互方式。
屏幕共享
Connect 能在浏览器中共享你树莓派的屏幕。使用以下说明来共享你树莓派的屏幕。
注意 | 屏幕共享需要 Wayland 窗口服务器。默认情况下，树莓派设备仅在树莓派 5、4 或 400 上使用 64 位 发行版的树莓派系统 Bookworm才使用 Wayland。屏幕共享 不支持 精简版树莓派系统和使用 X 窗口服务器的系统。 |
在任意计算机上访问connect.raspberrypi.com。
Connect 会将你重定向至树莓派 ID 服务进行登录。登录后，Connect 会显示已连接设备的列表。支持屏幕共享的设备在设备名称下方显示灰色的 屏幕共享 徽章。
点击你想访问的设备右侧的 通过 Connect 按钮。从菜单中选择 屏幕共享 选项。这将打开一个浏览器窗口，显示你树莓派的桌面。
现在你可以像本地使用你的树莓派一样使用它。要了解更多连接信息，请将鼠标悬停在 断开连接 按钮右侧的挂锁图标上。
提示 | 使用桌面上方的 从远程复制 和 粘贴到远程 按钮在本地和远程剪贴板之间传输文本。 |
连接后，Connect 仪表板中 屏幕共享 徽章旁边会出现绿色圆点，表示有活动的屏幕共享会话。悬停以查看当前的屏幕共享会话数。
当屏幕共享会话进行中时，系统托盘中的 Connect 图标会变成紫色并显示一个闭合的圆圈。
停止屏幕共享
要关闭屏幕共享会话，请点击桌面上方的 断开连接 按钮。
禁用屏幕共享
要关闭屏幕共享，请点击 Connect 系统托盘图标并取消选择 允许屏幕共享。你的树莓派仍然登录到 Connect，但你将无法从 Connect 仪表板创建屏幕共享会话。
或者，你可以使用以下命令禁用屏幕共享：
在 Connect 仪表板上，屏幕共享 徽章和 通过 Connect 菜单中的 屏幕共享 选项将显示为删除线。
要重新启用屏幕共享，请执行以下操作之一：
点击 Connect 系统托盘图标并选择 允许屏幕共享
运行以下命令：
远程 shell
Connect 包含从浏览器访问在 Raspberry Pi 上运行的 shell 的功能。按照以下说明访问远程 shell。
在其他计算机上访问 connect.raspberrypi.com。
Connect 会重定向到 Raspberry Pi ID 服务以进行登录。登录后，Connect 显示已链接设备的列表。可远程访问 shell 的设备在设备名称下方显示灰色的 Remote shell 标记。
点击你想访问的设备右侧的 Connect via 按钮。从菜单中选择 Remote shell 选项。这将在你的 Raspberry Pi 上打开一个 shell 会话。
现在你可以像本地一样使用你的 Raspberry Pi。
提示 | 在某些操作系统上，浏览器会拦截像 Ctrl + Shift + C 和 Ctrl+C 这样的键组合。你可以使用右键菜单或 Ctrl + Insert 进行复制，Shift + Insert 进行粘贴。 |
连接后，Connect 仪表板上的 Remote shell 标记旁边会出现绿色圆点，表示活动的远程 shell 会话。悬停显示当前的远程 shell 会话数量。
提示 | 每个远程 shell 连接都会创建一个全新的连接，就像 SSH 一样。要跨多个会话持久化后台命令和配置，请使用 |
当远程 shell 会话进行时，系统托盘中的 Connect 图标会变为紫色，并显示一个闭合的圆圈。
提示 |
|
结束远程 shell 会话
要关闭远程 shell 会话，请运行 exit 命令或关闭窗口。
禁用远程 shell 访问
要关闭远程 shell 访问，请点击 Connect 系统托盘图标并取消选择 Allow remote shell。你的 Raspberry Pi 仍然登录到 Connect，但你将无法从 Connect 仪表板创建远程 shell 会话。
或者，你可以使用以下命令禁用远程 shell 访问：
在 Connect 仪表板上，Remote shell 标记和 Connect via 菜单中的 Remote shell 选项将显示为被划掉。
要重新启用 shell 共享，请执行以下操作之一：
点击 Connect 系统托盘图标并选择 Allow remote shell
运行以下命令：
随时启用远程 shell
Connect 作为用户级服务运行，而不是作为 root。因此，只有当你的用户帐户当前在 Raspberry Pi 上登录时，Connect 才能正常工作。如果禁用自动登录并重新启动，这可能导致你的 Raspberry Pi 不可访问。为了即使在你没有登录设备时也能继续运行 Connect，请启用 user-lingering。从你的用户帐户运行以下命令以启用 user-lingering：
管理设备
Connect 仪表板列出了与你的 Raspberry Pi ID 链接的所有 Raspberry Pi 设备，并显示可以访问它们的各种方法。
点击设备名称以打开设备详细信息页面。该屏幕提供有关设备的低级信息。你还可以编辑设备名称或从 Connect 中删除设备。
从 Connect 中删除设备会自动登出设备上的 Connect。Connect 系统托盘图标变为灰色，并且菜单只提供 Sign in 选项。
更新
要更新到最新版本的 Connect，请运行以下命令：
重新启动设备以使更新生效：
Here's the translation of the provided text:
断开连接设备
在树莓派上运行以下命令来注销你的树莓派 ID，这将在连接屏幕上禁用你的设备：
提示 | 要完全从你的连接账户中移除一个树莓派，请从连接仪表板 中移除它。 |
卸载
运行以下命令从树莓派上移除连接软件：
提示 | 如果你安装了 Connect Lite，请在上述命令中使用 |
卸载后，树莓派的序列号仍与你的树莓派 ID 关联。设备仍然显示在连接仪表板上，但无法用于远程访问。如果你再次安装 Connect，即使使用不同的存储卡，在同一台树莓派上，它将重复使用连接仪表板中现有的设备名称。
要解除树莓派与树莓派 ID 之间的关联，请从连接仪表板的设备列表中移除树莓派。
故障排除
已知问题
屏幕共享仅支持共享树莓派的单个主显示器。当树莓派连接多个 HDMI 屏幕时，Connect 有时会共享次要屏幕的内容。你可以通过右键单击桌面并在桌面首选项中更改任务栏位置来解决此问题。
Connect 不支持屏幕键盘。为了完整功能，请使用物理键盘。
Connect 需要支持ECMAScript 2020（ES11）的浏览器，因为它使用了旧版本浏览器中不可用的特性 。
浏览器截获某些键和键组合。因此，你无法将这些键输入到你的 Connect 窗口中。屏幕共享包括一个工具栏，模拟一些最受欢迎的被截获键。
查看 Connect 状态
要查看 Connect 服务的当前状态，请运行以下命令：
此命令的输出显示你当前是否已登录到 Connect，以及在你的树莓派上启用的远程服务。
启用增强日志记录
你可以为rpi-connect及其专用的 WayVNC 服务器启用调试日志，详细记录树莓派上的本地操作。
在rpi-connect中启用增强日志记录
rpi-connect中启用增强日志记录用以下命令打开rpi-connect配置文件进行编辑：
在注释之间输入以下配置行：
注意 | 你需要 同时 使用以 |
最后，使用以下命令重启服务：
在专用的wayvnc服务器中启用增强日志记录
wayvnc服务器中启用增强日志记录打开与 Connect 关联的专用 WayVNC 服务器的配置文件：
在注释之间输入以下配置行：
注意 | 你需要 同时 使用以 |
最后，使用以下命令重启服务：
查看 Connect 日志
要查看 Connect 服务及其专用 WayVNC 服务器的日志，请运行以下命令：
最后更新于
