linuxserver/krita Docker镜像文档

镜像概述和主要用途

Krita 是一款专业的免费开源绘画软件，由艺术家开发，旨在为所有人提供可负担的数字艺术工具。linuxserver/krita 镜像是由LinuxServer.io团队构建的Docker化版本，将Krita集成到容器环境中，支持通过Web界面访问，便于在各种平台上快速部署和使用。

核心功能和特性

LinuxServer.io镜像共同特性

• 定期及时的应用更新
• 简易的用户映射（PGID、PUID）
• 基于s6 overlay的自定义基础镜像
• 每周基础操作系统更新，跨LinuxServer.io生态系统共享通用层，以最小化空间占用、 downtime和带宽消耗
• 定期安全更新

架构支持

该镜像通过Docker manifest实现多平台支持，默认拉取lscr.io/linuxserver/krita:latest会自动匹配对应架构，也可通过标签指定：

使用场景和适用范围

• 数字艺术创作者：需要在容器化环境中运行Krita进行绘画创作
• 开发/测试环境：快速部署独立的Krita实例，避免系统环境冲突
• 远程访问场景：通过Web界面远程使用Krita，无需本地安装
• 教育/培训场景：在服务器上部署，供多用户通过浏览器访问学***

[!NOTE] 该镜像基于Selkies GUI容器框架，需注意安全配置，不建议直接暴露在公网环境。

详细使用方法和配置说明

应用访问地址

容器部署后，可通过以下地址访问Krita Web界面：

• HTTP: [***]
• HTTPS: [***]

安全注意事项

[!WARNING] 本容器提供对主机系统的特权访问，请勿在未适当安全配置的情况下暴露到互联网。

• HTTPS要求：完整功能需HTTPS支持，现代浏览器特性（如WebCodecs）不支持不安全的HTTP连接
• 认证机制：默认无认证，可通过CUSTOM_USER和PASSWORD环境变量启用基础HTTP认证（仅适用于可信局域网）；公网暴露建议使用反向代理（如SWAG）增强安全
• 权限风险：Web界面包含带无密码sudo权限的终端，任何访问者可在容器内获取root权限，安装软件或探测本地网络
• seccomp配置：老旧硬件或系统可能需要禁用seccomp限制（--security-opt seccomp=unconfined），但会降低容器安全性，仅在必要时使用

Docker部署方案

docker-compose配置（推荐）

---
services:
  krita:
    image: lscr.io/linuxserver/krita:latest
    container_name: krita
    environment:
      - PUID=1000        # 用户ID，通过`id your_user`获取
      - PGID=1000        # 组ID，通过`id your_user`获取
      - TZ=Etc/UTC       # 时区，如Asia/Shanghai
      # 可选环境变量（详见下文）
      # - CUSTOM_USER=admin
      # - PASSWORD=yourpassword
      # - LC_ALL=zh_CN.UTF-8
    volumes:
      - /path/to/config:/config  # 持久化配置目录
    ports:
      - 3000:3000        # HTTP端口
      - 3001:3001        # HTTPS端口
    shm_size: "1gb"      # 共享内存大小，桌面应用推荐至少1GB
    restart: unless-stopped
    # 可选：GPU加速配置
    # devices:
    #   - /dev/dri:/dev/dri

docker run命令

docker run -d \
  --name=krita \
  -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/krita:latest

参数说明

端口映射（-p）

环境变量（-e）

卷映射（-v）

运行时配置

高级配置

语言支持

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

• LC_ALL=zh_CN.UTF-8：中文
• LC_ALL=ja_JP.UTF-8：日语
• LC_ALL=ko_KR.UTF-8：韩语
• LC_ALL=fr_FR.UTF-8：法语
• LC_ALL=de_DE.UTF-8：德语

DRI3 GPU加速

通过挂载DRI设备实现GPU加速，仅支持开源驱动：

配置示例：

docker run -d \
  --name=krita \
  # 其他基础参数...
  --device /dev/dri:/dev/dri \
  -e DRINODE=/dev/dri/renderD128 \
  lscr.io/linuxserver/krita:latest

应用管理

PRoot Apps（持久化）

推荐使用proot-apps安装持久化应用（存储在/config目录，容器重建后保留）：

# 进入容器
docker exec -it krita /bin/bash
# 安装应用（支持列表见[***]
proot-apps install filezilla

原生应用（非持久化）

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

# docker-compose.yaml中添加
environment:
  - DOCKER_MODS=linuxserver/mods:universal-package-install
  - INSTALL_PACKAGES=libfuse2|git|gdb  # 需安装的包，用|分隔

维护与更新

查看容器状态

# 查看日志
docker logs -f krita

# 进入容器终端
docker exec -it krita /bin/bash

# 查看容器版本
docker inspect -f '{{ index .Config.Labels "build_version" }}' krita

更新容器

通过docker-compose

# 拉取最新镜像
docker-compose pull krita

# 更新容器
docker-compose up -d krita

# 清理旧镜像
docker image prune

通过docker run

# 拉取最新镜像
docker pull lscr.io/linuxserver/krita:latest

# 停止并删除旧容器
docker stop krita && docker rm krita

# 用原参数启动新容器（/config目录持久化，配置保留）
docker run -d \
  --name=krita \
  # 原参数...
  lscr.io/linuxserver/krita:latest

版本历史

• 22.09.25: 基于Debian Trixie重建
• 12.07.25: 基于Selkies和Debian重建，使用AppImage，强制HTTPS，移除arm64支持
• 06.12.24: 基于Alpine 3.21重建
• 23.05.24: 基于Alpine 3.20重建
• 10.02.24: 基于Alpine 3.19重建，更新文档环境变量，添加PWA图标
• 07.12.23: 初始发布