如何修改Rocker容器的HOME目录以保留Rstudio用户设置？

问题背景 #

使用Rocker容器运行RStudio时，默认HOME目录位于容器内部，重启容器后用户的配置文件、Git凭据等设置会丢失。需要将HOME目录改为挂载存储卷上的用户专属路径/aci/scripts/R.generiek/User.settings/$USER，实现设置持久化。尝试在构建镜像时向.Renviron文件添加HOME='/aci/scripts/R.generiek/User.settings/$USER'，导致容器无法正常启动，但手动修改.Renviron后启动新R会话时HOME目录是正确的。

问题原因 #

1. 构建镜像时静态写入.Renviron的HOME路径，在容器启动时可能因用户环境不匹配（如用户未创建、挂载卷目录不存在或权限错误）导致RStudio启动失败。
2. RStudio服务器启动时依赖原HOME目录下的配置文件（如.config/rstudio），提前通过.Renviron修改HOME会导致启动时找不到必要文件，引发启动异常。

解决方案 #

通过容器启动脚本动态设置HOME，并确保挂载卷目录存在、权限正确，同时迁移必要的RStudio配置文件到新HOME目录。

修改后的Dockerfile #

FROM rocker/tidyverse:latest

# 设置构建参数：用户名、UID、GID
ARG USER
ARG UID=1000
ARG GID=1000

# 创建指定用户并配置sudo权限
RUN groupadd -g $GID $USER && \
    useradd -m -u $UID -g $GID -s /bin/bash $USER && \
    echo "$USER ALL=(ALL) NOPASSWD:ALL" >> /etc/sudoers.d/$USER && \
    chmod 0440 /etc/sudoers.d/$USER

# 复制R脚本文件
COPY install_packages.R /install_packages.R
COPY packages_scan.R /packages_scan.R
# 将RStudio配置文件暂存到临时目录，启动时再迁移
COPY rstudio-prefs.json /tmp/rstudio-prefs.json

# 安装ODBC及系统依赖
RUN apt-get update && apt-get install -y \
    cron \
    nano \
    tdsodbc \
    odbc-postgresql \
    libsqliteodbc \
    apt-transport-https \
    curl \
    gnupg \
    unixodbc-dev \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/ \
    && rm -rf /tmp/downloaded_packages/ /tmp/*.rds

# 安装Microsoft ODBC驱动
RUN curl https://packages.microsoft.com/keys/microsoft.asc | apt-key add -
RUN curl https://packages.microsoft.com/config/debian/9/prod.list > /etc/apt/sources.list.d/mssql-release.list
RUN apt-get update -y
RUN ACCEPT_EULA=Y apt-get install --yes --no-install-recommends msodbcsql18 

# 安装Azure CLI
RUN curl -sL https://aka.ms/InstallAzureCLIDeb | bash

# 安装R包
RUN Rscript /install_packages.R

# 安装额外系统依赖
RUN apt-get update \
    && apt-get upgrade -y \
    && apt-get install -y \
    default-jre \
    libv8-dev \
    python3-pip \
    xclip \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/

# 运行R包扫描脚本
RUN Rscript /packages_scan.R

# 复制容器启动脚本并赋予执行权限
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh

# 切换到创建的用户
USER $USER

# 设置启动入口
ENTRYPOINT ["/entrypoint.sh"]

容器启动脚本（entrypoint.sh） #

#!/bin/bash

# 定义挂载卷上的用户HOME目录
USER_HOME="/aci/scripts/R.generiek/User.settings/$USER"

# 创建HOME目录及RStudio配置子目录，确保权限正确
mkdir -p $USER_HOME/.config/rstudio
chown -R $USER:$USER $USER_HOME

# 首次启动时，将默认RStudio配置迁移到新HOME
if [ ! -f $USER_HOME/.config/rstudio/rstudio-prefs.json ]; then
    cp /tmp/rstudio-prefs.json $USER_HOME/.config/rstudio/
fi

# 设置环境变量，覆盖默认HOME路径
export HOME=$USER_HOME

# 启动RStudio服务器
exec /usr/lib/rstudio-server/bin/rserver --server-daemonize 0

关键改动说明 #

1. 构建时创建用户：确保容器运行时用户存在，避免因用户不存在导致的目录权限问题。
2. 动态设置HOME：在启动脚本中创建挂载卷目录、迁移配置文件后，再通过export设置HOME环境变量，确保RStudio启动时能找到必要的配置文件。
3. 配置迁移：首次启动时将默认RStudio配置复制到新HOME，保证初始配置正常加载。

使用说明 #

1. 将上述Dockerfile和entrypoint.sh放在同一目录下。
2. 构建镜像时传递用户参数：

   docker build --build-arg USER=your_username -t rstudio-persistent .
   

3. 启动容器时挂载存储卷到/aci/scripts/R.generiek/User.settings：

   docker run -d -p 8787:8787 -v /host/path/to/User.settings:/aci/scripts/R.generiek/User.settings rstudio-persistent
   

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