remote连接不同地方的设备。
Agent 会主动连接服务端，因此也能管理位于 NAT 后的设备。可用二维码或六位码配对，在一个工作区查看多台设备。
YOUR DEVICES. ONE WORKSPACE.
设备不在身边，
也能照常管理。
把要管理的设备接入同一个工作区。
用网页、移动应用或命令行
查看状态、处理文件和执行命令。
WindowsLinuxmacOSAndroidOpenWrt
我的设备在这里查看和管理
CONNECTED$ 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 或 CLI↔02 连接服务 验证身份、转发请求↔03 设备 Agent 接收并执行操作
01 / CAPABILITIES
常用操作，都在这里。
先查看设备，再选择要做的事。
具体功能取决于设备和权限。
远程运行命令。
执行一条命令，或打开交互式终端。适合日常维护，也可以配合自己的脚本使用。
查看和传输文件。
浏览设备上的目录，上传或下载文件。可以在控制台或 CLI 中操作。
看看设备现在怎样。
查看在线状态、系统信息、运行指标和日志，方便了解设备当前的情况。
需要时操作屏幕。
在支持的设备上查看屏幕、点击和输入文字。语音、展示和系统设置等功能取决于设备平台。
管理谁能访问设备。
在工作区设置成员、角色和设备访问权限，查看操作记录。也可以自行部署连接服务。
不同平台与系统权限决定可用能力。Android 屏幕共享、辅助功能和输入法需在设备上启用；OpenWrt 另提供 ubus 操作。
03 / DOWNLOADS
下载适合设备的安装包。
要管理哪台设备，就在那台设备上安装 Agent。
正在读取版本信息…
电脑与服务器
Windows、Linux、macOS · 安装包包含 Agent 与 CLI
QUICK INSTALL
也可以运行下面的命令安装。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 ↙
macOSApple Silicon · arm64 · Agent + CLI下载 TAR.GZ ↙
Android
按设备的角色选择应用 · ARM64 / x86_64
被管理设备
Remote Agent
装在要管理的 Android 设备上，让它连接工作区并接收操作。你可以在应用中查看连接状态、设置权限和检查更新。
下载 Android Agent ↓Android APK · Release 签名控制端
Remote Console
装在用来操作的 Android 设备上。可以查看其他设备的状态、打开终端或处理文件，也可以改用网页控制台。
下载 Android Console ↓独立 APK · Release 签名OpenWrt按固件 target 选择 Agent，LuCI 为可选配置界面
以下为 ImmortalWrt SNAPSHOT 的 apk-tools 软件包，不是 Android 安装包。请核对设备固件与目标架构。
OpenWrt AgentImmortalWrt SNAPSHOT · ipq40xx/generic · ARMv7下载 APK ↙
OpenWrt AgentImmortalWrt SNAPSHOT · x86/64下载 APK ↙
OpenWrt AgentImmortalWrt SNAPSHOT · armsr/armv8 · aarch64下载 APK ↙
OpenWrt AgentImmortalWrt SNAPSHOT · mediatek/filogic · aarch64下载 APK ↙
OpenWrt AgentImmortalWrt SNAPSHOT · ath79/generic · mips_24kc下载 APK ↙
OpenWrt LuCI路由器配置界面 · 全架构 · 配合对应 Agent 安装下载 LuCI APK ↙
04 / IN PRACTICE
试试这些常用命令。
登录 CLI 后，选择你要做的事。
记得把 my-device 换成你的设备 ID。
remote-cli device list remote-cli metrics my-device --limit 5 remote-cli logs my-device --limit 20
查看设备列表、近期指标和日志。能看到哪些信息，取决于设备平台和权限。
05 / QUESTIONS
你可能想了解。
Agent、Console 和 CLI 有什么区别？
Agent 装在要管理的设备上。你可以通过网页控制台、Android Console 或 CLI 操作。Exchange 负责验证身份和转发请求，也可以自行部署。
每个平台的功能都一样吗？
设备管理、远程命令和文件操作都可以从控制端进入，但能用哪些功能取决于系统和权限。操作屏幕还需要平台支持和设备授权；输入法、系统设置及 ubus 等功能只在对应平台提供。
设备需要公网 IP 吗？
通常不需要。Agent 会主动连接 Exchange，设备一般不用开放入站端口。无论使用默认服务还是自建服务，设备和控制端都要能访问它。
如何安装和更新？
从下载区选择对应平台。Android 首次安装可能需要允许浏览器安装应用；后续可在 Agent 或 Console 的设置中检查更新，并按系统提示确认。旧 Debug 签名版本无法直接覆盖为 Release 签名，卸载会清除本机配置。
支持自更新的桌面版本可运行 remote-agent update self --check 或 remote-cli update self --check；去掉 --check 后执行更新。
设备锁屏或进入后台后还能用吗？
这取决于系统的电源管理和运行权限。Android Agent 连接期间会保持亮屏，断开后恢复正常息屏。要操作屏幕，仍需解锁设备并授予对应权限。
能接入脚本或 AI 助手吗？
可以使用 CLI 或 HTTP API 接入自动化流程。AI 助手可参考 Remote Skill；可执行的操作仍受账号权限和设备能力约束。
READY WHEN YOU ARE