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

Если ты работаешь с TrueNAS Scale и хочешь выйти за рамки стандартного каталога приложений, то TrueCharts — твой следующий обязательный шаг. Это сообщество, которое создает, поддерживает и обновляет огромную библиотеку приложений, упакованных в Helm-чарты, специально оптимизированных для экосистемы TrueNAS. Давай разберем, что это такое, как это установить и как избежать самых частых ошибок.

Что такое TrueCharts и зачем они нужны на TrueNAS Scale?

Представь, что стандартный каталог приложений в TrueNAS — это базовый набор инструментов. Он надежный, но ограниченный. TrueCharts — это профессиональный набор, который добавляет сотни новых инструментов: от медиасерверов (Plex, Jellyfin) и систем мониторинга (Prometheus, Grafana) до утилит для разработчиков и домашней автоматизации.

Как добавить каталог TrueCharts в TrueNAS Scale: Пошаговая инструкция

Процесс добавления прост, но требует внимания к деталям. Следуй этим шагам.

Шаг 1: Подготовка системы и создание пула для приложений

Перед установкой убедись, что у тебя есть отдельный пул или набор данных для приложений. Это критически важно для изоляции и управления снапшотами.

# Рекомендуемая структура пула через веб-интерфейс:
# Пул: tank
#   -> Датасет: apps
#       -> Далее TrueNAS создаст свои поддатасеты для ix-applications

Шаг 2: Добавление каталога TrueCharts

1. Зайди в веб-интерфейс TrueNAS Scale (http://<truenas-ip>).
2. Перейди в раздел «Apps».
3. Нажми «Manage Catalogs».
4. Кликни «Add Catalog».
5. Заполни форму следующими данными:

Имя Каталога: truecharts
Реестр: https://github.com/truecharts/catalog
Ветка: main
Тренировочный каталог: НЕТ (сними галочку!)

Нажми «Save». Система начнет первоначальную синхронизацию каталога. Это может занять несколько минут.

Шаг 3: Настройка хранилища для приложений

Перед установкой первого приложения необходимо настроить пул, который будет использоваться для хранения данных приложений и их конфигурации.

1. В разделе «Apps» нажми «Settings».
2. Выбери вкладку «Advanced Settings».
3. В поле «Pool for Apps» выбери подготовленный пул (например, tank/apps).
4. Нажми «Save». Система перезапустит сервис Kubernetes (k3s).

Установка первого приложения из TrueCharts (на примере Plex)

Давай установим Plex Media Server, чтобы увидеть процесс в действии.

1. В разделе «Apps» нажми «Available Applications».
2. В выпадающем списке каталогов выбери «truecharts».
3. Найди приложение «Plex» и нажми «Install».
4. Заполни основные настройки:

Имя приложения: plex (используй строчные буквы)
Версия: Последняя стабильная (stable)
Настройка сети:
  - Service Type: LoadBalancer или NodePort (для доступа)
  - Выдели статический IP, если нужно.
Настройка хранилища:
  - Добавь Host Path Volume для медиафайлов.
  - Укажи путь на TrueNAS (например, /mnt/tank/media).
  - Смонтируй в контейнер (например, в /media).

Сравнение: Стандартный каталог vs TrueCharts

Частые проблемы и их решения

1. Ошибка: «Catalog sync failed»

Причина: Чаще всего — неправильный URL или проблема с сетью.

Решение:

• Убедись, что в поле «Реестр» указано: https://github.com/truecharts/catalog
• Убедись, что снята галочка «Тренировочный каталог».
• Проверь сетевое соединение TrueNAS с GitHub.
• Попробуй удалить каталог и добавить заново.

2. Приложение не запускается, ошибки доступа к хранилищу

Причина: Неправильные права на файлы или пути монтирования.

Решение:

• В настройках датасета для приложений установи ACL Type: POSIX или NFSv4.
• Убедись, что пользователь/группа apps (UID/GID 568) имеет права на чтение/запись в директориях с медиа.
• Проверь, что путь Host Path в настройках приложения существует на хосте.

# Проверь права на директории с хоста TrueNAS (чешел Shell)
ls -la /mnt/tank/media/
# Дай права пользователю apps (если нужно)
chown -R 568:568 /mnt/tank/media

3. Не могу получить доступ к приложению по сети

Причина: Неправильная настройка Service Type или сетевого порта.

Решение:

• При установке выбери LoadBalancer и укажи статический IP из своей подсети.
• Или используй NodePort и подключись по IP TrueNAS и высокому порту (например, 32400 для Plex).
• Проверь брандмауэр TrueNAS и сетевого оборудования.

Лучшие практики работы с TrueCharts на TrueNAS Scale

• Используй стабильные (stable) версии для продакшена. Тестовые (beta) и нестабильные (incubator) ветки — для экспериментов.
• Всегда настраивай резервное копирование датасета ix-applications через задачи TrueNAS. Это сохранит конфигурации всех твоих приложений.
• Перед обновлением приложения делай снапшот его датасета. Откат через веб-интерфейс не всегда возможен.
• Изучи раздел «Apps -> Installed Applications -> <app> -> Shell». Там можно запускать команды внутри контейнера для отладки.
• Подпишись на официальный Discord TrueCharts. Это лучшее место для получения помощи и информации об обновлениях.

Интеграция TrueCharts с TrueNAS Scale открывает новый уровень возможностей для твоего домашнего или корпоративного сервера. Это мост между мощью Kubernetes и удобством веб-интерфейса TrueNAS. Начни с простого приложения, разберись с настройками хранилища и сети, и вскоре ты будешь управлять целым парком сервисов из единой консоли. Удачи в настройке!