SSH 访问

直接 SSH 访问主机设备，适用于高级调试场景。

我们建议通过云端 IDE 终端访问运行中的 Docker 容器，而不是通过 SSH 连接到主机设备。直接访问主机会破坏隔离的容器化环境原则。

前提条件

• 设备必须在本地网络（或通过 VPN）可达
• 您需要 .flock 配置文件中的设备私钥
• 出于安全考虑，默认禁用密码认证

提取 SSH 密钥

私钥嵌入在 .flock 设备配置文件中，提取方式如下：

cat /path/to/mydevice.flock | jq -r .authentication.key > id_rsa

设置正确的文件权限：

chmod 600 id_rsa

通过 SSH 连接

ssh -i id_rsa {project_owner}@{device_ip}

SSH 用户名必须是项目所有者名称的小写形式。

何时使用 SSH

SSH 访问适用于：

• 诊断操作系统级问题（网络、磁盘、内核）
• 检查 Docker 守护进程状态
• 从失败的更新中恢复
• 访问未挂载到容器中的硬件外设

要调试您的应用，请改用云端 IDE 的侧边栏终端——它可以直接连接到正在运行的容器，无需使用 SSH。