Как настроить интеграцию OnlyOffice с WordPress на сервере Ubuntu

WordPress позволяет создавать сайты и блоги, а OnlyOffice представляет собой сервер для работы с офисными документами в режиме онлайн, который можно размещать на своем сервере. В этом руководстве вы узнаете, как соединить WordPress с OnlyOffice, чтобы редактировать файлы форматов DOCX, XLSX, PPTX и других прямо через веб-интерфейс WordPress.

Характеристики интеграции OnlyOffice с WordPress

• Онлайн доступен текстовый редактор с полным набором функций, сопоставимых с возможностями настольных программ.
• Полная точность при просмотре, преобразовании, печати и нумерации страниц.
• Даёт возможность добавлять гиперссылки, таблицы, графики, встраивать изображения, автофигуры, формулы и текстовые элементы, а также управлять ими. Позволяет создавать списки с маркировкой или нумерацией.
• Осуществляет редактирование и сохранение файлов форматов DOCX, XLSX, PPTX, TXT. Также доступно сохранение в различные другие форматы, включая ODT, ODS, ODP, DOC, XLS, PPT, PPS, EPUB, RTF, HTML, HTM.
• Полностью поддерживает форматы Office Open XML:.docx,.xlsx,.pptx
• Ваши файлы сохраняются автоматически, поэтому вы не утратите свои данные.
• Поддерживает символы латинского алфавита, а также китайские, японские и корейские знаки.

Предварительные условия

Документоориентированный сервер OnlyOffice нуждается в как минимум двухъядерном процессоре и 2 ГБ оперативной памяти. Для оптимальной работы с WordPress лучше использовать сервер с 4 ядрами и 4 ГБ ОЗУ. Вы можете приобрести мощный VPS от Contabo по доступной цене. Если у вас много пользователей, стоит подумать о повышении параметров сервера.

Для завершения данного руководства вам потребуется функционирующий сервер WordPress. Если вы еще не выполнили эту задачу, рекомендуется ознакомиться со следующей статьей, чтобы сначала настроить сервер WordPress.

• Установите WordPress на Ubuntu с использованием Nginx (LEMP-стек).

После этого ознакомьтесь с инструкциями по интеграции OnlyOffice и WordPress. Серверы документов OnlyOffice и WordPress могут находиться на различных хостах.

Приступим.

Инсталляция сервера документов OnlyOffice на операционной системе Ubuntu.

Документооборотный сервер OnlyOffice работает на базе PostgreSQL, Node.js, Redis Server, RabbitMQ и Nginx. Приведенные ниже инструкции были протестированы на Ubuntu 22.04, однако они также могут быть использованы на дистрибутивах Linux из семейства Debian.

Процесс установки PostgreSQL на операционную систему Ubuntu.

PostgreSQL можно установить из стандартного репозитория Ubuntu. Разработчики PostgreSQL постоянно работают над повышением производительности в каждой новой версии. Для установки самой последней версии PostgreSQL из репозитория postgresql.org выполните следующие команды.

echo "deb [signed-by=/etc/apt/keyrings/postgresql.asc] http://apt. postgresql.org/pub/repos/apt $(lsb_release - cs)-pgdg main" | sudo tee /etc/apt/sources. list. d/pgdg. list sudo mkdir - p /etc/apt/keyrings/ wget --quiet - O - https://www. postgresql.org/media/keys/ACCC4CF8.asc | sudo tee /etc/apt/keyrings/postgresql.asc sudo apt update sudo apt install - y postgresql postgresql-contrib postgresql-15 postgresql-client-15

После этого создайте базу данных onlyoffice.

sudo - i - u postgres psql - c "CREATE DATABASE onlyoffice;"

Создайте учетную запись пользователя onlyoffice.

sudo - i - u postgres psql - c "CREATE USER onlyoffice WITH password 'onlyoffice';"

sudo - i - u postgres psql - c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"

Важно: Логин и пароль должны быть исключительно office.

Установка NodeJS из официальных источников.

Сервер документов OnlyOffice нуждается в Node.js версии 14.0 или выше, однако версия, доступная в репозитории Ubuntu, устарела. Поэтому необходимо установить Node.js из более актуального репозитория.

Добавьте репозиторий для Node.js.

curl - sL https://deb. nodesource.com/setup_14.x | sudo - E bash -

sudo apt install nodejs - y

Убедитесь, что у вас установлена актуальная версия Node.js.

node - v

v14.21.1

Настройка серверов Redis и RabbitMQ.

sudo apt install redis-server rabbitmq-server

Убедитесь в их состоянии.

systemctl status redis-server systemctl status rabbitmq-server

Обратите внимание на активность служб. Если rabbitmq-server не запускается, причиной может быть нехватка памяти на устройстве или ошибка в имени хоста. Сервер Redis работает по адресу 127.0.0.1:6379, в то время как RabbitMQ слушает на 0.0.0.0:25672 и 0.0.0.0:4369.

Установите сервер для работы с документами OnlyOffice.

Добавьте репозиторий OnlyOffice, выполнив следующую команду. (Возможно, вы задумываетесь, можно ли использовать репозиторий Debian squeeze в Ubuntu. Не волнуйтесь. Этот репозиторий OnlyOffice подходит для всех версий Debian и Ubuntu.)

echo "deb http://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources. list. d/onlyoffice. list

Импортируйте публичный ключ OnlyOffice.

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys CB2DE8E5

Обновите локальный индекс пакетов и установите OnlyOffice Document Server. Учтите, что установка пакета onlyoffice-documentserver потребует зависимости nginx-extras, поэтому перед этим необходимо остановить работающий веб-сервер Apache.

sudo apt update sudo apt install onlyoffice-documentserver

Во время установки вам будет необходимо ввести пароль PostgreSQL для onlyoffice. Пожалуйста, укажите «onlyoffice» (без кавычек).

Чтобы установить шрифты TrueType от Microsoft, вам потребуется согласиться с условиями лицензии Microsoft.

Конфигурация сервера Nginx будет размещена по адресу /etc/nginx/conf.d/ds.conf.(Фактически это символическая ссылка на /etc/onlyoffice/documentserver/nginx/ds.conf.) Документный сервер OnlyOffice представляет собой веб-приложение, разработанное на nodejs, а Nginx служит в роли обратного прокси-сервера. Корневая веб-директория находится по пути /var/www/onlyoffice/documentserver/.

По завершении установки откройте веб-браузер и введите публичный IP-адрес вашего сервера. Вы должны увидеть сообщение: «ONLYOFFICE Docs Community Edition успешно установлен».

Для того чтобы узнать номер версии сервера документов, используйте следующую команду.

apt search onlyoffice-documentserver

onlyoffice-documentserver/squeeze, now 7.2.1-23 amd64 [установлено] Онлайн-редакторы для текстовых документов, таблиц и презентаций

В случае возникновения ошибки при установке, это может быть связано с неправильными настройками в конфигурационных файлах Nginx. Выполните команду sudo nginx — t для проверки.

dpkg: ошибка обработки пакета onlyoffice-documentserver (--configure): установленный пакет onlyoffice-documentserver скрипт пост-установки завершился с кодом выхода с ошибкой 1 Обработка триггеров для libc-bin (2.35-0ubuntu3.1) . При обработке возникли ошибки: onlyoffice-documentserver E: Подпроцесс /usr/bin/dpkg вернул код ошибки (1)

Активация HTTPS для сервера документов

Для подключения WordPress к серверу документов OnlyOffice необходимо, чтобы он работал через HTTPS. Сервер WordPress и браузеры пользователей также должны обращаться к серверу документов через защищённое соединение. Ниже приведены шаги по получению и установке TLS-сертификата от Let’s Encrypt.

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

sudo nano /etc/nginx/conf.d/ds.conf

Добавьте директиву server_name, как указано в примере ниже. Убедитесь, что настроена DNS A запись для onlyoffice. your-domain.com.

include /etc/nginx/includes/http-common.conf; server < listen 0.0.0.0:80; listen [::]:80 default_server; server_tokens off; server_name onlyoffice. your-domain.com; include /etc/nginx/includes/ds-*.conf; >

Сохраните файл и закройте его. Перезапустите Nginx для применения изменений.

sudo systemctl reload nginx

Установите клиент certbot (Let’s Encrypt) и дополнение для Nginx.

sudo apt install certbot python3-certbot-nginx

Для получения бесплатного сертификата TLS с помощью плагина Nginx выполните следующую команду.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email Пожалуйста, предоставьте текст для перефразирования. - d onlyoffice. your-domain.com

• —nginx: Воспользуйтесь плагином для nginx.
• —agree-tos : Примите условия использования.
• Принудительное использование HTTPS с перенаправлением 301.
• —hsts : Добавляет заголовок Strict-Transport-Security ко всем HTTP-ответам. Обязывает браузер всегда применять TLS для данного домена, обеспечивая защиту от атак типа SSL/TLS Stripping.
• —staple-ocsp : Активирует OCSP Stapling. Сервер прикладывает актуальный OCSP-ответ к сертификату, который передается при установке TLS-соединения.

Через несколько секунд на экране появится сообщение, подобное показанному ниже, указывающее на успешное получение TLS-сертификата.

Откройте в веб-браузере адрес https://onlyoffice.your-domain.com, чтобы проверить корректную работу сервера документов OnlyOffice в режиме HTTPS.

Третий шаг: Установите плагин для интеграции WordPress с OnlyOffice.

Авторизуйтесь в админ-панели WordPress и откройте раздел Плагины, где найдите плагин OnlyOffice. Установите и включите его.

Затем откройте настройки WordPress, перейдите на вкладку ONLYOFFICE в левой части экрана и укажите доменное имя для OnlyOffice (например, https://onlyoffice.example.com) в поле для адреса сервиса редактирования документов.

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

Обратите внимание: OnlyOffice доступен исключительно в стандартном редакторе блоков WordPress. Его нельзя применять в классическом редакторе.

Настройка сервера для документов OnlyOffice и платформы WordPress на едином хостинге.

Документоориентированный сервер OnlyOffice применяет Nginx в роли веб-сервера.

Если у вас уже функционирует сервер WordPress на базе Nginx, установка OnlyOffice на том же компьютере не повредит вашему WordPress-серверу. В процессе установки будет удалён пакет nginx-core и установлен пакет nginx-extras, что приведёт к кратковременному простоям, однако ваши настройки останутся без изменений.

Если у вас есть функционирующий сервер WordPress с веб-сервером Apache и вы планируете установить OnlyOffice на том же устройстве, у вас есть два варианта:

1. Приостановите или удалите Apache и настройте Nginx в качестве веб-сервера для WordPress и OnlyOffice. Для настройки Nginx для WordPress вы можете обратиться к этому руководству.
2. Настроить Nginx в качестве обратного прокси-сервера для Apache.

Как произвести обновление сервера документов OnlyOffice.

При выходе обновленной версии сервера документов OnlyOffice, вы можете легко обновить её с помощью менеджера пакетов apt.

sudo apt update;sudo apt upgrade

Имейте в виду, что новая версия заменит ваши настройки в файле /etc/nginx/conf.d/ds.conf.Рекомендую сделать резервную копию этого файла с помощью следующей команды, чтобы у вас была возможность легко восстановить свои индивидуальные настройки.

cat /etc/nginx/conf.d/ds.conf | sudo tee /etc/nginx/conf.d/ds.conf.backup

Заключение

Надеюсь, данное руководство было вам полезным при интеграции OnlyOffice с WordPress. Если вы оценили этот материал, не забудьте подписаться на нашу бесплатную рассылку. Также вы можете следить за нами в Google+, Twitter или поставить лайк нашей странице на Facebook.