bm296672810/libreoffice

LibreOffice 中文字体增强镜像

镜像概述

本镜像基于 lscr.io/linuxserver/libreoffice 构建，在保留原镜像全部功能的基础上，额外集成了常用中文字体，解决文档处理和转换过程中的中文显示乱码问题，适用于需要处理中文内容的办公自动化场景。

核心功能与特性

• 继承基础功能：完整保留 lscr.io/linuxserver/libreoffice 的全部功能，包括文档编辑、格式转换（如Word转PDF、Excel转CSV等）、命令行操作等。
• 中文字体支持：预安装常用中文字体（如宋体、黑体、微软雅黑等），确保中文文本在文档渲染、打印和转换过程中正常显示，避免乱码。
• 轻量扩展：在原镜像基础上仅添加字体文件，保持镜像体积精简，不影响原有性能。

使用场景

• 服务器端文档处理：在Linux服务器环境中处理包含中文的Office文档（Word、Excel、PowerPoint等）。
• 文档格式转换服务：作为后台服务，批量将中文文档转换为PDF、HTML等格式。
• 自动化办公流程：集成到CI/CD或自动化脚本中，处理中文报告生成、数据导出等任务。

使用方法

基本使用（docker run）

通过以下命令启动容器，映射必要端口和数据卷：

bash
docker run -d \
  --name=libreoffice-cn \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Shanghai \
  -p 8080:8080 \
  -v /path/to/documents:/config \
  --restart unless-stopped \
  [镜像名称]

参数说明：

• -e PUID=1000/-e PGID=1000：指定运行容器的用户ID和组ID，避免权限问题。
• -e TZ=Asia/Shanghai：设置时区为上海。
• -p 8080:8080：映射Web界面端口（若原镜像提供Web访问）。
• -v /path/to/documents:/config：挂载本地文档目录到容器内，便于文件读写。

docker-compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: "3"
services:
  libreoffice-cn:
    image: [镜像名称]
    container_name: libreoffice-cn
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Shanghai
    ports:
      - "8080:8080"
    volumes:
      - /path/to/local/documents:/config
    restart: unless-stopped

启动容器：

bash
docker-compose up -d

配置说明

• 环境变量：继承自 lscr.io/linuxserver/libreoffice，具体可参考原镜像文档，常用变量包括 PUID、PGID、TZ 等。
• 字体路径：中文字体文件已预装在容器内的标准字体目录（如 /usr/share/fonts），无需额外配置即可使用。

注意事项

• 确保本地挂载的文档目录具有正确权限（与 PUID/PGID 匹配），避免文件读写失败。
• 若需处理大量或大型文档，建议为容器分配足够的内存资源。
• 原镜像的其他功能（如命令行工具 soffice）可直接使用，中文支持已自动生效。