ZeroTermux 中文文档 下载 App

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 是否正确