连接不同地方的设备。
Agent 会主动连接服务端,因此也能管理位于 NAT 后的设备。可用二维码或六位码配对,在一个工作区查看多台设备。
你的设备,同一个工作区。
把要管理的设备接入同一个工作区。
用网页、移动应用或命令行
查看状态、处理文件和执行命令。
$ remote-cli device list
DEVICE PLATFORM STATUS
workstation windows online
server linux online
tablet android online
$ remote-cli file server ls
reports/ backups/ notes.txt
✓ 设备已连接
WEB / APP / CLI从这里,连到你的设备。
01 / 产品能力
先查看设备,再选择要做的事。
具体功能取决于设备和权限。
Agent 会主动连接服务端,因此也能管理位于 NAT 后的设备。可用二维码或六位码配对,在一个工作区查看多台设备。
执行一条命令,或打开交互式终端。适合日常维护,也可以配合自己的脚本使用。
浏览设备上的目录,上传或下载文件。可以在控制台或 CLI 中操作。
查看在线状态、系统信息、运行指标和日志,方便了解设备当前的情况。
在支持的设备上查看屏幕、点击和输入文字。朗读、音频、全屏展示和系统设置等功能取决于设备平台。
在工作区设置成员、角色和设备访问权限,查看操作记录。也可以自行部署连接服务;对敏感设备可启用端到端密封会话,由设备自己核验授权。
不同平台与系统权限决定可用能力。Android 屏幕共享、辅助功能和输入法需在设备上启用;OpenWrt 另提供 ubus 操作。
03 / 下载
要管理哪台设备,就在那台设备上安装 Agent。
正在读取版本信息…
Windows、Linux(glibc / musl)、macOS、FreeBSD、NetBSD · 安装包包含 Agent 与 CLI
快速安装
也可以运行下面的命令安装。Windows 请使用 Git Bash。
curl -fsSL https://remote.ivjn.us/install.sh | bash -s -- agent
curl -fsSL https://remote.ivjn.us/install.sh | bash -s -- cli
先在控制台获取设备 ID 和令牌,再把 --device-id YOUR_DEVICE_ID --token YOUR_TOKEN 加在 bash -s -- agent 后面。如果本机已有连接配置,就不用重复填写。
按设备的角色选择应用 · ARM64 / x86_64
装在要管理的 Android 设备上,让它连接工作区并接收操作。你可以在应用中查看连接状态、设置权限和检查更新。
下载 Android Agent ↓Android APK · Release 签名装在用来操作的 Android 设备上。可以查看其他设备的状态、打开终端或处理文件,也可以改用网页控制台。
下载 Android Console ↓独立 APK · Release 签名让 Chrome 或 Edge 成为可管理设备。
解压 ZIP,在扩展管理页启用开发者模式,然后加载解压后的目录。
以下为 apk-tools 路由器软件包,不是 Android 安装包。官方 OpenWrt 25.12 提供 ipq40xx、x86/64、armsr/armv8、mediatek/filogic、bcm27xx/bcm2711、ramips/mt7621、ath79/generic;ImmortalWrt SNAPSHOT 提供 ipq40xx 专用包与 LuCI,其余 target 的兼容文件名(x86/64、armsr/armv8、mediatek/filogic、ath79)现指向官方 25.12.5 构建(musl agent,ImmortalWrt 同样可装)。请按设备固件(cat /etc/openwrt_release)与架构(apk --print-arch)选择。安装:apk add --allow-untrusted ./文件名.apk。
04 / 使用示例
登录 CLI 后,选择你要做的事。
记得把 my-device 换成你的设备 ID。
remote-cli device list remote-cli metrics my-device --limit 5 remote-cli logs my-device --limit 20
查看设备列表、近期指标和日志。能看到哪些信息,取决于设备平台和权限。
05 / 常见问题
Agent 装在要管理的设备上。你可以通过网页控制台、Android Console 或 CLI 操作。Exchange 负责验证身份和转发请求,也可以自行部署。
设备管理、远程命令和文件操作都可以从控制端进入,但能用哪些功能取决于系统和权限。操作屏幕还需要平台支持和设备授权;输入法、系统设置及 ubus 等功能只在对应平台提供。
通常不需要。Agent 会主动连接 Exchange,设备一般不用开放入站端口。无论使用默认服务还是自建服务,设备和控制端都要能访问它。
设备操作默认使用原生端到端密封会话。Exchange 只转发密文,设备根据所有者签发的授权判断权限,无需额外 CLI 参数。详见端到端密封会话。
中间证书(rsc1.)链不限层数(仅有 64 张、64 KiB 的防滥用上限,颁发者可用 max_path_len 自行限制深度),子证书的级别、设备范围和到期都不能超出父证书;吊销中间证书后,它下面的授权一并失效。转让超级管理员就是交接根私钥:口令加密包存在连接服务上,服务解不开;新超级管理员导入后会立刻轮换,旧副本随之失效。也可以不上传,改为带外交接。超级管理员若上传了口令备份,在新设备登录时客户端会自动尝试从 Exchange 恢复根私钥(空口令静默;有口令则非阻塞提示);多台机器同时持有根会增加泄露风险。
从下载区选择对应平台。Android 首次安装可能需要允许浏览器安装应用;后续可在 Agent 或 Console 的设置中检查更新,并按系统提示确认。旧 Debug 签名版本无法直接覆盖为 Release 签名,卸载会清除本机配置。
支持自更新的桌面版本可运行 remote-agent update self --check 或 remote-cli update self --check;去掉 --check 后执行更新。
这取决于系统的电源管理和运行权限。Android Agent 连接期间会保持亮屏,断开后恢复正常息屏。要操作屏幕,仍需解锁设备并授予对应权限。
运行 remote-cli skill 即可生成独立的 Remote CLI Skill,默认获取官网最新版,无法获取时使用内置副本。浏览器操作包含多标签页、表单、iframe、CDP 和截图,不依赖其他 skill。操作仍受账号权限和设备能力约束。
随时开始