INGOO KANG

IT 기술 블로그
상처 많은 꽃잎들이 가장 향기롭다.

안녕하세요! 최근 강력해진 성능으로 많은 사랑을 받고 있는 라즈베리파이 5(Raspberry Pi 5)를 이용해 다양한 토이 프로젝트나 서버 구축을 시작하신 분들이 많을 텐데요.

라즈베리파이 OS(Debian Bookworm 기반)를 처음 설치하고 터미널이나 웹 브라우저를 열면 가장 먼저 마주치는 문제가 있습니다. 바로 한글 텍스트가 사각형(ㅁ)으로 깨져 보이거나, 키보드 자판의 특수문자가 다르게 입력되고, 시스템 시간이 영국 시간으로 고정되어 있는 현상입니다.

오늘은 라즈베리파이 5 환경에서 한글 깨짐을 완벽하게 해결하고, 한글 입력기 설정 및 시간대(Timezone)까지 대한민국 표준 환경으로 세팅하는 방법을 한 페이지로 깔끔하게 정리해 드립니다!

🏗️ 1. 패키지 업데이트 및 한글 기본 폰트 설치

라즈베리파이 OS에는 기본적으로 한글 글꼴이 포함되어 있지 않아 한글이 깨져 보입니다. 터미널을 열고 가장 먼저 시스템 패키지를 최신화한 뒤, 네이버 나눔 폰트를 설치해 주어야 합니다.

터미널을 열고 아래 명령어를 순서대로 입력해 주세요. (한 줄씩 복사해서 실행하시면 됩니다.)

# 시스템 패키지 목록 업데이트 및 업그레이드
sudo apt update && sudo apt upgrade -y

# 대한민국 대표 무료 서체인 나눔 폰트 설치
sudo apt install fonts-nanum -y

💡 Tip: 이전에 제가 포스팅했던 .bash_aliases 설정법을 기억하시나요? 자주 쓰는 sudo apt update && sudo apt upgrade 명령어를 alias update=’…‘로 등록해 두셨다면, 터미널에 update 한 단어만 쳐서 더 빠르게 진행할 수 있습니다!

설치가 완료되면 웹 브라우저(Chromium)나 문서 뷰어에서 사각형(ㅁ)으로 깨지던 한글이 부드럽고 깔끔한 나눔글꼴로 즉시 변환되는 것을 확인할 수 있습니다.

⌨️ 2. 터미널 명령어로 끝내는 라즈베리파이 핵심 지역 설정

이제 시스템의 뼈대가 되는 지역 언어(Locale), 키보드 레이아웃, 그리고 시간대(Timezone)를 한국 기준으로 맞춰줄 차례입니다. GUI 메뉴를 찾아 들어가는 것보다 터미널 텍스트 기반의 환경 설정 도구를 이용하는 것이 가장 정확하고 빠릅니다. 터미널에 아래 명령어를 입력하여 라즈베리파이 구성 도구를 실행합니다.

sudo raspi-config

파란색 화면의 메뉴창이 뜨면 키보드 방향키를 이용해 5 Localisation Options로 진입한 뒤, 아래 3가지 설정을 차례대로 완료해 줍니다.

① Locale (언어 설정)

  1. L1 Locale을 선택합니다.
  2. 수많은 언어 목록이 나오는데, 아래로 쭉 내려서 ko_KR.UTF-8 UTF-8을 찾습니다.
  3. 스페이스바를 눌러 해당 항목 좌측에 별표([*]) 표시를 활성화한 뒤 엔터(OK)를 누릅니다.
  4. 기본 시스템 언어를 선택하는 화면이 나오면 C.UTF-8이나 en_GB 대신 방금 활성화한 ko_KR.UTF-8을 선택하고 마칩니다.

② Timezone (시간 설정)

라즈베리파이가 데이터베이스(MySQL 등) 연동이나 자동화 스크립트를 수행할 때 시스템 시간이 한국 표준시(KST)와 맞지 않으면 치명적인 에러가 발생할 수 있습니다.

  1. L2 Timezone을 선택합니다.
  2. Geographic area에서 Asia를 선택합니다.
  3. Time zone에서 Seoul을 찾아서 선택하고 엔터를 누릅니다.
  4. 터미널 창에 date를 입력해 보면 현재 한국 시간과 정확히 동기화된 것을 확인할 수 있습니다.

③ Keyboard (키보드 레이아웃 설정)

초기 설정 상태에서는 @나 #, / 같은 특수문자를 누르면 엉뚱한 기호가 입력되곤 합니다. 영국식(UK) 키보드로 잡혀 있기 때문입니다.

  1. L3 Keyboard를 선택합니다.
  2. 일반적인 키보드를 사용 중이시라면 Generic 105-key PC (Intl)를 선택합니다.
  3. Keyboard layout 목록에서 Other ➔ Korean ➔ Korean - Korean (101/104 key compatible)을 순서대로 선택해 줍니다. 모든 설정이 끝났다면 방향키를 오른쪽으로 이동해 ‘Finish’를 누르고, 시스템을 한 번 재부팅(sudo reboot)해 줍니다.

✍️ 3. 한글 입력기(fcitx5) 설치 및 한영키 매핑

글꼴을 설치하고 시스템 환경을 바꿨지만, 아직 키보드의 ‘한/영’ 키를 눌러도 한글 타이핑은 불가능한 상태입니다. 리눅스 환경에서 가장 가볍고 라즈베리파이 5와 호환성이 좋은 한글 입력기인 Fcitx5를 설치해 주어야 합니다.

# fcitx5 입력기 및 한글 팩 설치
sudo apt install fcitx5 fcitx5-hangul -y

⚙️ 입력기 환경 세팅 방법

  1. 설치가 완료되면 라즈베리파이 바탕화면 좌측 상단 메뉴에서 [기본 설정] ➔ [Fcitx 5 구성(Fcitx 5 Configuration)]을 클릭합니다.
  2. ‘사용 가능한 입력기’ 창에서 Hangul을 찾아서 오른쪽 창(현재 입력기)으로 추가해 줍니다.
  3. 상단의 [전역 설정(Global Options)] 탭으로 이동합니다.
  4. ‘입력기 전환(Trigger Input Method)’ 항목의 단축키 설정 버튼을 누른 뒤, 내 키보드의 [한/영] 키를 직접 눌러서 매핑해 줍니다. (오른쪽 Alt 키 등으로 인식되어 등록됩니다.) 이제 터미널이나 에디터 어디서든 [한/영] 키를 누르면 우측 하단 트레이 아이콘이 ‘한’ 모양으로 바뀌면서 자유롭게 한글을 입력할 수 있습니다!

📝 마치며

오늘 다룬 설정들은 라즈베리파이 5를 활용한 하드웨어 제어, 파이썬 코딩, 웹 서버 구축 등을 시작하기 전 반드시 거쳐야 하는 ‘기초 체력’과 같은 세팅입니다. 오늘 내용 중 막히는 부분이 있거나 에러 메시지가 뜬다면 언제든지 댓글로 질문을 남겨주세요! 😊

댓글 남기기

참고