Immich

Immich App是一款开源的照片、视频备份与管理工具，主打极致的隐私保护。和其他照片视频备份工具相比，用户需要自行在私有服务器或者NAS上部署并管理Immich 服务端才能正常使用，这意味着用户的所有照片和视频全部存储在用户本地服务器上，不经过任何第三方云或者官方服务器，可以最大限度保护用户的隐私安全。

Immich App还内置了先进的机器学习技术，支持AI人脸识别和物体快速搜索功能。当用户将自己的照片全部导入的时候，无需手动打标签，只需通过文字描述即可快速找到对应的照片。另外，像自动备份和多端同步、分享与协作、文件管理等功能都是应有尽有的，基本可以满足用户日常使用。

Immich使用指南

一、要求

•至少配备 6GB 内存和 2 个 CPU 核心的系统。

•Docker

二、设置服务器

步骤 1 - 下载所需文件

创建您选择的目录（例如./immich-app），用于存放docker-compose.yml和.env文件。

下载docker-compose.yml并example.env运行以下命令：

或者，您可以从浏览器下载这两个文件，并将它们移动到您创建的目录中，在这种情况下，请确保将其重命名example.env为.env.

步骤 2 - 使用自定义值填充 .env 文件

•请填写UPLOAD_LOCATION您首选的备份资产存储位置。它应该是服务器上一个具有足够可用空间的新目录。

•考虑将其更改DB_PASSWORD为自定义值。Postgres 并未公开，因此此密码仅用于本地身份验证。为避免 Docker 解析此值时出现问题，最好仅使用字符A-Za-z0-9。`.`pwgen是一个方便的工具，可用于此操作。

•取消注释该TZ=行即可设置您的时区。

•必要时填充自定义数据库信息。

步骤 3 - 启动容器

从您在步骤 1 中创建的目录（现在应该包含您的自定义docker-compose.yml文件.env）中，运行以下命令以将 Immich 作为后台服务启动：

三、登录移动应用

使用服务器端点 URL 登录移动应用程序http://:2283

四、从移动设备传输照片

•点击屏幕右上角的云图标，进入备份界面。

•您可以从备份屏幕选择要备份到 Immich 服务器的专辑。

•向下滚动到页面底部，然后点击“启用备份”按钮开始备份过程。这将上传所选相册中的所有素材。

备份时间取决于您移动设备上的照片数量。上传大量照片可能需要较长时间。为了快速开始，您可以先按照此指南选择性地上传少量照片。

您可以选择“作业队列”选项卡来查看 Immich 正在处理您的照片。

Immich常见问题

如何重置管理员密码？

可以通过在 immich-server 上运行reset-admin-password命令来重置管理员密码。

如何查看 Immich 中的所有用户列表？

您可以通过在 Immich 服务器上运行list-users命令来查看所有用户的列表。

如何更改我的个人资料图片？

查看单张照片，点击右上角的三点图标打开上下文菜单，然后选择“设置为个人资料图片”。在弹出的窗口中，使用鼠标滚轮放大图片，直到图片完全充满圆形区域。点击并拖动图片调整到您喜欢的位置。点击“保存”按钮保存更改。

移动应用上的云朵图标有什么区别？

更新后我无法登录应用程序，该怎么办？

请确认移动应用和服务器运行的版本（主版本号和次版本号）相同。

如果仍然无法登录应用，请尝试以下方法：

查看手机日志

请在网页应用上登录，确保登录凭据正确。

为什么当我离开应用时，前台备份会停止？它不应该把备份任务转移到后台吗？

前台备份和后台备份是两种独立的机制，它们之间互不通信或交互。

前台备份由用户操作控制，而后台备份则由设备操作系统控制。当应用进入后台时，后台任务的调用将委托给设备操作系统的调度程序。它决定后台任务何时运行以及运行多长时间。

根据设备制造商和操作系统不同，这些行为也会有所不同，但大多数都与省电策略有关。

为什么移动应用中的某些功能在使用自签名证书、基本身份验证、自定义标头或双向 TLS 时无法正常工作？

这些网络功能尚处于实验阶段。它们通常无法与视频播放、资源上传或下载以及其他功能兼容。许多此类限制已在#15230中记录。我们建议您不要使用这些实验性功能，而是使用 URL 切换功能或为您的域名申请免费的受信任 SSL 证书。

我们目前并未积极开发这些功能，也无法提供支持，但欢迎大家贡献代码来改进它们。如果您要提交较大的 PR，请务必先与我们的开发团队沟通，以免浪费您的时间。

Immich修改了文件吗？

不，Immich 不会修改原始文件。所有编辑过的元数据都会保存在配套的。xmp附属文件和数据库中。但是，当在 Immich 用户界面中清空回收站时，Immich 会删除已被删除的原始文件。

为什么我的文件名在文件管理器中显示为随机字符串？

当存储模板关闭（默认设置）时，Immich 会将文件名保存为随机字符串（也称为随机 UUID），以防止文件名重复。要恢复原始文件名，您必须启用存储模板，然后运行“存储模板迁移”作业。建议您在启用存储模板之前阅读相关文档。

我可以添加我现有的照片库吗？

是的，使用外部库。

选择新的存储模板后，现有文件会发生什么变化？

模板更改仅适用于新上传的资产。要将模板追溯应用于先前上传的资产，请运行“存储迁移作业”（可在“作业”页面找到）。

为什么只有照片不能上传到 Immich？

这种情况通常发生在 Immich 前端使用反向代理时。请确保将反向代理设置为允许处理大型请求。此外，请检查反向代理的磁盘空间。在某些情况下，代理会在转发请求之前将其缓存到磁盘，如果磁盘空间不足，请求就会失败。

如果您使用的是 Cloudflare Tunnel，请注意其文件大小上限为 100 MB，且无法更改。有时，大于此限制的文件（最大可达 1 GB）也可能可以传输。但是，官方限制为 100 MB。如果您遇到问题，我们建议您切换到其他网络部署方案。

为什么有些照片在文件系统中存储的日期是错误的？

导致这种情况的原因可能有多种。解决方法是重新运行存储迁移作业。该作业在上传后每个资产只会自动运行一次。如果元数据提取最初失败、作业被清除/取消等，则作业可能第一次没有自动运行。

如何从时间线中隐藏照片或视频？

您可以将它们归档。归档后，该资源将从主时间线和文件夹视图中隐藏，但仍会出现在搜索结果中。所有已归档的资源都可以在“归档”视图中找到。

如果一项资产存在于多个账户中会发生什么情况？

系统不要求资源在不同用户之间必须唯一。如果多个用户上传同一张图片，系统会将其视为不同的资源进行处理，并据此运行作业和生成缩略图。

为什么HDR视频在Immich播放器中看起来很苍白，但下载后看起来却正常？

Immich 使用的播放器存在已知的 HDR 色彩显示问题。我们正在尝试使用另一款播放器，该播放器能为 HDR 内容提供更好的色彩配置文件，以期在未来进行改进。

为什么 Immich 会将我的视频转码成低质量版本？

Immich始终保留您的原始文件。同时，出于兼容性和性能方面的考虑，它还会生成一个转码版本。

如何删除转码后的视频而不删除原视频？

可以通过设置转码策略使其不再需要，然后对该资源运行转码作业来删除已转码的资源版本。您可以针对单个资源执行此操作：在资源查看器选项中使用“刷新已编码视频”按钮启动单个资源的转码作业；或者，您也可以从管理页面运行所有资源的转码作业来删除所有资源。

要更新转码策略，请导航至“管理”>“视频转码设置”>“转码策略”，然后从下拉列表中选择一项策略。此策略将决定在转码作业中是删除还是覆盖现有转码。如果视频应根据此策略进行转码，则会覆盖现有转码；否则，将删除现有转码。

备份过程中是否可以压缩图像？

不。我们的设计原则是始终保持原始素材不变。

软件特色

*上传和查看资产（视频/图像）

*支持多用户

*使用拖动滚动条快速导航

*自动备份

*支持 HEIC/HEIF 备份

*提取并显示 EXIF 信息

*多设备上传事件的实时渲染

*基于ImageNet数据集的图像标记/分类

*基于 COCO SSD 的目标检测

*根据标签和 exif 数据（镜头、品牌、型号、方向）搜索资产

*使用 immich cli 工具从您的本地计算机/服务器上传资产

*从图像 exif 数据进行反向地理编码

*在地图（OpenStreetMap）上显示资产的位置信息

*在搜索页面上显示精选地点

*在搜索页面上显示精选对象

更新日志

v3.0.3版本

各种错误修复

我们已将代码推送到自己的 F-Droid 仓库中。https//app.futo.org/fdroid/repo现在，请注意：如果您正在使用 F-Droid，请从该平台下载该应用程序。

修复了LivePhotos在后台上传时无法显示的问题。