Чтобы настроить отображение пользовательского шрифта в Collabora Online CODE, работающем в Docker, храните файлы шрифтов на хосте и смонтируйте один и тот же каталог как в системный каталог шрифтов контейнера, так и в его системную папку документа. Системная папка предоставляет файлы изолированным процессам обработки документов; монтирование шрифтов только в эту папку /usr/share/fontsможет привести к тому, что семейство шрифтов появится в меню шрифтов, но не будет отображаться в документе. В этом руководстве используется Docker Compose и текущий путь к образу CODE /opt/cool/systemplate; проверьте путь, если вы используете другой путь к образу.
Обычно для одного хоста Docker наиболее простым вариантом является монтирование контейнера CODE только для чтения. Это позволяет сохранить файлы шрифтов при пересоздании или обновлении контейнера CODE, а также проверить, какие именно файлы контейнер может читать. Используйте файлы шрифтов, которые вы имеете право устанавливать и распространять на сервере. Не копируйте весь каталог шрифтов настольной системы, если вы не проверили ее лицензии и вам не нужны эти файлы.
Используйте несжатые файлы шрифтов в форматах, поддерживаемых вашей средой, обычно это TrueType ( .ttf) или OpenType ( .otf). Включите необходимые для ваших документов стили, такие как обычный, полужирный, курсив и полужирный курсив. Указывайте чёткость названий семейств шрифтов и имен файлов, а также убедитесь, что пользователь контейнера может читать все каталоги и файлы. Шрифт, содержащий только один стиль, может привести к тому, что Collabora заменит его другим шрифтом, когда документ запросит полужирный или курсивный.
Сначала создайте отдельный каталог на хосте и скопируйте в него разрешенные файлы:
sudo mkdir -p /srv/collabora/fonts
sudo cp BrandSans-Regular.ttf BrandSans-Bold.ttf /srv/collabora/fonts/
sudo chmod -R a+rX /srv/collabora/fontsЗамените приведенные примеры имен файлов на ваши реальные файлы шрифтов. Права доступа на чтение важны, поскольку процесс CODE запускается от имени непривилегированной учетной записи в текущих образах. Сохраняйте путь к каталогу неизменным; привязки Compose будут ссылаться на него.
В существующую collaboraслужбу docker-compose.ymlдобавьте следующие записи тома. Сохраните существующий образ, порты, список разрешенных доменов, настройки SSL, секреты и политику перезапуска; в приведенном ниже фрагменте показаны только точки монтирования шрифтов.
services:
collabora:
volumes:
- /srv/collabora/fonts:/usr/share/fonts/truetype/more:ro
- /srv/collabora/fonts:/opt/cool/systemplate/usr/share/fonts/truetype/more:roПервый целевой объект делает шрифты доступными для обычного механизма обнаружения шрифтов контейнера. Второй целевой объект помещает их внутрь шаблона, используемого для подготовки изолированных сред документов. В руководстве по SDK Collabora описана эта схема двухпозиционного размещения томов для Docker. Не следует монтировать поверх всего каталога /usr/share/fontsили системной директории: это может скрыть шрифты, уже предоставленные образом.
Путь к системной плате зависит от версии. Текущие метаданные образа CODE 26.04 указывают /opt/cool/systemplateпуть к системному шаблону, и в текущей документации Collabora используется именно это местоположение. Если вы используете более старый образ или сборку от конкретного поставщика, перед редактированием целевого пути ознакомьтесь с документацией или конфигурацией запуска этого образа.
После сохранения файла Compose и размещения файлов шрифтов на хосте, пересоздайте службу CODE, чтобы Docker применил привязку монтирования:
docker compose up -d --force-recreate collabora
docker compose exec -T collabora fc-listВ выходных данных найдите название семейства шрифтов или путь к смонтированному файлу. Чтобы сузить список, передайте grepв качестве параметра название семейства шрифтов, указанное самим шрифтом, например:
docker compose exec -T collabora fc-list | grep -i "Brand Sans"Если команда не выдает результат, проверьте путь к хосту, права доступа к файлам, отступы монтирования и журналы контейнера. Вы можете проверить фактические точки монтирования с помощью команды docker inspectв запущенном контейнере или использовать команду docker compose configдля обнаружения ошибок отступов в YAML-файлах. Запуск команды docker compose downобычно не требуется только для применения изменений тома; достаточно пересоздать службу.
Откройте тестовый документ через стандартную интеграцию Nextcloud или WOPI, выделите небольшой фрагмент текста и выберите пользовательское семейство шрифтов в палитре. Наберите новую строку этим шрифтом, сохраните, закройте и снова откройте файл. Проверьте обычный и полужирный текст, а также сравните переносы строк или макет страницы с исходным документом. Появление семейства шрифтов в меню — это лишь проверка на наличие проблем; видимый текст после повторного открытия — это полезная проверка рендеринга.
fc-listвыходные данные и журналы запуска контейнера.Привязка монтирования обеспечивает независимость шрифтов от образа CODE, но не гарантирует идентичное расположение на каждом клиенте или в каждом документе. Замена шрифтов, отсутствующие глифы, разные версии шрифтов и форматирование, специфичное для документа, по-прежнему могут изменять перенос строк. Для получения дополнительных сведений о настройке используйте документацию Collabora по установке шрифтов , руководство по образу CODE Docker и руководство по Collabora Online SDK . Пример Docker в руководстве и текущую документацию по образу следует проверить еще раз при смене версий CODE.
Смонтируйте файлы шрифтов в Docker и системную панель Collabora, чтобы пользовательские шрифты отображались в редакторе и корректно отображались в документах.
Создайте резервную копию файла coolwsd.xml и его исходных файлов развертывания, безопасно восстановите их и проверьте код, прежде чем пользователи вернутся к редактированию.
Разрешите использование именно Nextcloud или другого источника WOPI в коде, затем проверьте список разрешенных активных хостов и сопоставьте его с ограничением Nextcloud по IP-адресу источника.
Проанализируйте соединения Collabora с браузером, WOPI и WebSocket, чтобы выяснить, почему документ не открывается, а затем примените исправление, соответствующее вашей настройке Nextcloud.
Разверните реплики Collabora CODE с помощью Helm, разместите каждый документ в отдельном поде с помощью привязки WOPI и проверьте входящий трафик, размещение узлов и редактирование в Nextcloud.
Проследите за ошибкой установления соединения между браузером и coolwsd, затем сопоставьте маршрут обратного прокси с вашей версией Collabora, включая изменение Apache в коде 26.04.
Обнаруживайте причины сбоев подтверждения WOPI в Collabora, такие как несоответствие ключей, устаревшие данные обнаружения, смещение времени или изменения URL-адресов прокси-сервера, — без ослабления проверки.
Сбросьте масштаб браузера, протестируйте чистую сессию и определите, когда меню с некорректным размером требует обновления сервера Collabora.
Разверните Collabora CODE с помощью Docker, безопасно подключите его к Nextcloud Office и проверьте корректность редактирования документов с помощью практических проверок WOPI и прокси-сервера.
Временно переведите coolwsd в режим отладки, зафиксируйте одну неудачную попытку открытия и используйте последовательность логов для разделения проблем, связанных с WebSocket, WOPI, прокси и контейнерами.
