rpufky/digikam

digikam

弃用通知： 支持将在digikam下一个主要版本结束。详情及迁移至https://hub.docker.com/r/linuxserver/digikam%E9%95%9C%E5%83%8F%E7%9A%84%E6%96%B9%E6%B3%95%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81https://github.com/r-pufky/digikam/blob/master/migration.md%E3%80%82

digikam是一款高级开源数字照片管理应用，可运行于Linux、Windows和MacOS系统。该应用提供了一套全面的工具，用于导入、管理、编辑和分享照片及原始文件。

本Docker镜像结合了digikam AppImage与https://hub.docker.com/r/jlesage/baseimage-gui/，实现了digikam的容器化使用，可通过任何现代Web浏览器访问所有插件，无需额外客户端配置。

有关基础镜像的详细使用方法，请阅读https://hub.docker.com/r/jlesage/baseimage-gui/文档。

版本标签

本镜像提供多种版本，可通过标签获取。建议使用stable或明确的digikam版本（如7.6.0），以获取更新同时减少意外变更。

• stable：提供digikam最新正式发布版本。
• latest：提供digikam最新构建版本，可能不稳定。

stable和latest容器每周自动重建。

• 旧版容器点发布的详细https://github.com/r-pufky/digikam/blob/master/RELEASE.md。仅保留当前和上一版本。
• 与Docker相关的问题请https://github.com/r-pufky/digikam/issues。
• digikam发布计划见此。
• 有关问题（如DB 10到11升级失败），请参见故障排除。

docker-compose配置示例

yaml
---
version: "3"
services:
  digikam:
    image: rpufky/digikam:stable
    ports:
      - "5800:5800"
    environment:
      - USER_ID=1000
      - GROUP_ID=1000
      - UMASK=022
      - TZ=America/Los_Angeles
      - KEEP_APP_RUNNING=1
      - DISPLAY_WIDTH=1920
      - DISPLAY_HEIGHT=1080
      - ENABLE_CJK_FONT=1
    volumes:
      - /my/docker/service/config:/config
      - /my/photo/location:/data
      - /etc/localtime:/etc/localtime:ro

参数

有关基础镜像的详细参数，请阅读https://hub.docker.com/r/jlesage/baseimage-gui/文档。以下仅列出本镜像使用的参数及新默认设置。

端口

以下是容器使用的端口列表，可通过-p <主机端口>:<容器端口>映射到主机。容器内端口不可更改，主机端口可任意指定。

卷

用户/组ID

使用数据卷（-v参数）时，主机与容器之间可能出现权限问题。例如，容器内用户可能在主机上不存在，导致主机无法正常访问共享卷上的文件和文件夹。

为避免此类问题，可通过USER_ID和GROUP_ID环境变量指定应用运行的用户。

要获取正确的ID，在主机上执行以下命令（使用主机上拥有数据卷的用户）：

id <用户名>

输出示例：

uid=1000(myuser) gid=1000(myuser) groups=1000(myuser),4(adm),24(cdrom),27(sudo),46(plugdev),113(lpadmin)

其中uid（用户ID）和gid（组ID）即为应传递给容器的值。

配置目录

容器内，应用配置应存储在/config目录。此目录还用于存储VNC密码。

注意：默认情况下，容器启动时，应用运行用户（即USER_ID定义的用户）将获取此目录所有内容的所有权。此行为可通过TAKE_CONFIG_OWNERSHIP环境变量修改。

访问GUI

假设容器端口映射到主机相同端口，应用图形界面可通过以下方式访问：

Web浏览器

http://{主机IP}:5800

VNC客户端

{主机IP}:5900

建议使用基于反向代理的Web访问。

安全

默认情况下，应用GUI通过未加密连接（HTTP或VNC）访问。可通过SECURE_CONNECTION环境变量启用加密连接。启用后，通过浏览器访问时使用HTTPS连接，所有HTTP访问将自动重定向到HTTPS。

使用VNC客户端时，VNC连接通过SSL进行。注意，少数VNC客户端支持此方式。

更多文档见https://hub.docker.com/r/jlesage/baseimage-gui/。

反向代理设置

digikam应在反向代理后运行，以隔离容器访问。以下反向代理示例假设已为nginx设置digikam子域名。

nginx
server {
  listen 443 ssl http2;
  server_name digikam.example.com digikam;

  location / {
    proxy_pass https://digikam:5800/;
  }

  location /websockify {
    proxy_pass https://digikam:5800;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "Upgrade";
  }
}

• websockify提供浏览器的WebSocket连接，需暴露以确保GUI正确渲染。

digikam设置

首次启动digikam时，必须显式设置以下内容：

配置图像存储位置

• 手动设置为/data。

配置数据库存储位置

• 类型：SQLite
• 手动设置为/config。

面部识别训练数据

• 大小约335MB
• 如/config映射到容器外，仅需下载一次。

故障排除

DB schema从10升级到11失败8s

digikam数据库用户没有修改表的足够权限。

默认情况下，存储函数需要超级用户（root）权限。

启用可信存储函数：

bash
mysql -u root -p

set global log_bin_trust_function_creators=1;

手动构建

使用Makefile管理构建，假设当前用户具有Docker权限。常用命令如下：

bash
make

• 显示所有make选项。

bash
make digikam version=7.6.0

• 使用appimage 7.6.0构建'stable'版本。

bash
make latest version=7.6.0

• 使用appimage 7.6.0构建'latest'版本。

bash
make clean

• 清理文件系统上的构建产物。

许可

digikam遵循此处所述的GPLv2许可证。digikamhttps://raw.githubusercontent.com/r-pufky/digikam/master/media/digikam_oxygen.svg?sanitize=true未经修改，根据此许可证复制。