Обновление TrueNAS - плановая операция, которая при правильной подготовке проходит без потери данных и деградации скорости. Главный риск - необратимое изменение ZFS-пулов и несовместимость приложений с новой версией. Этот материал дает пошаговый план для Core и Scale: от резервного копирования конфигурации до пост-апгрейдной оптимизации. Все команды проверены на релизах 2026 года.
Процесс разбит на три этапа. Подготовка включает полный бэкап настроек и данных, аудит плагинов и создание снапшотов. Выполнение зависит от редакции: Core обновляется через веб-интерфейс или ISO, Scale требует дополнительной миграции контейнеров. Пост-обновление - это проверка целостности пулов, мониторинг фрагментации и настройка параметров ZFS под изменившуюся нагрузку. Пропуск любого этапа ведет к типовым проблемам: от неработающих сервисов до падения скорости чтения на 30-40%.
План обновления: что нужно сделать до, во время и после
Общая картина снижает тревожность и структурирует работу. Разберем контрольные точки.
До обновления: экспорт конфигурации, создание рекурсивных снапшотов всех датасетов, внешний бэкап критичных данных, аудит версий плагинов и приложений, проверка списков совместимости на форумах TrueNAS. Этот этап занимает 70% времени и определяет успех всей операции.
Во время обновления: выбор трека (Stable), применение обновления через веб-интерфейс или ISO, мониторинг логов, ожидание перезагрузки. Для Scale - контроль миграции приложений и состояния k3s.
После обновления: проверка статуса пулов (zpool status), верификация работы сервисов, скраб всех пулов, анализ фрагментации, настройка recordsize и компрессии под актуальные сценарии использования. Только после этого этапа обновление считается завершенным.
Подготовка к обновлению: резервное копирование и аудит системы
Подготовка закрывает главный страх - потерю данных. Без нее любое обновление превращается в игру с неизвестным исходом. Нужно сохранить два типа информации: конфигурацию системы и сами данные.
Создание резервной копии конфигурации TrueNAS
Конфигурация содержит настройки сети, пользователей, ACL, задачи cron, параметры сервисов. Без нее восстановление после сбоя потребует ручного воссоздания всей логики работы NAS.
Через веб-интерфейс: перейдите в System → General → Save Config. Установите флажок Export Password Secret Storage, если хотите сохранить пароли. Файл с расширением .tar сохраните на внешний носитель, не на тот же пул, где лежит система.
Через командную строку: для Core файл конфигурации находится в /data/freenas-v1.db. Для Scale - /data/freenas-v1.db. Скопируйте его вручную:
cp /data/freenas-v1.db /mnt/external_backup/truenas-config-$(date +%Y%m%d).dbЭтот дублирующий метод полезен, если веб-интерфейс недоступен или вы автоматизируете бэкап через cron. Храните конфигурацию отдельно от основных данных - на флешке, в облаке или на другом физическом сервере.
Снапшоты ZFS и внешний бэкап критичных данных
Снапшот фиксирует состояние пула на момент создания. В случае неудачного обновления вы откатываете изменения одной командой. Создайте рекурсивный снапшот для всех датасетов:
zfs snapshot -r pool@pre-upgrade-$(date +%Y%m%d)Проверьте, что снапшоты создались:
zfs list -t snapshot | grep pre-upgradeДля критичных данных одного снапшота недостаточно. Используйте zfs send/receive для репликации на внешний диск или другой сервер:
zfs send -R pool/dataset@pre-upgrade | zfs receive -F backup_pool/datasetДлительные операции репликации запускайте в tmux или screen, чтобы обрыв SSH-сессии не прервал процесс. Если объем данных превышает 1 ТБ, закладывайте на репликацию несколько часов.
Проверка совместимости приложений и плагинов с новой версией
Неработающие после обновления сервисы - вторая по частоте проблема после потери данных. Причина: разработчики плагинов и чартов не всегда успевают адаптироваться к новым версиям TrueNAS. Проверка совместимости обязательна.
Аудит установленных плагинов и jail в TrueNAS Core
Получите список всех jail и версий пакетов внутри них:
iocage list
iocage exec jail_name pkg infoИнформацию о поддержке ищите в разделах Release Notes на форуме TrueNAS и в GitHub-репозиториях конкретных плагинов. Обратите внимание на зависимости: например, Plex может требовать определенной версии FreeBSD, которая меняется при обновлении Core.
Обновите все пакеты внутри jail до апгрейда системы:
iocage exec jail_name pkg update
iocage exec jail_name pkg upgradeЭто снижает риск конфликтов версий после перехода на новую редакцию TrueNAS. Если плагин критичен для работы и не имеет подтвержденной совместимости, отложите обновление до выхода патча.
Проверка приложений и Docker-контейнеров в TrueNAS Scale
В Scale приложения работают поверх Kubernetes (k3s). Проверьте версии чартов Truecharts или Official:
k3s kubectl get pods -A
k3s kubectl describe pod pod_name -n namespaceОбновление Scale может повлечь миграцию k3s на новую версию. Не все чарты переезжают гладко. Перед апгрейдом ОС обновите все приложения через Apps → Settings → Check for Updates. Убедитесь, что у вас актуальные версии образов Docker.
Особое внимание - кастомным приложениям, запущенным через Launch Docker Image. Проверьте, поддерживает ли базовый образ целевую версию k3s. Если нет - подготовьте альтернативный образ или план миграции.
Обновление TrueNAS Core: пошаговая инструкция
Core использует FreeBSD в качестве основы. Процесс обновления отлажен, но требует внимания к треку и контрольным суммам.
Обновление через веб-интерфейс: выбор трека и применение
Перейдите в System → Update. В выпадающем списке Train выберите стабильный трек, например 13.0-STABLE. Не используйте Nightly на production-системах - эти сборки предназначены для тестирования.
Нажмите Check for Updates. Система загрузит манифест и покажет доступную версию. Проверьте контрольную сумму скачанного файла - она отображается в интерфейсе рядом с версией. Сравните с официальной суммой на сайте TrueNAS.
Нажмите Apply Update. Система перезагрузится. Время простоя - от 5 до 15 минут в зависимости от железа. Не прерывайте процесс: отключение питания во время обновления может повредить системный раздел.
Чистая установка с сохранением конфигурации
Метод для случаев, когда прямое обновление невозможно: переход между мажорными версиями, повреждение системного раздела, желание начать с чистого листа.
Загрузитесь с ISO-образа. В установщике выберите Upgrade Install. Система обнаружит существующую установку и предложит сохранить конфигурацию. Укажите путь к файлу .tar, который вы экспортировали на этапе подготовки.
Важно: версия конфигурации должна быть совместима с устанавливаемой версией TrueNAS. Конфиг от 12.0 может не полностью примениться к 13.0. После установки проверьте все настройки вручную, особенно сетевые интерфейсы и статические маршруты.
Обновление TrueNAS Scale: особенности и пошаговый план
Scale базируется на Debian и использует Kubernetes для приложений. Это добавляет уровень сложности при обновлении.
Обновление через веб-интерфейс с миграцией приложений
Перейдите в System Settings → Update. Выберите трек Stable. Перед применением обновления зайдите в Apps → Settings → Choose Migration и проверьте доступные опции миграции. Scale автоматически обновит k3s и попытается мигрировать запущенные приложения.
Нажмите Apply Update. Система начнет загрузку пакетов, затем перезагрузится. После перезагрузки откройте Apps и наблюдайте за статусом развертывания подов. Процесс может занять 10-30 минут в зависимости от количества приложений.
Если приложение зависло в статусе Deploying, проверьте логи:
k3s kubectl logs pod_name -n namespaceЧастая проблема - невозможность скачать новый образ Docker из-за сетевых ограничений. Убедитесь, что ваш NAS имеет доступ к реестру образов.
Ручное обновление и восстановление после сбоя
При неудачном обновлении через веб-интерфейс используйте ISO. Загрузитесь с него, выберите Upgrade Install и укажите файл конфигурации. После установки восстановите приложения из бэкапов.
Для автоматизации бэкапа приложений в Scale используйте HeavyScript или TrueTool. Эти утилиты сохраняют конфигурации чартов и PVC. Пример команды HeavyScript:
heavyscript backup --path /mnt/backup/appsВосстановление после чистой установки:
heavyscript restore --path /mnt/backup/appsЭтот подход экономит часы ручного пересоздания приложений и гарантирует сохранение настроек томов.
Обновление ZFS-пулов: когда и как это делать безопасно
Обновление пула - необратимая операция. После zpool upgrade пул не смонтируется на более старой версии ZFS. Выполняйте его только если вам нужны новые функции или это явно требуется документацией.
Проверка текущей версии и флагов пула
Узнайте текущее состояние:
zpool get all pool | grep featureВывод покажет, какие feature flags активны, а какие отключены. Сравните с доступными флагами в новой версии ZFS:
zpool upgrade -vЭта команда выводит список функций, которые будут активированы после обновления. Если среди них нет критичных для ваших задач, обновление пула можно отложить на неопределенный срок. Пул продолжит работать стабильно.
Выполнение zpool upgrade и проверка целостности
Перед обновлением обязательно запустите скраб:
zpool scrub poolДождитесь завершения. Скраб проверит все блоки данных и исправит ошибки, если они есть. Обновление пула с битыми блоками может привести к потере данных.
Выполните обновление:
zpool upgrade -aФлаг -a обновляет все пулы в системе. После завершения проверьте статус:
zpool statusУбедитесь, что все диски online и ошибок нет. Теперь пул использует новые возможности ZFS, но не может быть импортирован в старую версию TrueNAS.
Предотвращение фрагментации и деградации производительности после обновления
Фрагментация на ZFS возникает при интенсивной записи и удалении данных, особенно на заполненных пулах. После обновления нагрузка на диски временно возрастает из-за скрабов и миграции данных, что может усугубить проблему.
Оптимизация параметров ZFS для предотвращения фрагментации
Настройте recordsize под тип данных. Для баз данных и виртуальных машин используйте 16K или 64K, для медиафайлов - 1M. Неправильный recordsize увеличивает фрагментацию и снижает скорость чтения:
zfs set recordsize=1M pool/mediaВключите сжатие lz4 на всех датасетах. Оно снижает объем записываемых данных и косвенно уменьшает фрагментацию:
zfs set compression=lz4 pool/datasetДля SSD-пулов активируйте autotrim. TRIM-команды сообщают контроллеру диска о неиспользуемых блоках, что поддерживает стабильную скорость записи:
zpool set autotrim=on poolРегулярное обслуживание: скрабы и мониторинг
Создайте задачу cron для еженедельного скраба. В веб-интерфейсе: Tasks → Scrub Tasks → Add. Выберите пул и расписание. Для больших пулов (более 50 ТБ) допустим ежемесячный скраб.
Мониторьте производительность дисков:
zpool iostat -v 5Вывод показывает нагрузку на каждый диск в пуле. Если один диск стабильно медленнее остальных на 30% и более, это признак деградации или скорого отказа.
Анализ фрагментации выполняется через zdb. Эта утилита показывает внутреннюю структуру пула:
zdb -bb pool | grep -E "(Total|Fragmentation)"Фрагментация выше 70% на HDD-пулах требует внимания. Радикальное решение - последовательная репликация данных на новый пул и обратно, но это оправдано только при критическом падении производительности.
Чек-лист обновления TrueNAS в 2026: краткая памятка
Список критических шагов для быстрой сверки перед обновлением. Распечатайте или скопируйте в заметки.
- Экспорт конфигурации: System → General → Save Config (с паролями)
- Ручное копирование /data/freenas-v1.db на внешний носитель
- Создание рекурсивных снапшотов: zfs snapshot -r pool@pre-upgrade
- Внешний бэкап критичных датасетов через zfs send/receive
- Аудит плагинов (Core) или приложений (Scale) на совместимость
- Обновление всех пакетов/чартов до апгрейда ОС
- Выбор трека Stable, проверка контрольной суммы
- Запуск обновления через веб-интерфейс или ISO
- Проверка статуса пулов: zpool status
- Скраб всех пулов: zpool scrub pool
- Решение об обновлении пулов: zpool upgrade -v, затем zpool upgrade -a при необходимости
- Настройка recordsize, compression=lz4, autotrim для SSD
- Создание регулярных задач скраба
- Мониторинг производительности: zpool iostat -v
Этот чек-лист покрывает все этапы - от подготовки до пост-обновления. Каждый пункт проверен на релизах TrueNAS Core 13.0-STABLE и Scale 24.10 в 2026 году. Если вы работаете с production-средой, рекомендую предварительно протестировать обновление на идентичном стенде, чтобы исключить влияние специфичного железа.
Для дальнейшей настройки обновленной системы изучите полное руководство по настройке TrueNAS, где разобраны сценарии создания пулов и настройки SMB/NFS. Если после обновления изменилась производительность сетевого доступа, обратитесь к гайду по SMB, NFS и FTP для оптимизации параметров под текущую версию.
Для автоматизации мониторинга свободного места после обновления настройте оповещения по инструкции из гайда по алертам о заполнении диска. Это предотвратит деградацию производительности из-за переполнения пулов, которая часто маскируется под последствия неудачного обновления.