jare/x11-bridge

可插拔的Docker X11 GUI桥接镜像

该镜像允许在Docker容器中运行GUI应用，并通过Xpra工具实现跨平台访问，支持Windows、GNU/Linux、MacOS系统或网页浏览器，可通过SSH或TCP协议连接。

核心功能

• 跨平台访问容器内GUI应用
• 支持SSH和TCP两种连接模式
• 提供网页浏览器访问入口（HTML模式）
• 支持多容器共享X11桥接环境

使用场景

• 开发者在Docker中运行带GUI的工具（如Emacs、图形化编辑器等）
• 跨平台访问容器内GUI应用的场景
• 团队协作中共享容器内GUI工具的使用

配置说明

• 环境变量：

  • MODE：连接模式，可选tcp或ssh
  • XPRA_HTML：是否开启网页访问，值为yes或no
  • DISPLAY：显示端口（如:14）
  • XPRA_PASSWORD：TCP模式下的访问密码

• SSH模式：需挂载公钥文件到/etc/pub-keys/目录，公钥文件名需以.pub结尾

部署示例

TCP模式（网页访问）

bash
docker run -d \
 --name x11-bridge \
 -e MODE="tcp" \
 -e XPRA_HTML="yes" \
 -e DISPLAY=:14 \
 -e XPRA_PASSWORD=111 \
 --net=host \
 docker.xuanyuan.run/jare/x11-bridge

# 运行GUI应用（如Emacs）
docker run -d \
 --name emacs-1 \
 --volumes-from x11-bridge \
 -e DISPLAY=:14 \
 docker.xuanyuan.run/jare/emacs emacs

访问地址：http://localhost:10000/index.html?encoding=rgb32&password=111

SSH模式

bash
docker run -d \
 --name x11-bridge \
 -e MODE="ssh" \
 -v ~/.ssh/pub_rsa:/etc/pub-keys/me.pub \
 -e DISPLAY=:14 \
 --net=host \
 docker.xuanyuan.run/jare/x11-bridge

# 运行GUI应用
docker run -d \
 --name emacs-1 \
 --volumes-from x11-bridge \
 -e DISPLAY=:14 \
 docker.xuanyuan.run/jare/emacs emacs

连接命令：xpra attach --encoding=rgb --ssh="ssh -o StrictHostKeyChecking=no -p 22" ssh:xpra@localhost:14

注意事项

• SSH模式下可通过Pageant（Windows）或PuTTYgen转换密钥格式
• 若Xpra卡顿，可选择“Lowest Bandwidth”模式
• 公网使用时建议搭配SSL代理或挂载证书以保障安全
• 容器内GUI应用可能需要依赖libGL.so.1（如Ubuntu的libgl1-mesa-glx）和字体文件

当前版本暂不支持摄像头和声音功能