2025-01-09 03:37:33 +00:00

137 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Immich
Immich - 高性能自托管照片和视频备份解决方案
![Immich](https://file.lifebus.top/imgs/immich_cover.png)
![](https://img.shields.io/badge/%E6%96%B0%E7%96%86%E8%90%8C%E6%A3%AE%E8%BD%AF%E4%BB%B6%E5%BC%80%E5%8F%91%E5%B7%A5%E4%BD%9C%E5%AE%A4-%E6%8F%90%E4%BE%9B%E6%8A%80%E6%9C%AF%E6%94%AF%E6%8C%81-blue)
## 硬件支持
+ 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>
---
![Ms Studio](https://file.lifebus.top/imgs/ms_blank_001.png)