remoteit/docker-extension

Remote.it Docker扩展镜像（Docker Jumpbox）

镜像概述

Remote.it Docker扩展镜像是一款用于将设备注册到Remote.it账户的工具镜像，提供两种安装方式：通过Docker Desktop扩展（适用于安装Docker Desktop的桌面环境）和Docker容器（适用于仅运行Docker守护进程的服务器/嵌入式环境，如树莓派），简化设备与Remote.it服务的集成流程。

核心功能与特性

• 双安装模式：支持Docker Desktop扩展（图形化操作）和Docker容器（命令行部署）
• 设备注册：无缝对接Remote.it账户，自动处理注册流程
• 配置持久化：容器模式下支持配置文件持久化存储，确保重启后配置不丢失
• 环境适配：兼容桌面环境与服务器/嵌入式设备（如树莓派）

使用场景与适用范围

• 桌面环境：已安装Docker Desktop的用户，通过扩展商店快速安装配置
• 服务器/嵌入式设备：仅运行Docker守护进程的环境（如树莓派、云服务器），通过命令行部署容器实现设备注册

详细使用方法

方式一：Docker Desktop扩展安装（桌面环境）

1. 从Docker Desktop应用打开Docker Dashboard
2. 进入左侧导航栏的「扩展」菜单
3. 点击「添加扩展」选项
4. 在「浏览」搜索栏输入「Remote.It」
5. 选择「Remote.It」扩展并点击「安装」，安装完成后点击「打开」
6. 在扩展界面点击「获取注册码」，登录需注册设备的Remote.it账户
7. 登录后系统生成注册码，并提示返回Docker Desktop
8. 返回Docker Desktop后，注册码将自动填充
9. 点击「注册」按钮完成设备注册

方式二：Docker容器安装（服务器/嵌入式环境）

适用于无Docker Desktop的环境（如树莓派、仅运行Docker守护进程的服务器），通过以下命令部署容器：

bash
docker run \
  -d \
  --name myname \
  --hostname myname \
  -e R3_REGISTRATION_CODE="<registration_code>" \
  -v $PWD/myname:/etc/remoteit \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart unless-stopped \
  --pull always \
  remoteit/docker-extension

命令参数说明

• -d：后台运行容器（detached模式）
• --name myname：自定义容器名称（默认自动生成）
• --hostname myname：设置容器内主机名，Remote.it将以此作为设备名称
• -e R3_REGISTRATION_CODE="<registration_code>"：注册码环境变量，需替换为从Remote.it Desktop获取的注册码（通过设备列表「+」号→「添加设备」→「Docker」获取）
• -v $PWD/myname:/etc/remoteit：挂载主机目录到容器内/etc/remoteit，用于持久化存储配置文件（容器重启后config.json可被代理识别）
• -v /var/run/docker.sock:/var/run/docker.sock：挂载Docker守护进程socket到容器内
• --restart unless-stopped：确保Docker守护进程重启（如主机开关机）后容器自动重启
• --pull always：运行时始终拉取最新镜像，确保使用最新版本