
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
digiKam:拥有开源力量的专业照片管理软件
!https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/digikam.png
我们利用docker manifest实现多平台支持。更多信息可从docker https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list%E5%92%8C%E6%88%91%E4%BB%AC%E7%9A%84%E5%85%AC%E5%91%8A%E6%AD%A4%E5%A4%84%E8%8E%B7%E5%8F%96%E3%80%82
只需拉取 lscr.io/linuxserver/digikam:latest 即可获取适合您架构的正确镜像,您也可以通过标签拉取特定架构的镜像。
此镜像支持的架构:
| 架构 | 可用 | 标签 |
|---|---|---|
| x86-64 | ✅ | amd64-<版本标签> |
| arm64 | ✅ | arm64v8-<版本标签> |
| armhf | ❌ |
当使用mysql内部模式作为数据库时,您需要点击"Find"按钮来定位所有必需的二进制文件(mysql_install_db、mysqladmin、mysqld)。然后选择二进制文件并按"Open"。
应用可通过以下地址访问:
此容器基于https://github.com/linuxserver/docker-baseimage-kasmvnc%E6%9E%84%E5%BB%BA%EF%BC%8C%E8%BF%99%E6%84%8F%E5%91%B3%E7%9D%80%E6%9C%89%E9%A2%9D%E5%A4%96%E7%9A%84%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E5%92%8C%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE%E5%8F%AF%E7%94%A8%E4%BA%8E%E5%90%AF%E7%94%A8%E6%88%96%E7%A6%81%E7%94%A8%E7%89%B9%E5%AE%9A%E5%8A%9F%E8%83%BD%E3%80%82
可选环境变量
| 变量 | 描述 |
|---|---|
| CUSTOM_PORT | 容器内部HTTP监听端口,如需从默认3000更改时使用 |
| CUSTOM_HTTPS_PORT | 容器内部HTTPS监听端口,如需从默认3001更改时使用 |
| CUSTOM_USER | HTTP基本认证用户名,默认为abc |
| PASSWORD | HTTP基本认证密码,默认为abc。如未设置则无需认证 |
| SUBFOLDER | 应用的子文件夹(如运行在子文件夹反向代理下),需要包含前后斜杠,例如/subfolder/ |
| TITLE | 网页浏览器上显示的页面标题,默认为"KasmVNC Client" |
| FM_HOME | 文件管理器的主目录(起始位置),默认为"/config" |
| START_DOCKER | 如果设置为false,具有特权的容器将不会自动启动DinD Docker设置 |
| DRINODE | 如果挂载/dev/dri用于DRI3 GPU加速,允许您指定要使用的设备,例如/dev/dri/renderD128 |
可选运行配置
| 变量 | 描述 |
|---|---|
--privileged | 将在容器内启动Docker in Docker (DinD)设置,以便在隔离环境中使用docker。为提高性能,可将容器内的Docker目录挂载到主机,例如-v /home/user/docker-data:/var/lib/docker |
-v /var/run/docker.sock:/var/run/docker.sock | 挂载主机级别的Docker socket,以便通过CLI与之交互或使用支持Docker的应用 |
--device /dev/dri:/dev/dri | 将GPU挂载到容器中,可与DRINODE环境变量结合使用,以利用主机视频卡进行GPU加速应用。仅支持开源驱动,如(Intel, AMDGPU, Radeon, ATI, Nouveau) |
通过将流质量预设更改为"Lossless",此容器能够以高帧率向您的Web浏览器提供真正的无损图像,更多信息此处。要从非本地主机端点使用此模式,需要使用3001上的HTTPS端口。如果使用反向代理到3000端口,则需要设置特定的头信息,如https://github.com/linuxserver/docker-baseimage-kasmvnc#lossless%E6%89%80%E8%BF%B0%E3%80%82
以下是一些示例代码片段,帮助您开始创建容器。
yaml--- version: "2.1" services: digikam: image: lscr.io/linuxserver/digikam:latest container_name: digikam environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - SUBFOLDER=/ #可选 volumes: - /path/to/config:/config ports: - 3000:3000 #可选 - 3001:3001 #可选 restart: unless-stopped
bashdocker run -d \ --name=digikam \ -e PUID=1000 \ -e PGID=1000 \ -e TZ=Etc/UTC \ -e SUBFOLDER=/ `#可选` \ -p 3000:3000 `#可选` \ -p 3001:3001 `#可选` \ -v /path/to/config:/config \ --restart unless-stopped \ lscr.io/linuxserver/digikam:latest
容器镜像通过运行时传递的参数进行配置(如上所示)。这些参数用冒号分隔,表示<外部>:<内部>。例如,-p 8080:80会将容器内的80端口暴露出来,可通过主机IP的8080端口访问。
| 参数 | 功能 |
|---|---|
-p 3000 | digiKam桌面GUI |
-p 3001 | digiKam桌面GUI HTTPS |
-e PUID=1000 | 用户ID - 详见下方说明 |
-e PGID=1000 | 组ID - 详见下方说明 |
-e TZ=Etc/UTC | 指定使用的时区,详见此列表 |
-e SUBFOLDER=/ | 指定反向代理使用的子文件夹,例如/subfolder/ |
-v /config | 容器中的用户主目录,存储数据库 |
您可以通过使用特殊的前缀FILE__从文件中设置任何环境变量。
例如:
bash-e FILE__PASSWORD=/run/secrets/mysecretpassword
将根据/run/secrets/mysecretpassword文件的内容设置环境变量PASSWORD。
对于我们所有的镜像,您可以使用可选的-e UMASK=022设置来覆盖容器内启动的服务的默认umask设置。
请记住,umask不是chmod,它根据其值减去权限,而不是添加。在请求支持之前,请先了解相关知识。
使用卷(-v标志)时,主机操作系统和容器之间可能会出现权限问题,我们通过允许您指定用户PUID和组PGID来避免此问题。
确保主机上的任何卷目录都归您指定的同一用户所有,这样任何权限问题都会像魔术一样消失。
在这个例子中PUID=1000和PGID=1000,要找到您的ID,请使用id user,如下所示:
bash$ id username uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
我们发布了各种https://github.com/linuxserver/docker-mods%EF%BC%8C%E4%BB%A5%E5%90%AF%E7%94%A8%E5%AE%B9%E5%99%A8%E5%86%85%E7%9A%84%E9%99%84%E5%8A%A0%E5%8A%9F%E8%83%BD%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E4%B8%8A%E6%96%B9%E7%9A%84%E5%8A%A8%E6%80%81%E5%BE%BD%E7%AB%A0%E8%AE%BF%E9%97%AE%E6%AD%A4%E9%95%9C%E5%83%8F%E5%8F%AF%E7%94%A8%E7%9A%84Mods%E5%88%97%E8%A1%A8%EF%BC%88%E5%A6%82%E6%9C%89%EF%BC%89%E4%BB%A5%E5%8F%8A%E5%8F%AF%E5%BA%94%E7%94%A8%E4%BA%8E%E6%88%91%E4%BB%AC%E4%BB%BB%E4%BD%95%E9%95%9C%E5%83%8F%E7%9A%84%E9%80%9A%E7%94%A8Mods%E3%80%82
docker exec -it digikam /bin/bashdocker logs -f digikamdocker inspect -f '{{ index .Config.Labels "build_version" }}' digikamdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/digikam:latest我们的大多数镜像是静态的、版本化的,需要更新镜像并重新创建容器才能更新内部的应用程序。除了一些例外情况(如nextcloud、plex),我们不建议或支持在容器内更新应用程序。请查阅上方的应用设置部分,了解是否推荐对该镜像进行更新。
以下是更新容器的说明:
docker-compose pull
docker-compose pull digikamdocker-compose up -d
docker-compose up -d digikamdocker image prunedocker pull lscr.io/linuxserver/digikam:latestdocker stop digikamdocker rm digikam/config文件夹和设置将被保留)docker image prune拉取最新标签的镜像并在一次运行中使用相同的环境变量替换它:
bashdocker run --rm \ -v /var/run/docker.sock:/var/run/docker.sock \ containrrr/watchtower \ --run-once digikam
您还可以删除旧的悬空镜像:docker image prune
注意: 我们不认可使用Watchtower作为现有Docker容器自动更新的解决方案。事实上,我们通常不鼓励自动更新。但是,对于您忘记原始参数的容器,这是一个有用的一次性手动更新工具。从长远来看,我们强烈建议使用Docker Compose。
如果您想对这些镜像进行本地修改以用于开发目的或自定义逻辑:
bashgit clone https://github.com/linuxserver/docker-digikam.git cd docker-digikam docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/digikam:latest .
可以使用multiarch/qemu-user-static在x86_64硬件上构建ARM变体
bashdocker run --rm --privileged multiarch/qemu-user-static:register --reset
注册后,您可以使用-f Dockerfile.aarch64来指定要使用的dockerfile。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务