X11 安装步骤——跑 termux-x11-install.sh
入口方式
从左侧边栏进入:
X11 功能 → 安装 X11
ZeroTermux 会把安装脚本发送到当前终端。如果菜单里没有这个选项或想手动装,按下面的命令行方式来。
命令行方式
第一步:安装基础包
pkg update
pkg install x11-repo
pkg install termux-x11-nightly
pkg install pulseaudio
x11-repo 是 Termux 的 X11 软件仓库,里面有所有 GUI 程序的编译版本。装完这个仓库 pkg install firefox 才找得到包。
termux-x11-nightly 是 X Server 本体,由 ZeroTermux 内置的 X11 通道承载。
pulseaudio 是声音服务——如果你跑的 GUI 程序需要声音输出(比如 VLC、Firefox),这个包也要装。
第二步:启动 X Server
termux-x11 :0 &
参数 :0 是显示器号。启动成功后终端会输出 Waiting for client to connect 之类的提示。
第三步:设置 DISPLAY 环境变量
在同一个终端会话里:
export DISPLAY=:0
export PULSE_SERVER=127.0.0.1
想持久化的话加到 ~/.bashrc 里。
第四步:测试
pkg install xeyes
xeyes
屏幕上应该会出现两只眼睛跟着手指转。成功了说明 X11 通道跑通了。
发行版里也能用
如果你在发行版(Ubuntu / Debian 等)里跑 GUI 程序,需要把 DISPLAY 映射过去。典型的方式:
# 在发行版里设置
export DISPLAY=127.0.0.1:10
export PULSE_SERVER=127.0.0.1
# 或者通过 proot 的 --bind 挂载 X11 socket
不同发行版启动脚本可能自动处理了这个映射,如果没有需要手动配。
安装失败排查
| 问题 | 处理 |
|---|---|
pkg install x11-repo 找不到包 | 先 pkg update,确认源可用 |
| termux-x11 启动后立即退出 | 检查版本是否和 ZeroTermux 内置通道匹配,重新装 termux-x11-nightly |
| 启动 xeyes 没反应 | 确认 DISPLAY 设置正确,termux-x11 还在运行 |
| GUI 程序声音没出来 | 检查 pulseaudio 是否装了、PULSE_SERVER 是否正确 |