CLion在Docker Desktop构建keepassxc时遇权限拒绝及用户ID不匹配问题

问题背景 #

我使用Ubuntu 22.04系统、CLion 2024.2.2及Docker Desktop 4.34.2，按照官方教程配置Docker工具链构建KeePassXC项目时遇到以下问题：

• 初始阶段CLion无法识别容器内编译器路径，手动指定后出现CMake权限拒绝错误，提示无法写入日志文件
• 将cmake-build-debug-docker目录权限设为0777后构建成功，但生成的可执行文件等文件属主为用户ID 100999，与宿主用户ID不匹配
• 尝试在Dockerfile中添加指定UID用户的配置（ARG UID=1000；RUN useradd -m -u ${UID} -s /bin/bash builder；USER builder），但问题未解决

修复步骤 #

1. 修正Dockerfile的用户映射配置 #

之前的配置只创建了用户，但未同步用户组权限，也没有确保工作目录对该用户开放。修改后的Dockerfile如下：

FROM ubuntu:jammy

ENV DEBIAN_FRONTEND=noninteractive

# 接收宿主UID/GID参数，默认值为1000（Ubuntu默认用户UID）
ARG UID=1000
ARG GID=1000

# 创建与宿主匹配的用户组和用户
RUN groupadd -g ${GID} builder && \
    useradd -m -u ${UID} -g ${GID} -s /bin/bash builder

# 安装KeePassXC构建依赖
RUN apt update && apt install -y \
    asciidoctor \
    build-essential \
    clang \
    cmake \
    gcc \
    gdb \
    g++ \
    make

RUN apt install -y \
    qtbase5-dev qtbase5-private-dev qttools5-dev qttools5-dev-tools \
        libqt5svg5-dev libargon2-dev libminizip-dev libbotan-2-dev libqrencode-dev \
        libkeyutils-dev zlib1g-dev libreadline-dev libpcsclite-dev libusb-1.0-0-dev \
        libxi-dev libxtst-dev  libqt5x11extras5-dev

# 设置项目工作目录并赋予builder用户完全权限
WORKDIR /project
RUN chown -R builder:builder /project

# 切换到builder用户执行后续构建操作
USER builder

2. 调整CLion Docker工具链参数 #

• 打开CLion的Settings > Build, Execution, Deployment > Docker，确认Docker Desktop已正常连接
• 进入Settings > Build, Execution, Deployment > Toolchains，选中已配置的Docker工具链：
  • 在Container settings的Build arguments中添加：--build-arg UID=$(id -u) --build-arg GID=$(id -g)，这样会自动读取当前宿主用户的UID和GID传入容器
  • 确保Working directory设置为/project（与Dockerfile中的WORKDIR保持一致）
  • 检查CMake、C Compiler、CXX Compiler的路径是否正确指向容器内的工具（比如/usr/bin/cmake、/usr/bin/gcc、/usr/bin/g++）

3. 清理本地旧构建目录（可选） #

如果之前的cmake-build-debug-docker目录权限已混乱，先删除重建：

rm -rf cmake-build-debug-docker
mkdir cmake-build-debug-docker

无需手动设置0777权限，因为容器内的builder用户与宿主UID一致，会自动拥有该目录的读写权限

4. 重新构建镜像并加载项目 #

• 在CLion的Docker工具链页面点击Rebuild image，确保构建参数生效
• 重新加载CMake项目，此时构建生成的文件属主会与宿主用户一致，同时不会再出现权限拒绝问题

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