文档建议反馈控制台
首页
学习
活动
专区
圈层
工具
MCP广场
文章/答案/技术大牛
发布
社区首页 >专栏 >从零搭建私有云相册：使用Docker一键部署Damselfly实战

从零搭建私有云相册：使用Docker一键部署Damselfly实战

原创
作者头像
江湖有缘
发布于 2026-08-06 23:16:43
发布于 2026-08-06 23:16:43
1040
举报
文章被收录于专栏：Docker项目实战Docker项目实战

一、Damselfly介绍

1.1 Damselfly简介

Damselfly是一个基于服务器的高性能照片管理应用程序，专为大规模图像集合设计，通过丰富的元数据、AI 视觉识别和快速搜索功能，实现高效的照片组织、检索与协作。

1.2 Damselfly主要特点

  • 广泛格式支持：兼容 JPG、PNG、HEIC、TI TIFF、WebP、BMP 及主流 RAW 格式（如 CR2、NEF、ORF、DNG）。
  • AI 图像识别：集成面部检测、人脸识别、物体识别与图像颜色分类等计算机视觉能力。
  • 全文与高级搜索：支持关键词短语、部分匹配及按日期、设备、方向、文件大小、标签状态等多维度筛选。
  • 视觉相似性搜索：可查找外观相似的图片，提升内容发现效率。
  • 极速性能：在包含 50 万张图片的库中，搜索响应时间低于 1 秒。
  • 非破坏性关键词标记：使用 ExifTool 更新 IPTC/EXIF 元数据，避免 JPEG 重新编码导致的质量损失。
  • 多用户与权限控制：支持多账户及基于角色的访问控制（如只读用户无法编辑标签）。
  • 地理信息可视化：在地图上显示带有地理位置元数据的照片位置。
  • 选择篮功能：用户可创建私有或共享的图像篮，用于下载、导出至外部工具或上传至 WordPress。
  • 自动后台索引：新增或修改图像时自动更新索引与缩略图，无需手动干预。
  • 跨平台桌面客户端：提供基于 Electron.NET 的 macOS（通用）、Windows 和 Linux 桌面应用，增强本地集成体验。
  • 灵活部署：支持 Windows、Linux、macOS 及 Docker 环境，后端基于 .NET 7，前端采用 Blazor WebAssembly。
  • 媒体排除机制：通过在文件夹中放置 .nomedia 文件，阻止 Damselfly 扫描特定目录。
  • 安全导出与水印：支持导出带水印的图像，便于社交媒体分享或邮件发送。

二、本次实践规划

2.1 本地环境规划

本次实践为个人测试环境，操作系统版本为 Ubuntu 24.04.2 LTS。

hostname

IP地址

操作系统版本

Docker版本

部署项目

备注

jeven

192.168.3.88

Ubuntu 24.04.2 LTS

28.5.0

Damselfly

——

2.2 本次实践介绍

1.本次实践部署环境为个人测试环境，生产环境请谨慎；

2.在Docker环境下部署Damselfly照片管理系统。

三、本地环境检查

3.1 检查Docker服务状态

检查Docker服务是否正常运行，确保Docker正常运行。

代码语言：bash
复制
root@jeven:~# systemctl status docker
● docker.service - Docker Application Container Engine
     Loaded: loaded (/usr/lib/systemd/system/docker.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-12-02 00:51:31 CST; 1min 11s ago
TriggeredBy: ● docker.socket
       Docs: https://docs.docker.com
   Main PID: 75393 (dockerd)
      Tasks: 32
     Memory: 34.1M (peak: 34.8M)
        CPU: 1.248s
     CGroup: /system.slice/docker.service
在这里插入图片描述
在这里插入图片描述

3.2 检查Docker版本

检查Docker版本

代码语言：bash
复制
root@jeven:~# docker -v
Docker version 28.5.0, build 887030f

3.3 检查docker compose 版本

检查Docker compose版本，确保2.0以上版本。

代码语言：bash
复制
root@jeven:~# docker compose version
Docker Compose version v2.39.4

四、拉取Damselfly镜像

下载Damselfly镜像，执行以下命令：

代码语言：bash
复制
 docker pull webreaper/damselfly
在这里插入图片描述
在这里插入图片描述

五、部署Damselfly服务

5.1 创建部署目录

  • 创建部署目录
代码语言：bash
复制
mkdir -p /data/damselfly/{config,thumbs,photos}   && cd /data/damselfly
  • 目录权限设置：
代码语言：bash
复制
chmod -R 777 /data/damselfly

5.2 docker compose方式部署

新建及编辑docker-compose.yaml文件，宿主机映射端口可自行设置，注意防止端口冲突。

代码语言：bash
复制
vim docker-compose.yaml
代码语言：yaml
复制
version: '3'

services:
  damselfly:
    image: webreaper/damselfly
    container_name: damselfly
    restart: unless-stopped
    ports:
      - 7100:6363
    volumes:
      - ./config:/config
      - ./thumbs:/thumbs
      - ./photos:/pictures

宿主机路径（Host Path）

容器内路径（Container Path）

说明

./config

/config

存放 Damselfly 的应用程序配置文件，如数据库、用户设置等。

./thumbs

/thumbs

用于存储系统自动生成的图像缩略图，提升浏览和搜索性能。

./photos

/pictures

挂载用户的照片库根目录，Damselfly 将从此路径索引和管理所有图片。

5.3 创建Damselfly容器

执行以下命令，创建Damselfly容器。

代码语言：bash
复制
docker compose up -d
在这里插入图片描述
在这里插入图片描述

5.4 查看Damselfly容器状态

检查Damselfly容器运行状态，确保Damselfly容器正常启动。

代码语言：bash
复制
root@jeven:/data/damselfly# docker compose ps
WARN[0000] /data/damselfly/docker-compose.yaml: the attribute `version` is obsolete, it will be ignored, please remove it to avoid potential confusion
NAME        IMAGE                 COMMAND                   SERVICE     CREATED          STATUS          PORTS
damselfly   webreaper/damselfly   "sh /damselfly-entry…"   damselfly   24 seconds ago   Up 23 seconds   0.0.0.0:7100->6363/tcp, [::]:7100->6363/tcp
在这里插入图片描述
在这里插入图片描述

5.5 检查Damselfly容器日志

检查容器运行日志，确保Damselfly服务正常运行。

代码语言：bash
复制
docker compose logs
在这里插入图片描述
在这里插入图片描述

六、访问Damselfly服务

6.1 访问Damselfly首页

浏览器地址： http://<个人的服务器IP>:7100，访问Damselfly初始页。如果无法访问，请确保宿主机的防火墙已关闭或已放行相关端口，对于云服务器还需配置相应的安全组规则。

在这里插入图片描述
在这里插入图片描述

6.2 上传图片

将本地图片上传到/data/damselfly/photos/目录下，如下所示：

代码语言：bash
复制
root@jeven:/data/damselfly# cd photos/
root@jeven:/data/damselfly/photos# ls
v2-61dca6243b04c6eebc3d0c29891bbd49~resize_1440_q75.png  v2-768e5c8c516926c529b73e6c4788a1a0~resize_1440_q75.jpg
v2-6dc50c16c4184fddd69718633cf9f267~resize_1440_q75.png  v2-aa1fabee7fefc859930de3fcebbdc6d4~resize_1440_q75.png
root@jeven:/data/damselfly/photos#

6.3 浏览照片

刷新Damselfly页面后，即可看到所有的照片。

在这里插入图片描述
在这里插入图片描述

七、总结

通过本次实践，我们成功使用 Docker 快速部署了 Damselfly 照片管理系统，验证了其在容器化环境下的易用性与稳定性。借助 docker-compose 编排工具，仅需几条命令即可完成服务搭建，并通过挂载本地目录实现配置、缩略图和照片库的持久化管理。系统启动后，通过 Web 界面可高效上传、浏览和搜索海量图像，AI 识别与元数据功能表现流畅。Damselfly 凭借高性能、跨平台支持和非破坏性编辑特性，非常适合作为个人或团队的私有照片管理中心。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

linux
目录
  • 一、Damselfly介绍
    • 1.1 Damselfly简介
    • 1.2 Damselfly主要特点
  • 二、本次实践规划
    • 2.1 本地环境规划
    • 2.2 本次实践介绍
  • 三、本地环境检查
    • 3.1 检查Docker服务状态
    • 3.2 检查Docker版本
    • 3.3 检查docker compose 版本
  • 四、拉取Damselfly镜像
  • 五、部署Damselfly服务
    • 5.1 创建部署目录
    • 5.2 docker compose方式部署
    • 5.3 创建Damselfly容器
    • 5.4 查看Damselfly容器状态
    • 5.5 检查Damselfly容器日志
  • 六、访问Damselfly服务
    • 6.1 访问Damselfly首页
    • 6.2 上传图片
    • 6.3 浏览照片
  • 七、总结

腾讯云开发者

扫码关注腾讯云开发者

扫码关注腾讯云开发者

领取腾讯云代金券

热门产品

热门推荐

更多推荐

Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有 

深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 粤公网安备44030502008569号

腾讯云计算（北京）有限责任公司 京ICP证150476号 |  京ICP备11018762号

问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档