Si toda la ventana de ONLYOFFICE se ve borrosa, pruebe el escalado de pantalla de Linux antes de cambiar los archivos de fuente o la configuración de Fontconfig. Si solo el texto dentro de un documento se ve mal, compruebe si el documento utiliza una fuente que falta o que ha sido sustituida en su equipo. Estos son problemas diferentes y requieren soluciones diferentes.
Cierre y vuelva a abrir ONLYOFFICE después de cada cambio y, a continuación, revise el mismo documento con el mismo tamaño de ventana. Esta sencilla comparación le ayudará a evitar modificar varias configuraciones a la vez y a identificar claramente qué cambio fue el relevante. Si no está seguro de si el problema es específico del editor, compare el texto pequeño en otra aplicación de escritorio en la misma pantalla.
Los bordes borrosos en menús, etiquetas de barras de herramientas y texto de documentos suelen indicar problemas con el escalado de la pantalla o la forma en que se muestra la aplicación. El escalado fraccional, como el 125 % o el 150 %, puede influir en algunas combinaciones de escritorio y tarjeta gráfica de Linux. Esto no demuestra un defecto generalizado de ONLYOFFICE: el servidor de visualización, el entorno de escritorio, el formato del paquete, el controlador gráfico y la versión de la aplicación también afectan al resultado.
Para una prueba rápida, abre la configuración de pantalla de tu entorno de escritorio y cambia temporalmente a una escala estándar, como 100 % o 200 %, si estas opciones se ajustan a tu pantalla. Cierra sesión y vuelve a iniciarla si tu escritorio lo requiere, y luego ejecuta ONLYOFFICE de nuevo. En GNOME, el control correspondiente se encuentra en Configuración > Pantallas; otros entornos de escritorio usan nombres diferentes y pueden ofrecer incrementos de escala distintos. Si la aplicación se ve nítida a una escala estándar, es probable que el desenfoque esté relacionado con el escalado fraccional o la ruta de visualización. Elige la escala más nítida y utilizable como solución práctica, o consulta la documentación actual de tu escritorio para ver las opciones HiDPI compatibles.
Puedes identificar el tipo de sesión desde una terminal con echo "$XDG_SESSION_TYPE". El resultado suele ser waylando x11. Esto no diagnostica la pila gráfica por sí solo, pero proporciona información útil si necesitas comparar el comportamiento entre sesiones o informar de un problema reproducible. No copies comandos antiguos de GNOME que habilitan funciones experimentales de escalado fraccional sin consultar la documentación de tu versión de GNOME instalada; la configuración disponible ha cambiado con el tiempo.
Un informe de ONLYOFFICE Desktop Editors documenta un caso particular de GNOME 45 Wayland con un escalado fraccional del 125%, donde el usuario observó una interfaz y un documento borrosos, mientras que reportó un comportamiento diferente en KDE Wayland. Considere este informe como evidencia de que el síntoma puede depender del entorno, no como una solución garantizada para todos los sistemas Linux. Consulte el informe de ONLYOFFICE sobre el escalado fraccional de GNOME .
ONLYOFFICE ofrece una opción de escalado de interfaz en Linux, y su historial de versiones registra compatibilidad con valores de escalado de interfaz como 125 %, 150 % y 175 %. Los controles exactos pueden variar según la versión. Abra la configuración de la aplicación y busque el control de escalado de interfaz o aplicación; si la etiqueta o la ubicación difieren, consulte la ayuda de su versión instalada en lugar de basarse en la ruta del menú de una versión anterior.
Modifique únicamente la escala de la interfaz de la aplicación para realizar una prueba y, si se le solicita, reinicie el editor. La escala de la interfaz cambia el tamaño de los controles de la aplicación. El zoom del documento modifica el tamaño de la página dentro del editor. Aumentar el zoom del documento puede facilitar la lectura de las letras, pero no corregirá el texto borroso de la barra de herramientas ni la baja resolución de la ventana completa. Por el contrario, reducir la escala de la interfaz puede mejorar la nitidez de los controles en una configuración, pero hacerlos demasiado pequeños para su uso. Elija una configuración que permita una lectura fluida y compare tanto la barra de herramientas como la página.
Como información adicional, el registro de cambios de ONLYOFFICE Desktop Editors indica compatibilidad con escalado de interfaz al 125 % y al 175 % para Linux y, en una versión anterior, compatibilidad al 150 %. La versión del registro de cambios vigente al momento de consultar este artículo es la 9.4.0, publicada el 19 de mayo de 2026. Esta página no garantiza que todas las escalas fraccionarias de escritorio funcionen igual de bien en todas las distribuciones.
Si los menús se ven nítidos, pero un documento en particular tiene letras borrosas, inusualmente anchas o visiblemente diferentes, revise la familia de fuentes. Es posible que el documento utilice una fuente que no esté instalada en su sistema Linux. En ese caso, el editor debe mostrar una fuente sustituta, lo que puede modificar la forma de las letras, los saltos de línea, el número de páginas y el espaciado. Un diseño diferente no es lo mismo que una visualización borrosa en pantalla, pero una fuente sustituta puede hacer que el texto se vea tan mal que se confunda con un problema de visualización.
En una terminal, compruebe la familia de fuentes utilizada por el documento con la herramienta de coincidencia de Fontconfig. Por ejemplo:
fc-match ArialEsto imprime la fuente que Fontconfig coincide con esa familia. Si está comprobando un nombre de fuente compuesto por varias palabras, póngalo entre comillas, como en fc-match "Liberation Serif". Un resultado alternativo no significa necesariamente que ONLYOFFICE utilice exactamente la misma fuente alternativa en cada parte de su proceso de renderizado; es una comprobación práctica de las fuentes disponibles para el sistema de fuentes de Linux.
Instala la tipografía necesaria desde una fuente confiable y asegúrate de que su licencia te permita usarla. ONLYOFFICE documenta las ubicaciones de las fuentes por usuario, como ~/.local/share/fontsy el directorio del sistema /usr/share/fonts/. Para una instalación personal, copia un archivo de fuente compatible en una subcarpeta de ~/.local/share/fonts, luego actualiza la caché de fuentes del usuario con fc-cache -f. Un paquete de distribución o su administrador gráfico de fuentes puede ser más seguro y fácil, especialmente para las fuentes del sistema. Evita descargar paquetes de fuentes de sitios desconocidos o reemplazar directorios de fuentes del sistema.
Tras instalar una fuente, cierre completamente ONLYOFFICE y reinícielo. Las instrucciones oficiales de ONLYOFFICE para añadir fuentes también indican que se debe reiniciar el editor después de la instalación. Vuelva a abrir el mismo archivo y compruebe si la fuente seleccionada aparece ahora en la lista de fuentes y si el diseño del texto coincide con lo esperado.
Fontconfig mantiene la información de las fuentes y los archivos de caché. Si acaba de instalar, eliminar o actualizar fuentes, pero las aplicaciones aún no ven el cambio, actualice la caché y reinicie ONLYOFFICE:
fc-cache -fEn sistemas donde instalaste fuentes globalmente, el gestor de paquetes de tu distribución puede actualizar las cachés de fuentes durante la instalación. Ejecutar este comando es un paso de actualización razonable, pero no corregirá el desenfoque causado por el escalado fraccional de la pantalla, el compositor o el controlador gráfico. No elimines los directorios de caché de Fontconfig como primera medida. La documentación de usuario de Fontconfig describe la configuración y las ubicaciones de la caché, e indica que algunas ubicaciones antiguas por usuario están obsoletas.
Si el problema afecta a todo el editor con el escalado normal, actualice ONLYOFFICE Desktop Editors usando el mismo canal de instalación compatible que ya utiliza y vuelva a probar. La página oficial de introducción a ONLYOFFICE incluye un enlace a la guía de instalación para Linux. Los usuarios de AppImage deben descargar una versión más reciente para actualizar, según las instrucciones oficiales de AppImage . Evite mezclar paquetes de diferentes canales al solucionar problemas; primero confirme qué compilación está ejecutando desde el menú de la aplicación o la terminal.
Ahora crea un documento en blanco con una fuente común instalada y compáralo con el archivo afectado. Si el documento en blanco se ve nítido, pero un archivo no, concéntrate en la fuente, las imágenes incrustadas y el zoom de ese archivo. Si todos los archivos y todas las partes de la aplicación permanecen borrosos, la evidencia apunta a un problema de escalado o a la ruta de gráficos/pantalla de Linux. Exportar el documento a PDF una sola vez puede ayudarte a distinguir la vista previa en pantalla del documento final, pero no es una prueba completa de renderizado: los visores e impresoras de PDF utilizan sus propias rutas de renderizado.
fc-matchpara comprobar la fuente especificada, instale la fuente con licencia si es necesario, actualice la detección y reinicie el editor.No existe una única opción de renderizado de fuentes en Linux que solucione todos los problemas. El método más fiable consiste en una comparación repetible: el mismo texto se ve nítido a una escala útil, las fuentes esperadas están disponibles y el diseño del documento se mantiene correcto. Si cambiar la escala del sistema soluciona el problema de la ventana, pero dificulta el uso de otras aplicaciones, tenga en cuenta esta observación e informe de los detalles del entorno al proyecto ONLYOFFICE o al canal de soporte de su distribución, en lugar de realizar cambios generales y permanentes en la configuración de fuentes.
Solucione los problemas de copiar y pegar de Collabora Online con aplicaciones locales probando los atajos de teclado, los permisos del portapapeles del navegador, HTTPS, las políticas de iframe y los formatos de contenido.
Solucione el problema del texto borroso en los editores de escritorio de ONLYOFFICE en Linux comprobando el escalado de la pantalla, el escalado de la interfaz de la aplicación, la disponibilidad de la fuente y el ámbito de representación en un orden seguro.
Aprenda cómo bloquear la impresión y las descargas en las integraciones de ONLYOFFICE Workspace, DocSpace o Docs, y verifique qué controles se aplican a cada método de uso compartido.
Solucione los errores 502 del servidor de documentos ONLYOFFICE detrás de Nginx. Verifique el estado del servicio, los registros, los puertos ascendentes, los encabezados reenviados, los WebSockets y la red de Docker.
Solucione los problemas de tiempo de espera de ONLYOFFICE Documents en un servidor autohospedado comprobando la URL correcta del portal o WebDAV, el acceso a la red, HTTPS, las credenciales y el enrutamiento del servidor.
Establezca una plantilla personalizada de LibreOffice Writer como predeterminada, actualícela o restablézcala y verifique que los nuevos documentos utilicen sus estilos y diseño de página preferidos.
Solucione los problemas de exportación de PDF de ONLYOFFICE separando los problemas de conversión, descarga del navegador y servidor, y luego verifique que el PDF guardado se abra y conserve su diseño.
Elimine ONLYOFFICE Document Server de Linux de forma segura. Siga los pasos para la instalación del paquete, Docker, Snap y Kubernetes, conserve los datos y verifique los servicios restantes.
Configure la sincronización con LDAP o Active Directory en ONLYOFFICE Workspace con ajustes de conexión segura, filtros de usuarios y grupos, asignación de atributos, derechos de administrador, sincronización programada y comprobaciones de verificación prácticas.
Instale ONLYOFFICE Document Server detrás de HAProxy con terminación TLS, encabezados reenviados, comprobaciones de estado, tiempos de espera seguros para WebSocket y enrutamiento con reconocimiento de documentos para implementaciones de varios nodos.
