Установка ONLYOFFICE Docs Enterprise Edition на Debian и Ubuntu

Введение

Enterprise Edition позволяет установить ONLYOFFICE Docs на локальном сервере и интегрировать онлайн-редакторы с платформой для совместной работы ONLYOFFICE или другими популярными системами (смотрите подробный список возможностей). В данной инструкции объясняется, как установить на компьютере версию ONLYOFFICE Docs Enterprise Edition для Linux.

Системные требования

• Процессор: двухъядерный с тактовой частотой 2 ГГц или лучше
• Оперативная память: не менее 2 ГБ, но это зависит от ОС хоста. Чем больше, тем лучше
• Жесткий диск: не менее 40 ГБ свободного места
• SWAP: не менее 4 ГБ, но это зависит от ОС хоста. Чем больше, тем лучше
• ОС: 64-битная Debian, Ubuntu или другой совместимый дистрибутив с версией ядра 3.13 или выше
• Дополнительные требования
  • PostgreSQL: версия 12.9 или выше
  • NGINX: версия 1.3.13 или выше
  • libstdc++6: версия 4.8.4 или выше
  • Redis: версия 4 или выше
  • RabbitMQ

Установка ONLYOFFICE Docs

Установка на Debian-основанные дистрибутивы также требует наличия в системе libstdc++6, NGINX и PostgreSQL.

Все необходимые инструкции по установке этих компонентов и зависимостей можно найти на их официальных сайтах.

Есть и другие зависимости, которые устанавливаются совместно с ONLYOFFICE Docs:

• libcurl3
• libxml2
• fonts-dejavu
• fonts-liberation
• ttf-mscorefonts-installer
• fonts-crosextra-carlito
• fonts-takao-gothic
• fonts-opensymbol

Эти зависимости устанавливаются автоматически, если вы используете Ubuntu 14.04 LTS или выше. Для более ранних дистрибутивов может потребоваться установить их вручную.

Установка зависимостей

ONLYOFFICE Docs использует NGINX и PostgreSQL как базу данных. Зависимости, найденные в репозитории системы, будут установлены автоматически при установке ONLYOFFICE Docs командой apt-get install.

Установка и настройка PostgreSQL

Установите версию PostgreSQL, включенную в вашу версию Ubuntu:

sudo apt-get install postgresql

примечание

Если вы хотите установить какую-то другую версию PostgreSQL из репозитория PostgreSQL, обратитесь за дополнительной информацией к официальной документации PostgreSQL.

После установки PostgreSQL создайте базу данных и пользователя PostgreSQL:

примечание

Пользователь базы данных должен называться onlyoffice. Пароль можно задать любой.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Установка Redis

sudo apt-get install redis-server

Установка RabbitMQ

sudo apt-get install rabbitmq-server

Установка NGINX

sudo apt-get install nginx

примечание

В Ubuntu 18.04 вместо этого установите пакет nginx-extras: sudo apt-get install nginx-extras

Важно

Если вы планируете запускать ONLYOFFICE Docs на порту 80, отключите сайт NGINX по умолчанию сейчас. В противном случае ONLYOFFICE Docs может работать некорректно. Для этого выполните следующие команды:

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

В зависимости от способа установки NGINX одна из первых двух команд может сообщить, что файл не существует. Это сообщение можно игнорировать.

примечание

Для дистрибутивов Ubuntu, более ранних, чем 14.04 LTS, может потребоваться установка некоторых других зависимостей.

Смена порта для ONLYOFFICE Docs, используемого по умолчанию

По умолчанию ONLYOFFICE Docs слушает входящие соединения на порту 8083. Начиная с версии 4.3 вы можете сменить порт для ONLYOFFICE Docs в случае, если вы планируете использовать его вместо того, который идет по умолчанию.

примечание

Если вы меняете порт по умолчанию, убедитесь, что он открыт для входящих/исходящих соединений. Посмотрите полный список портов, которые используются ONLYOFFICE Docs.

Для этого вам нужно поменять порт по умолчанию для системы debconf. Это можно сделать с помощью команды:

echo onlyoffice-documentserver-ee onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

Вместо <PORT_NUMBER> в команде выше необходимо вписать номер порта, который будет использоваться.

примечание

Если вы задаете порт 80, убедитесь, что вы отключили сайт NGINX по умолчанию, как описано в разделе Установка NGINX.

Внимание

Если вы хотите поменять протокол ONLYOFFICE Docs на HTTPS, не меняйте порт на 443, а воспользуйтесь этой инструкцией.

Есть ряд дополнительных параметров, которые можно использовать для установки ONLYOFFICE Docs. Для получения дополнительной информации обратитесь к этому разделу.

После этого можно продолжить установку ONLYOFFICE Docs.

Установка ONLYOFFICE Docs

Добавьте GPG-ключ:

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Добавьте репозиторий ONLYOFFICE Docs:

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list

примечание

Хотя данный пакет APT собран для дистрибутива Debian Squeeze, он совместим с рядом производных Debian (включая Ubuntu), а значит, можно использовать один репозиторий для всех этих дистрибутивов.

При установке ONLYOFFICE Docs на Debian добавьте компонент contrib в /etc/apt/sources.list. Для получения дополнительной информации вы можете обратиться к документации Debian.

Обновите кэш менеджера пакетов:

sudo apt-get update

Установите mscorefonts:

sudo apt-get install ttf-mscorefonts-installer

Установите ONLYOFFICE Docs:

sudo apt-get install onlyoffice-documentserver-ee

примечание

В ходе установки будет запрошен пароль для пользователя onlyoffice в PostgreSQL. Введите пароль onlyoffice, который был задан при настройке PostgreSQL.

После этого ONLYOFFICE Docs будет запущен как процесс. Пакет будет обновляться, как любой другой deb-пакет.

Теперь вы можете ввести http://localhost:8083 в адресной строке браузера, чтобы открыть страницу приветствия ONLYOFFICE Docs, где приводятся дальнейшие инструкции о том, как подключить примеры документов или интегрировать онлайн-редакторы в веб-приложение с помощью API.

Запуск ONLYOFFICE Docs с использованием HTTPS

В большинстве случаев доступ к порталу по протоколу HTTPS намного безопаснее, чем по протоколу HTTP, который используется по умолчанию. ONLYOFFICE Docs можно легко запустить, используя безопасное соединение. Дополнительную информацию о том, как это сделать, можно найти здесь.

Регистрация вашей версии Enterprise Edition

Если вы купили Enterprise Edition и получили файл license.lic, вы можете поместить его в инсталляцию для получения полной версии программы.

Если вы используете дистрибутив Linux на базе Debian, файл license.lic помещается в следующую папку:

/var/www/onlyoffice/Data/license.lic

После этого ваша версия Enterprise Edition станет зарегистрированной и полнофункциональной.

Дополнительная информация: дополнительные параметры для установки ONLYOFFICE Docs

Установка ONLYOFFICE Docs позволяет использовать дополнительные параметры debconf, которые могут быть очень полезны в том случае, если вы хотите установить его на нескольких серверах, или в некоторых других случаях.

Эти параметры включают в себя:

• Параметры базы данных PostgreSQL

  • Задайте адрес хоста базы данных PostgreSQL (заменив <DB_HOST> на действительный адрес установленного сервера PostgreSQL):

    echo onlyoffice-documentserver-ee onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

  • Задайте имя пользователя базы данных PostgreSQL (заменив <DB_USER> на действительное имя пользователя с соответствующими правами доступа к базе данных PostgreSQL):

    echo onlyoffice-documentserver-ee onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

  • Задайте пароль пользователя базы данных PostgreSQL (заменив <DB_PASSWORD> на действительный пароль пользователя с соответствующими правами доступа к базе данных PostgreSQL):

    echo onlyoffice-documentserver-ee onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections

  • Задайте имя базы данных PostgreSQL (заменив <DB_NAME> на действительное имя базы данных PostgreSQL):

    echo onlyoffice-documentserver-ee onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

• Параметры Redis

  • Задайте адрес хоста Redis (заменив <REDIS_HOST> на действительный адрес установленного Redis):

    echo onlyoffice-documentserver-ee onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

• Параметры RabbitMQ

  • Задайте адрес хоста RabbitMQ (заменив <RABBITMQ_HOST> на действительный адрес установленного RabbitMQ):

    echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

  • Задайте имя пользователя RabbitMQ (заменив <RABBITMQ_USER> на действительное имя пользователя с соответствующими правами доступа к RabbitMQ):

    echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections

  • Задайте пароль пользователя RabbitMQ (заменив <RABBITMQ_PWD> на действительный пароль пользователя с соответствующими правами доступа к RabbitMQ):

    echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

• Параметры JWT

  Вы можете использовать debconf-set-selections, чтобы избежать перезаписи пользовательских значений в файле local.json после обновления ONLYOFFICE Docs.

  • Включите JSON Web Tokens (JWT):

    echo onlyoffice-documentserver-ee onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

  • Задайте секретный ключ JWT, заменив <JWT_SECRET> на свое значение:

    echo onlyoffice-documentserver-ee onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections