Установка ONLYOFFICE Docs Developer Edition на Debian ARM64

Введение

Developer Edition позволяет установить ONLYOFFICE Docs на локальном сервере и интегрировать онлайн-редакторы с вашим веб-приложением (смотрите подробный список возможностей). В данной инструкции объясняется, как установить ONLYOFFICE Docs Developer Edition версии 7.1 и выше на Ubuntu 18.04 или Ubuntu 20.04 для 64-битной архитектуры ARM.

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

• Процессор: 64-битный процессор ARM

• Оперативная память: не менее 2 ГБ, но это зависит от ОС хоста. Чем больше, тем лучше

• Жесткий диск: не менее 40 ГБ свободного места

• SWAP: не менее 4 ГБ, но это зависит от ОС хоста. Чем больше, тем лучше

• ОС: Ubuntu 18.04 или Ubuntu 20.04 для arm64

  примечание

  В настоящее время Ubuntu 16.04 не поддерживается.

• Дополнительные требования

  • 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 18.04 LTS или Ubuntu 20.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

Важно

Если вы планируете запускать 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, одна из первых двух команд может сообщить, что файл не существует. Это сообщение можно спокойно проигнорировать.

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

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

примечание

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

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

echo onlyoffice-documentserver-de 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-ключ:

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

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

echo "deb 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-de

примечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Параметры Redis

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

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

• Параметры RabbitMQ

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

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

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

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

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

    echo onlyoffice-documentserver-de 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-de onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

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

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