Docker entrypoint脚本修改配置文件报permission denied错误如何解决

• sed -i 执行原地修改的原理为：先在目标文件所在目录生成临时文件写入修改后内容，再用临时文件替换原文件，因此要求执行命令的用户对文件所在目录有写权限，本次错误就是容器启动的user用户对 /usr/local/userhome 目录没有写权限，无法创建sed临时文件导致。
• 即使你在Dockerfile中执行了chown -R user ${USER_HOME}/，权限依然失效的最常见原因是：你通过docker-compose挂载了本地目录到容器内的${USER_HOME}路径，挂载操作会覆盖镜像内该目录的所有原有权限配置，最终权限以宿主机目录为准。如果宿主机该目录的所有者uid与容器内user用户的uid不一致，就会出现user用户无目录写权限的问题。
• 次要原因包括：Dockerfile中执行顺序错误，USER_HOME变量未提前定义导致chown路径错误、entrypoint运行用户确实不是user用户、目录被其他安全策略限制写入等。

方案1：适配挂载目录权限（存在本地挂载时优先使用） #

• 首先进入容器查看user用户的uid：docker exec -u root <容器名> id -u user，假设输出为1000。
• 在宿主机修改对应挂载目录的权限，所有者uid匹配容器内的user用户uid：

sudo chown -R 1000:1000 /宿主机/对应/挂载/目录路径

• 也可以在Dockerfile创建user用户时指定固定uid，和宿主机目录的所有者uid保持一致，避免每次手动改权限：

RUN useradd -m -d ${USER_HOME} -u 1000 user

方案2：修正Dockerfile配置（无挂载时使用） #

调整Dockerfile的执行顺序，先创建用户再操作目录文件，保证权限生效，同时补充必要的脚本执行权限配置：

FROM centos:7 AS ingestbase
# 提前定义用户目录变量
ENV USER_HOME=/usr/local/userhome
# 先创建用户
RUN useradd -m -d ${USER_HOME} user
# 再创建目录、复制配置文件
RUN mkdir -p ${USER_HOME}/certs ${USER_HOME}/logs
COPY config/*  ${USER_HOME}/
# 复制entrypoint脚本并添加执行权限
COPY entrypoint.sh /entrypoint.sh
RUN chmod +x /entrypoint.sh
# 统一给用户目录赋权
RUN chown -R user:user ${USER_HOME}/
USER user
WORKDIR ${USER_HOME}
ENTRYPOINT ["/entrypoint.sh"]

方案3：修改sed命令逻辑（不想调整目录权限时使用） #

避免sed在当前目录创建临时文件，改为使用有权限的/tmp目录中转：

# 方法1：用重定向实现内容替换，不需要当前目录写权限
sed "s#{DB_PASS}#$DB_PASS#g" ${USER_HOME}/config.py > /tmp/config.py && cat /tmp/config.py > ${USER_HOME}/config.py

# 方法2：指定sed临时文件生成路径为/tmp
sed -i -T /tmp "s#{DB_PASS}#$DB_PASS#g" ${USER_HOME}/config.py

方案4：切换root用户运行 #

如果确实需要root权限操作，可以在docker-compose配置中添加user: root指定启动用户，或者修改Dockerfile最后USER root，即可跳过用户权限限制。

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