如何在VS Code Dev Container中正确配置remoteUser使用自定义用户？

问题原因 #

你遇到的unable to find user vorpalsword: no matching entries in passwd file错误，核心原因是：虽然绑定了主机的/etc/passwd和/etc/group到容器，但容器内没有创建对应用户的家目录，且缺少该用户的实际系统实体（UID/GID对应的用户组和用户目录），导致Dev Containers切换用户时无法找到有效用户。另外，你的.devcontainer配置存在JSON语法错误："image": "my_image"行末尾缺少逗号，会导致配置解析失败。

解决方案 #

方案1：修改Dockerfile预创建匹配主机用户的用户（推荐） #

通过构建参数传递主机用户的UID和GID，在镜像构建时创建完全匹配的用户，确保容器内用户环境与主机一致：

1. 修改Dockerfile：

FROM ubuntu:20.04

# 添加构建参数，接收主机用户的UID/GID（默认值1000对应多数Linux系统的普通用户）
ARG USER_UID=1000
ARG USER_GID=1000

# 安装依赖工具
RUN apt update &&\
  apt install -qq -y software-properties-common &&\
  add-apt-repository ppa:deadsnakes/ppa &&\
  apt update &&\
  apt install -qq -y python3.8 build-essential cmake git sudo

# 创建匹配主机UID/GID的用户及家目录，配置sudo权限
RUN groupadd --gid $USER_GID devuser && \
    useradd --uid $USER_UID --gid $USER_GID -m devuser && \
    echo devuser ALL=\(root\) NOPASSWD:ALL > /etc/sudoers.d/devuser && \
    chmod 0440 /etc/sudoers.d/devuser

# 安装交叉编译工具链
COPY sdk.sh .
RUN ./sdk.sh && rm sdk.sh

# 默认切换到创建的普通用户
USER devuser

ENTRYPOINT ["/bin/bash"]

2. 构建镜像：
   执行以下命令，将你的主机UID和GID传递给构建参数：

docker build --build-arg USER_UID=$(id -u) --build-arg USER_GID=$(id -g) -t my_image .

3. 修改.devcontainer配置：

{
  "image": "my_image",
  "remoteUser": "devuser"
}

方案2：在容器启动时自动创建用户（无需修改Dockerfile） #

修正配置语法错误，通过postCreateCommand在容器启动后自动创建匹配主机的用户：

{
  "image": "my_image",
  "remoteUser": "${env:USERNAME}",
  "postCreateCommand": "groupadd --gid $(id -g) ${env:USERNAME} || true; useradd --uid $(id -u) --gid $(id -g) -m ${env:USERNAME} || true; echo ${env:USERNAME} ALL=(root) NOPASSWD:ALL > /etc/sudoers.d/${env:USERNAME}; chmod 0440 /etc/sudoers.d/${env:USERNAME}",
  "mounts": [
    "type=bind,source=/etc/passwd,target=/etc/passwd,readonly=true",
    "type=bind,source=/etc/group,target=/etc/group,readonly=true"
  ]
}

• || true用于避免用户/组已存在时的报错
• 配置sudo权限是为了让你在容器内可以执行需要root权限的操作

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