Docker Compose 安装Collabora

0.环境说明：

①Collabora介绍
Collabora 是一款基于知名开源套件 LibreOffice 核心技术的办公软件，它最大的特点是能在网页、桌面和移动端提供一致且私密的协作体验。无论你是在浏览器中在线编辑，还是用桌面应用离线工作，界面和功能都保持一致，无需重新学习。它原生支持 ODF 和微软的 DOCX/XLSX/PPTX 格式，并能轻松导出为 PDF。在隐私方面，Collabora 坚持离线优先和透明开源的设计，你的文档默认只保留在设备上，除非你主动分享。

为了让你更直观地了解 Collabora 的特点，这里有一份它与市面上其他主流办公软件的对比表：

②配置要求:

1.Docker Compose 方式安装Collabora

配置docker-compose文件：

mkdir ~/collabora-docker
cd ~/collabora-docker
vi docker-compose.yml

配置如下内容：

version: '3.8'

services:
  collabora:
    # 使用 Collabora CODE 的稳定版镜像
    image: collabora/code:latest
    container_name: collabora
    # 重启策略：除非手动停止，否则容器退出时自动重启
    restart: unless-stopped
    # 暴露容器端口 9980 到宿主机的 9980
    ports:
      - "9980:9980"
    # 添加必要的 Linux 内核功能
    cap_add:
      - MKNOD
    # 配置环境变量
    environment:
      # 设置管理员用户名 (请务必修改)
      - username=admin
      # 设置管理员密码 (请务必修改为强密码)
      - password=your_strong_password
      # 允许访问此 Collabora 实例的域名或IP
      # 例如：nextcloud.yourdomain.com 或者你的应用服务器IP
      - aliasgroup1=https://your-webapp-domain.com
      # 设置字典，支持中文
      - dictionaries=en_US zh_CN
      # 额外参数：这里示例禁用了内置的SSL，因为我们通常会使用外部反向代理处理HTTPS
      - "extra_params=--o:ssl.enable=false"
      # 设置时区
      - TZ=Asia/Shanghai
    #如需自定义精细配置
    #volumes:
      # 需要提前在宿主机创建好目录并设置好权限（chown 101:101）
      #- ./coolwsd.xml:/etc/coolwsd/coolwsd.xml
    deploy:
      resources:
        limits:                # 硬性限制（必须满足）
          cpus: "2"          # 最多使用2个CPU核心（如50%）
          memory: 2048M         # 最大内存2048MB
        reservations:          # 软性预留（最低保障）
          cpus: "0.5"         # 至少分配0.5个CPU核心
          memory: 256M         # 至少预留256MB内存
# 如果需要自定义网络，可以取消下面的注释
# networks:
#   collabora-network:
#     driver: bridge

配置说明:

• image: 使用 collabora/code 官方镜像，latest 标签会拉取最新的稳定版。
• ports: 将容器的 9980 端口映射到宿主机的 9980 端口。这是 Collabora 默认的服务端口。
• environment:
  • username 和 password：用于登录 Collabora 后台管理界面的凭据，请务必修改为你自己的强密码。
  • aliasgroup1：这是最关键的安全配置。设置允许访问此 Collabora 实例的主机域名或IP（如你的Nextcloud或Cloudreve域名）。这可以有效防止他人盗用你的协作服务。
  • extra_params：添加了 --o:ssl.enable=false 参数，因为 Collabora 容器内部默认会尝试启用HTTPS，但我们在生产环境中通常会在前面加一层Nginx反向代理来负责HTTPS加密，所以这里先禁用它。
  • dictionaries：添加了中文（zh_CN）和英文（en_US）拼写检查词典。

启动

docker-compose up -d

2. 验证安装

可以使用以下三种方式：

检查容器状态：运行 docker ps，你应该能看到名为 collabora 的容器状态为 Up（正常运行）。

访问服务发现接口：在浏览器中访问 http://<<your-ip>:9980/hosting/discovery。如果看到一个包含大量XML格式信息的页面（描述了支持的文件格式和功能），说明 Collabora 的核心服务已就绪。

访问欢迎页面：直接访问 http://<your-ip>:9980，通常会看到一个欢迎页面或简单的”OK”字样。

3.集成到你的应用

Collabora Online 本身不存储文件，它通过 WOPI (Web Application Open Platform Interface) 协议 与文件托管系统（如 Nextcloud、Cloudreve、SeaTable 或自定义应用）通信。