跳转到主要内容

系统设置

管理员用户可以在这里管理 Immich 实例的设置。

提示

您可以随时通过点击重置为默认按钮返回默认设置。

身份验证设置​

管理密码、OAuth 和其他身份验证设置

OAuth 身份验证​

Immich 支持 OAuth 身份验证。关于此功能及其配置的更多信息，请查看此处。

密码身份验证​

管理员可以选择禁用整个实例的用户名和密码登录。这意味着任何人，包括系统管理员，都无法使用此方法登录。如果 OAuth 身份验证 也被禁用，则没有用户可以使用任何方法登录。更改此设置不会影响现有会话，仅影响新的登录尝试。

提示

您可以随时使用服务器 CLI重新启用密码登录。

图像设置（缩略图和预览）​

  • 缩略图 - 用于主时间线。
  • 预览 - 用于资产查看器。

默认情况下，Immich 为每个资产创建3种缩略图， 模糊的（thumbhash）, 小缩略图（webp） 和大预览（jpeg/webp），使用这些设置您可以更改创建的缩略图和预览文件的质量。

缩略图格式 允许您选择缩略图图像的格式类型，Webp 比 jpeg 文件小，但编码速度较慢。

提示

您可以在 Adobe 的网站 上详细了解使用 webp 而非 jpeg 的优缺点。

缩略图分辨率 用于查看照片组（主时间线，专辑视图等）。较高分辨率可以保留更多细节但编码时间更长，文件大小更大，并可能降低应用响应速度。

预览格式 允许您选择预览图像的格式类型，Webp 比 jpeg 文件小，但编码速度较慢。

预览分辨率 用于单张照片的查看和机器学习。较高分辨率可以保留更多细节但编码时间更长，文件大小更大，并可能降低应用响应速度。

质量 图像质量从 1-100。数值越高图像质量越好但会产生较大的文件，此选项会影响预览和缩略图图像。

优先使用宽色域 为缩略图使用 Display P3。这可以更好地保留宽色域图像的鲜艳度，但在使用旧设备和旧浏览器版本时图像可能显示不一样。sRGB 图像将保持为 sRGB 以避免颜色转换。

优先使用嵌入式预览 在处理图像时优先使用 RAW 照片中的嵌入式预览作为输入（如果可用）。这可以为某些图像提供更准确的颜色，但预览质量取决于相机，可能会有更多的压缩伪影。

提示

可以将大缩略图的默认分辨率从 1440p（默认）降低到 1080p 或 720p 以节省存储空间。

工作设置​

通过这些设置，您可以确定每个任务在微服务中并发运行的工作量。一些任务可以在硬件强大的计算机以及 IO 性能良好的存储设备上设置更高的值。

并发更高时，主机将会同时处理更多资产， 这种建议提高的是吞吐量，而不是延迟。例如，它可以让智能搜索任务处理得更快，但不会加快搜索速度。

重要的是要记住，像智能搜索、面部检测、面部识别和视频转码这样的工作需要大量的处理能力，因此不要将工作数量设置得过高，否则可能会导致服务器完全过载。

重要事项

如果将并发从我们设置的默认值提高，尤其是为缩略图生成设置，确保您不要将数量增加到您可用的 CPU 核心数量以上。 这样做可能会影响 API 响应速度，但无法提高缩略图生成速度。

面部识别并发

面部识别并发值无法更改，因为 DBSCAN 通常是顺序处理的，但也有一些并行的实现。我们的实现不是并行的。

外部库​

库监视（实验性）​

外部库可以在无需完整扫描的情况下自动导入更改的文件。只要操作系统报告文件更改，就会导入该文件。如果您的照片是通过网络挂载的，则此功能无法正常工作。

定期扫描​

您可以在管理 -> 设置 -> 库下定义触发外部库重新扫描的自定义时间间隔。 您可以使用预设或 cron 格式设置扫描间隔。有关更多信息，请参考例如 Crontab Guru。

日志记录​

Immich 的默认日志级别是 Log（通常称为 Info）。Immich 管理员可以根据个人喜好或 Immich 支持团队的要求选择更高或更低的日志级别。

机器学习设置​

通过此设置，您可以管理 Immich 中与机器学习相关的所有设置，从远程机器学习设置到模型及其参数 您可以选择禁用某种类型的机器学习，例如智能搜索或面部识别。

URL​

默认情况下内置机器学习服务器 (http://immich-machine-learning:3003) 将被配置，但您可以更改此设置或添加其他服务器。

将在具有更强 GPU 的设备上托管 immich-machine-learning 容器，有助于处理大量照片（例如批量导入期间）或实现更快的搜索。

如果提供多个 URL，每个服务器将一次尝试一个，直到其中一个成功响应为止，按从第一个到最后一个的顺序进行。无法响应的服务器将在重新上线前被暂时忽略。

智能搜索​

智能搜索设置允许您更改CLIP模型。较大的模型通常会提供更准确的搜索结果，但会消耗更多处理能力和内存。在更换CLIP模型时，必须对所有图像重新运行智能搜索任务以完全应用更改。

网络连接

更改模型需要连接到互联网以下载模型。 下载后 Immich 不需要连接网络 除非启用设置中的版本检测。

重复检测​

使用 CLIP 嵌入查找可能的重复。可以配置最大检测距离以提高/减少检测准确度。

  • 最大检测距离 - 两张图片之间的最大距离以将它们视为重复的范围，从 0.001-0.1。较高值将检测更多重复项，但可能导致误报。

面部识别​

通过这些设置，您可以更改面部识别设置 可编辑设置：

  • 面部识别模型
  • 检测得分最低值
  • 最大识别距离
  • 识别出的面部最低数量

您可以在面部识别页面上了解更多关于这些选项的信息。

信息

在更改检测得分最低值、最大识别距离和识别出的面部最低数量的值时。 您必须重新启动仅限工作面部识别 - 全部。

如果您替换了面部识别模型，需要运行工作面部检测 - 全部。

相同的双胞胎

如果您有双胞胎，可能需要降低最大识别距离值，稍微减少该值可以让系统区分他们。

地图和 GPS 设置​

地图设置​

通过这些设置，您可以根据个人喜好以及支持的选项更改地图在夜间和白天模式下的外观。 地图可以通过OpenMapTiles进行调整，例如。

逆地理编码设置​

Immich 支持使用 GeoNames 地理数据库的逆地理编码。

通知设置​

SMTP 服务器设置，用于用户创建通知、新专辑等。更多信息可参见这里。

通知模板​

使用通知模板覆盖默认通知文本。更多信息可参见这里。

服务器设置​

外部域名​

覆盖共享链接和电子邮件通知中的域名。URL 不应包含尾部斜杠。

欢迎消息​

管理员可以在登录页面设置自定义消息（该消息将显示给所有用户）。

存储模板​

Immich 支持自定义存储模板。通过这里了解此功能及其配置。

主题设置​

您可以编写自定义 CSS 供所有用户在 web 应用程序中加载。这使管理员能够更改字体、颜色和其他样式。

例如：

自定义 CSS
p {
  color: green;
}

回收站设置​

在系统管理员的选项中可以为已删除文件设置一个回收站，这些文件将在删除日期后保留 30 天（默认）或由系统管理员定义的时间。

可以禁用回收站，但这不推荐，因为未来删除的文件将永久删除。

快速永久删除的键盘快捷键

您可以从时间线上选择资产并按 Ctrl + Del 进行快速永久删除，而不使用回收站选项。

用户设置​

删除延迟​

系统管理员可以通过管理面板选择删除用户，系统管理员可以立即删除用户，也可以选择延迟删除用户（默认7天）。此操作将永久删除用户的账户和资源。用户删除任务将在午夜运行以检查准备删除的用户。对此设置的更改将在下次执行时生效。

版本检查​

启用此选项时，immich-server将定期向GitHub发送请求以检查新版本。

视频转码设置​

系统管理员可以配置哪些视频文件将被转换为不同格式。可以深入更改设置，要了解此处使用术语的更多信息，请参阅FFmpeg有关 H.264 编解码器、HEVC 编解码器和 VP9 编解码器的文档。

视频文件的哪些流将被转码由转码策略决定。转码的流使用以下设置（配置文件名称在括号中）。未转码的流保持原始设置不变。

支持的容器格式 (ffmpeg.acceptedContainers)​

如果视频资产的容器格式不在此列表中，即使没有流需要转码，也会将其重新混流为MP4。

默认支持的容器格式为 mov、ogg 和 webm。

预设 (ffmpeg.preset)​

转码时投入的“计算工作量”。这些使用H.264的预设名称，并将被转换为针对不同方式配置工作量的编码器的适当值。

默认值是 ultrafast。

音频编解码器 (ffmpeg.targetAudioCodec)​

在转码音频流时使用的音频编解码器。可以是 mp3、aac 或 libopus。

默认值是 aac。

视频编解码器 (ffmpeg.targetVideoCodec)​

在转码视频流时使用的视频编解码器。可以是 h264、hevc、vp9 或 av1。

默认值是 h264。

目标分辨率 (ffmpeg.targetResolution)​

转码视频流时，将最大尺寸缩小到此值，同时保持宽高比。视频永远不会被放大。

默认值是 720。

转码策略 (ffmpeg.transcode)​

转码策略配置视频资产的哪些流将被转码。针对视频流和音频流独立做出转码决定。这意味着如果一个视频流需要转码，而音频流不需要，那么视频流将被转码，而音频流将被复制。如果转码策略不要求任何流需要转码且不要求视频重新混流，则不会创建单独的视频文件。

默认策略是 required。

所有视频 (all)​

视频总是被转码。这确保了视频播放的一致性。

不转码任何视频 (disabled)​

视频从不转码。这节省了服务器上的空间和资源，但可能会阻止在不支持源格式的设备（尤其是网络浏览器）上播放，或者在播放高比特率文件时导致高带宽使用。

仅转码不在支持格式中的视频 (required)​

满足以下任一条件时，视频流将被转码：

  • 视频为HDR。
  • 视频不是yuv420p像素格式。
  • 视频编解码器不在 acceptedVideoCodecs 中。

如果音频编解码器不在 acceptedAudioCodecs 中，则音频将被转码。

超过最大比特率或不在支持格式中的视频 (bitrate)​

除了 required 中的条件外，如果视频流的比特率超过 maxBitrate，也会被转码。

分辨率高于目标分辨率或不在支持格式中的视频 (optimal)​

除了 required 中的条件外，如果视频的水平和垂直尺寸都高于目标分辨率，则视频流也会被转码。