Vault 资讯瀑布官方2026.07.29 22:20 UTC+8

immich-app/immich 发布 v3.1.0

Immich v3.1.0 发布,带来上传唤醒锁、撤销归档、按服务器路径筛选资产、OIDC 角色声明同步改进等多项优化与修复。

欢迎使用 Immich v3.1.0

本次发布包含多项生活质量改进和又一轮错误修复。请继续阅读以下完整亮点。

亮点

  • 上传唤醒锁(Web)
  • 撤销归档(Web)
  • 按服务器文件路径筛选资产(工作流)
  • 快速导航至维护页面(Web)
  • 改进幻灯片按钮可访问性(Web)
  • OIDC 角色声明同步改进(OAuth)
  • 密码重置时使会话失效(admin-cli)

上传唤醒锁(Web)

与移动端类似,Web 应用现在会自动获取唤醒锁,以防止上传过程中屏幕变暗。此功能需要 HTTPS 连接。

撤销归档(Web)

归档资产后,成功通知现在提供“撤销”按钮以撤销操作。

Undo button on success notification

按服务器文件路径筛选资产(工作流)

资产文件筛选器新增“使用路径”选项。设置为 true 时,将基于服务器上的实际路径进行筛选,而非原始文件名。

按 EXIF 元数据筛选资产(工作流)

新增了一个工作流筛选器,允许你根据资产的 EXIF 元数据字段进行筛选。目前仅支持字符串比较,数值比较预计很快推出。

快速导航至维护页面(Web)

命令面板(CTRL+K/)现在包含维护页面的条目。

改进幻灯片按钮可见性(Web)

Web 上的幻灯片按钮现在被包裹在带有背景模糊的容器中,使它们在当前资产非常亮时更容易查看。

Slideshow controls on a low contrast image

OIDC 角色声明同步改进(OAuth)

Immich 中的 OAuth 集成支持通过角色声明为新用户设置初始 isAdmin 值。此过程已更新,现在可在后续登录时同步 isAdmin。此外,角色声明现在支持单值(immich_role: 'admin')和值列表(immich_role: ["admin", "user"]),使其更加灵活。

密码重置时使会话失效(admin-cli)

使用 admin 命令行界面重置密码时,现在有一个新选项可以使现有会话失效。

immich-app/immich released v3.1.0

Welcome to Immich v3.1.0!

This release includes several quality of life improvements and another round of bug fixes. Keep reading below for the complete highlights.

Highlights

  • Upload wakelock (web)
  • Undo archive (web)
  • Filter assets by server filepath (workflows)
  • Quick navigate to maintenance page (web)
  • Better slideshow button accessibility (web)
  • OIDC role claim sync improvements (OAuth)
  • Invalidate sessions on password reset (admin-cli)

Upload wakelock (web)

Similar to mobile, the web application will now automatically acquire a wakelock to prevent the screen from dimming while uploads are happening. This feature will require an HTTPS connection.

Undo archive (web)

After archiving assets, the success notification now has an “undo” button to undo the action.

Undo button on success notification

Filter assets by server filepath (workflows)

The asset file filter has a new option “Use path”. When set to true, it will filter based on the actual path on the server rather than the original file name.

Filter assets by EXIF metadata (workflows)

A new workflow filter has been added that allows you to filter assets based on their EXIF metadata fields. For now it only supports string comparisons, with numerical comparisons expected to come soon.

Quick navigate to maintenance page (web)

The command palette (CTRL+K or /) now includes an item for the maintenance page.

Better slideshow button visibility (web)

The slideshow buttons on the web are now wrapped in a container with a backdrop blur, making them easier to view when the current asset is very light.

Slideshow controls on a low contrast image

OIDC role claim sync improvements (OAuth)

The OAuth integration in Immich supports setting an initial isAdmin value for new users via a role claim. This same process has been updated to now sync isAdmin on subsequent logins. Additionally, the role claim now supports both single values (immich_role: 'admin') in addition to lists of values ( immich_role: ["admin", "user"]), making in more flexible.

Invalidate sessions on password reset (admin-cli)

When using the admin command line interface to reset a password, there is now a new option to invalidate existing sessions.

immich-admin reset-admin-password
Found Admin:
- ID=e65e6f88-2a30-4dbe-8dd9-1885f4889b53
- OAuth ID=
- Email=admin@example.com
- Name=Immich Admin
? Please choose a new password (optional) immich-is-cool
? Invalidate existing sessions? Yes
The admin password has been updated.

Date range for map (mobile)

Similar to web, mobile now also supports filtering the map for assets within a given date range.


What's Changed

🚨 Breaking Changes

🚀 Features

🌟 Enhancements

🐛 Bug fixes

📚 Documentation

🌐 Translations

New Contributors

Full Changelog: https://github.com/immich-app/immich/compare/v3.0.3...v3.1.0

查看原始发布