Linux

Guacamole 에서 한글깨짐

스카이데이즈 2025. 9. 13. 23:38
728x90

Guacamole 에서 터미널 창을 들어가면 아래와 같이 네모로 표시가 나오는 현상이 있음

 


"네모박스(□)" 문제는 서버 인코딩(UTF-8) 문제라기보다는 폰트 문제.
즉, 한글 코드가 제대로 전달되지만, Apache Guacamole의 웹 터미널에서 사용하는 폰트가 한글 글리프(문자 모양)를 포함하지 않아서 □ 로 표시되는 거


해결 방법

1. Guacamole 웹에 한글 폰트 추가

Guacamole 웹앱은 HTML5 + CSS로 동작 하니까  브라우저가 한글을 표시할 수 있는 폰트를 불러와야 한다.

(1) 시스템 폰트 설치 (Guacamole 서버 OS)

예를 들어 Ubuntu라면:

sudo apt-get install fonts-noto-cjk

CentOS / RHEL:

sudo yum install google-noto-sans-cjk-fonts

 

위와 같이해도 안되서 https://www.clien.net/service/board/cm_nas/17175238 의 내용 참고 해서 진행 했다

 

1. guacamole 터미널에 접속 후  폰트 파일 다운로드 및 설치 

cd /usr/share/fonts
wget https://github.com/naver/d2codingfont/releases/download/VER1.3.2/D2Coding-Ver1.3.2-20180524.zip
unzip D2Coding-Ver1.3.2-20180524.zip

2. 폰트 캐시 지우고 다시 생성

fc-cache -f -v

3. 잘 설치 되었는지 확인

fc-list | grep "D2Coding"

 

4. guacamole tty 커넥션 설정화면에서 폰트 이름 지정하면 된다

 

위에서 wget으로 파일을 못 받을때는 아래 파일 다운하고 1번 항목에서 unzip D2Coding-Ver1.3.2-20180524.zip 대신 tar vjxf D2conding.tar.gz  를 입력하면 된다

D2Conding.tar.gz
18.13MB

 

728x90