Если всё окно ONLYOFFICE выглядит размытым, проверьте масштабирование экрана Linux, прежде чем изменять файлы шрифтов или настройки Fontconfig. Если некорректно отображается только текст внутри документа, проверьте, не используется ли в документе шрифт, отсутствующий или замененный на вашем компьютере. Это разные проблемы, требующие разных решений.
После каждого изменения закрывайте и снова открывайте ONLYOFFICE, затем просматривайте тот же документ в окне того же размера. Это простое сравнение поможет вам избежать одновременного изменения нескольких настроек и позволит понять, какое изменение имело значение. Если вы не уверены, связана ли проблема только с редактором, сравните мелкий текст в другом настольном приложении на том же экране.
Размытые края в меню, надписях на панелях инструментов и тексте документа часто указывают на масштабирование экрана или способ отображения приложения. Дробное масштабирование, например, 125% или 150%, может быть причиной на некоторых комбинациях настольных компьютеров и графических процессоров Linux. Это не является доказательством универсального дефекта ONLYOFFICE: на результат влияют сервер отображения, среда рабочего стола, формат пакета, графический драйвер и версия приложения.
Для быстрой проверки откройте настройки дисплея вашей среды рабочего стола и временно переключитесь на стандартный масштаб, например, 100% или 200%, если эти значения подходят для вашего экрана. Выйдите из системы и войдите снова, если это требуется для вашей среды рабочего стола, затем снова запустите ONLYOFFICE. В GNOME соответствующий параметр находится в разделе «Настройки» > «Дисплеи»; в других средах рабочего стола используются другие названия, и могут быть доступны другие значения масштабирования. Если изображение в приложении становится четким при стандартном масштабе, размытие, вероятно, связано с дробным масштабированием или путем к файлу отображения. В качестве практического решения выберите наиболее удобный для использования масштаб или проверьте текущую документацию вашей среды рабочего стола на предмет поддерживаемых параметров HiDPI.
Тип сессии можно определить в терминале с помощью команды ` echo "$XDG_SESSION_TYPE"gvn - wayland...x11
В одном из сообщений ONLYOFFICE Desktop Editors описан конкретный случай в GNOME 45 Wayland при масштабировании до 125%, когда пользователь заметил размытие интерфейса и документа, в то время как в KDE Wayland наблюдалось другое поведение. Рассматривайте это сообщение как доказательство того, что симптом может зависеть от среды, а не как гарантированное решение для каждой системы Linux. См. сообщение ONLYOFFICE о масштабировании до 125% в GNOME .
В ONLYOFFICE есть опция масштабирования интерфейса приложения для Linux, и в истории релизов указана поддержка значений масштабирования интерфейса, включая 125%, 150% и 175%. Точные параметры могут различаться в зависимости от релиза. Откройте настройки приложения и найдите параметр масштабирования интерфейса или приложения; если название или расположение отличаются, обратитесь к справке для установленной версии, а не к пути в меню более старой версии.
Для проверки измените только масштаб интерфейса приложения, затем перезапустите редактор, если потребуется. Масштабирование интерфейса изменяет размер элементов управления приложения. Масштабирование документа изменяет размер страницы внутри редактора. Увеличение масштаба документа может облегчить чтение текста, но не исправит нечеткость текста на панели инструментов или низкое разрешение масштабирования всего окна. И наоборот, уменьшение масштаба интерфейса может сделать элементы управления более четкими в одной конфигурации, но при этом слишком мелкими для использования. Выберите параметр, который остается читаемым, и сравните панель инструментов и страницу.
Для справки, в списке изменений ONLYOFFICE Desktop Editors указана поддержка масштабирования интерфейса на 125% и 175% для Linux, а в более ранней записи о выпуске — поддержка 150%. На момент проверки этой статьи указана версия списка изменений 9.4.0, выпущенная 19 мая 2026 года. На этой странице не указано, что все варианты масштабирования рабочего стола одинаково хорошо работают на всех дистрибутивах.
Если меню отображаются четко, но в конкретном документе буквы размыты, необычно широки или заметно отличаются от оригинала, проверьте семейство шрифтов. В документе может быть указан шрифт, который не установлен в вашей системе Linux. В этом случае редактору приходится отображать альтернативный шрифт, который может изменять форму букв, переносы строк, количество страниц и интервалы. Изменение макета не то же самое, что размытое отображение на экране, но альтернативный шрифт может настолько исказить текст, что его можно принять за проблему с отображением.
В терминале проверьте семейство шрифтов, используемое в документе, с помощью инструмента сопоставления Fontconfig. Например:
fc-match ArialЭта команда выводит шрифт, соответствующий данному семейству, в Fontconfig. Если вы проверяете многословное имя шрифта, заключите его в кавычки, например, ` fc-match "Liberation Serif".`. Полученный результат не обязательно означает, что ONLYOFFICE использует точно такой же резервный вариант на каждом этапе своего конвейера рендеринга; это практическая проверка шрифтов, доступных в системе шрифтов Linux.
Установите необходимый шрифт из надежного источника и убедитесь, что его лицензия разрешает его использование. В документации ONLYOFFICE указаны расположения шрифтов для каждого пользователя, например, ~/.local/share/fontsв системном /usr/share/fonts/каталоге. Для персональной установки скопируйте поддерживаемый файл шрифта в подпапку ~/.local/share/fonts, а затем обновите кэш шрифтов пользователя с помощью fc-cache -fкоманды `npm install - ...
После установки шрифта полностью закройте и перезапустите ONLYOFFICE. В официальных инструкциях ONLYOFFICE по добавлению шрифтов также указано, что после установки необходимо перезапустить редактор. Снова откройте тот же файл и проверьте, появился ли выбранный шрифт в списке шрифтов и соответствует ли расположение текста ожиданиям.
Fontconfig хранит информацию о шрифтах и файлы кэша. Если вы только что установили, удалили или обновили шрифты, но приложения по-прежнему не видят изменений, обновите кэш и перезапустите ONLYOFFICE:
fc-cache -fВ системах, где шрифты установлены глобально, менеджер пакетов вашего дистрибутива может обновлять кэш шрифтов в процессе установки. Выполнение этой команды является разумным шагом обновления, но оно не исправит размытие, вызванное дробным масштабированием экрана, композитором или графическим драйвером. Не удаляйте каталоги кэша Fontconfig в первую очередь. В документации пользователя Fontconfig описаны места расположения конфигурационных файлов и кэша, а также отмечено, что некоторые старые расположения для каждого пользователя устарели.
Если проблема затрагивает весь редактор при обычном масштабировании, обновите ONLYOFFICE Desktop Editors, используя тот же поддерживаемый канал установки, который вы уже используете, а затем повторите тестирование. На официальной странице ONLYOFFICE по началу работы есть ссылка на руководство по установке для Linux. Пользователям AppImage необходимо загрузить более новую версию AppImage для обновления в соответствии с официальными инструкциями AppImage . Избегайте смешивания пакетов из разных каналов при устранении неполадок; сначала убедитесь, какую сборку вы запускаете из меню приложения или терминала.
Теперь создайте пустой документ с распространенным установленным шрифтом и сравните его с проблемным файлом. Если пустой документ четкий, а один файл — нет, сосредоточьтесь на выборе шрифтов, встроенных изображениях и масштабировании этого файла. Если каждый файл и каждая часть приложения остаются размытыми, это указывает на проблему с масштабированием или на путь к графическому интерфейсу/дисплею Linux. Однократный экспорт в PDF может помочь отличить предварительный просмотр на экране от вывода документа, но это не является полной проверкой рендеринга на экране: программы просмотра PDF и принтеры используют свои собственные пути рендеринга.
fc-matchименованный шрифт, при необходимости установите лицензионный шрифт, обновите поиск и перезапустите редактор.В Linux нет единого параметра рендеринга шрифтов, который бы решал все проблемы. Надежным конечным результатом является повторяемое сравнение: один и тот же текст выглядит четко при удобном масштабе, ожидаемые шрифты доступны, а макет документа остается правильным. Если изменение масштаба системы решает проблему с окном, но делает работу с другими приложениями непрактичной, сохраните это наблюдение и сообщите подробности об окружении в проект ONLYOFFICE или в канал поддержки вашего дистрибутива, вместо того чтобы вносить масштабные и необратимые изменения в конфигурацию шрифтов.
Подключите Seafile к Collabora Online с помощью Docker или отдельного хоста. Сравните компромиссы при развертывании, настройте параметры HTTPS и WOPI и проверьте корректность редактирования.
Диагностика медленной печати, прокрутки и сохранения файлов LibreOffice Writer, содержащих большое количество изображений. Проверка настроек дисплея, сжатие изображений большого размера и выявление проблем с профилем или оборудованием.
Разверните Collabora CODE в Kubernetes с помощью официального Helm-диаграммы. Настройте входящий трафик, TLS, доступ к хосту WOPI, секреты, масштабирование и сквозные проверки.
Уменьшите размер большой презентации LibreOffice Impress, сжав фотографии большого размера, выбрав разумное разрешение и качество JPEG, а также проверив сохраненный файл, не жертвуя при этом читаемостью слайдов.
Установите Collabora Online CODE в Docker, безопасно опубликуйте его через обратный прокси-сервер, подключите к Nextcloud Office и проверьте возможность редактирования документов в браузере.
Диагностика ошибок памяти ONLYOFFICE Docs на VPS, проверка ограничений хоста и Docker, просмотр логов и забытых документов, безопасное добавление файла подкачки и перезапуск без риска потери активных правок.
Для устранения неполадок с копированием и вставкой в Collabora Online в локальных приложениях проверьте сочетания клавиш, разрешения буфера обмена браузера, HTTPS, политики iframe и форматы контента.
Чтобы исправить размытый текст в настольных редакторах ONLYOFFICE на Linux, проверьте масштабирование экрана, масштабирование интерфейса приложения, доступность шрифтов и область рендеринга в безопасном порядке.
Узнайте, как добавлять элементы управления формами Writer, устанавливать метки и порядок перехода по вкладкам, экспортировать данные с включенной функцией создания PDF-форм и тестировать интерактивный PDF-файл перед его отправкой.
Узнайте, как блокировать печать и загрузку документов в интеграциях ONLYOFFICE Workspace, DocSpace или Docs, и проверьте, какие элементы управления применяются к каждому способу совместного доступа.
