# Immich

Immich - 高性能自托管照片和视频备份解决方案

![Immich](https://file.lifebus.top/imgs/immich_cover.png)

## 简介

欢迎您
您好，很高兴您能来到这里。

我叫亚历克斯。我在学校时是一名电气工程师，后来因为工作和对解决问题的纯粹热爱而成为了一名软件工程师。

我们和新生儿躺在床上，我妻子说："我们开始积累大量宝宝的照片和视频，我不想再为 App-Which-Must-Not-Be-Name
付费了。你总是想为我建一些东西，为什么不为我建一个能做到这一点的应用程序呢？

就这样，这个想法开始在我脑海中萌生。之后，我开始在自助托管领域寻找具有类似备份功能和 "非命名应用程序 "
性能水平的现有解决方案。我发现目前的解决方案主要集中在画廊类型的应用程序上。然而，我想要的是一个简单易用的备份工具，并带有一个能高效查看照片和视频的本地移动应用程序。于是，我作为一名如饥似渴的工程师踏上了寻找之旅。

另一个促使我执行 "不可名状的应用程序 "替代方案的动机是，我希望能为开源社区做出贡献，多年来我从这个社区中受益匪浅。

我很荣幸能与大家分享这一作品，它重视隐私、回忆，以及在易用、友好的界面中回顾这些时刻的喜悦。

如果您喜欢这款应用程序，或者它在某些方面对您有帮助，请考虑支持这个项目。这将有助于我继续开发和维护应用程序。

## 环境准备

+ `Redis` 服务

Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。

## 升级说明

+ **大版本** `v1.106.2`

`2024/06/12` 上线，升级需要注意：

1. 移除 `immich-microservices` 服务
2. 环境变量发生了合并
3. 底层API发生了变化
    4. 移动端需要同步更新

## 安装参数

### 机器学习 预加载模型(CLIP)

可选模型列表，粘贴时输入 `immich-app/` 之后的内容即可。

[immich-app's Collections - CLIP](https://huggingface.co/collections/immich-app/clip-654eaefb077425890874cd07)

[immich-app's Collections - Multilingual CLIP](https://huggingface.co/collections/immich-app/multilingual-clip-654eb08c2382f591eeb8c2a7)

默认模型

中文支持较好的模型 `XLM-Roberta-Large-Vit-B-16Plus`

### 人脸识别 预加载模型

`buffalo_l`, `buffalo_m`, `buffalo_s`, `antelopev2`

## 常见问题

+ 安装失败
    + 网络问题，可以尝试使用代理
+ 升级失败
    + 请查看升级说明
    + 请查看日志，查看具体错误信息
    + 记录安装参数，进行卸载重装
    + 升级1Panel后,提示容器找不到
        + 请删除容器,重新安装
        + 提示文件或目录不存在
            + 可手动创建不存在的文件和目录，然后重试
            + 创建的文件可为空文件
    + 每次都升级失败
        + 很抱歉，官方应用不支持编排式应用(一个应用包含多个容器)的安装与升级，您可以尝试手动卸载安装最新版
+ 无法访问
    + 请检查是否安装了 `Redis` 服务
    + 请检查是否正确配置了 `Redis` 服务
    + 请检查是否正确配置了 `域名` 和 `SSL`
    + 请检查是否正确配置了 `端口`
    + 请检查是否正确配置了 `防火墙` 并开放了 `端口`
    + 请检查是否正确配置了 `Nginx` 服务