termux/termux-x11

项目介绍

Termux:X11 是为 Termux 打造的 Android X 服务器，使用 Android NDK 构建。它让 Termux 里的图形 Linux 程序——完整桌面环境或单个 X11 应用——显示在 Android 窗口中，而不只是停留在无图形界面的终端里。适合已经使用 Termux、希望在手机或平板上运行真实 X 会话的用户。

项目由 Android 应用和 Termux 配套包两部分组成，二者都必须安装，且要求 Android 7 及以上。

快速使用

1. 从 nightly 发布标签下载并安装 Android 应用 termux-x11-universal-debug.apk（nightly release）。
2. 在 Termux 中启用图形软件源并安装配套包：

pkg i x11-repo && pkg i termux-x11-nightly

3. 可选：安装桌面环境，例如用 pkg i xfce 安装 XFCE。
4. 启动显示和会话，例如：

termux-x11 :1 -xstartup "dbus-launch --exit-with-session xfce4-session"

也可以先 export TERMUX_X11_XSTARTUP="xfce4-session" 再运行 termux-x11 :1，或用 & 启动服务器后设置 DISPLAY=:1 再手动启动会话。若 dbus-launch 不可用，改用 -xstartup "xfce4-session" 直接启动。结束使用时从通知栏退出 Android 界面；termux-x11 服务器进程仍在运行，需要另用 pkill -f termux-x11 停止。也可以用 am broadcast -a com.termux.x11.ACTION_STOP -p com.termux.x11 从命令行关闭界面。

设备问题与选项

部分设备只显示黑色屏幕加光标，此时加 -legacy-drawing 启动。部分设备颜色通道颠倒，可用 -force-bgra 解决。字体或缩放过大时，可在桌面环境的外观设置中调整 DPI，或在启动 termux-x11 时传 -dpi <数值>。

多个显示要作为独立 Android 窗口时，为每个显示传 -tag <名称>；重复运行同一 tag 会把已有窗口带到前台，而不是再开一个。

容器与第三方使用

使用 proot 或 proot-distro 时，需从 Termux shell 启动 termux-x11，并以 --shared-tmp 启动容器，或把 TMPDIR 设置为容器内 /tmp 对应的目录。使用 chroot 或 unshare 时，需以 root 运行，把 TMPDIR 指向容器的 tmp，把 XKB_CONFIG_ROOT 指向容器的 /usr/share/X11/xkb，并按文档通过 app_process 启动；README 说明该场景需禁用 SELinux。第三方应用可按 shell-loader/src/main/java/com/termux/x11/Loader.java 的方式集成。

使用约束

• 要求 Android 7 及以上，且 Android 应用和 Termux 配套包都要安装。
• sharedUid 变体可以减轻 Termux 在后台时的 CPU 限速，但只适用于从 GitHub 安装的 Termux，F-Droid 或 Google Play 版本签名不同，无法使用。
• Android 13 及以上需要授予通知权限，通知栏控制才会出现。
• 仓库使用 git 子模块，克隆时需加 --recurse-submodules，或之后执行 git submodule update --init --recursive。
• 源码以 GPL-3.0 发布。nightly 发布和 CI 构建都是 debug 版本，并非稳定发布通道。

HotRepo 点评

项目处在 Android 与 Linux 桌面工具的交叉地带。2026-11-08 它出现在 Java 日榜第 8 名，当天新增 7 星，累计 5,100 星、817 个 fork。这只是单次快照，只能说明当天仓库仍有增长，不足以判断趋势。更值得关注的是文档里的容器和多显示路径：proot、chroot、tag 窗口和偏好设置命令行都有覆盖，说明它面向实际使用场景，而不只是一个演示应用。