Docker容器内运行Nextflow报错：文件存在却提示不存在

问题背景 #

我在Docker容器内运行Nextflow流程，为让容器内的Nextflow能下载运行所需Docker镜像，将Docker套接字挂载为卷，对应的docker-compose.yml配置如下：

pipeline:
    build:
      dockerfile: ./docker/pipeline/dockerfile
    volumes:
      - ./nextflow:/home/app/nextflow
      - ./data:/home/app/data
      - /var/run/docker.sock:/var/run/docker.sock

运行nf-core/sarek等流程时，下载部分镜像后出现以下错误：

Command exit status:
  127

Command output:
  (empty)

Command error:
  /bin/bash: .command.run: No such file or directory

Work dir:
  /home/app/nextflow/work/e5/83f1be41789e7aa1f5b7fbc19851fc

Tip: you can replicate the issue by changing to the process work dir and entering the command `bash .command.run`

进入容器后，确认工作目录下确实存在.command.run文件，但执行bash .command.run仍报相同错误：

/bin/bash: /home/app/nextflow/work/e5/83f1be41789e7aa1f5b7fbc19851fc/.command.run: No such file or directory

使用的Dockerfile内容如下：

FROM nextflow/nextflow:23.11.0-edge

RUN yum install -y python3 python3-pip python3-devel gcc openssl-devel libffi-devel python3-setuptools

RUN mkdir -p /home/app
COPY docker/pipeline /home/app

WORKDIR /home/app

RUN pip3 install -r requirements.txt

CMD ["gunicorn", "-b", "0.0.0.0:5000", "main:app"]

问题原因 #

核心原因是挂载的主机目录与容器内用户权限不匹配，或者Nextflow启动的子容器无法访问挂载目录内的文件：

• 主机./nextflow目录的所有者UID/GID与容器内运行Nextflow的用户不一致，导致子容器（通过挂载的docker.sock启动）无权限读取.command.run文件
• Bash在权限不足时会返回类似“文件不存在”的错误，而非明确的权限提示

解决方法 #

方法1：统一容器与主机的用户UID/GID #

修改Dockerfile，创建与主机当前用户UID/GID一致的用户，避免权限冲突：

FROM nextflow/nextflow:23.11.0-edge

# 构建时传入主机用户的UID和GID
ARG USER_UID
ARG USER_GID

# 创建匹配主机权限的用户组和用户
RUN groupadd -g ${USER_GID} appuser && \
    useradd -u ${USER_UID} -g ${USER_GID} -m appuser

RUN yum install -y python3 python3-pip python3-devel gcc openssl-devel libffi-devel python3-setuptools

RUN mkdir -p /home/app
COPY docker/pipeline /home/app

# 切换到创建的用户
USER appuser

WORKDIR /home/app

# 用--user参数安装Python依赖到用户目录
RUN pip3 install --user -r requirements.txt

CMD ["gunicorn", "-b", "0.0.0.0:5000", "main:app"]

修改docker-compose.yml，构建时传入主机用户的UID和GID：

pipeline:
    build:
      dockerfile: ./docker/pipeline/dockerfile
      args:
        - USER_UID=${UID}
        - USER_GID=${GID}
    volumes:
      - ./nextflow:/home/app/nextflow
      - ./data:/home/app/data
      - /var/run/docker.sock:/var/run/docker.sock

方法2：使用容器内部工作目录 #

修改Nextflow配置文件（nextflow.config），指定工作目录为容器内部路径，避免挂载目录的权限问题：

workDir = '/home/app/work'
docker {
    enabled = true
    runOptions = '-v /home/app/work:/home/app/work'
}

调整docker-compose.yml，仅挂载流程代码而非工作目录：

pipeline:
    build:
      dockerfile: ./docker/pipeline/dockerfile
    volumes:
      - ./nextflow/scripts:/home/app/nextflow/scripts  # 只挂载流程代码
      - ./data:/home/app/data
      - /var/run/docker.sock:/var/run/docker.sock

方法3：临时放宽挂载目录权限（仅测试用） #

如果只是临时测试，可修改主机./nextflow目录权限，让所有用户读写：

chmod -R 777 ./nextflow

验证方法 #

重新构建容器并运行流程，进入容器后执行以下命令验证权限：

ls -l /home/app/nextflow/work/e5/83f1be41789e7aa1f5b7fbc19851fc/.command.run

若文件所有者与容器内运行用户一致，再执行bash .command.run即可正常运行。

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