OnlyOffice на TrueNAS: Полное руководство по установке и интеграции

Введение: Почему OnlyOffice на TrueNAS?

Представь, что ты построил мощный домашний или корпоративный сервер на TrueNAS — надежную систему для хранения данных. Но теперь нужны инструменты для работы с этими данными: редактирование документов, таблиц, презентаций прямо из браузера, без установки Office на каждый компьютер. Решение — OnlyOffice, полноценный open-source офисный пакет. Давай разберем, как объединить эти две мощные технологии.

Выбор платформы: TrueNAS Core или TrueNAS Scale?

TrueNAS предлагает две основные ветки. Для установки OnlyOffice выбор критически важен.

Для этого руководства мы фокусируемся на TrueNAS Scale, так как его Docker-интеграция делает процесс установки OnlyOffice почти тривиальным.

Пошаговое руководство: Установка OnlyOffice на TrueNAS Scale

Давай пройдем путь от чистого TrueNAS Scale до работающего OnlyOffice Document Server.

Шаг 1: Предварительные требования и планирование

• Работающая система TrueNAS Scale (версия 22.12 или выше).
• Созданный пул данных с достаточным свободным пространством.
• Статический IP адрес для вашего TrueNAS или возможность использовать Host Network.
• Доступ к веб-интерфейсу TrueNAS (обычно порт 80 или 443).

Шаг 2: Настройка хранилища для OnlyOffice

OnlyOffice как Docker-приложение будет хранить свои данные (конфигурацию, логи) в Dataset. Создадим его.

# В веб-интерфейсе TrueNAS Scale:
# 1. Перейдите в 'Storage -> Datasets'.
# 2. Создайте новый Dataset, например, назовите его 'onlyoffice_data'.
# 3. Установите тип ACL (обычно 'POSIX' или 'NFSv4') согласно вашей сети.
# 4. Запишите путь к Dataset (например: /mnt/pool_name/onlyoffice_data).

Шаг 3: Установка через Apps (Docker)

TrueNAS Scale имеет интегрированный магазин приложений. Мы можем найти там OnlyOffice.

1. Перейдите в раздел 'Apps'. 2. Нажмите 'Discover Apps' и в поиске введите "onlyoffice". 3. Если приложение доступно, нажмите 'Install'. Если нет, создадим его сами.

Создание Custom App для OnlyOffice Document Server

Нажмите 'Manage Catalogs', убедитесь, что официальный TrueNAS Charts добавлен. Затем создайте новое приложение:

# Конфигурация для ручного создания в TrueNAS Apps (Custom App):

version: '3'
services:
  onlyoffice:
    image: onlyoffice/documentserver:latest
    container_name: onlyoffice_truenas
    restart: unless-stopped
    ports:
      - "8080:80"  # Мапируем внутренний порт 80 на порт 8080 хоста
    volumes:
      - /mnt/pool_name/onlyoffice_data/logs:/var/log/onlyoffice  # Логи
      - /mnt/pool_name/onlyoffice_data/data:/var/www/onlyoffice/Data  # Данные
      - /mnt/pool_name/onlyoffice_data/lib:/var/lib/onlyoffice  # Библиотеки
    environment:
      - JWT_ENABLED=true  # Включить JWT для безопасности (опционально)
      - JWT_SECRET=your_very_strong_secret_key_here  # Свой секретный ключ

В интерфейсе Custom App заполните поля: - Image: onlyoffice/documentserver:latest - Ports: 8080:80 - Volumes: Добавьте три маппинга, как в конфиге выше. - Environment Variables: Добавьте JWT_ENABLED и JWT_SECRET.

Шаг 4: Настройка сети и доступности

После установки OnlyOffice будет доступен на порту 8080 вашего TrueNAS сервера. Проверьте:

# Проверка работы контейнера из CLI TrueNAS (если доступен):
docker ps | grep onlyoffice

# Или просто откройте в браузере:
http://your_truenas_ip:8080

Вы должны увидеть стартовую страницу OnlyOffice Document Server с сообщением "Document Server is running".

Шаг 5: Интеграция OnlyOffice с Nextcloud на TrueNAS

Одна из главных причин установки OnlyOffice на TrueNAS — интеграция с Nextcloud (который также легко установить как App). Это дает полноценную Google Docs альтернативу.

1. Установите Nextcloud из Apps TrueNAS Scale. 2. В админ-панели Nextcloud перейдите в 'Apps', найдете и установите приложение 'OnlyOffice'. 3. В настройках OnlyOffice приложения в Nextcloud введите:

Адрес Document Server: http://your_truenas_ip:8080
Secret Key (если JWT включен): your_very_strong_secret_key_here

4. Теперь файлы в Nextcloud можно открывать для редактирования через OnlyOffice.

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

Проблема 1: Контейнер не запускается или сразу завершается

• Проверьте логи контейнера в TrueNAS Apps -> Installed Applications -> ваш OnlyOffice -> Logs.
• Убедитесь, что Dataset для volumes существует и ACL настроены правильно (контейнер должен иметь права на запись).
• Попробуйте запустить с меньшим количеством переменных среды для диагностики.

Проблема 2: OnlyOffice не соединяется с Nextcloud

• Убедитесь, что IP адрес и порт указаны правильно. Используйте внутренний IP, если сервисы на одном хосте.
• Если используете JWT, убедитесь, что одинаковый JWT_SECRET указан в контейнере OnlyOffice и в настройках Nextcloud.
• Проверьте, что Nextcloud может «достучаться» к порту 8080 (нет блокировки firewall на TrueNAS).

Проблема 3: Недостаточно памяти

OnlyOffice Document Server может потреблять значительную память при работе с большими документами или множеством пользователей. В TrueNAS Apps вы можете ограничить ресурсы контейнера:

В настройках Custom App:
CPU Limits: Установите лимиты (например, 2 ядра).
Memory Limits: Установите максимум (например, 4096 MiB).

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

Можно ли установить OnlyOffice на TrueNAS Core?

Да, но процесс сложнее. Вам нужно создать Jail, внутри Jail установить необходимые пакеты (nginx, node.js) и затем следовать официальной инструкции OnlyOffice для FreeBSD. Это требует глубоких знаний FreeBSD и не рекомендуется для новичков.

Будет ли OnlyOffice работать без Nextcloud?

Абсолютно. OnlyOffice Document Server — это самостоятельный продукт. Его можно использовать как отдельный сервис для редактирования документов через его API. Nextcloud — лишь один из многих клиентов.

Как обновлять OnlyOffice на TrueNAS?

Если установлено через Apps (официальный или custom), обновление происходит через изменение Image тag в настройках контейнера (например, с 'latest' на конкретную версию) и перезапуск. Не забудьте проверить совместимость после обновления.

Насколько безопасна такая установка?

При использовании внутри локальной сети безопасность высока. Для внешнего доступа обязательно: 1. Использовать HTTPS (настроить Reverse Proxy в TrueNAS или через отдельный контейнер). 2. Использовать JWT секрет. 3. Ограничить доступ по IP или через VPN.

Заключение и дальнейшие шаги

Теперь у тебя работает мощная комбинация: надежная система хранения TrueNAS и полнофункциональный офисный пакет OnlyOffice. Это основа для создания полностью независимой рабочей среды.

• Расширьте функциональность: Интегрируйте OnlyOffice с другими системами (например, via API).
• Настройте резервное копирование: Регулярно бэкапите Dataset onlyoffice_data через возможности TrueNAS.
• Мониторинг: Используйте встроенные в TrueNAS инструменты мониторинга ресурсов контейнера.