Docker部署含Kotlinc的Rust GUI应用的两类问题排查

1. Rust与Kotlinc的容器部署选择 #

不需要为两个编译器单独创建容器，用多阶段构建就能搞定。这种方式既可以在构建阶段完整安装Rust和Kotlinc，又能在最终镜像里只保留运行必需的文件，大幅减小镜像体积，也方便应用和Kotlinc的集成调用。

2. 解决链接错误：找不到-lXinerama等依赖 #

fltk-rs依赖X11系列系统库，构建时必须安装对应的开发包。在Dockerfile的构建阶段添加以下依赖安装命令：

apt-get update && apt-get install -y \
    libxinerama-dev \
    libxft-dev \
    libxext-dev \
    libx11-dev \
    libfontconfig1-dev

这些包包含了链接时需要的头文件和静态库，能解决-lXinerama这类找不到依赖的报错。

3. 解决运行时"Can't open display: :0"错误 #

GUI应用需要访问宿主机的X11显示服务，所以运行容器时要做三个关键配置：

• 传递宿主机的DISPLAY环境变量到容器
• 挂载X11的Unix套接字文件
• 给容器授权访问X服务器

修正后的Dockerfile（多阶段构建） #

# 构建阶段：安装Rust、Kotlinc及构建依赖
FROM rust:1.78 as builder

# 安装fltk构建依赖
RUN apt-get update && apt-get install -y \
    libxinerama-dev \
    libxft-dev \
    libxext-dev \
    libx11-dev \
    libfontconfig1-dev \
    curl unzip

# 下载并安装Kotlinc（替换为你需要的版本）
RUN curl -L https://github.com/JetBrains/kotlin/releases/download/v1.9.22/kotlin-compiler-1.9.22.zip -o kotlinc.zip && \
    unzip kotlinc.zip -d /opt/kotlinc && \
    rm kotlinc.zip

# 配置Kotlinc环境变量
ENV PATH="/opt/kotlinc/bin:${PATH}"

# 复制项目代码并构建
WORKDIR /app
COPY Cargo.toml Cargo.lock ./
COPY src ./src
RUN cargo build --release

# 运行阶段：轻量镜像，只保留运行必需文件
FROM debian:stable-slim

# 安装运行时依赖
RUN apt-get update && apt-get install -y \
    libxinerama1 \
    libxft2 \
    libxext6 \
    libx11-6 \
    libfontconfig1 \
    openjdk-17-jre-headless && \
    rm -rf /var/lib/apt/lists/*

# 从构建阶段复制产物
COPY --from=builder /opt/kotlinc /opt/kotlinc
COPY --from=builder /app/target/release/your-app /usr/local/bin/your-app

# 配置运行时环境变量
ENV PATH="/opt/kotlinc/bin:${PATH}"

# 启动应用
CMD ["your-app"]

修正后的docker-compose.yaml #

version: '3.8'
services:
  rust-kotlin-gui:
    build: .
    environment:
      - DISPLAY=$DISPLAY
    volumes:
      - /tmp/.X11-unix:/tmp/.X11-unix

运行前的准备 #

在宿主机终端执行以下命令，授权容器访问X服务器：

xhost +local:root

（如果追求更安全的权限控制，可以用xhost +local:$(id -u)，运行完容器后记得执行xhost -收回权限）

然后启动容器：

docker-compose up

内容的提问来源于stack exchange，提问作者Orcadeum