Immich 自托管照片视频管理

immich-app/immich 访问 GitHub ↗
🔤 TypeScript ★ 111150 ⑂ 0 daily #9 (+175) 抓取 2026-08-18

一句话简介

Immich 是一款基于 TypeScript 的自托管照片与视频备份管理平台,兼容 Google 相册核心功能,支持多设备同步、智能搜索与分享。

标签

  • 自托管
  • 照片管理
  • 视频备份
  • TypeScript
  • 家庭云相册

适用应用场景

  • 家庭用户替代 Google 相册进行本地照片备份
  • 摄影爱好者集中管理并检索海量影像素材
  • 小型团队搭建私有化的媒体资产共享平台
  • 开发者作为全栈 TypeScript 项目学习与二次开发

README 中文摘要

项目概述

Immich 是一款高性能的自托管照片与视频管理解决方案,旨在替代 Google 相册等云端服务,让用户完全掌控自己的媒体数据。项目采用 AGPL v3 开源协议,提供完整的 Web 端和移动端体验。

重要提醒

请务必为珍贵的照片与视频遵循 3-2-1 备份策略:至少保留 3 份副本,存储在 2 种不同的介质上,其中 1 份放在异地。这是保护数据安全的最佳实践。

官方文档(包括详细的安装指南)请访问 https://immich.app/。

在线演示

可通过 https://demo.immich.app 体验完整功能。移动端用户可在「Server Endpoint URL」配置中填写该地址进行连接。

演示账号:

邮箱 密码
demo@immich.app demo

核心特性

下表汇总了各功能在移动端与 Web 端的可用性:

  • 资产上传与查看:支持视频和照片的上传、查看、下载到本地设备
  • 自动备份:打开应用时自动备份,可选择性指定备份相册
  • 去重机制:上传过程中自动检测并防止资产重复
  • RAW 格式支持:完整支持各类相机 RAW 文件
  • 元数据浏览:查看 EXIF 信息和地图位置
  • 多维度搜索:支持基于元数据、对象、人脸以及 CLIP 模型的语义搜索
  • 多用户体系:支持多用户、OAuth 登录、API Keys 管理
  • 相册与共享:普通相册、共享相册、公开分享、伙伴共享
  • LivePhoto / MotionPhoto:完整备份与回放支持
  • 360 度图像:Web 端支持全景图显示
  • 存储结构:用户可自定义存储路径布局
  • 地理与时间轴:全局地图视图、「N 年前的今天」回忆功能
  • 人脸识别:自动识别人脸并进行聚类分组
  • 组织功能:归档、收藏、只读相册、堆叠照片、标签、文件夹视图
  • 体验优化:可拖动滚动条、虚拟滚动、离线支持

架构与管理

Web 端提供完整的管理功能,包括用户管理、标签、文件夹视图与 API Keys 配置;移动端则侧重备份、共享和离线访问体验。

资源链接

  • 文档主页:https://docs.immich.app/
  • 项目介绍:https://docs.immich.app/overview/introduction
  • 安装指南:https://docs.immich.app/install/requirements
  • 路线图:https://immich.app/roadmap
  • 翻译协作:https://docs.immich.app/developer/translations
  • 贡献指南:https://docs.immich.app/overview/support-the-project

本地化支持

项目已支持简体中文、正體中文、繁體中文等二十余种语言,翻译工作通过 Weblate 协作平台进行,欢迎社区贡献者参与改进。

摘要更新于 2026-08-18 00:32:01 · 原文 5957 字符 · md5 c369ad016dc2…