跳到主要内容

Klipper Cloud 远程代理

Klipper Cloud 远程代理用于让已联网的 FLYOS-FAST 设备连接 Klipper Cloud，以便在云平台中绑定和远程访问当前上位机。FLYOS-FAST v1.4.0 测试版镜像会在首次启动时生成本机凭据，但远程访问默认关闭，必须由用户主动开启。

测试功能与远程访问风险

该功能目前仅在 FLYOS-FAST v1.4.0 测试版镜像中确认。启用后，设备会主动连接远程服务；不需要远程访问时请保持关闭。

设备 ID、本机凭据、代理配置和包含这些内容的日志均不应发布到论坛、群聊或其他公开位置。

远程操作安全

远程移动、加热或执行 G-code 前，必须确认打印机现场环境安全，并保留可以立即断电或急停的措施。网络延迟、连接中断或状态不同步可能影响操作结果，不建议在无人看管且无法处理异常时远程启动打印。

功能说明​

  • 开启远程代理后，可以按照 Klipper Cloud 平台提示绑定当前上位机。
  • 关闭远程代理只会停止云端远程连接，不影响 Fluidd、Mainsail、Moonraker 和 SSH 的局域网访问。
  • 后台存在 agent 进程，不代表远程访问已经开启；代理进程也可能只是在等待用户授权。
  • 设备 ID 用于识别当前上位机，不是主板 USB ID、CAN UUID 或打印机配置中的 MCU ID。

完整启用流程​

1. 开启远程服务​

通过 SSH 执行：

/data/klipper-cloud-agent/klipper-cloud-agent --enable-remote

命令执行后如果没有报错，请等待代理连接云端。不要连续反复执行开启命令。

2. 查询设备 ID​

确保云服务已经开启并且上位机可以访问互联网，然后执行：

/data/klipper-cloud-agent/klipper-cloud-agent --device-id

命令正常返回设备 ID 后，再按照 Klipper Cloud 平台提示绑定设备。复制时只选择设备 ID 本身，不要把整张终端截图发送给其他人。

Loading...
图片说明

上图是终端操作示意，设备 ID 已隐藏。请以自己设备实际返回的内容为准。

3. 完成云平台绑定​

云平台网址

Klipper Cloud 设备管理

打开 Klipper Cloud 设备管理，使用自己的账号登录。首次使用时请先阅读页面中的使用须知、服务协议和隐私规则。

Loading...

登录后，在左侧 我的设备 区域找到设备添加框：

  1. 将 --device-id 返回的完整设备 ID 填入 输入 KD-… 设备 ID。
  2. 点击 添加。
  3. 等待设备出现在左侧列表，并确认状态显示为 在线。
  4. 点击设备后，可在页面中打开远程设备管理界面；需要独立窗口时点击右上角的 新窗口打开。
Loading...
提示

设备管理页面截图中的账号、设备名称、设备 ID 和远程打印界面均已隐藏。不要将包含真实信息的页面截图公开发布。

绑定后应同时检查：

  1. 云平台显示的设备与当前上位机一致。
  2. 远程页面能够读取当前打印机状态。
  3. 局域网内的 Fluidd 或 Mainsail 仍可正常访问。

不要使用他人提供的设备 ID，也不要将自己的设备绑定到不受信任的账号。

关闭远程服务​

不再使用远程访问时执行：

/data/klipper-cloud-agent/klipper-cloud-agent --disable-remote
Loading...

关闭后，本地 Fluidd、Mainsail、Moonraker 和 SSH 的局域网访问不受影响。如果准备转让、维修或重装设备，还应在 Klipper Cloud 平台中解除设备绑定；只执行关闭命令不等于解除云平台账号关系。

解除云平台绑定​

准备转让、维修或不再使用当前设备时，应同时关闭设备端远程服务并解除平台绑定：

  1. 先在 SSH 中执行 --disable-remote。
  2. 在电脑端右键点击左侧设备；手机或触控设备长按该设备。
  3. 选择 删除/解绑。
  4. 按页面提示输入当前设备名称进行确认。
Loading...

解绑会移除当前账号与该设备的关系。设备端保存的配置、打印文件以及局域网访问不会因此被删除。

命令速查​

操作命令使用条件
检查代理程序test -x /data/klipper-cloud-agent/klipper-cloud-agent && echo "klipper-cloud-agent 已安装"登录 SSH 后执行
开启远程服务/data/klipper-cloud-agent/klipper-cloud-agent --enable-remote上位机已经联网
查询设备 ID/data/klipper-cloud-agent/klipper-cloud-agent --device-id远程服务已开启且网络正常
关闭远程服务/data/klipper-cloud-agent/klipper-cloud-agent --disable-remote不再需要云端访问时执行
Loading...