libreoffice/online

LibreOffice Online Docker镜像文档

镜像概述和主要用途

LibreOffice Online Docker镜像通过复用LibreOffice核心功能，在浏览器中提供基础文档协作编辑能力。该镜像确保文档渲染保真度优秀，且与LibreOffice的互操作性完全匹配，适用于需要在网页环境中进行文档协作的场景。

核心功能和特性

• 基于LibreOffice核心：复用LibreOffice成熟的文档处理引擎，确保文档兼容性
• 浏览器端协作编辑：支持在网页浏览器中直接进行文档协作编辑
• 高渲染保真度：文档显示效果与LibreOffice桌面版保持高度一致
• 完整互操作性：支持LibreOffice兼容的各类文档格式（如ODT、DOCX、XLSX等）

使用场景和适用范围

• 团队在线协作编辑文档
• 集成到Web应用中提供文档编辑功能
• 作为Nextcloud等云存储平台的文档编辑组件
• 开发和测试文档协作系统

使用方法和配置说明

配置文件

LibreOffice Online WebSocket Daemon (loolwsd)的配置文件位于容器内的/etc/loolwsd/loolwsd.xml。可通过以下步骤自定义配置：

1. 从容器中复制配置文件：docker cp <container_id>:/etc/loolwsd/loolwsd.xml ./loolwsd.xml
2. 编辑配置文件
3. 将修改后的配置文件复制回容器：docker cp ./loolwsd.xml <container_id>:/etc/loolwsd/loolwsd.xml
4. 提交更改：docker commit <container_id> custom-libreoffice-online

环境变量

容器支持通过以下环境变量进行配置：

• DONT_GEN_SSL_CERT
  默认情况下，容器启动时会生成新的自签名SSL证书、SSL CA证书和密钥。若要使用自定义SSL证书，设置为1以禁用自动生成。

• domain
  WOPI主机的域名。

• username
  管理控制台的用户名。

• password
  管理控制台的密码。

• extra_params
  loolwsd命令行额外参数。例如，测试或开发时可禁用SSL：-e "extra_params=--o:ssl.enable=false"

Docker部署示例

基本启动命令

bash
docker run -d -p 9980:9980 \
  -e "username=admin" \
  -e "password=yourpassword" \
  --name libreoffice-online \
  docker.xuanyuan.run/libreoffice/online

禁用SSL的开发环境

bash
docker run -d -p 9980:9980 \
  -e "extra_params=--o:ssl.enable=false" \
  --name libreoffice-online-dev \
  docker.xuanyuan.run/libreoffice/online

与Nextcloud集成

有关与Nextcloud集成的Docker Compose示例，请参考：https://github.com/smehrbrodt/nextcloud-libreoffice-online

问题反馈与源码

• Bug报告：请在官方Bugzilla提交：https://bugs.documentfoundation.org/
• 源码地址：https://cgit.freedesktop.org/libreoffice/online/tree/docker