如何解决Docker部署的Nextcloud与Collabora文档加载失败问题？

问题 #

使用以下Docker Compose配置部署本地Nextcloud（25.0.6）与Collabora服务器，已在Nextcloud后台完成Collabora关联配置，但无法在线打开文档编辑，页面提示「文档加载失败」：

version: '3'

services:
  db:
    image: mysql:8.0.32
    command: --default-authentication-plugin=mysql_native_password
    volumes:
      - ./db:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: nextcloud
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: nextcloud
    networks:
      - nextcloud

  app:
    image: nextcloud:25.0.6
    ports:
      - 45080:80
    depends_on:
      - db
      - collabora
    volumes:
      - ./nextcloud:/var/www/html
    restart: always
    networks:
      - nextcloud
    environment:
      - NEXTCLOUD_TRUSTED_DOMAINS=cloud.nextcloud.com

  collabora:
    image: collabora/code
    restart: unless-stopped
    networks:
      - nextcloud
    ports:
      - "9980:9980"
    environment:
      - domain=cloud\\.nextcloud\\.com
      - "extra_params=--o:ssl.enable=false  --o:ssl.termination=true"
    tty: true
    cap_add:
      - MKNOD

networks:
  nextcloud:

排查与解决方案 #

以下是最可能遗漏的关键配置项：

• 修正Nextcloud访问地址与可信域名

  1. 本地hosts文件添加解析：127.0.0.1 cloud.nextcloud.com，确保用http://cloud.nextcloud.com:45080访问Nextcloud，而非0.0.0.0:45080（Collabora仅信任配置的cloud.nextcloud.com域名）。
  2. 更新Nextcloud容器的NEXTCLOUD_TRUSTED_DOMAINS环境变量，包含实际访问的域名+端口：

     environment:
       - NEXTCLOUD_TRUSTED_DOMAINS=cloud.nextcloud.com cloud.nextcloud.com:45080
     

• 修正Collabora的Nextcloud域名匹配规则
  因为Nextcloud带端口访问，Collabora的domain参数需要匹配完整的域名+端口，修改为：

  environment:
    - domain=cloud\\.nextcloud\\.com:45080
    - "extra_params=--o:ssl.enable=false  --o:ssl.termination=true"
  

• 修正Nextcloud后台的Collabora服务器地址
  在Nextcloud管理后台的Collabora配置中，填写Docker内部网络的服务地址http://collabora:9980，而非外部的http://0.0.0.0:9980。Nextcloud容器通过Docker网络直接访问Collabora服务，避免跨域和外部网络问题。

• 检查Collabora服务可用性
  访问http://cloud.nextcloud.com:9980/hosting/discovery，若返回JSON格式的配置信息，说明Collabora服务正常；若返回403/404，需检查domain参数的转义是否正确（双反斜杠\\.是Docker Compose中对.的转义要求）。

• 解决跨域问题（可选）
  若仍存在跨域报错，可添加反向代理（如Nginx）将Nextcloud与Collabora映射到同一域名的不同路径下，例如：

  • cloud.nextcloud.com/nextcloud → Nextcloud容器
  • cloud.nextcloud.com/collabora → Collabora容器
    这样浏览器不会触发跨域限制。

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