immich

immich-appAGPL-3.0活跃维护

自托管的照片和视频管理方案,可替代 Google Photos,支持自动备份、相册浏览和移动端同步,数据完全掌握在自己手里。

High performance self-hosted photo and video management solution.

v3.3.6发布于 2026-11-04 17:24 UTC118,701star +276 / 7 天7,548fork同步于 2026-11-10 17:17 UTC

怎么上手

由 README 提炼,执行前请确认
详见 https://docs.immich.app/install/requirements
硬件要求按 README 说明

README 未说明具体硬件与显存要求,安装要求见官方文档 install/requirements 页面。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

高性能自托管照片视频管理方案,把手机相册搬回自己服务器

自托管的照片和视频管理方案,可替代 Google Photos,支持自动备份、相册浏览和移动端同步,数据完全掌握在自己手里。

核心能力

  • 移动端打开应用即自动备份,可选相册备份
  • 按元数据、物体、人脸和 CLIP 搜索照片
  • 人脸识别与聚类,自动生成人物相册
  • 支持 RAW 格式与 LivePhoto/MotionPhoto 备份播放
  • 多用户、共享相册、Partner Sharing 与公开分享

容易踩的坑

README 未给出安装命令,需按官方文档部署;官方强调务必遵循 3-2-1 备份策略,不要把它当唯一备份;部分功能仅 Web 端提供(如标签、用户管理),移动端没有。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v3.3.6
  1. 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=v2 to 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_VERSION in your .env file:

    IMMICH_VERSION=v3.4.0-rc.3
    

    or

    IMMICH_VERSION=v3-rc
    

    Then pull and restart:

    docker compose pull && docker compose up -d
    

    Mobile

    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

    🌟 Enhancements

    New Contributors

    Full Changelog: https://github.com/immich-app/immich/compare/v3.4.0-rc.2...v3.4.0-rc.3

  2. 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=v2 to 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_VERSION in your .env file:

    IMMICH_VERSION=v3.4.0-rc.2
    

    or

    IMMICH_VERSION=v3-rc
    

    Then pull and restart:

    docker compose pull && docker compose up -d
    

    Mobile

    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

    New Contributors

    Full Changelog: https://github.com/immich-app/immich/compare/v3.4.0-rc.1...v3.4.0-rc.2

  3. 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

    New Contributors

    Full Changelog: https://github.com/immich-app/immich/compare/v3.3.5...v3.3.6

  4. 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_VERSION in your .env file:

    IMMICH_VERSION=v3.4.0-rc.1
    

    or

    IMMICH_VERSION=v3-rc
    

    Then pull and restart:

    docker compose pull && docker compose up -d
    

    Mobile

    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

    🚀 Features

  5. 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.

    https://xkcd.com/221/

    What's Changed

    🔒 Security

    Full Changelog: https://github.com/immich-app/immich/compare/v3.3.4...v3.3.5

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    [!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

    EmailPassword
    [email protected]demo

    Features

    FeaturesMobileWeb
    Upload and view videos and photosYesYes
    Auto backup when the app is openedYesN/A
    Prevent duplication of assetsYesYes
    Selective album(s) for backupYesN/A
    Download photos and videos to local deviceYesYes
    Multi-user supportYesYes
    Album and Shared albumsYesYes
    Scrubbable/draggable scrollbarYesYes
    Support raw formatsYesYes
    Metadata view (EXIF, map)YesYes
    Search by metadata, objects, faces, and CLIPYesYes
    Administrative functions (user management)NoYes
    Background backupYesN/A
    Virtual scrollYesYes
    OAuth supportYesYes
    API KeysN/AYes
    LivePhoto/MotionPhoto backup and playbackYesYes
    Support 360 degree image displayNoYes
    User-defined storage structureYesYes
    Public SharingYesYes
    Archive and FavoritesYesYes
    Global MapYesYes
    Partner SharingYesYes
    Facial recognition and clusteringYesYes
    Memories (x years ago)YesYes
    Offline supportYesNo
    Read-only galleryYesYes
    Stacked PhotosYesYes
    TagsNoYes
    Folder ViewYesYes

    Translations

    Read more about translations here.

    Repository activity

    Activities

    Contributors