Immich на TrueNAS: Полное руководство по установке и настройке

Представь, что у тебя есть собственная облачная фототека уровня Google Photos, но полностью под твоим контролем, без подписок и с приватностью данных. Это Immich — современный self-hosted сервис для хранения и управления фотографиями. А TrueNAS Scale — идеальная платформа для его развертывания. Давай разберем, как соединить эти две технологии в надежную систему для твоих воспоминаний.

Что такое Immich и почему TrueNAS?

Immich — это open-source альтернатива коммерческим фотосервисам с поддержкой:

• Автоматической загрузки с мобильных устройств
• Распознавания лиц и объектов (машинное обучение)
• Геотегов и временных линий
• Альбомов и общего доступа

TrueNAS Scale, в свою очередь, предоставляет идеальную среду для Immich благодаря встроенному Kubernetes (k3s), удобному управлению хранилищем ZFS и простой установке приложений через TrueCharts.

Подготовка TrueNAS Scale к установке Immich

Перед началом установки Immich на TrueNAS нужно подготовить инфраструктуру:

1. Настройка хранилища для фотографий

Создадим отдельный dataset для Immich с оптимальными настройками ZFS:

Storage → Datasets → Add Dataset
Name: immich-data
Compression: lz4 (рекомендуется для фото)
Record Size: 128K (оптимально для медиафайлов)
Quota: установи по необходимости

2. Установка TrueCharts каталога

TrueCharts предоставляет готовые Helm-чарты для удобной установки:

Apps → Manage Catalogs → Add Catalog
Name: truecharts
Repository: https://github.com/truecharts/catalog
Branch: main

Пошаговая установка Immich на TrueNAS

Теперь перейдем к основной части — установке и настройке Immich. Этот процесс состоит из нескольких ключевых этапов.

Шаг 1: Поиск и начало установки

В интерфейсе TrueNAS Scale:

1. Apps → Available Applications
2. В поиске введи "immich"
3. Найди "Immich" от truecharts
4. Нажми "Install"

Шаг 2: Базовая конфигурация приложения

Заполни основные настройки:

Шаг 3: Настройка хранилища (Storage)

Это критически важный этап. Привяжем созданный dataset к контейнерам Immich:

Добавь маунты:
1. uploads → /usr/src/app/upload
2. library → /usr/src/app/library
3. backups → /usr/src/app/backups

Тип: Host Path
Путь: /mnt/pool/immich-data/ (твой dataset)

Шаг 4: Конфигурация базы данных

Immich использует PostgreSQL. Настрой подключение:

PostgreSQL:
  enabled: true
  auth:
    username: immichuser
    password: strong_password_here
    database: immich

ИЛИ используй внешнюю БД:
DB_HOSTNAME: postgres.local
DB_USERNAME: immich
DB_PASSWORD: password
DB_DATABASE_NAME: immich

Шаг 5: Сетевые настройки и доступ

Настроим доступ к Immich из локальной сети:

Service Type: ClusterIP
Ports:
  - containerPort: 3000
    hostPort: 8083
    name: web

Ingress (если нужен доступ извне):
  enabled: true
  hosts:
    - host: immich.home.local
      paths:
        - path: /
          pathType: Prefix

Шаг 6: Дополнительные настройки

Опциональные, но полезные параметры:

• Machine Learning: Включи если есть GPU для ускорения
• Redis: Оставь включенным для кэширования
• Resource Limits: Установи лимиты CPU/RAM по возможностям системы

Шаг 7: Запуск и проверка

Нажми "Install" и жди развертывания. Проверь статус:

# В TrueNAS CLI или через SSH
k3s kubectl get pods -n ix-immich

# Должны увидеть:
immich-server-xxxx     1/1     Running
immich-microservices-xxxx  1/1     Running
immich-web-xxxx        1/1     Running
immich-postgres-xxxx   1/1     Running

Первоначальная настройка Immich после установки

После успешной установки Immich на TrueNAS открой браузер:

http://truenas-ip:8083

1. Создай администратора
2. Настрой библиотеку (укажи путь к фотографиям)
3. Скачай мобильное приложение Immich
4. Настрой автоматическую загрузку

Интеграция с существующей библиотекой

Если у тебя уже есть фотографии на TrueNAS:

# Скопируй фотографии в dataset Immich
cp -r /mnt/pool/photos/* /mnt/pool/immich-data/library/

# В веб-интерфейсе Immich:
Админ → Настройки → Библиотека
Укажи путь: /usr/src/app/library

Оптимизация и расширенные настройки

Чтобы Immich работал максимально эффективно на TrueNAS:

1. Настройка резервного копирования

Используй встроенные возможности TrueNAS:

Data Protection → Replication Tasks
Source: /mnt/pool/immich-data
Destination: другой сервер/облако
Schedule: ежедневно в 2:00

2. Мониторинг и логи

Следи за работой Immich:

# Просмотр логов
k3s kubectl logs -n ix-immich deployment/immich-server

# Мониторинг ресурсов
k3s kubectl top pods -n ix-immich

3. Обновление Immich

Через TrueNAS обновлять просто:

Apps → Installed Applications
Найди Immich → Actions → Upgrade
Выбери новую версию → Save

Решение частых проблем

Давай разберем типичные ошибки при установке Immich на TrueNAS:

FAQ: Ответы на частые вопросы