Immich 自托管照片与视频管理系统：能力全景与源码实现对照

Immich 自托管照片与视频管理系统能力全景与源码实现对照【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich本文基于 Immich 仓库的俄语版主 READMEreadme_i18n/README_ru_RU.md展开完整继承其中的项目定位、演示环境说明、移动端/Web 端功能矩阵与翻译机制并结合当前仓库的服务端、机器学习与移动端源码逐项印证每项能力的落地实现帮助你在评估或部署这套自托管照片/视频管理系统之前建立从功能到代码路径的完整认知。项目定位与总体说明README 对 Immich 的一句话定义是高性能的自托管self-hosted照片与视频存储、分组与管理方案。仓库根目录的 README.md 与俄语版内容一致项目采用 AGPL v3 许可证并配套官方文档站仓库内 docs/docs/ 目录即文档源文件。官方 README 中有两条明确的运维提示部署前务必注意3-2-1 备份原则官方用 WARNING 级别强调珍贵的照片和视频应始终遵循 3-2-1 备份策略3 份副本、2 种介质、1 份异地。自托管意味着数据主权归你但同时也意味着备份责任归你安装指引以官方文档为准README 将具体安装步骤指向文档站的安装章节对应仓库内的 docs/docs/install/requirements.md、docs/docs/install/docker-compose.mdx 等文件。从仓库目录结构看整个系统由四个可独立运行的组件构成这也解释了 README 中高性能的来源——它是前后端分离 独立 ML 推理服务的架构组件仓库路径职责服务端 APIserver/NestJS 后端含 82 个控制器、100 个服务负责资产管理、鉴权、分享、任务调度机器学习服务machine-learning/独立的 Python 推理服务内置 CLIP、人脸识别、OCR 三类模型移动端 Appmobile/Flutter 客户端含备份、下载、小组件等原生能力Web 前端web/SvelteKit 应用面向管理员与日常浏览演示环境与体验凭据README 提供了一个可在线体验的演示实例。在移动端应用中将Server Endpoint URL服务器地址一栏填写为https://demo.immich.app然后使用以下账号登录邮箱密码demoimmich.appdemo这个演示环境是验证下文功能矩阵最快速的方式——无需自行部署即可看到人脸分组、时间轴、地图等功能在真实数据上的表现。若要本地部署仓库内 docker/docker-compose.yml 与 docker/example.env 给出了标准编排immich-server端口 2283、immich-machine-learning、valkeyRedis 兼容与postgres内置向量扩展的定制镜像四个容器。docker/example.env 中的关键变量为# 上传文件照片/视频原件的存储位置 UPLOAD_LOCATION./library # 数据库文件存储位置官方明确不支持网络共享盘存放数据库 DB_DATA_LOCATION./postgres # 版本锁定可固定为具体版本号如 v2.1.0 IMMICH_VERSIONv3 # postgres 连接密码官方建议更换为仅含 A-Za-z0-9 的随机密码 DB_PASSWORDpostgres注意 compose 文件头部的注释强调生产部署应使用当前 release 版本发布的 compose 文件main分支上的 compose 可能与最新 release 不兼容。完整功能矩阵移动端 vs Web 端以下表格完整继承自 README 的功能清单逐项标注移动端App与 Web 端的支持情况功能移动端Web 端上传、查看视频与照片支持支持打开应用时自动备份支持不适用防止资产重复支持支持选择指定相册进行备份支持不适用将照片/视频下载到本地设备支持支持多用户账号支持支持支持相册与共享相册支持支持可拖拽滚动的时间轴滚动条支持支持RAW 格式支持支持支持元数据查看EXIF、地图支持支持按元数据、物体、人脸与 CLIP 语义搜索支持支持管理功能用户管理不支持支持后台备份支持不适用虚拟滚动支持支持OAuth 支持支持支持API 密钥不适用支持LivePhoto / MotionPhoto 备份与播放支持支持360° 全景图展示不支持支持用户自定义存储结构支持支持公开分享支持支持归档与收藏支持支持全球地图支持支持合作者共享Partner Sharing支持支持人脸识别与聚类分组支持支持回忆X 年前的今天支持支持离线支持支持不支持只读画廊支持支持堆叠照片/拼贴支持支持标签Tags不支持支持文件夹视图支持支持可以归纳出分工边界移动端独占的能力集中在采集与备份侧自动备份、后台备份、相册选择性备份、离线支持Web 端独占的能力集中在管理侧用户管理、API 密钥、360° 展示、标签其余核心浏览与检索能力两端齐备。能力到源码关键功能的实现印证下面选取功能矩阵中技术含量最高的几项对照当前仓库源码说明其实际落地位置便于阅读代码或二次开发时快速定位。上传、备份与去重移动端侧mobile/lib/services/ 下提供了完整的备份基础设施background_upload.service.dart与foreground_upload.service.dart分别对应上表后台备份与打开应用时自动备份download.service.dart负责下载到本地设备。服务端侧同步与去重的入口在 server/src/services/sync.service.ts对应 sync.controller.ts 暴露的同步接口重复检测则由 server/src/services/duplicate.service.ts 承担——README 中防止资产重复在 Web 端同样支持对应管理界面中的重复资产管理入口。搜索元数据 人脸 CLIP 语义检索这是 Immich 最核心的差异化能力。README 将其概括为按元数据、物体、人脸与 CLIP 搜索。从源码结构看检索的统一入口是 server/src/services/search.service.tsSearchService见该文件 L35而真正执行跨模态检索的模型在独立的 ML 服务中machine-learning/immich_ml/models/clip/ —— CLIP 零样本图像/文本嵌入支撑按自然语言搜图machine-learning/immich_ml/models/facial_recognition/ —— 人脸检测与特征提取machine-learning/immich_ml/models/ocr/ —— 图片内文字识别。ML 服务通过 machine-learning/immich_ml/sessions/ort.py 基于 ONNX Runtime 加载模型docker/docker-compose.yml 的注释说明可通过修改镜像标签追加-cuda、-rocm、-openvino、-rknn、-armnn等后缀启用硬件加速仓库同时提供了 docker/hwaccel.ml.yml 与 docker/hwaccel.transcoding.yml 两个加速编排模板。人脸识别与聚类分组App 与 Web 均支持的人脸识别与聚类在服务端由 server/src/services/person.service.tsPersonServiceL52管理人物Person/Face实体与分组关系配合 person.controller.ts 对外提供接口聚类计算依赖 ML 服务产出的人脸向量再由服务端数据库聚合。分享体系相册、公开链接与合作者共享功能表中公开分享与合作者共享是两个独立能力分别对应server/src/services/album.service.ts私有与共享相册server/src/services/shared-link.service.ts基于链接的公开分享支撑只读画廊场景server/src/services/partner.service.ts合作者Partner共享允许在保持各自账号独立的前提下共享特定内容。记忆、地图与标签回忆X 年前的今天server/src/services/memory.service.tsMemoryServiceL16按拍摄日期检索历史同期素材全球地图server/src/services/map.service.ts 提供按地理位置查询素材的接口移动端地图能力见 mobile/lib/services/map.service.dart标签server/src/services/tag.service.tsTagServiceL24——功能表中明确标注仅 Web 端支持。管理、鉴权与 API 密钥功能表中管理功能用户管理仅 Web 端支持对应 server/src/controllers/ 下的管理端控制器user-admin.controller.ts、auth-admin.controller.ts、config-admin.controller.ts等均带-admin后缀标识权限边界。鉴权侧auth.service.ts处理常规登录oauth.controller.ts支撑 OAuthapi-key.service.ts为 Web 端提供 API 密钥管理供脚本或第三方程序调用 OpenAPI规范文件见 open-api/immich-openapi-specs.json。多语言支持从 i18n 目录到翻译流程本文所依据的俄语版 README 本身即是 Immich 多语言实践的一部分——仓库 readme_i18n/ 目录下维护着 20 个语言的 README 译本西班牙语、法语、日语、中文简体/繁体、乌克兰语等而主 README 通过语言徽章导航到各译本。项目级国际化则集中在 i18n/ 目录当前仓库包含89 个语言的 JSON 翻译文件从af.json阿法尔语到zh_Hant.json繁体中文这些文件被移动端Flutter 本地化与 Web 端SvelteKit 国际化共同消费。移动端 App 名称字符串的资源打包见 mobile/assets/ 与各平台 manifest而 mobile/scripts/check_i18n_keys.py 提供了 i18n key 一致性校验脚本可用于发现缺失或多余的翻译键。翻译协作流程在文档站有专门页面对应 docs/docs/developer/translations.mdREADME 中附带的 Weblate 徽章即指向该协作平台。若你希望贡献新语言基本路径是在 Weblate 上完成翻译后合入结果以 JSON 文件形式落地到 i18n/ 目录。小结Immich 的 README 以功能矩阵为核心契约备份与采集能力沉在 Flutter 移动端的原生服务层管理与检索能力沉在 NestJS 服务端加独立 ONNX 推理服务的组合中四容器 Docker 编排server / machine-learning / valkey / postgres把这套架构收敛为可一键自托管的部署单元。对自托管用户而言建议先通过演示实例验证功能契合度再按 docker/example.env 固化存储位置与版本策略并牢记 README 反复强调的一点——自托管解决的是数据主权问题而数据安全仍取决于你是否执行了 3-2-1 备份。【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考