Damselfly
SHA-256自托管照片管理服务器，具备 AI 人脸/物体识别、快速搜索和关键词标记功能，类似 Google Picasa 但更智能且可私有部署。
스마트 다운로드
Download 버전 다운로드
v4.5.3 · 475 MB
自建照片库的 AI 管家，搜图快、能认人、可多设备同步。
주요 기능
- 支持几乎所有常见图片格式（JPG/PNG/HEIC/RAW 等）
- AI 自动识别人脸、辨认身份、检测物体和颜色分类
- 全文搜索，支持多短语、模糊匹配，50 万张图秒出结果
- 高级筛选：按日期、相机镜头、大小、方向、相似图等
- 非破坏性关键字编辑（借助 ExifTool 不重编码）
할 수 없는 것
- •依赖 ExifTool 进行非破坏性写入，需单独安装（Docker 镜像已内置）。离线人脸识别模型首次使用时需下载约 200MB 模型文件。Windows 版可能需要安装 .NET 7 运行库。RAW 格式预览依赖系统解码，部分老相机 RAW 可能不兼容。建议照片目录保持稳定，移动路径需手动更新设置。
사용 사례
- 摄影爱好者管理海量 RAW 照片，快速找人找图
- 家庭照片库多成员共享，自动识别家庭成员
- 图库管理员批量标记关键词、导出用于社交媒体或投稿
상세 설명
Damselfly 是一款自托管的数字照片管理服务器，专为大型文件夹式照片库设计。核心优势在于毫秒级搜索和 AI 驱动的标签工作流：它能自动识别人脸、辨认人物、检测物体并分类颜色。支持 JPEG、PNG、HEIC、TIFF、Webp、BMP 以及 DNG/CR2/ORF/NEF 等 RAW 格式。功能包括全文搜索、高级筛选（日期、相机、尺寸、相似图片）、多用户权限管理、导出/上传篮子、桌面客户端同步等。可在 Windows、Linux、macOS 和 Docker 上运行。基于 .NET 7 和 Blazor WebAssembly 构建。
문제 해결 & FAQ (2)
문제 해결왜 내 Linux 빌드에 onnxruntime.dll과 libonnxruntime.so가 포함되어 500MB 크기 증가가 발생하나요?
이는 onnxruntime 패키지(microsoft/onnxruntime#23077)의 알려진 버그로, Windows DLL이 Linux 빌드에 잘못 포함되는 문제입니다. macOS에도 영향을 미칩니다. 해결 방법: 빌드 후 불필요한 Windows DLL을 수동으로 제거합니다. 예: find . -name "onnxruntime*.dll" -delete. 영구적인 수정을 위해 업스트림 이슈를 추적하세요.
문제 해결얼굴 감지가 작동하는데도 Damselfly에서 'Unable to start Azure service: Value cannot be null' 오류가 발생하는 이유는 무엇인가요?
이 오류는 종종 헛된 경고입니다. 'Azure Detected X faces'와 같은 항목이 있는지 로그를 확인하여 서비스가 실제로 작동하는지 확인하세요. 시작 오류에도 불구하고 얼굴 감지가 성공하면 안전하게 무시할 수 있습니다. 구성 변경이 필요하지 않습니다.
태그
시작하기
소프트웨어 설치
배포판에 맞는 패키지를 설치 (dpkg / rpm / AppImage)
方式一（推荐）：用 Docker 运行，执行 docker run -d -p 8080:8080 -v /你的照片目录:/pictures webreaper/damselfly
方式二：下载对应平台的可执行文件（Windows/Linux/macOS），解压后运行 Damselfly.exe
启动后浏览器访问 http://localhost:8080，按向导设置照片路径和数据库（支持 SQLite 或 MySQL）
- 方式一（推荐）：用 Docker 运行，执行 docker run -d -p 8080:8080 -v /你的照片目录:/pictures webreaper/damselfly
- 方式二：下载对应平台的可执行文件（Windows/Linux/macOS），解压后运行 Damselfly.exe
- 启动后浏览器访问 http://localhost:8080，按向导设置照片路径和数据库（支持 SQLite 或 MySQL）
SHA-256 체크섬 확인됨
GitHub 공식 Release 페이지에서 추출된 체크섬
SHA256 체크섬
1c651a341c449da6c049ea1cb32bc4d034565a6130c320e044188c79d5d400ad이 체크섬은 GitHub Release 페이지에서 추출되었습니다. 다운로드 후 파일 무결성을 확인하세요.
이 플랫폼의 모든 SHA-256 체크섬은 프로젝트의 공식 GitHub Release 페이지에서 추출되었으며, 어떠한 변경도 없습니다. GitHub Releases 페이지에서 직접 검증할 수 있습니다.
오픈소스 투명성
GitHub 소스 보기제거 정보
Docker 部署：停止容器并删除镜像及数据卷。直接部署：删除解压目录，并清理数据库文件（默认在程序目录下的 .db 文件）。
추가 의존성 없음
다운로드 후 바로 사용 가능. 추가 런타임이 필요하지 않습니다.
문제 발생? 아래 FAQ 확인
2 FAQs