Установка ONLYOFFICE Docs на Debian, Ubuntu и производные

Введение

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

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

• Процессор: двухъядерный с тактовой частотой 2 ГГц или лучше
• Оперативная память: не менее 2 ГБ, но это зависит от ОС хоста. Чем больше, тем лучше
• Жесткий диск: не менее 40 ГБ свободного места
• SWAP: не менее 4 ГБ, но это зависит от ОС хоста. Чем больше, тем лучше
• ОС: 64-битная Debian 12, Ubuntu 18.04 или другой совместимый дистрибутив
• Дополнительные требования
  • NGINX: версия 1.30 или выше

Установка ONLYOFFICE Docs

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

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

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

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

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

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

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

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

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

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

примечание

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

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

echo onlyoffice-documentserver 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

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

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

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

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

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

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

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

• Параметры JWT

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

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

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

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

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