Docker部署anything-llm：docker-compose挂载错误修复方案问询

问题描述 #

我希望通过docker-compose.yml部署多个anything-llm容器。参考官方仓库的Docker命令可正常运行该服务，但自行编写的docker-compose.yml首次启动时，出现容器初始化挂载错误（提示找不到/run/desktop目录）。即使将配置中的STORAGE_LOCATION变量替换为绝对路径，首次启动仍报错；仅先执行官方Docker命令、停止容器后再启动compose才能正常运行。请问需如何修改docker-compose.yml，使其无需提前执行官方命令即可正常运行？

官方Docker命令：

export STORAGE_LOCATION=$HOME/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env" && \
docker run -d -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm

我的docker-compose.yml配置：

services:
  anythingllm:
    image: mintplexlabs/anythingllm
    ports:
      - "3001:3001"
    cap_add:
      - SYS_ADMIN
    volumes:
      - ${STORAGE_LOCATION}:/app/server/storage
      - ${STORAGE_LOCATION}/.env:/app/server/.env
    environment:
      - STORAGE_DIR=/app/server/storage
    command: /bin/sh -c "mkdir -p $STORAGE_LOCATION && touch \"$STORAGE_LOCATION/.env\" && npm start"

解决方案 #

问题核心是你自定义的command逻辑错误：你在容器内部执行mkdir -p $STORAGE_LOCATION，但STORAGE_LOCATION是宿主机的路径，容器内没有对应的目录结构，自然会报错。官方命令是在宿主机上提前创建目录和.env文件，而非在容器内操作。

最终可用的docker-compose.yml配置 #

移除容器内创建目录和文件的错误命令，使用镜像默认启动逻辑，同时优化变量默认值：

services:
  anythingllm:
    image: mintplexlabs/anythingllm
    ports:
      - "3001:3001"
    cap_add:
      - SYS_ADMIN
    volumes:
      # 绑定宿主机存储目录到容器内指定路径，添加默认值避免变量未定义报错
      - ${STORAGE_LOCATION:-$HOME/anythingllm}:/app/server/storage
      # 单独挂载.env文件
      - ${STORAGE_LOCATION:-$HOME/anythingllm}/.env:/app/server/.env
    environment:
      - STORAGE_DIR=/app/server/storage

自动初始化宿主机目录和文件（可选） #

如果不想手动提前创建目录和.env文件，可以添加一个初始化服务，确保启动anything-llm前完成前置准备：

services:
  init:
    image: alpine:latest
    volumes:
      - ${STORAGE_LOCATION:-$HOME/anythingllm}:/storage
    command: /bin/sh -c "mkdir -p /storage && touch /storage/.env"
  anythingllm:
    image: mintplexlabs/anythingllm
    ports:
      - "3001:3001"
    cap_add:
      - SYS_ADMIN
    volumes:
      - ${STORAGE_LOCATION:-$HOME/anythingllm}:/app/server/storage
      - ${STORAGE_LOCATION:-$HOME/anythingllm}/.env:/app/server/.env
    environment:
      - STORAGE_DIR=/app/server/storage
    depends_on:
      init:
        condition: service_completed_successfully

关键原理 #

• Docker绑定挂载时，若宿主机目录不存在，会自动创建目录，但不会创建文件。因此.env文件必须提前存在，否则容器会因找不到文件报错。
• 你之前的错误是把宿主机路径放到容器内执行，容器没有宿主机的目录结构，所以会出现找不到/run/desktop这类Docker Desktop路径的错误。

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