咕嘎容器 · 使用说明

写给完全没用过命令行的人。素材源:MiniRoot USER-GUIDE(九部分)。命令、端口、路径以本页为准;标「✅ 已实测」的为真机验证结论。

第一部分 · 上手前必读

1. 它到底是什么

在安卓的一个 App 里给你一个 Linux 命令行。不用 root、不用解锁、不刷机、不重装系统。

它不是:不是虚拟机、不是完整系统、没有桌面、不能装安卓 App、不能当公网云服务器。

2. 五个先记住的常识

  1. 只有黑底白字的命令行,没有鼠标点的东西。
  2. 命令要按回车才执行。手机键盘右下角的「换行/回车」就是。
  3. 里面的 root 是假的。提示符写着 root@localhost,但没有真系统权限(见第七部分)。
  4. 敲错命令不会弄坏手机。最多该命令失败,或删掉你自己刚建的文件。
  5. 按 Home 回桌面 ≠ 退出。容器在后台继续跑(通知栏有提示),回来接着用。

3. 三个版本,选哪个

你的手机装哪个里面有什么包体
Android 6 – 9,64 位V2 ARM64完整 Ubuntu 24.04,能 apt 装软件约 36MB
Android 6 – 9,仅 32 位V2 ARM同上约 31MB
Android 4.2 – 5.xV1 工具箱busybox + Node.js(自带 61MB glibc 版 node)+ 网页终端约 60MB
Android 2.3 – 4.1V3 复活版纯 busybox 终端(ash)+ 网页终端约 8MB
Android 10 及以上建议 V3新系统沙箱会拦 Ubuntu 需要的机制,✅ 实测 vivo Android 11 上 V2 起不来约 8MB
V1 特别说明:官网旧文案曾写「busybox + Node + Python」,实际只打包了 Node,没有 Python,也没有 apt(装不了新软件)。

4. 第一次打开

  1. 引导页:第 1 页 QQ 群二维码(群号可点复制)→ 第 2 页微信 → 第 3 页底部显示局域网密码,旁边有「复制密码」「设置密码」两个按钮。
  2. 点「进入容器」→ 弹「用前须知」→ 勾选同意才能进。
  3. 第一次要解压文件系统(进度条,几十秒到几分钟)。别中途划掉后台。至少留 400MB 存储空间。
  4. 解压完直接进终端,看到提示符:
root@localhost:~#

拆开看:root 当前用户 · @localhost 机器名 · ~ 你现在在哪个目录(~ = 家目录) · # 管理员提示符(普通用户是 $)。

到这一步,你已经在手机上用命令行里了。第二部分讲怎么改用电脑来操作它。

第二部分 · 从电脑连上这台手机

很多人卡住的原因是手机上的字太小、敲字太累。正确用法是把它当一台小服务器,坐在电脑前操作。

5. 前提:手机和电脑必须在同一个网络

  • 连着同一个 WiFi,或者电脑插路由器、手机连同一路由器的 WiFi。
  • 不算:手机用流量(4G/5G)、电脑和手机连的是两个不同的路由器/访客网络。
  • 路由器开的「AP 隔离 / 客户端隔离 / 访客网络」会让设备之间互相看不见 → 必须关掉(见 §10)。

6. 先拿到手机的 IP 地址

目前 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 后面那串
记下来,下面所有例子里的 192.168.1.13 都换成你自己的。IP 可能会变:手机重连 WiFi 后路由器可能发新地址,连不上时先回这步重新查。

7. 路线 A:用 guga 小工具(最快,电脑什么都不用装)

  1. 下载 guga.exe(Windows)/ guga-linux-amd64 / guga-linux-arm64,免安装、免 Python。
  2. 手机上打开引导页第 3 页,点「复制密码」(或自己改成短密码)。
  3. 电脑按 Win+R 输入 cmd 回车,进到放着 guga.exe 的目录,然后:
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 开关、不用配公钥,App 一起来就能用(端口 8911)。适合快速看两眼、跑脚本、给 AI 当工具。

它还能直接传文件和一键配好 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)
✅ 已实测:200KB 随机二进制传上去再传回来,MD5 完全一致(图片、压缩包、日志都能传)。

8. 路线 B:SSH(要长期用、要 vim/top 这类全屏程序,走这条)

最省事:一条命令配好

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:~#

手动配(没有 guga 工具时的备用办法)

  1. 手机存储根目录放一个空文件当开关,文件名必须一字不差:minroot_ssh_on
    (电脑上 adb:adb shell touch /sdcard/minroot_ssh_on)
  2. 把公钥(C:\Users\你\.ssh\id_ed25519.pub 的整行内容)写进手机上的 /sdcard/minroot_authorized_keys
  3. 把咕嘎容器退出重开一次(让它读到开关和公钥)
  4. ssh -p 2200 -i 私钥 root@192.168.1.13
要点:端口是 2200(不是 22);只认公钥,不认密码;只在内网可达;默认关闭。✅ 实测能拿到容器 root shell,ssh -tt 伪终端正常(vim、top 都能全屏跑)。

9. 路线 C:浏览器和原始 HTTP 接口

  • V1 / V3 有网页终端:电脑浏览器直接打开 http://192.168.1.13:8910,就能在网页里敲命令。
⚠️ 这个网页终端没有密码,只在自家可信 WiFi 下用,用完关掉 App。(V2 没有这个网页终端,✅ 实测 8910 端口不通。)

原始 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

10. 连不上怎么排查(按顺序试,别跳)

症状原因怎么办
完全连不上 / 超时不在同一网络回 §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 resetSSH 握手被重置同上检查开关/公钥/端口;scp、sftp 本来就不支持,别用——传文件请用 guga put/get
403 password required密码不对用引导页「复制密码」重新拿;改过密码就用改后的
昨天还能连今天不行手机 IP 变了回 §6 重新查 IP
电脑有防火墙弹窗Windows 防火墙拦了允许该网络(专用网络)访问

第三部分 · 命令行基本功

没有 AI 时全靠这几节。

11. 顶部那排按键

键干什么要点
CTRL组合键前缀按一次是「预备」,接着按字母键生效,用完自动解除。CTRL→c 中断 · CTRL→d 退出/EOF · CTRL→z 暂停 · CTRL→l 清屏 · CTRL→a 行首 · CTRL→e 行尾 · CTRL→r 搜历史
ALTAlt 前缀少数程序用
TAB自动补全新手第一神器。敲 cd /sy 按 TAB → 补全;多个候选再按 TAB 列出
ESC退出插入模式 / 取消vim 出不去就是靠它(见 §17)
↑ ↓历史命令 / 移动光标↑ 调出上一条
← →移动光标改中间的字
/ -直接给斜杠和减号老手机切符号页很痛苦,所以单独放出来

12. 路径:绝对 和 相对

  • 以 / 开头的是绝对路径:/sdcard/Download/a.txt
  • 不以 / 开头是相对路径,相对当前目录
  • . 当前目录,.. 上一级,~ 家目录
  • 常用:pwd、cd 目录、cd ..、cd(回家)

容器里四个关键目录(✅ 已实测):

路径是什么
/root家目录,容器自己的文件放这
/sdcard手机内部存储,和手机文件管理器同一个地方,双向可读写
/storage存储卡列表(外置 TF 卡在这,能否写视机型)
/supportApp 自己的运行文件(proot、busybox 等),别动

13. 通配符、重定向、管道

通配符

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; pwd

14. 引号(不写清楚一定会踩)

echo hello world
echo "两个 词"
echo $PATH
echo '$PATH'

文件名里有空格:cat "我的 文件.txt",或 cat 我的\ 文件.txt(反斜杠转义)。

15. 不知道命令怎么写的时候

命令 --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 装不了新软件。

16. 让命令在后台跑 / 权限位

长任务 &
jobs ; fg ; fg %1
nohup 长任务 &
CTRL + Z
ps | grep 名字
kill 进程号
kill -9 强杀

ls -l 文件
chmod +x 脚本.sh

读法:rwx = 可读/可写/可执行,三组分别是 拥有者 / 同组 / 其他人。

第四部分 · 编辑文件

17. 新手最大的坑:vim 怎么退出

先说结论:Ctrl+C 不能退出 vim。这是 vim 的设计,不是这个 App 的 bug。

vim 退出三步(✅ 已实测):

  1. 按 ESC(多按两次没关系,确保回到普通模式)
  2. 敲 :q!(冒号、q、感叹号;感叹号 = 不保存硬退)
  3. 按 回车

想保存并退出::wq 回车。开了多个文件全关::qa! 回车。

屏幕底部红字 E37: No write since last change (add ! to override) 的意思就是「你有改动没存,加个 ! 再来一次」。

vim 打开后打字没反应 / 字跑到屏幕最下面? vim 默认是「普通模式」,按键是命令不是文字。按 i 才进入插入模式(左下角出现 -- INSERT --);改完按 ESC 回普通模式再 :wq。

18. 推荐新手用 nano(退出提示就写在屏幕底部)

apt install -y nano
nano 文件名
  • 保存:CTRL → o,回车确认文件名
  • 退出:CTRL → x
  • 有改动不想存:问 Y/N 时按 n
  • 屏幕底部两行 ^O ^X 就是快捷键,^ 代表 CTRL

V1 / V3 装不了 nano(没有 apt),只能用 vi,退出方法同上。

第五部分 · 三个版本各自能干什么

19. V2(Ubuntu,主力版本)

能干什么:完整 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

第六部分 · 五个完整实例

22. 实例一:把手机上的照片传到电脑

# 一条命令拉下来(远端路径用容器里看到的路径)
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 就是文件列表。

23. 实例二:装 vim、写一个文件、退出

apt update
apt install -y vim
vim 笔记.txt        # 打开(没有就新建)
i                  # 按 i 进入插入模式,左下角出现 -- INSERT --
今天试了一下手机跑 Linux。
ESC                # 按顶部的 ESC 键,回到普通模式
:wq                # 冒号 w q,回车保存并退出
cat 笔记.txt

中途想放弃:ESC → :q! → 回车。

24. 实例三:手机当下载机(夜里挂着下)

apt install -y wget
cd /sdcard/Download
wget -c 你要下载的资源地址
  • -c = 断点续传,中断了重跑同一条接着下
  • 想丢后台:nohup wget -c 地址 > 下载.log 2>&1 &,然后 tail -f 下载.log 看进度(CTRL→c 退出查看,不影响下载)
  • 下完在手机上打开文件管理器就能看到(因为存的是 /sdcard)

25. 实例四:跑一个自己的小服务

apt install -y python3
cat > /root/hello.py <<'EOF'
print("hello from my old phone")
EOF
python3 /root/hello.py

对外提供服务时记住三件事:端口必须大于 1024、手机要和访问者同一网络、没有 systemd 所以服务得手动起。

26. 实例五:每天自动备份自己的文件

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
容器里的文件在卸载 App 或清除数据时会一起没了,所以备份一定要写到 /sdcard。

第七部分 · 限制与安全(诚实清单)

27. 这些事做不到,不是 bug

想干能吗为什么
监听 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

28. 安全须知

  • V1/V3 的网页终端 :8910 没有密码。只在自家可信 WiFi 用;公共 WiFi 别开,用完关掉 App。
  • Agent :8911 有局域网密码;SSH :2200 只认公钥且默认关闭。
  • 密码泄露 = 遥控权限泄露。别在不受信任的网络里用,别把端口映射到公网。
  • 完全开源免费(GPL-2.0)。任何收费售卖、预装收费、会员版都是盗版,买到立刻退款并举报。

第八部分 · 没有 AI 时,自己排障

29. 报错对照表

之类连 bash 都找不到
屏幕上出现意思怎么办
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 changevim 有改动没存存::wq;不存::q!
vim 里打的字跑到屏幕最下面你在插入模式按 ESC 回普通模式
bash: not foundPATH 乱了重开一次容器终端
403 password requiredAgent 接口密码不对引导页「复制密码」拿当前密码;改过密码就用改后的
解压卡住 / 提示空间不足存储不够至少留 400MB 空闲
通知栏一直显示保活设计不想用就退出 App

30. 三步自查法(记住这个比问人快)

  1. 看报错第一行:Permission denied / not found / No such file 是三类完全不同的问题。
  2. 确认你在哪:pwd 然后 ls。八成的 No such file 是目录不对或文件名打错(用 TAB 补全就不会打错)。
  3. 确认资源:df -h(磁盘满没)、free -m(内存够不够)、ps(程序活着没)。
在群里提问时请带上这四样,一次就能定位:手机型号 + 安卓版本 / 装的哪个版本(V1/V2/V3)/ 你敲的完整命令 / 屏幕完整报错截图。

第九部分 · 我们踩过的坑

想知道「为什么这样设计」再看。

  1. 为什么以前华为上 apt install 全失败? EMUI 禁止 App 创建硬链接,而 dpkg 解包必需。现在用 proot 的 link2symlink 把硬链接伪装成符号链接,dpkg 无感知。✅ 已真机验证。
  2. 为什么 SSH 端口是 2200? 22 是特权端口开不了;2022 是 UserLAnd 用的、8022 是 Termux 用的,故意错开避免撞车。
  3. 为什么 SSH 要放开关文件才启动? 不愿意在没人用的时候还开着一个能登录的端口。(推荐用 guga … ssh-on 一键打开。)
  4. 为什么 scp 不支持? 容器靠「跟踪进程」的机制跑 Linux,dropbear 自己 fork 的子进程会被干扰而死。传文件请走 /sdcard 或 guga put/get。
  5. 为什么密码能改、能复制? 老手机不能复制粘贴、没 QQ 没邮件,配置只能照屏幕手打。默认那串 guga-<32位序列号> 根本没法用。
  6. 为什么顶部 CTRL 是「一次性」的? 早期做成「按下不抬起」,修饰键永久卡住,之后每个键都变成控制码,vim 里彻底出不来。现在按一次、用一次、自动解除。
  7. 为什么 Ctrl+C 出不了 vim? 那是 vim 故意设计的,任何终端里都一样。见 §17。

求助

QQ 群 1098074780(引导页第 1 页扫码,群号可一键复制)。