1. 它到底是什么
在安卓的一个 App 里给你一个 Linux 命令行。不用 root、不用解锁、不刷机、不重装系统。
它不是:不是虚拟机、不是完整系统、没有桌面、不能装安卓 App、不能当公网云服务器。
写给完全没用过命令行的人。素材源:MiniRoot USER-GUIDE(九部分)。命令、端口、路径以本页为准;标「✅ 已实测」的为真机验证结论。
在安卓的一个 App 里给你一个 Linux 命令行。不用 root、不用解锁、不刷机、不重装系统。
它不是:不是虚拟机、不是完整系统、没有桌面、不能装安卓 App、不能当公网云服务器。
| 你的手机 | 装哪个 | 里面有什么 | 包体 |
|---|---|---|---|
| Android 6 – 9,64 位 | V2 ARM64 | 完整 Ubuntu 24.04,能 apt 装软件 | 约 36MB |
| Android 6 – 9,仅 32 位 | V2 ARM | 同上 | 约 31MB |
| Android 4.2 – 5.x | V1 工具箱 | busybox + Node.js(自带 61MB glibc 版 node)+ 网页终端 | 约 60MB |
| Android 2.3 – 4.1 | V3 复活版 | 纯 busybox 终端(ash)+ 网页终端 | 约 8MB |
| Android 10 及以上 | 建议 V3 | 新系统沙箱会拦 Ubuntu 需要的机制,✅ 实测 vivo Android 11 上 V2 起不来 | 约 8MB |
root@localhost:~#
拆开看:root 当前用户 · @localhost 机器名 · ~ 你现在在哪个目录(~ = 家目录) · # 管理员提示符(普通用户是 $)。
到这一步,你已经在手机上用命令行里了。第二部分讲怎么改用电脑来操作它。
很多人卡住的原因是手机上的字太小、敲字太累。正确用法是把它当一台小服务器,坐在电脑前操作。
目前 App 界面上不显示 IP,请用下面任一方法查(推荐第一种):
| 方法 | 怎么做 |
|---|---|
| 手机设置里看 | 设置 → WLAN(WiFi)→ 点你已连接的那个网络 → 看 IP 地址,形如 192.168.1.13 |
| 电脑用 adb 看 | 手机开 USB 调试连电脑,执行 adb shell ip addr show wlan0,找 inet 192.168.1.13 |
| 路由器后台看 | 浏览器打开 192.168.1.1(路由器地址),在「已连接设备」列表里找手机名字 |
| 容器里看 | 在手机上敲 ifconfig wlan0 或 ip addr,找 inet 后面那串 |
C:\tools> guga.exe 192.168.1.13 你的密码 "df -h"跑一条命令就退出(✅ 实测输出):
C:\tools> guga.exe 192.168.1.13 你的密码 "uname -a"
Linux localhost 3.10.49-g0467415 #1 SMP PREEMPT Tue Feb 14 21:46:05 CST 2017 aarch64 aarch64 aarch64 GNU/Linux不带命令就是交互模式,跟 ssh 一样,敲一条回车看一条:
C:\tools> guga.exe 192.168.1.13 你的密码
咕嘎容器 192.168.1.13 (exit 退出)
guga> ls /sdcard
guga> df -h
guga> exit它还能直接传文件和一键配好 SSH:
guga.exe 192.168.1.13 你的密码 put 报告.pdf # 传到手机 /sdcard/
guga.exe 192.168.1.13 你的密码 put 脚本.sh /root/脚本.sh # 传到容器里
guga.exe 192.168.1.13 你的密码 get /var/log/syslog 日志.txt # 从容器拿下来
guga.exe 192.168.1.13 你的密码 ssh-on # 一键配好 SSH(见 §8)guga.exe 192.168.1.13 你的密码 ssh-on它会自动做完下面所有事:把你电脑上的公钥推进容器、放下 SSH 开关、把 SSH 服务起起来(✅ 实测登录成功)。
第一次用如果电脑还没有密钥,先跑一次 ssh-keygen -t ed25519(一路回车),然后:
ssh -p 2200 -i C:\Users\你\.ssh\id_ed25519 root@192.168.1.13第一次会问 Are you sure you want to continue connecting (yes/no)?,输 yes 回车。然后你就在容器里了:root@localhost:~#
原始 HTTP 接口(给脚本/AI 用,V1/V2/V3 都有,端口 8911,要密码):
http://192.168.1.13:8911/api/status?pw=你的密码
http://192.168.1.13:8911/api/exec?pw=你的密码&cmd=ls -l&wait=5
http://192.168.1.13:8911/api/file?pw=你的密码&path=/etc/hosts # 下载文件
POST http://192.168.1.13:8911/api/file?pw=你的密码&path=/sdcard/a.txt # 上传(请求体=文件内容)running=false shellAlive=true offset=9999 port=8911
| 症状 | 原因 | 怎么办 |
|---|---|---|
| 完全连不上 / 超时 | 不在同一网络 | 回 §5 确认同一个 WiFi;手机别用流量 |
| 同一 WiFi 还是不通 | 路由器开了 AP 隔离 / 访客网络 | 登录路由器关掉,或连到同一个普通网络 |
| guga 能连,SSH 不通 | SSH 开关没开或公钥没配 | 优先 guga … ssh-on;手动则查 minroot_ssh_on 与 minroot_authorized_keys,App 退出重开 |
| Permission denied (publickey) | 公钥没配对 | 检查 /sdcard/minroot_authorized_keys 是不是公钥(.pub)、整行没截断;ssh -v 看细节 |
| Connection refused | 端口不对 | 是 2200(SSH)/ 8911(接口)/ 8910(网页终端,仅 V1/V3) |
| kex_exchange_identification: read: Connection reset | SSH 握手被重置 | 同上检查开关/公钥/端口;scp、sftp 本来就不支持,别用——传文件请用 guga put/get |
| 403 password required | 密码不对 | 用引导页「复制密码」重新拿;改过密码就用改后的 |
| 昨天还能连今天不行 | 手机 IP 变了 | 回 §6 重新查 IP |
| 电脑有防火墙弹窗 | Windows 防火墙拦了 | 允许该网络(专用网络)访问 |
没有 AI 时全靠这几节。
| 键 | 干什么 | 要点 |
|---|---|---|
| CTRL | 组合键前缀 | 按一次是「预备」,接着按字母键生效,用完自动解除。CTRL→c 中断 · CTRL→d 退出/EOF · CTRL→z 暂停 · CTRL→l 清屏 · CTRL→a 行首 · CTRL→e 行尾 · CTRL→r 搜历史 |
| ALT | Alt 前缀 | 少数程序用 |
| TAB | 自动补全 | 新手第一神器。敲 cd /sy 按 TAB → 补全;多个候选再按 TAB 列出 |
| ESC | 退出插入模式 / 取消 | vim 出不去就是靠它(见 §17) |
| ↑ ↓ | 历史命令 / 移动光标 | ↑ 调出上一条 |
| ← → | 移动光标 | 改中间的字 |
| / - | 直接给斜杠和减号 | 老手机切符号页很痛苦,所以单独放出来 |
容器里四个关键目录(✅ 已实测):
| 路径 | 是什么 |
|---|---|
| /root | 家目录,容器自己的文件放这 |
| /sdcard | 手机内部存储,和手机文件管理器同一个地方,双向可读写 |
| /storage | 存储卡列表(外置 TF 卡在这,能否写视机型) |
| /support | App 自己的运行文件(proot、busybox 等),别动 |
通配符
ls *.txt # 所有 .txt 结尾的文件
ls log?.txt # ? 代表任意一个字符
rm a* # 删所有 a 开头的 —— 敲 rm 前先想三秒重定向:把输出存成文件
ls > 清单.txt
ls >> 清单.txt
cmd 2> 错误.txt
cmd > 全部.txt 2>&1
cat a.txt b.txt > 合并.txt管道:把上一个命令的输出交给下一个
ps | grep vim
cat 大文件.txt | less
ls | wc -l
history | grep apt串起来执行
cd /sdcard && ls
mkdir x; cd x; pwdecho hello world
echo "两个 词"
echo $PATH
echo '$PATH'文件名里有空格:cat "我的 文件.txt",或 cat 我的\ 文件.txt(反斜杠转义)。
命令 --help
man ls # V2 要 apt install man-db;按 q 退出
busybox --list # V1/V3:这台机器到底有哪些命令
dpkg -S /usr/bin/vim # V2:某个命令属于哪个软件包
apt search nginx # V2:找软件
command -v 命令command not found 不代表手机坏了,只代表没装。V2 用 apt install 装;V1/V3 装不了新软件。
长任务 &
jobs ; fg ; fg %1
nohup 长任务 &
CTRL + Z
ps | grep 名字
kill 进程号
kill -9 强杀
ls -l 文件
chmod +x 脚本.sh读法:rwx = 可读/可写/可执行,三组分别是 拥有者 / 同组 / 其他人。
vim 退出三步(✅ 已实测):
想保存并退出::wq 回车。开了多个文件全关::qa! 回车。
屏幕底部红字 E37: No write since last change (add ! to override) 的意思就是「你有改动没存,加个 ! 再来一次」。
vim 打开后打字没反应 / 字跑到屏幕最下面? vim 默认是「普通模式」,按键是命令不是文字。按 i 才进入插入模式(左下角出现 -- INSERT --);改完按 ESC 回普通模式再 :wq。
apt install -y nano
nano 文件名V1 / V3 装不了 nano(没有 apt),只能用 vi,退出方法同上。
能干什么:完整 Ubuntu 命令行生态,apt 装软件,跑 Python/Node/Go/Rust 编译出来的程序,起 Web 服务、当下载机、跑脚本。
装软件(apt)(✅ 全流程已实测):
apt update # 先刷新列表,必做
apt install -y vim # -y = 不问直接 yes
apt remove -y vim
apt search nginx
apt list --installed
apt clean # 清下载缓存省空间国内镜像源已内置,不用自己换。
出厂只带最基础的命令(✅ 实测确认):vim 有;nano、python3、node、git、curl、wget 都没有,要用就 apt install。这不是 bug,是精简版根文件系统。
定时任务
apt install -y cron
crontab -e # 加一行: 0 3 * * * /root/bin/backup.sh
service cron start # 注意:没有 systemd,服务要手动 start里面有什么:busybox 全家桶 + Node.js(自带 61MB glibc 版,命令就是 node)+ 网页终端。
没有:apt(装不了软件)、Python(官网旧文案有误)。
node -v # Node 可用
node 脚本.js # 直接跑 JS
busybox --list # 看这台机器有哪些命令适合:手上只有 4.x 系统、想跑跑脚本 / 玩玩 Node。想要「能装软件的 Linux」必须 V2。
里面有什么:一个 busybox 静态二进制 + ash 终端。没有 apt、没有 Ubuntu、装不了新软件。
能用的都是 busybox 内置的那批(例如 ls cd cat grep sed awk find tar gzip vi wget nc df ps top sort cut tail head wc chmod chown xargs md5sum base64 nslookup netstat ifconfig 等)。
确切清单请在手机上执行 busybox --list 查看。
特点:约 8MB;✅ 实测在 90MB 内存的波导 T9108 上,App + shell 常驻内存约 19MB,能跑。
注意:老机器常常没有 SD 卡,所以局域网密码必须能在屏幕上看到/复制——这就是引导页放「复制密码」按钮的原因。
# 一条命令拉下来(远端路径用容器里看到的路径)
guga.exe 192.168.1.13 你的密码 get /sdcard/DCIM/Camera/IMG_0001.jpg 照片.jpg反过来把电脑文件送上手机:
guga.exe 192.168.1.13 你的密码 put 报告.pdf # 落到手机 /sdcard/报告.pdf
guga.exe 192.168.1.13 你的密码 put 脚本.sh /root/脚本.sh # 落到容器里不想用工具也行:手机文件管理器直接看 /sdcard(= 手机内部存储),或者:
# 容器里起一个临时下载站,电脑浏览器点着下载
apt install -y python3
cd /sdcard/DCIM/Camera
python3 -m http.server 8000电脑浏览器打开 http://192.168.1.13:8000 就是文件列表。
apt update
apt install -y vim
vim 笔记.txt # 打开(没有就新建)
i # 按 i 进入插入模式,左下角出现 -- INSERT --
今天试了一下手机跑 Linux。
ESC # 按顶部的 ESC 键,回到普通模式
:wq # 冒号 w q,回车保存并退出
cat 笔记.txt中途想放弃:ESC → :q! → 回车。
apt install -y wget
cd /sdcard/Download
wget -c 你要下载的资源地址apt install -y python3
cat > /root/hello.py <<'EOF'
print("hello from my old phone")
EOF
python3 /root/hello.py对外提供服务时记住三件事:端口必须大于 1024、手机要和访问者同一网络、没有 systemd 所以服务得手动起。
mkdir -p /root/bin
cat > /root/bin/backup.sh <<'EOF'
#!/bin/bash
D=$(date +%F)
tar czf /sdcard/备份-$D.tar.gz /root/bin /root/notes
echo "$D 备份完成" >> /sdcard/备份.log
EOF
chmod +x /root/bin/backup.sh
/root/bin/backup.sh # 先手动跑一次,确认能出文件
apt install -y cron
crontab -e # 加入: 0 3 * * * /root/bin/backup.sh
service cron start| 想干 | 能吗 | 为什么 |
|---|---|---|
| 监听 22/80/443 等 1024 以下端口 | ❌ | 没有真实特权。改用 2200、8000、8080 |
| ping | ❌ | 需要原始套接字(✅ 实测:命令没有,权限也不行) |
| mount、改分区、改安卓系统设置 | ❌ | 假 root |
| systemctl / 开机自启 | ❌ | 容器里没有 systemd。要手动 service xxx start 或脚本拉起 |
| su / sudo 提到安卓系统层 | ❌ | 装得上也不生效 |
| 图形桌面 / VNC | ❌ | 当前版本不含 |
| Android 10+ 跑 V2 | ⚠️ 多数不行 | 系统沙箱拦截(✅ 实测 vivo Android 11 失败)→ 用 V3 |
| 跑 Hadoop/Spark 这类重活 | ⚠️ 别指望 | 老手机 CPU + 小内存;跑脚本、轻量 Web、下载、学习可以 |
| scp / sftp 传文件 | ❌ 用 guga put / get | 见 §7、§22。也可以用 /sdcard 或 HTTP 接口 |
| 卸载 App 后找回容器里的文件 | ❌ 全没 | 重要文件定期拷到 /sdcard |
| 屏幕上出现 | 意思 | 怎么办 |
|---|---|---|
| Permission denied | 没权限 | 假 root 的正常现象。换到 /root 或 /sdcard 下操作,别碰 /system、别的 App 目录 |
| command not found | 命令没装 | V2:apt install;V1/V3:装不了。用 busybox --list / apt search 确认 |
| E: Could not get lock /var/lib/dpkg/lock | 另一个 apt 还在跑 | 等它结束;确认没在跑再 rm /var/lib/dpkg/lock-frontend |
| E: dpkg was interrupted ... dpkg --configure -a | 上次安装中途被打断 | 照提示执行 dpkg --configure -a(✅ 实测能恢复) |
| Temporary failure resolving ... | 解析不了域名 | 手机是否连网、WiFi 能不能上外网。DNS 已内置 223.5.5.5 / 8.8.8.8 |
| E37: No write since last change | vim 有改动没存 | 存::wq;不存::q! |
| vim 里打的字跑到屏幕最下面 | 你在插入模式 | 按 ESC 回普通模式 |
| bash: not found | 之类连 bash 都找不到PATH 乱了 | 重开一次容器终端 |
| 403 password required | Agent 接口密码不对 | 引导页「复制密码」拿当前密码;改过密码就用改后的 |
| 解压卡住 / 提示空间不足 | 存储不够 | 至少留 400MB 空闲 |
| 通知栏一直显示 | 保活设计 | 不想用就退出 App |
想知道「为什么这样设计」再看。
QQ 群 1098074780(引导页第 1 页扫码,群号可一键复制)。