飞牛NAS安装Immich应用笔记

Choc

# 飞牛NAS安装Immich应用笔记

Immich 是一款开源的私有化照片备份与管理工具，支持手机自动上传、相册分类、人脸识别等功能。本教程演示如何在飞牛NAS系统中通过Docker部署Immich。

---

## 环境准备
1. **飞牛NAS要求**
   - 系统版本：FN OS 2.0 或更新
   - 已安装 **Docker 管理器** 应用（通过应用中心安装）
   - 建议预留至少10GB存储空间

2. **SSH访问（可选）**
   - 如习惯命令行操作，可在飞牛控制台启用SSH服务并登录

---

## 安装步骤

### 方法一：通过Docker命令行部署
1. **创建存储目录**
   - 在飞牛NAS文件管理器中新建文件夹，例如：`/sharedata/AppData/immich`
   - 在此目录下创建子文件夹：

 /app/uploads
 /app/database
 ```

2. 创建docker-compose.yml

   version: "3.8"
   
   services:
     immich-server:
       image: ghcr.io/immich-app/immich-server:release
       container_name: immich_server
       volumes:
         - /sharedata/AppData/immich/upload:/usr/src/app/upload
       env_file:
         - .env
       depends_on:
         - redis
         - database
       restart: always
   
     immich-machine-learning:
       image: ghcr.io/immich-app/immich-machine-learning:release
       container_name: immich_machine_learning
       volumes:
         - /sharedata/AppData/immich/model-cache:/cache
       env_file:
         - .env
       restart: always
   
     redis:
       image: redis:6.2-alpine
       container_name: immich_redis
       restart: always
   
     database:
       image: postgres:14-alpine
       container_name: immich_postgres
       volumes:
         - /sharedata/AppData/immich/database:/var/lib/postgresql/data
       env_file:
         - .env
       restart: always
   
   networks:
     immich:

3. 创建环境变量文件

   # .env 文件内容
   DB_HOSTNAME=immich_postgres
   DB_USERNAME=postgres
   DB_PASSWORD=your_strong_password
   DB_DATABASE_NAME=immich
   
   REDIS_HOSTNAME=immich_redis
   
   TZ=Asia/Shanghai

4. 启动容器

   cd /sharedata/AppData/immich
   docker compose up -d

---

方法二：通过Docker图形界面部署

1. 下载镜像

   • 拉取以下镜像：
     • ghcr.io/immich-app/immich-server:release
     • ghcr.io/immich-app/immich-machine-learning:release
     • redis:6.2-alpine
     • postgres:14-alpine

2. 部署PostgreSQL容器

   • 卷映射：/sharedata/AppData/immich/database → /var/lib/postgresql/data
   • 环境变量：与 .env文件一致

3. 部署Redis容器

   • 使用默认配置，网络选择与PostgreSQL相同

4. 部署Immich核心服务

   • 按 docker-compose.yml配置映射卷和环境变量

---

初始化配置

1. 访问Web界面

   • 浏览器打开：http://NAS_IP:2283
   • 首次运行自动创建管理员账户

2. 手机端配置

   • 安装Immich APP（iOS/Android）
   • 输入服务器地址：http://NAS_IP:2283
   • 开启自动备份

---

常见问题

1. 端口冲突

   • 修改 docker-compose.yml中 2283:3000的左侧端口号

2. 存储权限错误

   • 检查 /app/uploads目录是否赋予Docker写入权限

3. 版本更新

   • 停止容器 → 删除旧容器 → 重新拉取最新镜像 → 重新部署

---

进阶配置

• 域名访问：通过反向代理配置HTTPS（推荐Nginx Proxy Manager）
• 定时备份：在飞牛任务计划中添加数据库备份任务
• 硬件加速：配置GPU直通（需飞牛支持）

---

通过以上步骤，即可在飞牛NAS上搭建私有化的Google Photos替代方案。建议定期检查Immich GitHub仓库获取更新。