# Immich
Immich - 高性能自托管照片和视频备份解决方案
## 硬件支持
+ RAM：最小 4GB，建议 6GB。
+ CPU：最少 2 核，建议 4 核。
+ 存储：推荐使用支持用户/组所有权和权限的 Unix 兼容文件系统（EXT4、ZFS、APFS 等）。
+ 缩略图和转码视频的生成可以使照片库的平均大小增加 10-20%。
## 简介
> 该版本无 `机器学习` 模块，适用于不具备硬件条件的用户。
>
> 您将无法使用 `机器学习` 功能，如 `CLIP`、`人脸识别` 等功能。
>
> 如果您需要 `机器学习` 模块，可通过配置远端 `机器学习` 服务来使用。
欢迎您
您好，很高兴您能来到这里。
我叫亚历克斯。我在学校时是一名电气工程师，后来因为工作和对解决问题的纯粹热爱而成为了一名软件工程师。
我们和新生儿躺在床上，我妻子说："我们开始积累大量宝宝的照片和视频，我不想再为 App-Which-Must-Not-Be-Name
付费了。你总是想为我建一些东西，为什么不为我建一个能做到这一点的应用程序呢？
就这样，这个想法开始在我脑海中萌生。之后，我开始在自助托管领域寻找具有类似备份功能和 "非命名应用程序 "
性能水平的现有解决方案。我发现目前的解决方案主要集中在画廊类型的应用程序上。然而，我想要的是一个简单易用的备份工具，并带有一个能高效查看照片和视频的本地移动应用程序。于是，我作为一名如饥似渴的工程师踏上了寻找之旅。
另一个促使我执行 "不可名状的应用程序 "替代方案的动机是，我希望能为开源社区做出贡献，多年来我从这个社区中受益匪浅。
我很荣幸能与大家分享这一作品，它重视隐私、回忆，以及在易用、友好的界面中回顾这些时刻的喜悦。
如果您喜欢这款应用程序，或者它在某些方面对您有帮助，请考虑支持这个项目。这将有助于我继续开发和维护应用程序。
## 环境准备
+ `Redis` 服务
Immich 使用 Redis 作为缓存服务，所以需要安装 Redis 服务。
### 硬件驱动挂载
默认仅挂载: `/dev/dri`,如果您的设备不存在硬件驱动，请使用删除完整 `devices` 配置。
可以通过 `ls /dev/` 查看存在的设备驱动。
```yml
devices:
- /dev/dri:/dev/dri
# - /dev/nvidia0:/dev/nvidia0
# - /dev/nvidiactl:/dev/nvidiactl
# - /dev/nvidia-modeset:/dev/nvidia-modeset
# - /dev/nvidia-nvswitchctl:/dev/nvidia-nvswitchctl
# - /dev/nvidia-uvm:/dev/nvidia-uvm
# - /dev/nvidia-uvm-tools:/dev/nvidia-uvm-tools
# - /dev/video11:/dev/video11
```
如果您的设备存在其他硬件驱动，可以选择挂载。删除 `# ` 号即可。格式为：`宿主机路径:容器路径`。
格式请与 `- /dev/dri:/dev/dri` 保持一致。
## 升级说明
+ **大版本** `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` 服务
## 移动端应用
<div style="text-align: center; display: flex; justify-content: center; gap: 20px;">
<div style="display: flex; flex-direction: column; align-items: center;">
<img src="https://file.lifebus.top/imgs/immich_app_store_qr.png" alt="App Store" style="width: 256px;">
<a href="https://apps.apple.com/sg/app/immich/id1613945652" style="text-align: center;">App Store</a>
</div>
<div style="display: flex; flex-direction: column; align-items: center;">
<img src="https://file.lifebus.top/imgs/immich_google_play_qr.png" alt="Google Play" style="width: 256px;">
<a href="https://play.google.com/store/apps/details?id=app.alextran.immich" style="text-align: center;">Google Play</a>
</div>
</div>
---
