ControlCmd Downloads

ANDROID

Android App

安装小狸控制台手机 App。安装后使用管理员分配的账号登录，再连接同账号下的电脑 Agent。

SHA-256
6f64aa3816bcba30f6f5ed8f0d155a8ddd28c9a9fe02366947ab1f8a5bc6c557

Download APK

WINDOWS

Windows Agent

适用于 Windows 10/11 amd64。请从当前登录的桌面用户启动，避免 Session 0 黑屏。

SHA-256
f8d584439ebd047445bb56f7d74b6e85f709ce8f2dddf17f7716d6d2378b5e79

Download ZIP

MACOS

macOS Agent

适用于 Intel macOS。需要安装 tmux，支持手机、浏览器和桌面终端同步查看。

SHA-256
a3df041727e453e47500bd9dd85b3a951689b13bf5e00991e18b8b3afabec8e3

Download TAR.GZ

LINUX

Linux Agent

适用于 Linux x86_64。需要 tmux，可手动后台启动或安装 systemd user service。

SHA-256
92059c992df041fb893cedf455e796eaf563ea2270cd9de728bb010c5bab160c

Download TAR.GZ

快速安装

先安装 Android App，再在需要控制的电脑上安装对应 Agent。

Windows

Copy-Item config\agent.env.example config\agent.env
notepad config\agent.env
powershell -ExecutionPolicy Bypass -File .\scripts\doctor.ps1
powershell -ExecutionPolicy Bypass -File .\scripts\start-agent.ps1

macOS / Linux

cp config/agent.env.example config/agent.env
nano config/agent.env
./scripts/doctor.sh
./scripts/start-agent.sh
./scripts/status-agent.sh

配置文件里必须填写 AGENT_ACCOUNT、AGENT_PASSWORD、AGENT_DEVICE_NAME 和唯一的 AGENT_DEVICE_FINGERPRINT。

SERVER_URL=https://api.xiaoli.world
AGENT_ACCOUNT=zhangsan@example.com
AGENT_PASSWORD=手机 App 登录使用的同一个密码
AGENT_DEVICE_NAME=office-windows-01
AGENT_DEVICE_FINGERPRINT=550e8400-e29b-41d4-a716-446655440000

AGENT_ACCOUNT 和 AGENT_PASSWORD 是服务端登录账号密码，必须和手机 App 登录使用的账号密码一致。App 只会显示同一个账号下面注册上来的电脑。

AGENT_DEVICE_NAME 是 App 设备列表里的显示名；AGENT_DEVICE_FINGERPRINT 是这台电脑的稳定唯一 ID，不是密码。每台电脑必须不同，安装后尽量不要修改，也不要复制到另一台电脑。

指纹可以用固定可读 ID，例如 windows-office-01-20260508，也可以用 UUID。Windows 执行 [guid]::NewGuid().ToString()，macOS/Linux 执行 uuidgen。

同步查看终端

Agent 启动后，同一台电脑可打开本地浏览器终端：

http://127.0.0.1:18081/terminal

macOS/Linux 还可以在桌面终端 attach 同一个任务：

tmux attach -t codex

退出查看但不关闭任务：Ctrl-b 后按 d。

校验下载

下载完整校验文件：

curl -O https://download.xiaoli.world/downloads/3.0.0/SHA256SUMS
shasum -a 256 -c SHA256SUMS

查看 SHA256SUMS

Windows 注意： 手机终端依赖 Windows ConPTY，Agent 必须从当前登录的桌面用户启动。不要用 WinRM、SSH 或 Windows Service 来测试交互终端。