基于 Docker 部署 Nextcloud + Collabora 在线预览服务

发表于 | 分类于 | | 阅读次数：

本文介绍如何基于 Docker 部署 Nextcloud + Collabora，实现 DOC、XLS、PPT、PDF、视频等文件的在线查看与编辑，并通过外部存储挂载服务器上的本地文件。

本文使用 192.168.10.100 作为服务器示例 IP。部署时请替换为 Ubuntu 服务器的实际 IP，并为数据库设置独立的强密码。

1. 目录规划

1
2
3
mkdir -p /opt/share-files
mkdir -p /srv/share-files
cd /opt/share-files

本地文件放入：

1
/srv/share-files

2. 完整 docker-compose.yml

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
services:
  nextcloud:
    image: nextcloud:apache
    container_name: nextcloud
    restart: unless-stopped
    ports:
      - "8080:80"
    environment:
      MYSQL_HOST: mariadb
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: "你的数据库密码"
    volumes:
      - ./nextcloud:/var/www/html
      - /srv/share-files:/external-files
    depends_on:
      - mariadb

  mariadb:
    image: mariadb:11.4
    container_name: nextcloud-mariadb
    restart: unless-stopped
    command: --transaction-isolation=READ-COMMITTED
    environment:
      MYSQL_ROOT_PASSWORD: "你的数据库Root密码"
      MYSQL_DATABASE: nextcloud
      MYSQL_USER: nextcloud
      MYSQL_PASSWORD: "你的数据库密码"
    volumes:
      - ./mariadb:/var/lib/mysql

  collabora:
    image: collabora/code:latest
    container_name: nextcloud-collabora
    restart: unless-stopped
    ports:
      - "9980:9980"
    environment:
      aliasgroup1: "http://192\.168\.10\.100:8080"
      aliasgroup2: "http://nextcloud:80"
      extra_params: >-
        --o:ssl.enable=false
        --o:ssl.termination=false
        --o:net.proto=IPv4
        --o:server_name=192.168.10.100:9980
    cap_add:
      - MKNOD

其中：

1
192.168.10.100

是本文使用的示例 IP，请替换为 Ubuntu 服务器的实际 IP。MYSQL_PASSWORD 在 Nextcloud 和 MariaDB 服务中的值必须保持一致。

启动：

1
2
cd /opt/share-files
docker compose up -d

3. 初始化 Nextcloud

浏览器访问：

1
http://192.168.10.100:8080

填写：

1
2
3
4
5
管理员账号：自行设置
数据库用户：nextcloud
数据库密码：填写 docker-compose.yml 中设置的数据库密码
数据库名：nextcloud
数据库主机：mariadb

4. 配置可信域名

查看：

1
1
docker exec -u www-data nextcloud php occ config:system:get trusted_domains

设置：

1
2
3
4
5
docker exec -u www-data nextcloud php occ config:system:set trusted_domains 0 \
  --value="192.168.10.100:8080"

docker exec -u www-data nextcloud php occ config:system:set trusted_domains 1 \
  --value="nextcloud"

验证：

1
1
docker exec -u www-data nextcloud php occ config:system:get trusted_domains

预期：

1
2
192.168.10.100:8080
nextcloud

5. 启用外部存储

启用应用：

1
docker exec -u www-data nextcloud php occ app:enable files_external

页面配置：

1
2
3
管理设置
→ 外部存储
→ 新增本地存储

配置：

1
2
3
名称：共享资料
类型：本地
路径：/external-files

通过“可用于”限制用户或用户组。

只读共享可将 Compose 改为：

1
1
- /srv/share-files:/external-files:ro

6. 离线安装 richdocuments

下载兼容版本：

1
2
3
cd /opt/share-files

wget https://github.com/nextcloud-releases/richdocuments/releases/download/v11.0.1/richdocuments-v11.0.1.tar.gz

复制到容器：

1
docker cp richdocuments-v11.0.1.tar.gz nextcloud:/tmp/

解压：

1
2
3
4
5
docker exec -u root nextcloud bash -c '
cd /var/www/html/custom_apps &&
tar -xzf /tmp/richdocuments-v11.0.1.tar.gz &&
chown -R www-data:www-data richdocuments
'

启用：

1
docker exec -u www-data nextcloud php occ app:enable richdocuments

验证：

1
docker exec -u www-data nextcloud php occ app:list | grep richdocuments

7. 配置 Collabora 地址

设置内部访问地址：

1
2
docker exec -u www-data nextcloud php occ config:app:set richdocuments wopi_url \
  --value="http://nextcloud-collabora:9980"

设置浏览器访问地址：

1
2
docker exec -u www-data nextcloud php occ config:app:set richdocuments public_wopi_url \
  --value="http://192.168.10.100:9980"

激活配置：

1
docker exec -u www-data nextcloud php occ richdocuments:activate-config

正常应显示：

1
2
3
4
5
Configured WOPI URL:
http://nextcloud-collabora:9980

Configured public WOPI URL:
http://192.168.10.100:9980

8. 验证服务链路

验证 Nextcloud 访问 Collabora：

1
2
docker exec nextcloud curl -s \
  http://nextcloud-collabora:9980/hosting/discovery | head

验证公开地址：

1
curl -s http://192.168.10.100:9980/hosting/discovery | head

验证 Collabora 访问 Nextcloud：

1
2
3
4
5
docker exec nextcloud-collabora bash -c '
exec 3<>/dev/tcp/nextcloud/80
printf "GET /status.php HTTP/1.1\r\nHost: nextcloud\r\nConnection: close\r\n\r\n" >&3
head -n 1 <&3
'

预期：

1
HTTP/1.1 200 OK

验证 Discovery 公开地址：

1
2
3
docker exec nextcloud curl -s \
  http://nextcloud-collabora:9980/hosting/discovery |
grep -o 'urlsrc="[^"]*"' | head -1

预期包含：

1
http://192.168.10.100:9980/browser/

9. 权限配置

创建只读用户：

1
2
3
管理员头像
→ 用户
→ 创建用户

创建只读组，例如：

1
1
viewer

在外部存储配置中，将“共享资料”仅授权给：

1
1
viewer

底层强制只读：

1
1
- /srv/share-files:/external-files:ro

重建：

1
docker compose up -d --force-recreate nextcloud

10. 支持的文件类型

文件类型 在线能力
DOC/DOCX Collabora 在线查看、编辑
XLS/XLSX 在线查看、编辑
PPT/PPTX 在线查看、编辑
PDF Nextcloud 内置预览
MP4 浏览器在线播放
Markdown Nextcloud Text 应用预览
HTML 通常按文本查看或下载

11. 常用排查命令

查看 Collabora 日志：

1
docker logs --since 5m nextcloud-collabora 2>&1 | tail -n 300

查看 Nextcloud 日志：

1
docker exec nextcloud tail -n 200 /var/www/html/data/nextcloud.log

筛选 WOPI 错误：

1
2
docker logs --since 5m nextcloud-collabora 2>&1 | \
grep -Ei 'error|wopi|authorized|unauthorized|failed'

查看 Office 配置：

1
docker exec -u www-data nextcloud php occ config:list richdocuments

查看 Nextcloud 状态：

1
docker exec -u www-data nextcloud php occ status

12. 本次关键问题

App Store 找不到应用

现象：

1
Could not download app richdocuments

处理：

1
2
3
手动下载 richdocuments 压缩包
→ 解压到 /var/www/html/custom_apps
→ app:enable richdocuments

浏览器无法打开 Collabora

原因：

1
public_wopi_url 使用 Docker 内部域名 nextcloud-collabora

修复：

1
2
内部地址：http://nextcloud-collabora:9980
公开地址：http://192.168.10.100:9980

Trusted domain error

原因：

1
nextcloud 未加入 trusted_domains

修复：

1
2
docker exec -u www-data nextcloud php occ config:system:set trusted_domains 1 \
  --value="nextcloud"

No authorized hosts found

原因：

1
Collabora 未授权实际 Nextcloud 地址

修复：

1
2
aliasgroup1: "http://192\.168\.10\.100:8080"
aliasgroup2: "http://nextcloud:80"