В данном руководстве описан процесс подготовки виртуальной машины для использования в качестве редакторов документов.
Подготовка системы и загрузка образа
Установите ОС AlterOS в режиме «Сервер».
При необходимости выполните базовую настройку сетевых параметров.
3. Подключение дополнительного репозитория
Подключите дополнительный репозиторий alteros-extras:
sudo yum install alteros-extras-release
4. Установка Docker и Docker Compose
Установите необходимые пакеты:
sudo yum install docker*
5. Запуск и автозагрузка Docker
Запустите службу Docker и добавьте её в автозагрузку:
sudo systemctl start docker
sudo systemctl enable docker
6. Загрузка образа AlterOffice Online
Создайте рабочий каталог, скачайте архив с образом и загрузите его:
sudo mkdir /opt/alteroffice-cloud
sudo chmod -R 777 /opt/alteroffice-cloud
cd /opt/alteroffice-cloud
curl -O https://repo.alteroffice.ru/test/alteros/9/x86_64/cloud/alteroffice-online.tar.gz
docker load < alteroffice-online.tar.gz
После загрузки будет выведено сообщение:
Loaded image: alteroffice-online:26-11-24
7. Проверка загруженного Docker-образа
Проверьте, что образ загружен:
sudo docker images
Ожидаемый вывод:
REPOSITORY TAG IMAGE ID CREATED SIZE
alteroffice-online 26-11-24 8fb5d64afedc 3 months ago 6.48GB
Настройка и запуск AlterOffice Online
1. Способы настройки
1.1 Через переменные окружения
|
Переменная |
Описание |
|
username |
Имя пользователя для консоли администратора. |
|
password |
Пароль для консоли администратора. |
|
DONT_GEN_SSL_CERT |
Наличие данной переменной окружения (непустое значение) отключает генерацию нового SSL-сертификата, подписанного тестовым УЦ, что позволяет использовать собственный сертификат. |
|
cert_domain |
Наличие данной переменной окружения (непустое значение) приводит к генерации SSL-сертификата тестовым УЦ для указанного доменного имени, а не для localhost. |
|
server_name |
Если данная переменная окружения задана (не пустая), её значение будет использоваться в качестве имени сервера в файле /etc/coolwsd/coolwsd.xml. Без этого параметра AlterOffice Online не всегда сможет передать корректный хост для WebSocket-подключения при использовании прокси. |
|
dictionaries |
По умолчанию в AlterOffice Online предустановлен ограниченный набор орфографических словарей и тезаурусов, что обусловлено соображениями производительности. Стандартный набор языков включает: de_DE, en_GB, en_US, es_ES, fr_FR, it, nl, pt_BR, pt_PT, ru. С помощью переменной окружения dictionaries можно изменить этот список. Переменная должна содержать разделённый пробелами перечень языковых кодов (с возможным указанием кода страны). Для оптимизации использования ресурсов рекомендуется загружать только те словари, которые действительно необходимы. |
|
extra_params |
С помощью данной переменной окружения можно передать дополнительные параметры командной строки для AOO. Например, для запуска без SSL в тестовых целях используется синтаксис:-e "extra_params=--o:ssl.enable=false". Полный перечень доступных параметров приведён в конфигурационном файле /etc/coolwsd/coolwsd.xml внутри Docker-образа. |
docker run -t -d --privileged -p 9980:9980 \
--add-host="<WOPI_HOSTNAME>:<WOPI_IP>" \
-e "username=admin" \
-e "password=admin" \
-e "extra_params=--o:ssl.enable=false --o:ssl.termination=false" \
--restart always \
alteroffice-online:26-11-24
-t - Выделяет псевдо-TTY (терминал) для контейнера (нужно для интерактивных процессов).
-d – Запускает контейнер в фоновом режиме (демоном).
--privileged - Этот параметр дает контейнеру привилегированные права. Фактически, контейнер получает практически те же возможности, что и сам хост.
-p - Пробрасывает порт. Для работы сервиса необходимо пробрость только основной порт 998
--add-host="host:ip" - Позволяет добавить пользовательскую запись в файл /etc/hosts внутри контейнера. Необходим для коммуникации с WOPI host в случае работы через proxy server.
-e - Передача переменных окружения. Описание базовых настроек описаны в таблице выше. Описание детальных настроек "extra_params" можно найти в прикреплённом файле.
--restart always - Автоматический перезапуск контейнера после сбоя.
extra_params, доступно в конфигурационном файле coolwsd.xml. 1.2 Через конфигурационный файл (coolwsd.xml)
Позволяет задать расширенную конфигурацию с полным контролем параметров.
Шаги:
- Создайте каталог с конфигурацией:
mkdir -p /opt/alteroffice-cloud/coolwsd
cd /opt/alteroffice-cloud/coolwsd
- Переместите coolwsd.xml в созданную директорию.
- Отредактируйте coolwsd.xml
- Запустите контейнер с примонтированной конфигурацией:
docker run --name alteroffice-online -t -d --privileged \
-p 9980:9980 \
--add-host="<WOPI_HOSTNAME>:<WOPI_IP>" \
-v /opt/alteroffice-cloud/coolwsd/coolwsd.xml:/etc/coolwsd/coolwsd.xml \
--restart always \
alteroffice-online:26-11-24
Настройка SSL соединения.
Ниже приведён пример запуска контейнера с SSL.
docker run -t -d --privileged -p 9980:9980 \
--add-host="<WOPI_HOSTNAME>:<WOPI_IP>" \
-e "username=admin" \
-e "password=admin" \
-e "DONT_GEN_SSL_CERT=1" \
-e "extra_params=--o:ssl.enable=true --o:ssl.termination=false --o:ssl.cert_file_path=/usr/local/share/ca-certificates/cert.pem --o:ssl.key_file_path=/usr/local/share/ca-certificates/privkey.pem --o:ssl.ca_file_path=/usr/local/share/ca-certificates/fullchain.pem" \
-v /home/user/aoo/ssl:/usr/local/share/ca-certificates \
--restart always \
alteroffice-online:26-11-24
Для настройки используются дополнительные параметры:
-v /home/user/aoo/ssl:/usr/local/share/ca-certificates \ - монтирование директории с сертификатами
-e "DONT_GEN_SSL_CERT=1" - для использования собственных сертификатов
--o:ssl.enable=true - включение SSL
--o:ssl.termination=false - отключение режима терминирования SSL на прокси
--o:ssl.cert_file_path, --o:ssl.key_file_path, --o:ssl.ca_file_path - указание путей до сертификата, ключа и цепочки сертификатов.
Доступ в консоль администратора:
Консоль администратора доступна по следующим адресам:
Локальный доступ:
https://localhost:9980/browser/dist/admin/admin.htmlДоступ по доменному имени:
https://<dns_name>:9980/browser/dist/admin/admin.html(замените <dns_name> на соответствующее DNS-имя вашего сервера)