Установка и обновления ONLYOFFICE через автоматический Docker-скрипт

Что нового

ONLYOFFICE Community Server 9.0

• Интеграция с DocuSign — платформа для электронных подписей.
• Переработано окно общего доступа, добавлена автоматическая генерация короткой ссылки.
• Восстановление предыдущей версии документа из истории версий.
• Обновлены разделы Tasks и Discussions в Projects — улучшена навигация.
• Копирование задач и подзадач.

ONLYOFFICE Document Server 4.3

• Добавление и редактирование сносок (footnotes).
• Отмена действий (Undo) в быстром режиме совместного редактирования.
• Поддержка большего числа языков для проверки орфографии.
• Новые формулы, новые стили границ и функция “Вставить специальным образом” в Таблицах.

Требования к системе и зависимости ONLYOFFICE

Аппаратные требования

• CPU: 2‑ядерный процессор 2 ГГц или выше
• ОЗУ: 6 ГБ или больше
• Диск: минимум 40 ГБ свободного места
• Дополнительно: минимум 6 ГБ подкачки (swap)

Программные требования

• ОС: amd64 Linux с ядром версии 3.10 или выше
• Docker: версия 1.10 или выше

Важно: указанные минимальные параметры подходят для небольших инсталляций и тестовых сред. Для продуктивных систем увеличьте ОЗУ и диск в зависимости от числа пользователей и объёма документов.

Подготовка к установке — краткая методология

1. Проверьте совместимость ОС и версию ядра: uname -r.
2. Убедитесь, что Docker установлен и имеет доступ к сети и правам на запуск контейнеров.
3. Освободите рекомендуемый объём диска и убедитесь в наличии swap.
4. Зарезервируйте доменное имя и настройте DNS, если планируете подключать Mail Server и SSL.
5. Сделайте резервную копию важных данных перед установкой на существующем сервере.

Установка ONLYOFFICE

1. Откройте терминал (например, Ctrl+Alt+T).

2. Скачайте Docker-скрипт по прямой ссылке:

wget http://download.onlyoffice.com/install/opensource-install.sh

3. Запустите Docker и выполните команду установки ONLYOFFICE с интегрированными онлайн‑редакторами:

bash opensource-install.sh -ims false

Если нужен также почтовый сервер, укажите команду с зарегистрированным доменом:

bash opensource-install.sh -md "yourdomain.com"

Примечание: скрипт автоматически развернёт набор Docker-контейнеров с компонентами ONLYOFFICE и их зависимостями. Время инициализации зависит от скорости сети и параметров машины.

Запуск веб‑офиса

Откройте веб‑браузер и введите IP‑адрес или hostname сервера.

Инициализация может занять некоторое время. После завершения укажите адрес электронной почты и создайте пароль для доступа в веб‑офис.

Ссылки

• Официальная документация по установке и настройке ONLYOFFICE.
• Информация о исходных кодах и сборках: onlyoffice.org.
• Вопросы поддержки и сообщество: dev.onlyoffice.org.

Проверка после установки — чек‑лист администратора

• Все контейнеры Docker в статусе running (docker ps).
• Порты 80/443 (и 25/587 для почты) открыты и переадресованы при необходимости.
• SSL: сертификат валиден или настроено автоматическое получение (Let’s Encrypt).
• Подключение к базе данных и хранилищу файлов успешно.
• Тестовое редактирование документа в Document Server работает, совместное редактирование — синхронизируется.
• Резервное копирование конфигураций и томов Docker настроено.

Критерии приёмки

• Веб‑интерфейс доступен по указанному адресу через HTTPS.
• Создание, совместное редактирование и сохранение документов без ошибок.
• Загрузка/скачивание файлов корректно работают для пользователей.
• Почтовый сервер (если установлен) отправляет/получает тестовые письма.
• Логи контейнеров не содержат критических ошибок (docker logs).

Типичные ошибки и способы устранения

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

   • Диагностика: docker ps, docker logs .
   • Решение: увеличить ресурс памяти, проверить конфликт портов, перезапустить Docker.

2. Проблема: Document Server не отвечает при совместном редактировании.

   • Диагностика: проверить логи Document Server и доступность API по указанному порту.
   • Решение: убедиться, что firewall не блокирует WebSocket/HTTP соединения; проверить переменные окружения контейнера.

3. Проблема: почта не отправляется.

   • Диагностика: проверка логов Mail Server, тест отправки от имени домена.
   • Решение: правильные записи MX/SPF/DKIM в DNS, корректная конфигурация TLS.

Быстрые команды и сниппеты

• Проверить запущенные контейнеры:

docker ps

• Посмотреть логи контейнера:

docker logs --tail 200 

• Перезапустить контейнер:

docker restart 

• Освободить место: очистить неиспользуемые образы и тома

docker system prune -a --volumes

Важно: команда очистки удалит все неиспользуемые данные — применяйте осторожно.

Матрица совместимости и советы по миграции

• Поддерживаемая архитектура: amd64 Linux. Для ARM‑платформ официальной поддержки может не быть — проверьте релизы и образы.
• Docker версии 1.10 и выше: рекомендуется использовать актуальную стабильную версию Docker Engine.
• При миграции с ранних версий ONLYOFFICE: сохраните бэкап томов Docker и конфигураций, тестируйте обновления на стенде перед переносом в продуктив.

Риски и меры предосторожности

• Риск: потеря данных при некорректной очистке томов. Мера: регулярные бэкапы и проверка стратегии восстановления.
• Риск: утечка почтовых данных при неправильной настройке TLS. Мера: принудительное использование TLS и проверка конфигурации DNS (SPF/DKIM).

Роли и обязанности

Администратор:

• Подготовка сервера и обеспечение требований.
• Настройка Docker, SSL и DNS.
• Мониторинг и бэкап.

DevOps:

• Управление контейнерами, CI/CD для обновлений.
• Траблшутинг сетевых проблем и масштабирование.

Пользователь:

• Проверка работы редакторов и совместной работы.
• Сообщение об ошибках с подробными шагами воспроизведения.

Короткий план действий (Playbook)

1. Подготовить сервер: обновить ОС, установить Docker.
2. Скачайте скрипт и запустите установку.
3. Дождаться развертывания контейнеров и проверить логи.
4. Настроить SSL и DNS, при необходимости — почтовый домен.
5. Провести тестовые операции: создать документ, пригласить пользователя, проверить почту.
6. Настроить регулярный бэкап и мониторинг.

Итог

ONLYOFFICE можно быстро развернуть с помощью официального Docker‑скрипта. Следуйте системным требованиям, протестируйте установку в стенде и подготовьте резервные копии перед переводом в продуктив. Если возникнут проблемы, сначала проверьте логи контейнеров и конфигурации сети.

Ключевые рекомендации:

• Используйте выделенные ресурсы для продуктивной среды.
• Настройте SSL и DNS корректно для почтовых и веб‑сервисов.
• Регулярно делайте бэкапы и тестируйте восстановление.