Comece por identificar o que está desfocado.
Se toda a janela do ONLYOFFICE parecer desfocada, teste a escala de exibição do Linux antes de alterar os arquivos de fonte ou as configurações do Fontconfig. Se apenas o texto dentro de um documento parecer incorreto, verifique se o documento usa uma fonte que está faltando ou foi substituída no seu computador. Esses são problemas diferentes e exigem soluções diferentes.
Feche e abra o ONLYOFFICE novamente após cada alteração e, em seguida, inspecione o mesmo documento no mesmo tamanho de janela. Essa comparação simples ajuda você a evitar alterar várias configurações de uma só vez e deixa claro qual alteração foi relevante. Se você não tiver certeza se o problema é específico do editor, compare o texto pequeno em outro aplicativo de desktop na mesma tela.
1. Verifique a escala de exibição da área de trabalho e o tipo de sessão.
Bordas desfocadas em menus, rótulos da barra de ferramentas e texto do documento geralmente indicam problemas de escala de exibição ou como o aplicativo está sendo exibido. Escalas fracionárias, como 125% ou 150%, podem ser um fator em algumas combinações de ambiente gráfico e área de trabalho Linux. Isso não comprova um defeito universal do ONLYOFFICE: servidor de exibição, ambiente de área de trabalho, formato do pacote, driver gráfico e versão do aplicativo, todos afetam o resultado.
Para um teste rápido, abra as configurações de Exibição do seu ambiente de área de trabalho e altere temporariamente para uma escala padrão, como 100% ou 200%, se essas opções forem adequadas à sua tela. Saia da sua conta e entre novamente, se necessário, e abra o ONLYOFFICE novamente. No GNOME, o controle relevante está em Configurações > Monitores; outros ambientes de área de trabalho usam nomes diferentes e podem oferecer incrementos de escala diferentes. Se o aplicativo ficar nítido em uma escala padrão, o desfoque provavelmente está relacionado à escala fracionária ou ao caminho de exibição. Escolha a escala utilizável mais nítida como uma solução prática ou consulte a documentação do seu ambiente de área de trabalho para obter informações sobre as opções HiDPI compatíveis.
Você pode identificar o tipo de sessão a partir de um terminal com o comando ` echo "$XDG_SESSION_TYPE". O resultado geralmente é waylandou x11. Isso não diagnostica a pilha gráfica por si só, mas fornece informações úteis se você precisar comparar o comportamento entre sessões ou relatar um problema reproduzível. Não copie comandos antigos do GNOME que habilitam recursos experimentais de escala fracionária sem verificar a documentação da sua versão do GNOME instalada; as configurações disponíveis mudaram ao longo do tempo.
Um relatório da ONLYOFFICE Desktop Editors descreve um caso específico no GNOME 45 Wayland com escala fracionária de 125%, onde o usuário relatou uma interface e documentos desfocados, enquanto que no KDE Wayland o comportamento foi diferente. Considere esse relato como evidência de que o sintoma pode variar de acordo com o ambiente, e não como uma solução garantida para todos os sistemas Linux. Veja o relatório da ONLYOFFICE sobre escala fracionária do GNOME .
2. Separar o dimensionamento da interface do zoom do documento
O ONLYOFFICE possui uma opção de dimensionamento da interface do aplicativo no Linux, e seu histórico de versões registra suporte para valores de dimensionamento de interface como 125%, 150% e 175%. Os controles exatos podem variar de acordo com a versão. Abra as configurações do aplicativo e procure pelo controle de dimensionamento da interface ou do aplicativo; se o nome ou a localização forem diferentes, consulte a ajuda da sua versão instalada em vez de usar um caminho de menu de uma versão anterior.
Para um teste, altere apenas a escala da interface do aplicativo e reinicie o editor, se solicitado. A escala da interface altera o tamanho dos controles do aplicativo. O zoom do documento altera o tamanho em que a página aparece dentro do editor. Aumentar o zoom do documento pode facilitar a leitura das letras, mas não corrigirá o texto desfocado da barra de ferramentas nem a baixa resolução da janela inteira. Por outro lado, reduzir a escala da interface pode tornar os controles mais nítidos em uma configuração, mas torná-los pequenos demais para usar. Escolha uma configuração que permaneça legível e compare a barra de ferramentas e a página.
Para contextualizar, o changelog do ONLYOFFICE Desktop Editors registra suporte para escalonamento de interface de 125% e 175% no Linux e, em uma versão anterior, suporte para 150%. A versão do changelog listada no momento da leitura deste artigo é a 9.4.0, lançada em 19 de maio de 2026. Essa página não garante que todas as escalas fracionárias de área de trabalho funcionem igualmente bem em todas as distribuições.
3. Verifique se o documento está substituindo uma fonte ausente.
Se os menus estiverem nítidos, mas um documento específico apresentar letras desfocadas, anormalmente largas ou visivelmente diferentes, verifique a família de fontes utilizada. Um documento pode usar uma fonte que não está instalada no seu sistema Linux. Nesse caso, o editor precisa exibir uma fonte substituta, o que pode alterar o formato das letras, as quebras de linha, a quantidade de páginas e o espaçamento. Um layout diferente não é o mesmo que uma renderização desfocada na tela, mas uma fonte substituta pode fazer com que o texto pareça incorreto o suficiente para ser confundido com um problema de renderização.
Em um terminal, verifique a família de fontes usada no documento com a ferramenta de correspondência do Fontconfig. Por exemplo:
fc-match Arial
Isso imprime as correspondências de fontes do Fontconfig para essa família. Se você estiver verificando um nome de fonte composto por várias palavras, coloque-o entre aspas, como em ` fc-match "Liberation Serif"font-family: 'nome_da_fonte'`. Um resultado de substituição não significa necessariamente que o ONLYOFFICE use exatamente a mesma fonte alternativa em todas as partes de seu pipeline de renderização; trata-se de uma verificação prática das fontes disponíveis para o sistema de fontes do Linux.
Instale a fonte necessária a partir de uma fonte confiável e certifique-se de que a licença permita o seu uso. O ONLYOFFICE documenta os locais de fontes por usuário, como ~/.local/share/fontso diretório de fontes do sistema /usr/share/fonts/. Para uma instalação pessoal, copie um arquivo de fonte compatível para uma subpasta de `/ usr/local/fontes` ~/.local/share/fonts, e então atualize o cache de fontes do usuário com fc-cache -f`sudo apt-get update`. Um pacote de fontes da distribuição ou seu gerenciador gráfico de fontes pode ser mais seguro e fácil, especialmente para fontes do sistema. Evite baixar pacotes de fontes de sites desconhecidos ou substituir diretórios de fontes do sistema.
Após instalar uma fonte, feche completamente e reinicie o ONLYOFFICE. As instruções oficiais do ONLYOFFICE para adicionar fontes também recomendam reiniciar os editores após a instalação. Reabra o mesmo arquivo e verifique se a fonte selecionada agora está disponível na lista de fontes e se o layout do texto corresponde ao esperado.
4. Atualizar a descoberta de fontes somente quando uma fonte for adicionada ou alterada.
O Fontconfig mantém informações sobre fontes e arquivos de cache. Se você acabou de instalar, remover ou atualizar fontes, mas os aplicativos ainda não reconhecem a alteração, atualize o cache e reinicie o ONLYOFFICE.
fc-cache -f
Em sistemas onde você instalou fontes globalmente, o gerenciador de pacotes da sua distribuição pode atualizar os caches de fontes como parte da instalação. Executar este comando é uma medida de atualização razoável, mas não corrigirá o desfoque causado por dimensionamento fracionário da tela, um compositor ou um driver gráfico. Não exclua os diretórios de cache do Fontconfig como primeira opção. A documentação do usuário do Fontconfig descreve a configuração e os locais de cache, e observa que alguns locais antigos por usuário estão obsoletos.
5. Atualize o editor e compare com um documento limpo.
Se o problema afetar todo o editor em escalas normais, atualize o ONLYOFFICE Desktop Editors usando o mesmo canal de instalação compatível que você já utiliza e teste novamente. A página oficial de primeiros passos do ONLYOFFICE contém links para o guia de instalação no Linux. Usuários do AppImage precisam baixar uma versão mais recente para atualizar, seguindo as instruções oficiais do AppImage . Evite misturar pacotes de canais diferentes durante a solução de problemas; primeiro, confirme qual versão você está executando no menu de aplicativos ou no terminal.
Agora, crie um documento em branco com uma fonte comum instalada e compare-o com o arquivo afetado. Se o documento em branco estiver nítido, mas um dos arquivos não, concentre-se nas escolhas de fonte, imagens incorporadas e zoom desse arquivo. Se todos os arquivos e todas as partes do aplicativo permanecerem desfocados, a evidência aponta para problemas de escala ou com o caminho gráfico/de exibição do Linux. Uma exportação única para PDF pode ajudar a distinguir a pré-visualização na tela da saída do documento, mas não é um teste completo de renderização de tela: visualizadores e impressoras de PDF usam seus próprios caminhos de renderização.
Escolha a solução que corresponde ao sintoma.
- Os menus, a barra de ferramentas e a página parecem desfocados: compare a escala de um desktop padrão com a sua escala atual e, em seguida, teste a escala da interface do ONLYOFFICE separadamente.
- Apenas um documento parece estar com problemas: use o comando
fc-matchpara verificar a fonte especificada, instale a fonte licenciada, se necessário, atualize a descoberta e reinicie o editor.
- Apenas o texto do documento está muito pequeno, não desfocado: ajuste o zoom do documento para melhorar a legibilidade; não considere o zoom como uma correção na renderização de fontes do sistema.
- O desfoque persiste após estes testes: registre a versão do ONLYOFFICE, a distribuição, o tipo de pacote, o ambiente de desktop, o tipo de sessão, a porcentagem de escala, a resolução da tela e se o desfoque afeta os menus, a página ou ambos. Inclua um arquivo de amostra somente se ele não contiver informações confidenciais.
Não existe uma única configuração de renderização de fontes no Linux que resolva todos os casos. O ponto de partida confiável é uma comparação repetível: o mesmo texto aparece nítido em uma escala utilizável, as fontes esperadas estão disponíveis e o layout do documento permanece correto. Se alterar a escala do sistema corrigir o problema na janela, mas tornar outros aplicativos impraticáveis, anote essa observação e relate os detalhes do ambiente ao projeto ONLYOFFICE ou ao canal de suporte da sua distribuição, em vez de fazer alterações amplas e permanentes na configuração de fontes.
Fontes