TrueNAS Scale Apps: Установка, настройка, Docker и Kubernetes | AdminWiki
Timeweb Cloud — сервера, Kubernetes, S3, Terraform. Лучшие цены IaaS.
Попробовать

TrueNAS Scale Apps: Полное руководство по установке, настройке и управлению приложениями

25 февраля 2026 7 мин. чтения #docker #ix-systems #kubernetes #nas #self-hosted #truenas scale #truenas scale app #контейнеры #приложения
Содержание статьи

Представь, что твой NAS превращается в полноценный сервер приложений: медиасервер Plex, облачное хранилище Nextcloud, системы мониторинга и даже игры — всё работает в изоляции, не мешая основной системе. Это и есть магия TrueNAS Scale Apps. Давай разберем, как это работает, как настроить и какие подводные камни тебя ждут.

Что такое TrueNAS Scale Apps и как это работает

TrueNAS Scale Apps — это система управления контейнеризированными приложениями на базе Kubernetes и Docker. В отличие от классических плагинов, которые были в TrueNAS Core, здесь используется современный подход:

  • Helm-чарты — стандартизированные пакеты приложений
  • Изоляция — каждое приложение работает в своем пространстве
  • Масштабируемость — можно запускать несколько экземпляров одного приложения
  • Автоматическое обновление — система сама следит за обновлениями образов
Важно: TrueNAS Scale использует собственный Kubernetes-кластер под названием "ix-kubernetes". Это не полноценный K8s для продакшена, а оптимизированная версия для работы приложений на NAS.

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

1. Настройка пулов и датасетов

Перед установкой любого truenas scale app нужно правильно настроить хранилище. Создай отдельный датасет для приложений:

bash
# Через веб-интерфейс:
# 1. Storage → Pools → Add Dataset
# 2. Имя: apps
# 3. ACL Type: POSIX (рекомендуется для приложений)
# 4. Enable Atime: Off (для производительности)

2. Настройка сети

Для работы приложений нужна правильная сетевая конфигурация:

  • Сетевой интерфейс — убедись, что у тебя есть выделенный интерфейс или VLAN
  • IP-адреса — TrueNAS Scale Apps могут получать IP через DHCP или статически
  • DNS — настрой внутренний DNS или используй внешние серверы
Внимание: Некоторые приложения требуют статических IP. Если у тебя динамические адреса, настрой резервацию в роутере.

Пошаговая установка приложения на TrueNAS Scale

Давай установим Plex Media Server как пример. Это покажет все этапы работы с truenas scale app системой.

Шаг 1: Выбор и настройка приложения

  1. Открой Apps в главном меню
  2. Нажми Discover Apps
  3. Найди "Plex" в списке или через поиск
  4. Нажми Install

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

В форме установки заполни основные параметры:

yaml
# Пример конфигурации Plex через веб-интерфейс:
Application Name: plex-media-server
Version: latest

# Storage Configuration:
Config Volume:
  Dataset Name: apps/plex/config
  Mount Path: /config

Media Volume:
  Dataset Name: media/movies  # Твой датасет с медиа
  Mount Path: /media

# Network Configuration:
Service Type: LoadBalancer
Container Port: 32400
Node Port: 32400
Host Network: false

Шаг 3: Расширенные настройки (Environment Variables)

Многие приложения требуют переменные окружения. Для Plex это может быть:

config
Environment Variables:
  - name: TZ
    value: Europe/Moscow
  - name: PLEX_CLAIM
    value: "claim-xxxxxxxx"  # Получи на plex.tv/claim
  - name: ADVERTISE_IP
    value: "http://192.168.1.100:32400/"

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

  1. Нажми Install и жди развертывания (2-5 минут)
  2. Перейди в Installed Applications
  3. Найди Plex и открой его Web Portal
  4. Проверь логи через Logs если что-то не работает

Управление приложениями: продвинутые техники

1. Кастомные Docker-образы

Если нужного приложения нет в каталоге, можно использовать любой Docker-образ:

yaml
# В разделе "Launch Docker Image":
Image Repository: linuxserver/heimdall
Image Tag: latest

# Port Mappings:
  - containerPort: 80
    hostPort: 8080
    protocol: TCP

# Volumes:
  - hostPath: /mnt/pool/apps/heimdall
    mountPath: /config
    readOnly: false

2. Настройка автоматических бэкапов

Для критически важных приложений настрой бэкапы конфигурации:

bash
# Создай задачу в Tasks → Cron Jobs:
0 2 * * * tar -czf /mnt/backup/apps/$(date +%Y%m%d)_app_configs.tar.gz /mnt/pool/apps/*/config

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

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

  • System → Reporting — мониторинг ресурсов
  • Apps → (выбери приложение) → Logs — логи контейнера
  • Shell — для ручной проверки через k3s kubectl get pods -n ix-application-name

Сравнение способов развертывания приложений

Метод Сложность Гибкость Поддержка Лучше для
Официальные Apps ★☆☆☆☆ ★★☆☆☆ ★★★★★ Новичков, базовых задач
Кастомные Docker ★★★☆☆ ★★★★★ ★★☆☆☆ Опытных пользователей
Ручная установка в VM ★★★★★ ★★★★★ ★☆☆☆☆ Специфичных приложений

Типичные проблемы и их решения

Проблема 1: Приложение не запускается

Решение:

  1. Проверь логи: Apps → Application → Logs
  2. Убедись, что порты не конфликтуют
  3. Проверь права доступа к датасетам: chmod -R 755 /mnt/pool/apps
  4. Перезапусти ix-kubernetes: systemctl restart k3s

Проблема 2: Медленная работа приложений

Решение:

  • Перенеси датасет приложений на SSD (если есть)
  • Увеличь лимиты RAM/CPU в настройках приложения
  • Отключи Atime для датасетов: zfs set atime=off pool/apps
  • Проверь сетевую загрузку

Проблема 3: Обновления ломают приложения

Важное правило: Всегда делай бэкап конфигурации перед обновлением TrueNAS Scale или приложений. Используй функцию снапшотов ZFS.

Лучшие практики для production-использования

  • Изоляция сетей — используй отдельный VLAN для приложений
  • Ресурсные лимиты — всегда устанавливай limits/requests для CPU и RAM
  • Снапшоты ZFS — настрой автоматические снапшоты датасетов приложений
  • Мониторинг — установи Netdata или Prometheus для мониторинга
  • Документация — веди список установленных приложений и их конфигураций

FAQ: Частые вопросы о TrueNAS Scale Apps

Можно ли мигрировать приложения с TrueNAS Core?

Прямой миграции нет. Тебе нужно:

  1. Экспортировать конфигурацию из плагина TrueNAS Core
  2. Установить аналогичное приложение в TrueNAS Scale
  3. Импортировать данные и конфигурацию
Для медиасерверов (Plex, Emby) обычно достаточно указать путь к библиотеке.

Сколько приложений можно запустить одновременно?

Зависит от ресурсов системы. На 16GB RAM можно комфортно запустить 10-15 легких приложений. Каждое приложение потребляет 50-500MB RAM в зависимости от типа. Мониторь использование через System → Reporting.

Как получить доступ к приложениям из интернета?

Рекомендуемая схема:

  • Настрой обратный прокси (Nginx Proxy Manager или Traefik)
  • Используй Cloudflare Tunnel для безопасного доступа
  • НИКОГДА не открывай порты приложений напрямую в интернет
  • Настрой SSL-сертификаты (Let's Encrypt)

Почему некоторые приложения нет в каталоге?

Каталог TrueNAS Scale Apps содержит только проверенные приложения с официальной поддержкой. Для остального используй Launch Docker Image или Community Charts (если включены).

Как полностью удалить приложение с данными?

1. В Installed Applications нажми Delete 2. Выбери Delete Storage Volumes для полного удаления данных 3. Вручную удали датасет если нужно: zfs destroy pool/apps/application_name

Заключение

TrueNAS Scale Apps — это мощная система, которая превращает твой NAS в универсальный сервер приложений. Начни с простых приложений (Plex, Nextcloud), освои базовые принципы работы с контейнерами, а затем переходи к сложным сценариям.

Помни: ключ к успеху — в правильной подготовке (хранилище, сеть, бэкапы) и постепенном освоении. Не пытайся установить всё сразу. Каждое приложение тестируй, документируй его настройки и только потом переходи к следующему.

Теперь у тебя есть полная картина работы с truenas scale app системой. Осталось только применить эти знания на практике. Удачи в настройке!

Поделиться:
Сохранить гайд? В закладки браузера