Docker部署带PostgreSQL的可迁移Nextcloud遇数据库连接错误

核心问题定位 #

你的配置存在两处直接导致安装失败的错误，并非Nextcloud本身的已知bug：

1. 数据库主机名配置不符合Docker Compose寻址规则
   同项目网络下的容器互访，直接通过服务名即可解析，不需要使用自动生成的带项目前缀的完整容器名。你之前配置的POSTGRES_HOST=nextcloud_db_1是手动拼接的容器名，Docker网络无法识别该域名，直接触发了日志中的Temporary failure in name resolution解析错误。你的数据库服务名是db，正确的主机地址应该是db。如果坚持使用Web安装界面手动填写参数，数据库主机栏也要填写db，不要填写任何带项目名前缀的长容器名。
2. 未处理容器启动的时序依赖
   原配置仅声明depends_on，只保证数据库容器先启动，不保证PostgreSQL服务完全就绪、可以接收连接请求，首次部署时容易出现数据库还没准备好Nextcloud就发起连接的报错。

修正后的可迁移配置 #

调整后的docker-compose.yml #

version: "3.5"
services:
  nextcloud:
    build:
      context: .
      dockerfile: ./Dockerfile
    ports:
      - "8080:80"
    restart: always
    volumes:
      - $PROJECTS_DIR/Personal/mc1/nextcloud:/var/www/html
      - $PROJECTS_DIR/Personal/mc1/apps:/var/www/html/custom_apps
      - $PROJECTS_DIR/Personal/mc1/config:/var/www/html/config 
      - $PROJECTS_DIR/Personal/mc1/data:/var/www/html/data
    environment:
      - POSTGRES_HOST=db
      - POSTGRES_DB=nextcloud_db
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=testing123
      # 可选配置：自动初始化管理员账号，跳过Web手动安装步骤
      - NEXTCLOUD_ADMIN_USER=admin
      - NEXTCLOUD_ADMIN_PASSWORD=你的自定义管理员密码
    depends_on:
      db:
        condition: service_healthy

  db:
    image: postgres:15
    restart: always
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=nextcloud_db
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=testing123
    # 增加健康检查，确保PostgreSQL完全就绪后再启动Nextcloud
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres -d nextcloud_db"]
      interval: 5s
      timeout: 5s
      retries: 5

你的原有Dockerfile不需要调整，安装smbclient的逻辑完全正确，适配外部存储功能的需求。

部署与迁移操作步骤 #

• 清理历史残留配置：之前的失败部署已经在挂载目录里写入了错误的数据库配置，先清理残留文件（操作前请备份已有个人数据）：

rm -rf $PROJECTS_DIR/Personal/mc1/nextcloud/* $PROJECTS_DIR/Personal/mc1/config/*

• 启动服务：在项目目录下依次执行：

docker-compose build
docker-compose up -d

服务启动完成后直接访问http://localhost:8080，Nextcloud会根据环境变量自动完成数据库连接和初始化，不需要再在Web安装页手动填写数据库参数。

• 跨云迁移适配：

1. 所有数据都存储在本地挂载的文件夹内，迁移时直接将整个项目目录打包复制到目标云服务器，只要服务器安装了Docker和docker-compose，执行启动命令即可完整恢复全部环境。
2. 配置中固定了PostgreSQL的镜像大版本号，避免不同环境拉取到版本差异过大的镜像，导致数据库结构不兼容。

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