linuxserver/calligra

镜像概述

Calligra是KDE开发的办公和图形艺术套件，适用于桌面PC、平板电脑和智能手机。它包含文字处理、电子表格、演示文稿、矢量图形和数据库编辑等应用。LinuxServer.io提供的此Docker镜像具备定期应用更新、用户映射（PGID、PUID）、自定义基础镜像、每周系统更新及安全更新等特性。

支持的架构

该镜像利用Docker manifest实现多平台支持，拉取lscr.io/linuxserver/calligra:latest即可获取对应架构的镜像，也可通过标签指定特定架构：

应用设置

访问地址

应用可通过以下地址访问：

• [***]

严格反向代理

默认使用自签名证书，协议为https。若反向代理验证证书，需禁用对容器的证书检查。

[!WARNING] 现代GUI桌面应用可能与最新Docker系统调用限制存在兼容性问题。在较旧内核或libseccomp版本的主机上，可使用--security-opt seccomp=unconfined允许这些系统调用。

安全注意事项

[!WARNING] 此容器提供对主机系统的特权访问。除非已正确配置安全措施，否则不要将其暴露到互联网。

HTTPS是完整功能的必要条件，现代浏览器特性（如WebCodecs）在不安全的HTTP连接下无法使用。默认无认证，可通过CUSTOM_USER和PASSWORD环境变量启用基本HTTP认证（仅适用于可信局域网）。互联网暴露时，强烈建议使用反向代理（如SWAG）配合可靠认证机制。

Web界面包含带无密码sudo访问的终端，任何有权访问GUI的用户可在容器内获取root权限，安装软件并探测本地网络。

环境变量

基于Docker Baseimage Selkies，支持以下可选环境变量：

语言支持

通过LC_ALL环境变量设置桌面会话语言，例如：

• -e LC_ALL=zh_CN.UTF-8（中文）
• -e LC_ALL=ja_JP.UTF-8（日语）
• -e LC_ALL=ko_KR.UTF-8（韩语）
• -e LC_ALL=ar_AE.UTF-8（阿拉伯语）
• -e LC_ALL=ru_RU.UTF-8（俄语）

GPU加速

DRI3 GPU加速

通过以下参数挂载渲染设备，支持加速应用：

--device /dev/dri:/dev/dri

仅支持开源GPU驱动：

Nvidia GPU支持

注意： Alpine基础镜像不支持Nvidia。

通过Zink支持Nvidia GPU的OpenGL加速，并自动用于硬件加速视频编码（x264enc全帧配置文件）。启用需添加运行时标志：

Docker Compose配置需先设置Nvidia运行时为默认：

sudo nvidia-ctk runtime configure --runtime=docker --set-as-default
sudo systemctl restart docker

然后在compose.yaml中配置：

services:
  calligra:
    image: lscr.io/linuxserver/calligra:latest
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: 1
              capabilities: [compute,video,graphics,utility]

应用管理

PRoot Apps（持久化）

推荐使用proot-apps安装持久化应用，安装到用户$HOME目录，容器重建后保留：

proot-apps install filezilla

支持的应用列表见此处。

Native Apps（非持久化）

通过universal-package-install mod安装系统原生包（容器重建后丢失）：

environment:
  - DOCKER_MODS=linuxserver/mods:universal-package-install
  - INSTALL_PACKAGES=libfuse2|git|gdb

使用方法

docker-compose（推荐）

---
services:
  calligra:
    image: lscr.io/linuxserver/calligra:latest
    container_name: calligra
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    shm_size: "1gb"
    restart: unless-stopped

docker cli

docker run -d \
  --name=calligra \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  lscr.io/linuxserver/calligra:latest

参数说明

环境变量（来自文件）

可通过FILE__前缀从文件设置环境变量，例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

将MYVAR设置为/run/secrets/mysecretvariable文件内容。

Umask设置

通过-e UMASK=022覆盖默认umask设置（umask为权限掩码，非直接权限设置）。

用户/组ID

使用卷时，通过指定PUID和PGID避免权限问题。通过id your_user命令获取当前用户的ID：

id your_user

输出示例：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

![Docker Mods]([] ![Docker Universal Mods]([]

支持信息

• 容器运行时Shell访问：

  docker exec -it calligra /bin/bash
  

• 实时监控容器日志：

  docker logs -f calligra
  

• 容器版本号：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' calligra
  

• 镜像版本号：

  docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/calligra:latest
  

更新信息

通过Docker Compose

• 更新镜像：

  docker-compose pull calligra  # 单个镜像
  # 或
  docker-compose pull  # 所有镜像
  

• 更新容器：

  docker-compose up -d calligra  # 单个容器
  # 或
  docker-compose up -d  # 所有容器
  

• 清理旧镜像：

  docker image prune
  

通过Docker Run

• 更新镜像：

  docker pull lscr.io/linuxserver/calligra:latest
  

• 停止并删除容器：

  docker stop calligra
  docker rm calligra
  

• 使用相同参数重新创建容器（/config卷映射正确则设置保留）
• 清理旧镜像：

  docker image prune
  

本地构建

git clone [***]
cd docker-calligra
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/calligra:latest .

ARM架构构建（需lscr.io/linuxserver/qemu-static）：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/calligra:latest .

版本历史

• 22.09.25: - 基于Debian Trixie重建。
• 12.07.25: - 基于Selkies重建，HTTPS现在是必需的。
• 10.02.24: - 更新Readme，添加新环境变量，引入适当的PWA图标。
• 07.12.23: - 初始发布。