README 未给出安装命令,需按官方文档部署;官方强调务必遵循 3-2-1 备份策略,不要把它当唯一备份;部分功能仅 Web 端提供(如标签、用户管理),移动端没有。
immich
immich-appAGPL-3.0活跃维护自托管的照片和视频管理方案,可替代 Google Photos,支持自动备份、相册浏览和移动端同步,数据完全掌握在自己手里。
High performance self-hosted photo and video management solution.
详见 https://docs.immich.app/install/requirementsREADME 未说明具体硬件与显存要求,安装要求见官方文档 install/requirements 页面。
高性能自托管照片视频管理方案,把手机相册搬回自己服务器
自托管的照片和视频管理方案,可替代 Google Photos,支持自动备份、相册浏览和移动端同步,数据完全掌握在自己手里。
核心能力
- 移动端打开应用即自动备份,可选相册备份
- 按元数据、物体、人脸和 CLIP 搜索照片
- 人脸识别与聚类,自动生成人物相册
- 支持 RAW 格式与 LivePhoto/MotionPhoto 备份播放
- 多用户、共享相册、Partner Sharing 与公开分享
容易踩的坑
- v3.4.0-rc.3pre-release2026-11-06 · 2026-11-06 20:44 UTC
查看更新说明
v3.4.0-rc.3
[!WARNING]
Disclaimer
This is a release candidate, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version.
Welcome to the third release candidate of
v3.4;v3.4.0-rc.3! This release brings passkeys support to mobile and also improves the FUTO Backups integration for those of you already using it. Keep reading below for the draft release notes and instructions on how to run this release candidate.Release notes
Work-in-progress release notes can be found here:
https://pr-934.dev.immich.app/blog/v3.4.0-release
Machine Learning
Set
MACHINE_LEARNING_MODEL_REVISION=v2to take full advantage of the memory usage and performance improvements in this release.Server
To use this RC version on the server, update the
IMMICH_VERSIONin your.envfile:IMMICH_VERSION=v3.4.0-rc.3or
IMMICH_VERSION=v3-rcThen pull and restart:
docker compose pull && docker compose up -dMobile
To use this RC version on the mobile app, follow the appropriate link for your platform:
Android
You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page
iOS
The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd
If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!
And as always, bugs are fixed, and many other improvements also come with this release.
What's Changed
🚀 Features
- feat(mobile): passkeys by @santoshakil in https://github.com/immich-app/immich/pull/33005
🌟 Enhancements
- feat: keyboard shortcuts for person page by @enVolt in https://github.com/immich-app/immich/pull/31679
New Contributors
- @enVolt made their first contribution in https://github.com/immich-app/immich/pull/31679
Full Changelog: https://github.com/immich-app/immich/compare/v3.4.0-rc.2...v3.4.0-rc.3
- v3.4.0-rc.2pre-release2026-11-04 · 2026-11-04 21:47 UTC
查看更新说明
v3.4.0-rc.2
[!WARNING]
Disclaimer
This is a release candidate, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version.
Welcome to the second release candidate of
v3.4;v3.4.0-rc.2! This release exclusively contains bug fixes. Keep reading below for the draft release notes and instructions on how to run this release candidate.Release notes
Work-in-progress release notes can be found here:
https://pr-934.dev.immich.app/blog/v3.4.0-release
Machine Learning
Set
MACHINE_LEARNING_MODEL_REVISION=v2to take full advantage of the memory usage and performance improvements in this release.Server
To use this RC version on the server, update the
IMMICH_VERSIONin your.envfile:IMMICH_VERSION=v3.4.0-rc.2or
IMMICH_VERSION=v3-rcThen pull and restart:
docker compose pull && docker compose up -dMobile
To use this RC version on the mobile app, follow the appropriate link for your platform:
Android
You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page
iOS
The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd
If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!
And as always, bugs are fixed, and many other improvements also come with this release.
What's Changed
🐛 Bug fixes
- fix(mobile): show 10-bit heic and avif originals on ios by @santoshakil in https://github.com/immich-app/immich/pull/32821
- fix(server): keep ocr search text after edits and thumbnail regeneration by @Shadi-Alrashoodi in https://github.com/immich-app/immich/pull/32577
- fix: font loading by @danieldietzler in https://github.com/immich-app/immich/pull/32873
- fix: remove asset from album doesn't resize the timeline by @alextran1502 in https://github.com/immich-app/immich/pull/32856
- fix: web worker import by @danieldietzler in https://github.com/immich-app/immich/pull/32876
- fix: oauth regressions by @danieldietzler in https://github.com/immich-app/immich/pull/32934
- fix: web error handler by @danieldietzler in https://github.com/immich-app/immich/pull/32935
- fix: people page websockets by @danieldietzler in https://github.com/immich-app/immich/pull/32940
- fix(ml): disable onnxruntime telemetry by @mjkent in https://github.com/immich-app/immich/pull/32956
- fix(server): read only valid ISO values by @Snowknight26 in https://github.com/immich-app/immich/pull/32938
- fix(server): validate motion photo video range before extraction by @bo0tzz in https://github.com/immich-app/immich/pull/32931
- fix(web): scroll memory by @danieldietzler in https://github.com/immich-app/immich/pull/32964
- fix(mobile): log out before resetting the local database by @santoshakil in https://github.com/immich-app/immich/pull/32928
- fix: asset viewer reactivity by @danieldietzler in https://github.com/immich-app/immich/pull/32978
New Contributors
- @Shadi-Alrashoodi made their first contribution in https://github.com/immich-app/immich/pull/32577
- @mjkent made their first contribution in https://github.com/immich-app/immich/pull/32956
- @medienbaecker made their first contribution in https://github.com/immich-app/immich/pull/32946
Full Changelog: https://github.com/immich-app/immich/compare/v3.4.0-rc.1...v3.4.0-rc.2
- v3.3.6最新正式版2026-11-04 · 2026-11-04 17:24 UTC
Unfortunately we missed that onnxruntime enabled telemetry by default in a recent release, resulting in the ML container automatically sending anonymous metric data to Microsoft. We have now disabled it. Apologies to everyone that we did not catch this change immediately, and thanks to our community for flagging it!
What's Changed
🐛 Bug fixes
- fix(ml): disable onnxruntime telemetry by @mjkent in https://github.com/immich-app/immich/pull/32956
New Contributors
- @mjkent made their first contribution in https://github.com/immich-app/immich/pull/32956
Full Changelog: https://github.com/immich-app/immich/compare/v3.3.5...v3.3.6
- v3.4.0-rc.1pre-release2026-10-30 · 2026-10-30 17:53 UTC
查看更新说明
v3.4.0-rc.1
[!WARNING]
Disclaimer
This is a release candidate, not a stable release. It is subject to change and may contain bugs or breaking changes. As always, make sure you have a backup of your database and library before upgrading to this version.
Welcome to the first release candidate of
v3.4;v3.4.0-rc.1(yeah yeah, we had to sacrifice a release again)! Keep reading below for the draft release notes and instructions on how to run this release candidate.Release notes
Work-in-progress release notes can be found here:
https://pr-934.dev.immich.app/blog/v3.4.0-release
Server
To use this RC version on the server, update the
IMMICH_VERSIONin your.envfile:IMMICH_VERSION=v3.4.0-rc.1or
IMMICH_VERSION=v3-rcThen pull and restart:
docker compose pull && docker compose up -dMobile
To use this RC version on the mobile app, follow the appropriate link for your platform:
Android
You can download the APK in the release note below, or tap on "Join the beta" from the Google Play Immich page
iOS
The iOS app is available via Testflight: https://testflight.apple.com/join/JTSTucBd
If you run into any issues, please report them on GitHub so we can address them before the final release. Thank you for helping us test!
And as always, bugs are fixed, and many other improvements also come with this release.
What's Changed
🔒 Security
- fix(server): apply shared link metadata visibility in asset mapper by @bo0tzz in https://github.com/immich-app/immich/pull/32561
- fix(server): anchor plugin allowedHosts matching by @bo0tzz in https://github.com/immich-app/immich/pull/32560
- fix(server): require upload access for checksum duplicate check by @bo0tzz in https://github.com/immich-app/immich/pull/32559
- fix(server): escape template variables in custom email templates by @bo0tzz in https://github.com/immich-app/immich/pull/32563
- fix(cli): only act on files that were sent in the bulk upload check by @bo0tzz in https://github.com/immich-app/immich/pull/32564
- fix(server): restrict partner timeline requests to timeline assets by @bo0tzz in https://github.com/immich-app/immich/pull/32565
- fix(server): sanitize EXIF template variables and tighten storage path check by @bo0tzz in https://github.com/immich-app/immich/pull/32566
- fix(server): only serve edited assets to shared links in archive downloads by @bo0tzz in https://github.com/immich-app/immich/pull/32562
- fix(server): only set OAuth cookies for server-generated state by @bo0tzz in https://github.com/immich-app/immich/pull/32600
- fix(server): do not expose album members to shared link viewers by @bo0tzz in https://github.com/immich-app/immich/pull/32607
- fix(server): dont follow symlinks by @etnoy in https://github.com/immich-app/immich/pull/32614
- fix(server): exclude partners' locked assets from legacy search by @bo0tzz in https://github.com/immich-app/immich/pull/32604
- feat(server): remove deprecated password field from update-me by @bo0tzz in https://github.com/immich-app/immich/pull/32623
- fix(server): require update access on the motion video when linking a live photo by @bo0tzz in https://github.com/immich-app/immich/pull/32606
- feat: inline hashes in helmet CSP by @bo0tzz in https://github.com/immich-app/immich/pull/30529
- fix(server): scope duplicate group resolution to the caller's assets by @bo0tzz in https://github.com/immich-app/immich/pull/32603
🚀 Features
- feat: option for mobile smooth timeline scrubbing by @TiDeane in https://github.com/immich-app/immich/pull/32552
- feat: pas
- v3.3.52026-10-21 · 2026-10-21 18:12 UTC
查看更新说明
[!CAUTION] This version contains a fix for today's CA compromise (https://emudhra.we-have-a-problem.com/) as well as some nodejs security patches. While we don't believe this compromise brings an immediate danger to Immich instances, we still recommend that you update as soon as possible.
What's Changed
🔒 Security
- chore(deps): update python docker digests by @bo0tzz in https://github.com/immich-app/immich/pull/32635
- chore(deps): update dependency certifi to v2026.10.19 by @bo0tzz in https://github.com/immich-app/immich/pull/32636
Full Changelog: https://github.com/immich-app/immich/compare/v3.3.4...v3.3.5
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
[!WARNING] ⚠️ Always follow 3-2-1 backup plan for your precious photos and videos!
[!NOTE] You can find the main documentation, including installation guides, at https://immich.app/.
Links
Demo
Access the demo here. For the mobile app, you can use https://demo.immich.app for the Server Endpoint URL.
Login credentials
| Password | |
|---|---|
| [email protected] | demo |
Features
| Features | Mobile | Web |
|---|---|---|
| Upload and view videos and photos | Yes | Yes |
| Auto backup when the app is opened | Yes | N/A |
| Prevent duplication of assets | Yes | Yes |
| Selective album(s) for backup | Yes | N/A |
| Download photos and videos to local device | Yes | Yes |
| Multi-user support | Yes | Yes |
| Album and Shared albums | Yes | Yes |
| Scrubbable/draggable scrollbar | Yes | Yes |
| Support raw formats | Yes | Yes |
| Metadata view (EXIF, map) | Yes | Yes |
| Search by metadata, objects, faces, and CLIP | Yes | Yes |
| Administrative functions (user management) | No | Yes |
| Background backup | Yes | N/A |
| Virtual scroll | Yes | Yes |
| OAuth support | Yes | Yes |
| API Keys | N/A | Yes |
| LivePhoto/MotionPhoto backup and playback | Yes | Yes |
| Support 360 degree image display | No | Yes |
| User-defined storage structure | Yes | Yes |
| Public Sharing | Yes | Yes |
| Archive and Favorites | Yes | Yes |
| Global Map | Yes | Yes |
| Partner Sharing | Yes | Yes |
| Facial recognition and clustering | Yes | Yes |
| Memories (x years ago) | Yes | Yes |
| Offline support | Yes | No |
| Read-only gallery | Yes | Yes |
| Stacked Photos | Yes | Yes |
| Tags | No | Yes |
| Folder View | Yes | Yes |
Translations
Read more about translations here.