Portal Office

Эта инструкция рассчитана на администратора, который уже установил Portal и хочет включить онлайн-редактор документов (Word / Excel / PowerPoint в браузере через WOPI).

Читайте сверху вниз. На каждом шаге есть команда и проверка.
Отдельный тариф и модуль в ключе не нужны: достаточно действующей лицензии Portal (подписка, бессрочная или trial).

Скачивание пакетов: korport.ru/portal-office. Поддержка — у вендора Portal. Образ: portal/office (MPL-2.0).

---

0. Что вы получите в итоге

После всех шагов:

1. Служба Portal Office отвечает на порту 9980 (discovery).
2. В конфиге Portal указаны publicUrl / internalUrl (или env PORTAL_OFFICE_*).
3. Документы из библиотек открываются в браузере в редакторе.

---

1. Как получить Office в вашей поставке

Канал Portal	Платформа	Что делать
Docker Compose	Хост с Docker	Уже в images/portal-images.tar (portal/office). Сервис office в compose.
Kubernetes / Helm	Кластер	То же portal-images.tar / registry. Chart поднимает Office.
Native	Linux	Не в native-бандле. Скачайте пакет Linux systemd или Docker на korport.ru.
Native	Windows	Не в native-бандле. Пакет Docker (Docker Desktop) или Office на отдельном Linux-хосте. Нативного Windows-сервера coolwsd нет.
Любой	Отдельный хост редактора	Пакет linux или docker с korport.ru + URL в конфиге Portal.
Любой	Без редактора	office.enabled: false / PORTAL_OFFICE_ENABLED=false.

Air-gap

Канал	Office офлайн
Docker / K8s	Внутри portal-images.tar основного bundle
Native	На машине с интернетом скачайте office-пакет (ключ + привязка), перенесите архив в контур

---

2. Выберите свой раздел

Ситуация	Откройте
Portal уже в Docker/K8s — Office в том же стеке	Обычно уже есть; проверьте конфиг в §6
Нужен отдельный пакет (Native / другой хост)	§3, затем §4 или §5
Linux без Docker	§4
Docker Engine / Desktop	§5
Обновление Office	§7

---

3. Скачать пакет с korport.ru

Условия

Условие
Отдельный платный SKU	Нет
Право	Действующий LICENSE.key, привязка совпадает, лицензия не отозвана
Канал / платформа лицензии	Не ограничивают выбор пакета Office
Версия	Активный релиз на korport.ru (та же линейка, что у Portal)

Шаг 3.1. В браузере

1. Откройте korport.ru/portal-office.
2. Возьмите Привязку из Portal: Админка → Настройки → Продукт и лицензия.
3. Вставьте содержимое LICENSE.key.
4. Выберите пакет: Linux (systemd) или Docker.
5. Скачайте архив по одноразовой ссылке.

Шаг 3.2. Какой пакет выбрать

Пакет	Когда
portal-{V}-office-linux-amd64.tar.gz	Linux без Docker: systemd
portal-{V}-office-docker.tar.gz	Docker Desktop / Engine (Windows или Linux)

Шаг 3.3. API (для автоматизации)

POST /api/portal/office/entitle
Content-Type: application/json

{
  "licenseKey": "<LICENSE.key>",
  "installBinding": "<sha256>",
  "variant": "linux"
}

variant: linux | docker. В ответе — downloadUrl.

Актуальная версия без ключа:

curl -sS https://korport.ru/api/portal/office/version

---

4. Установка: Linux (systemd)

Шаг 4.1. Распаковка и установка

tar -xzf portal-*-office-linux-amd64.tar.gz
cd portal-*-office-linux-amd64
sudo ./install/install-root.sh

Шаг 4.2. Проверка

systemctl status portal-office --no-pager
curl -sS http://127.0.0.1:9980/hosting/discovery | head

Ожидается: служба active (running), curl возвращает XML discovery.

Конфиг:

• /etc/portal-office/portal-office.env
• /etc/coolwsd/coolwsd.xml

Дальше — §6.

---

5. Установка: Docker

Шаг 5.1. Распаковка, load, запуск

tar -xzf portal-*-office-docker.tar.gz
cd portal-*-office-docker
docker load -i images/portal-office.tar
cp .env.example .env
# при необходимости отредактируйте .env
docker compose up -d

Шаг 5.2. Проверка

docker compose ps
curl -sS http://127.0.0.1:9980/hosting/discovery | head

Ожидается: контейнер Up, discovery отвечает.

Дальше — §6.

---

6. Подключение к Portal

Шаг 6.1. Конфиг Portal

В portal.config.yaml (или через env после install):

office:
  enabled: true
  publicUrl: https://office.company.ru
  internalUrl: http://office-internal:9980

Правила:

1. publicUrl — адрес, который открывает браузер пользователя.
2. WOPI_HOST_URL Portal должен быть доступен из хоста Office (не localhost с точки зрения контейнера Office, если Portal на другой машине — укажите реальный URL).
3. За reverse-proxy: обычно SSL на proxy, у coolwsd ssl.enable=false.

Без редактора:

office:
  enabled: false

или PORTAL_OFFICE_ENABLED=false.

Шаг 6.2. Перезапуск API / стека

Docker:

docker compose up -d --force-recreate backend
curl -sS http://127.0.0.1/health

Native Linux:

sudo systemctl restart portal-api
curl -sS http://127.0.0.1/health

Шаг 6.3. Проверка в браузере

1. Войдите в Portal.
2. Откройте библиотеку документов.
3. Откройте файл Word/Excel/PowerPoint — должен открыться редактор Portal Office.

Если документ не открывается — проверьте WOPI_HOST_URL и PORTAL_OFFICE_PUBLIC_URL / office.publicUrl. См. Устранение неполадок.

---

7. Обновление

Канал	Как обновляется Office
Docker / K8s (в одном стеке с Portal)	Вместе с Portal: новый portal/office в portal-images.tar + portal-cli upgrade / кнопка Обновить
Native / отдельный хост	Отдельно: Админка → Продукт и лицензия → Проверить версию Office → скачать пакет на korport.ru → переустановить (§4 или §5). Update-runner Portal Office не ставит.

Версия на хосте Office: /browser/dist/portal-office-version.json.
Запасной вариант на API Portal: env PORTAL_OFFICE_VERSION.

Проверка discovery после обновления:

curl -sS http://127.0.0.1:9980/hosting/discovery | head

---

8. Справка в редакторе

В меню Справка Portal Office:

Пункт	Назначение
Online Help	Руководство пользователя: Portal Office (https://korport.ru/docs/user/portal-office)
Сообщить о проблеме	korport.ru/support
О программе	Ссылка на ту же документацию
Форум	Скрыт

Настраивается при сборке образа.

---

9. Связанные документы

• Portal Office для пользователей
• Какой вариант установки выбрать
• Лицензии и тарифы
• Native Linux · Native Windows
• Внешние сервисы · Офлайн установка
• Устранение неполадок