将现有Jenkins目录挂载到Docker容器遇权限问题，如何解决？

问题场景 #

Ubuntu主机上原有Jenkins服务，JENKINS_HOME为/var/lib/jenkins。停止本地服务后，尝试用Docker容器复用该目录，执行命令：

service jenkins stop
docker run --rm -it -p 8880:8080 --name jenkins -v /var/lib/jenkins:/var/jenkins_home jenkins/jenkins:lts

触发权限错误：

touch: cannot touch '/var/jenkins_home/copy_reference_file.log': Permission denied
Can not write to /var/jenkins_home/copy_reference_file.log. Wrong volume permissions?

挂载方式可行性 #

这种挂载方式完全可行，问题根源是权限不匹配：本地/var/lib/jenkins目录的所有者是主机的jenkins用户，而容器内Jenkins进程默认使用UID为1000的用户，两者权限范围不重叠，导致容器进程无法写入目录。

修复方案 #

方案1：修改本地目录权限（推荐） #

直接把本地目录的所有者改成容器内Jenkins用户的UID（通常是1000）：

# 确认容器内Jenkins用户的UID（默认是1000）
docker run --rm jenkins/jenkins:lts id -u jenkins
# 递归修改本地目录权限
sudo chown -R 1000:1000 /var/lib/jenkins

改完后重新执行原来的docker run命令即可正常启动。

方案2：容器启动时指定主机jenkins用户身份 #

如果不想改动本地目录权限，可以让容器进程以主机jenkins用户的UID/GID运行：

# 获取主机jenkins用户的UID和GID
id jenkins
# 假设输出为 uid=111(jenkins) gid=117(jenkins)，替换到启动命令中
docker run --rm -it -p 8880:8080 --name jenkins -u 111:117 -v /var/lib/jenkins:/var/jenkins_home jenkins/jenkins:lts

这样容器进程和主机jenkins用户权限一致，就能正常读写目录。

方案3：临时调整容器内权限（仅测试用） #

如果只是临时验证，可先进入容器修改权限再启动Jenkins，但容器重启后失效：

# 启动容器进入bash
docker run --rm -it -v /var/lib/jenkins:/var/jenkins_home jenkins/jenkins:lts bash
# 容器内修改目录权限
chown -R jenkins:jenkins /var/jenkins_home
# 切换到jenkins用户启动服务
su jenkins -c "/usr/local/bin/jenkins.sh"

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