Ubuntu 20.04下docker-compose仅主目录生效问题排查与解决

可能的原因 #

• 环境变量强制指定配置文件：COMPOSE_FILE环境变量被设置为主目录的docker-compose.yml，导致无论在哪执行命令都读取该文件。
• 当前目录/文件权限不足：目标目录或docker-compose.yml文件的权限设置错误，当前用户无读取权限。
• Shell别名篡改命令行为：docker-compose被设置了别名，强制绑定到主目录的配置文件。
• Snap版本的沙箱限制：Snap安装的Docker有严格的文件访问控制，仅允许访问主目录等受限路径。

解决步骤 #

1. 检查并重置COMPOSE_FILE环境变量 #

• 执行命令查看变量值：

  echo $COMPOSE_FILE
  

• 如果输出为~/docker-compose.yml或主目录的绝对路径，临时取消变量：

  unset COMPOSE_FILE
  

• 永久解决：检查Shell配置文件（~/.bashrc、~/.zshrc、/etc/profile等），删除设置COMPOSE_FILE的行，重启Shell生效。

2. 修复目录与文件权限 #

• 进入目标目录，查看文件权限：

  ls -l docker-compose.yml
  

• 确保当前用户拥有读权限，若文件属于root，修改所属用户：

  sudo chown $USER:$USER docker-compose.yml
  

• 设置正确的文件权限：

  chmod 644 docker-compose.yml
  

• 检查目录本身的访问权限：

  ls -ld .
  

• 若当前用户无执行权限（无法进入目录），修改目录权限：

  chmod 755 .
  

3. 检查并取消Shell别名 #

• 查看是否存在docker-compose别名：

  alias docker-compose
  

• 若输出包含-f ~/docker-compose.yml，临时取消别名：

  unalias docker-compose
  

• 永久解决：在Shell配置文件中删除对应的别名设置行。

4. 处理Snap版本的沙箱限制 #

• 若使用Snap安装的Docker，建议切换到APT安装版本以避免沙箱限制：

  # 卸载Snap版本Docker
  sudo snap remove docker
  # 更新APT源并安装Docker及Docker-Compose
  sudo apt update
  sudo apt install docker.io docker-compose
  # 将当前用户加入docker组，避免每次用sudo
  sudo usermod -aG docker $USER
  

• 注销并重新登录系统，使组权限生效。

5. 验证-f选项的正确用法 #

• 确保指定的配置文件路径正确，在目标目录执行：

  docker-compose -f ./docker-compose.yml up
  

• 若仍有问题，验证配置文件语法是否合法：

  docker-compose -f ./docker-compose.yml config
  

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