Linux에서 ONLYOFFICE 데스크톱의 흐릿한 글꼴 문제를 해결하는 방법: 실용적인 가이드

먼저 흐릿한 부분을 파악하세요.

ONLYOFFICE 창 전체가 흐릿하게 보이는 경우, 글꼴 파일이나 Fontconfig 설정을 변경하기 전에 Linux 디스플레이 배율을 테스트해 보세요. 문서 내부의 텍스트만 잘못 표시되는 경우, 문서에 사용된 글꼴이 컴퓨터에 없거나 다른 글꼴로 대체되었는지 확인하세요. 이 두 가지 문제는 서로 다른 해결 방법을 필요로 합니다.

변경 사항을 적용할 때마다 ONLYOFFICE를 닫았다가 다시 열고, 동일한 창 크기로 문서를 확인하십시오. 이 간단한 비교를 통해 여러 설정을 한 번에 변경하는 것을 방지하고 어떤 변경 사항이 영향을 미쳤는지 명확하게 파악할 수 있습니다. 문제가 특정 편집기 때문인지 확실하지 않은 경우, 동일한 디스플레이에서 다른 데스크톱 애플리케이션의 작은 글씨와 비교해 보십시오.

1. 데스크톱 화면 배율과 세션 유형을 확인하세요.

메뉴, 툴바 레이블, 문서 텍스트의 가장자리가 흐릿하게 보이는 현상은 디스플레이 배율이나 애플리케이션 표시 방식과 관련이 있을 수 있습니다. 125% 또는 150%와 같은 소수점 배율은 일부 Linux 데스크톱 및 그래픽 카드 조합에서 문제가 될 수 있습니다. 하지만 이는 ONLYOFFICE의 보편적인 결함을 의미하는 것은 아닙니다. 디스플레이 서버, 데스크톱 환경, 패키지 형식, 그래픽 드라이버, 애플리케이션 버전 등 여러 요인이 결과에 영향을 미칩니다.

간단한 테스트를 위해 데스크톱 환경의 디스플레이 설정을 열고 화면에 맞는 경우 100% 또는 200%와 같은 표준 배율로 일시적으로 전환해 보세요. 데스크톱에서 로그아웃 후 다시 로그인해야 하는 경우 ONLYOFFICE를 다시 실행하세요. GNOME 환경에서는 설정 > 디스플레이에서 해당 설정을 찾을 수 있습니다. 다른 데스크톱 환경에서는 명칭이나 배율 단계가 다를 수 있습니다. 표준 배율에서 화면이 선명하게 보인다면 흐릿한 현상은 소수점 배율이나 디스플레이 경로와 관련이 있을 가능성이 높습니다. 임시 해결책으로 사용 가능한 가장 선명한 배율을 선택하거나 데스크톱 환경 설명서에서 지원하는 HiDPI 옵션을 확인하세요.

터미널에서 `--session-type` 명령어를 사용하면 세션 유형을 확인할 수 있습니다 echo "$XDG_SESSION_TYPE". 결과는 일반적 wayland으로 x11`--session-type` 또는 `--session-type`입니다. 이 명령어만으로는 그래픽 스택 문제를 진단할 수는 없지만, 세션 간 동작을 비교하거나 재현 가능한 문제를 보고해야 할 때 유용한 정보를 제공합니다. 실험적인 소수점 크기 조정 기능을 활성화하는 이전 GNOME 명령어를 복사할 때는 설치된 GNOME 버전의 설명서를 반드시 확인하십시오. 사용 가능한 설정이 시간이 지남에 따라 변경되었을 수 있습니다.

ONLYOFFICE 데스크톱 에디터 이슈에서는 GNOME 45 Wayland에서 125% 부분 확대/축소 시 인터페이스와 문서가 흐릿하게 보이는 특정 사례를 보고했는데, KDE Wayland에서는 다른 현상이 나타났다고 합니다. 이 보고서는 해당 증상이 환경에 따라 달라질 수 있음을 보여주는 예시일 뿐, 모든 Linux 시스템에서 해결되는 확실한 방법은 아닙니다. GNOME 부분 확대/축소 관련 ONLYOFFICE 보고서를 참조하십시오 .

2. 인터페이스 크기 조정과 문서 확대/축소를 분리합니다.

ONLYOFFICE는 Linux에서 애플리케이션 인터페이스 크기 조정 옵션을 제공하며, 이전 버전에서는 125%, 150%, 175% 등의 크기 조정 값을 지원했습니다. 정확한 설정 경로는 버전에 따라 다를 수 있습니다. 애플리케이션 설정을 열고 인터페이스 또는 애플리케이션 크기 조정 설정을 찾으십시오. 레이블이나 위치가 다른 경우, 이전 버전의 메뉴 경로를 참조하지 말고 설치된 버전의 도움말을 참조하십시오.

테스트를 위해 애플리케이션 인터페이스 배율만 변경한 다음, 필요한 경우 편집기를 다시 시작하십시오. 인터페이스 배율은 애플리케이션 컨트롤의 크기를 변경합니다. 문서 확대/축소는 편집기 내에서 페이지가 표시되는 크기를 변경합니다. 문서 확대/축소를 높이면 글자를 읽기 쉬워질 수 있지만, 도구 모음 텍스트가 흐릿하거나 전체 창의 해상도가 낮아지는 문제는 해결되지 않습니다. 반대로 인터페이스 배율을 낮추면 어떤 설정에서는 컨트롤이 더 선명해지지만, 어떤 설정에서는 너무 작아 사용하기 어려워질 수 있습니다. 읽기 쉬운 설정을 선택하고 도구 모음과 페이지를 모두 비교해 보십시오.

참고로, ONLYOFFICE Desktop Editors의 변경 로그에는 Linux에서 125% 및 175% 인터페이스 크기 조정 지원이 기록되어 있으며, 이전 릴리스 항목에서는 150% 지원도 언급되어 있습니다. 이 기사를 확인할 당시 변경 로그에 기록된 최신 버전은 2026년 5월 19일에 출시된 9.4.0입니다. 하지만 해당 페이지에서 모든 소수점 데스크톱 크기 조정이 모든 배포판에서 동일하게 잘 작동한다는 것을 보장하는 것은 아닙니다.

3. 문서에서 누락된 글꼴을 대체하고 있는지 확인하십시오.

메뉴는 선명하게 보이지만 특정 문서의 글자가 흐릿하거나, 비정상적으로 넓거나, 눈에 띄게 다르게 보인다면 글꼴 패밀리를 확인하십시오. 문서에 사용된 글꼴이 Linux 시스템에 설치되어 있지 않을 수 있습니다. 이 경우 편집기는 대체 글꼴을 표시해야 하는데, 이로 인해 글자 모양, 줄 바꿈, 페이지 수, 간격 등이 변경될 수 있습니다. 레이아웃이 달라지는 것은 화면 렌더링이 흐릿한 것과는 다르지만, 대체 글꼴로 인해 텍스트가 이상하게 보여 렌더링 문제로 오해될 수 있습니다.

터미널에서 Fontconfig의 일치 도구를 사용하여 문서에서 사용된 글꼴 패밀리를 확인합니다. 예를 들면 다음과 같습니다.

fc-match Arial

이 명령은 해당 글꼴 패밀리에 대해 Fontconfig와 일치하는 글꼴을 출력합니다. 여러 단어로 구성된 글꼴 이름을 확인하려면 따옴표로 묶으십시오(예: `<font>familiar>`) fc-match "Liberation Serif". 대체 결과가 표시된다고 해서 ONLYOFFICE가 렌더링 파이프라인의 모든 부분에서 정확히 동일한 대체 글꼴을 사용한다는 의미는 아닙니다. 이는 Linux 글꼴 시스템에서 사용 가능한 글꼴을 실질적으로 확인하는 것입니다.

신뢰할 수 있는 출처에서 필요한 글꼴을 설치하고 해당 글꼴의 라이선스가 사용을 허용하는지 확인하십시오. ONLYOFFICE는 사용자별 글꼴 위치(예: ~/.local/share/fonts및 시스템 전체 /usr/share/fonts/디렉터리)를 문서화합니다. 개인 설치의 경우, 지원되는 글꼴 파일을 의 하위 폴더에 복사한 ~/.local/share/fonts다음 명령어를 사용하여 사용자 글꼴 캐시를 새로 고치십시오 fc-cache -f. 특히 시스템 글꼴의 경우, 배포판 패키지 또는 그래픽 글꼴 관리자를 사용하는 것이 더 안전하고 간편할 수 있습니다. 알 수 없는 사이트에서 글꼴 묶음을 다운로드하거나 시스템 글꼴 디렉터리를 교체하지 마십시오.

글꼴을 설치한 후에는 ONLYOFFICE를 완전히 종료하고 다시 시작하십시오. ONLYOFFICE의 공식 글꼴 추가 설명서 에도 설치 후 편집기를 다시 시작하라고 나와 있습니다. 동일한 파일을 다시 열고 선택한 글꼴이 글꼴 목록에 나타나는지, 텍스트 레이아웃이 예상대로 표시되는지 확인하십시오.

4. 글꼴이 추가되거나 변경된 경우에만 글꼴 검색을 새로 고칩니다.

Fontconfig는 글꼴 정보와 캐시 파일을 관리합니다. 글꼴을 설치, 제거 또는 업데이트했는데도 응용 프로그램에서 변경 사항이 반영되지 않으면 캐시를 새로 고치고 ONLYOFFICE를 다시 시작하십시오.

fc-cache -f

글꼴을 전역적으로 설치한 시스템에서는 배포판의 패키지 관리자가 설치 과정의 일부로 글꼴 캐시를 업데이트할 수 있습니다. 이 명령을 실행하는 것은 적절한 새로 고침 단계이지만, 소수점 디스플레이 배율, 합성 도구 또는 그래픽 드라이버로 인한 흐림 현상은 해결하지 못합니다. 따라서 Fontconfig 캐시 디렉터리를 먼저 삭제하지 마십시오. Fontconfig 사용자 설명서에는 구성 및 캐시 위치에 대한 설명이 있으며, 일부 이전 사용자별 위치는 더 이상 사용되지 않는다는 점도 명시되어 있습니다.

5. 편집기를 업데이트하고 깨끗한 문서와 비교하세요.

일반적인 크기 조정에서 편집기 전체에 문제가 발생하는 경우, 기존에 사용 중인 동일한 설치 채널을 통해 ONLYOFFICE Desktop Editors를 업데이트한 후 다시 테스트하십시오. ONLYOFFICE 공식 시작 페이지 에서 Linux 설치 안내를 확인할 수 있습니다. AppImage 사용자는 공식 AppImage 지침 에 따라 최신 AppImage를 다운로드하여 업데이트해야 합니다 . 문제 해결 중에는 서로 다른 채널의 패키지를 혼용하지 마십시오. 먼저 응용 프로그램 메뉴 또는 터미널에서 실행하는 빌드를 확인하십시오.

이제 일반적으로 설치된 글꼴로 빈 문서를 만들고 문제가 있는 파일과 비교해 보세요. 빈 문서는 선명한데 특정 파일만 흐릿하다면, 해당 파일의 글꼴 선택, 삽입된 이미지, 확대/축소 기능을 집중적으로 살펴보세요. 모든 파일과 애플리케이션의 모든 부분이 여전히 흐릿하게 보인다면, 배율 조정이나 Linux 그래픽/디스플레이 경로에 문제가 있을 가능성이 높습니다. PDF로 한 번 내보내면 화면 미리보기와 실제 문서 출력을 구분하는 데 도움이 될 수 있지만, 이는 완벽한 화면 렌더링 테스트는 아닙니다. PDF 뷰어와 프린터는 각각 고유한 렌더링 경로를 사용하기 때문입니다.

증상에 맞는 해결책을 선택하세요

• 메뉴, 툴바, 페이지 모두 흐릿하게 보입니다. 표준 데스크톱 배율과 현재 배율을 비교해 보고, ONLYOFFICE의 인터페이스 배율을 별도로 테스트해 보세요.
• 문서 하나에만 문제가 있는 것 같습니다. 해당 글꼴 이름을 확인 하고 fc-match, 필요한 경우 라이선스가 있는 글꼴을 설치하고, 검색을 새로 고친 다음 편집기를 다시 시작하십시오.
• 문서의 텍스트가 너무 작을 뿐 흐릿하게 보이지는 않습니다. 가독성을 위해 문서 확대/축소 기능을 조정하십시오. 확대/축소 기능을 시스템 글꼴 렌더링 문제 해결 기능으로 사용하지 마십시오.
• 다음 테스트 후에도 흐림 현상이 지속되는 경우, ONLYOFFICE 버전, 배포판, 패키지 유형, 데스크톱 환경, 세션 유형, 배율, 디스플레이 해상도, 그리고 흐림 현상이 메뉴, 페이지 또는 둘 다에 영향을 미치는지 여부를 기록하십시오. 개인 정보가 포함되지 않은 샘플 파일만 첨부하십시오.

모든 문제를 해결하는 단 하나의 Linux 글꼴 렌더링 설정은 없습니다. 가장 확실한 방법은 반복 가능한 비교를 통해 동일한 텍스트가 사용 가능한 크기에서 선명하게 표시되고, 예상되는 글꼴이 사용 가능하며, 문서 레이아웃이 올바르게 유지되는지 확인하는 것입니다. 시스템 크기 조정을 통해 창 문제는 해결되지만 다른 응용 프로그램을 사용하기 어렵게 되는 경우, 해당 사항을 기록해 두고 글꼴 설정을 광범위하고 영구적으로 변경하기보다는 환경 세부 정보를 ONLYOFFICE 프로젝트 또는 해당 배포판의 지원 채널에 보고하십시오.

출처

• ONLYOFFICE: 데스크톱 편집기에 새 글꼴 추가하기
• ONLYOFFICE 데스크톱 편집기 변경 로그
• Fontconfig 사용자 설명서
• ONLYOFFICE 데스크톱 편집기에서 GNOME 소수점 크기 조정 관련 문제가 발생합니다.