Docker运行Bitfocus Companion出现权限错误求助

核心原因 #

容器内进程无权限访问宿主机挂载的配置目录，无法创建必要配置文件，导致容器循环重启。

具体解决步骤 #

1. 修复宿主机挂载目录权限 #

• 登录宿主机终端，定位你为Companion容器挂载的本地配置目录（例如/opt/companion-config）
• 执行命令修改权限，让容器内默认用户（通常UID 1000、GID 1000）拥有读写权限：

  sudo chown -R 1000:1000 /opt/companion-config
  sudo chmod -R 755 /opt/companion-config
  

  若不确定容器内用户的UID/GID，可临时执行以下命令查询：

  docker run --rm bitfocus/companion id -u
  docker run --rm bitfocus/companion id -g
  

2. 在Portainer中调整容器配置 #

• 打开Portainer找到目标Companion容器，点击「编辑」
• 切换到「卷」标签页，确认宿主机挂载目录路径无误
• 切换到「权限/安全」标签页：
  • 临时测试可勾选「以特权模式运行」（不建议长期开启）
  • 长期方案：在「用户ID(UID)」「组ID(GID)」输入框中，填入上述查询到的UID和GID值
• 保存配置后重启容器

3. 验证修复效果 #

• 查看容器日志，若不再出现Failed to create config directory报错，且容器保持运行状态，说明问题解决
• 访问Companion默认Web端口8000，确认功能正常

额外注意事项 #

• 避免使用宿主机root目录或系统敏感目录作为挂载点，建议创建独立的专用配置目录
• 后续创建容器时，提前给挂载目录设置好对应权限，避免重复出现权限问题

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