你的设备,同一个工作区。

设备不在身边,
也能照常管理。

把要管理的设备接入同一个工作区。
用网页、移动应用或命令行
查看状态、处理文件和执行命令。

WindowsLinuxmacOSAndroidOpenWrtFreeBSDNetBSD
▣
我的设备在这里查看和管理
已连接
remote-cli示例

$ 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 控制端 网页、App 或 CLI02 连接服务 验证身份、转发请求03 设备 Agent 接收并执行操作

01 / 产品能力

常用操作,都在这里。

先查看设备,再选择要做的事。
具体功能取决于设备和权限。

连接

连接不同地方的设备。

Agent 会主动连接服务端,因此也能管理位于 NAT 后的设备。可用二维码或六位码配对,在一个工作区查看多台设备。

多设备扫码连接六位码配对
终端

远程运行命令。

执行一条命令,或打开交互式终端。适合日常维护,也可以配合自己的脚本使用。

命令执行交互终端
文件

查看和传输文件。

浏览设备上的目录,上传或下载文件。可以在控制台或 CLI 中操作。

目录浏览上传与下载
状态

看看设备现在怎样。

查看在线状态、系统信息、运行指标和日志,方便了解设备当前的情况。

设备状态指标与日志
交互

需要时操作屏幕。

在支持的设备上查看屏幕、点击和输入文字。朗读、音频、全屏展示和系统设置等功能取决于设备平台。

屏幕交互按需授权
工作区

管理谁能访问设备。

在工作区设置成员、角色和设备访问权限,查看操作记录。也可以自行部署连接服务;对敏感设备可启用端到端密封会话,由设备自己核验授权。

成员与权限操作审计端到端密封会话

不同平台与系统权限决定可用能力。Android 屏幕共享、辅助功能和输入法需在设备上启用;OpenWrt 另提供 ubus 操作。

02 / 快速开始

先连接一台设备。

打开控制台,再安装设备端 Agent。
连接后就能在工作区查看设备。

01

打开控制台

在网页控制台注册或登录。你也可以用 Android Console 或 CLI 管理设备。

打开网页控制台 ↗
02

安装设备端 Agent

选好对应平台的安装包,再通过二维码、六位码或设备配置,将 Agent 接入工作区。

选择设备平台 ↓
03

开始操作设备

在设备列表查看状态、打开终端或处理文件。如果要操作屏幕,请先在设备上开启所需权限。

查看使用示例 ↓

03 / 下载

下载适合设备的安装包。

要管理哪台设备,就在那台设备上安装 Agent。
正在读取版本信息…

电脑与服务器

Windows、Linux(glibc / musl)、macOS、FreeBSD、NetBSD · 安装包包含 Agent 与 CLI

快速安装

也可以运行下面的命令安装。Windows 请使用 Git Bash。

管理这台设备 · Agent

curl -fsSL https://remote.ivjn.us/install.sh | bash -s -- agent

从这里操作其他设备 · CLI

curl -fsSL https://remote.ivjn.us/install.sh | bash -s -- cli
第一次安装 Agent,怎么连接设备?

先在控制台获取设备 ID 和令牌,再把 --device-id YOUR_DEVICE_ID --token YOUR_TOKEN 加在 bash -s -- agent 后面。如果本机已有连接配置,就不用重复填写。

桌面 / 服务器架构与内容下载
Windowsx64 · remote-cli.exe + remote-agent.exe下载 ZIP ↙
Windowsarm64 · remote-cli.exe + remote-agent.exe下载 ZIP ↙
Linuxx64 · remote-cli + remote-agent · glibc 2.28+下载 TAR.GZ ↙
Linuxarm64 · remote-cli + remote-agent · glibc 2.28+下载 TAR.GZ ↙
Linux (musl)x64 · Alpine 等 musl 发行版 · 静态链接下载 TAR.GZ ↙
Linux (musl)arm64 · Alpine 等 musl 发行版 · 静态链接下载 TAR.GZ ↙
macOSApple Silicon · arm64 · Agent + CLI下载 TAR.GZ ↙
FreeBSDx64 · remote-cli + remote-agent · FreeBSD 14+下载 TAR.GZ ↙
FreeBSDarm64 · remote-cli + remote-agent · FreeBSD 14+下载 TAR.GZ ↙
NetBSDx64 (amd64) · remote-cli + remote-agent · NetBSD 10+下载 TAR.GZ ↙

Android

按设备的角色选择应用 · ARM64 / x86_64

Browser Agent

让 Chrome 或 Edge 成为可管理设备。

Chrome / EdgeManifest V3 · 下载 ZIP ↙

解压 ZIP,在扩展管理页启用开发者模式,然后加载解压后的目录。

OpenWrt按固件 target 选择 Agent,LuCI 为可选配置界面

以下为 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。

OpenWrt Agent官方 OpenWrt 25.12 · ipq40xx/generic · ARMv7下载 APK ↙
OpenWrt Agent官方 OpenWrt 25.12 · x86/64下载 APK ↙
OpenWrt Agent官方 OpenWrt 25.12 · armsr/armv8 · aarch64_generic下载 APK ↙
OpenWrt Agent官方 OpenWrt 25.12 · mediatek/filogic · aarch64_cortex-a53下载 APK ↙
OpenWrt Agent官方 OpenWrt 25.12 · bcm27xx/bcm2711 · 树莓派 4 · aarch64_cortex-a72下载 APK ↙
OpenWrt Agent官方 OpenWrt 25.12 · ramips/mt7621 · mipsel_24kc下载 APK ↙
OpenWrt Agent官方 OpenWrt 25.12 · ath79/generic · mips_24kc下载 APK ↙
OpenWrt LuCI官方 OpenWrt 25.12 · 全架构 · 配合对应 Agent 安装下载 LuCI APK ↙
OpenWrt AgentImmortalWrt SNAPSHOT · ipq40xx/generic · ARMv7下载 APK ↙
OpenWrt AgentOpenWrt 25.12.5 官方构建(兼容 ImmortalWrt)· x86/64下载 APK ↙
OpenWrt AgentOpenWrt 25.12.5 官方构建(兼容 ImmortalWrt)· armsr/armv8 · aarch64下载 APK ↙
OpenWrt AgentOpenWrt 25.12.5 官方构建(兼容 ImmortalWrt)· mediatek/filogic · aarch64下载 APK ↙
OpenWrt AgentOpenWrt 25.12.5 官方构建(兼容 ImmortalWrt)· ath79/generic · mips_24kc下载 APK ↙
OpenWrt LuCIImmortalWrt SNAPSHOT · 全架构 · 配合对应 Agent 安装下载 LuCI 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、Console 和 CLI 有什么区别?

Agent 装在要管理的设备上。你可以通过网页控制台、Android Console 或 CLI 操作。Exchange 负责验证身份和转发请求,也可以自行部署。

每个平台的功能都一样吗?

设备管理、远程命令和文件操作都可以从控制端进入,但能用哪些功能取决于系统和权限。操作屏幕还需要平台支持和设备授权;输入法、系统设置及 ubus 等功能只在对应平台提供。

设备需要公网 IP 吗?

通常不需要。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 连接期间会保持亮屏,断开后恢复正常息屏。要操作屏幕,仍需解锁设备并授予对应权限。

能接入脚本或 AI 助手吗?

运行 remote-cli skill 即可生成独立的 Remote CLI Skill,默认获取官网最新版,无法获取时使用内置副本。浏览器操作包含多标签页、表单、iframe、CDP 和截图,不依赖其他 skill。操作仍受账号权限和设备能力约束。

在哪里查看文档和源码?

本站提供 使用说明、开发说明、技术说明、API 文档与 Skill 说明。源码与含服务器地址的部署步骤保留在私有仓库,公开文档与安装包无需仓库访问权限。

随时开始

要查看设备?
打开控制台。

进入工作区 ↗