한글입력기 IBus에서 Fcitx5로 전환 완벽 가이드

라즈베리파이를 한글 환경으로 설정하는 과정에서 많은 사용자들이 예상치 못한 난관에 부딪히게 됩니다.

특히 최신 라즈베리파이 OS인 Bookworm 버전에서는 Wayland 디스플레이 서버가 기본으로 채택되면서, 기존에 널리 사용되던 IBus 입력기가 Chrome 브라우저에서 정상적으로 작동하지 않는 현상이 빈번하게 발생합니다.

본 가이드에서는 IBus를 완전히 제거하고 Fcitx5 입력기로 교체하여 Chrome을 포함한 모든 애플리케이션에서 한글 입력이 원활하게 작동하도록 설정하는 방법을 단계별로 상세하게 안내합니다. 이 글을 따라하시면 라즈베리파이에서 한글 입력 문제로 고생하던 시간을 획기적으로 줄일 수 있습니다.

목 차

1. 문제 상황 이해하기 | IBUS로 잘되던 한글입력에 문제가 있다?

라즈베리파이 OS Bookworm 버전을 새로 설치한 후 한글 환경을 구성하려는 사용자들이 가장 먼저 시도하는 방법은 IBus(Intelligent Input Bus) 입력기를 설치(?)하는 것입니다. IBus는 리눅스 환경에서 오랫동안 표준처럼 사용되어 온 입력기 프레임워크로, 대부분의 배포판에서 기본으로 제공되거나 손쉽게 설치할 수 있습니다. 그러나 Bookworm 버전에서는 Wayland 디스플레이 서버가 기본으로 채택되면서 상황이 달라졌습니다. IBus를 설치하고 한글 입력을 설정하면 텍스트 에디터나 터미널에서는 정상적으로 한글이 입력되지만, 정작 가장 많이 사용하는 Chrome이나 Chromium 브라우저에서는 한글 입력이 전혀 되지 않는 현상이 발생합니다.

이 문제의 근본적인 원인은 Wayland 환경에서 Chrome 브라우저가 입력기 모듈(Input Method Module)을 인식하는 방식에 있습니다. X11 환경에서는 GTK_IM_MODULE, QT_IM_MODULE, XMODIFIERS와 같은 환경 변수만 올바르게 설정하면 대부분의 애플리케이션에서 입력기가 정상 작동했습니다. 그러나 Wayland에서는 이러한 환경 변수만으로는 충분하지 않으며, 애플리케이션이 Wayland 네이티브 입력 프로토콜을 지원해야 합니다. Chrome 브라우저의 경우 Wayland 환경에서 입력기와 통신하기 위한 추가적인 설정이 필요하며, 이 설정이 제대로 되어 있지 않으면 한글 입력이 불가능해집니다.

구분	x11 환경	Wayland 환경
디스플레이 서버	전통적인 X Window System 사용, 안정적이지만 보안 취약점 존재	현대적인 디스플레이 프로토콜로 보안성과 성능 향상
입력기 통신 방식	환경 변수(GTK_IM_MODULE 등)를 통한 간접 통신	네이티브 Wayland 프로토콜(input-method-v1/v3) 직접 통신
Chrome 한글 입력	환경 변수 설정만으로 대부분 정상 작동	추가 플래그 설정 및 호환 입력기 필요
IBus 호환성	대부분의 애플리케이션에서 안정적 작동	일부 애플리케이션에서 입력 문제 발생
Fcitx5 호환성	안정적 작동	Wayland 프로토콜 지원으로 더 나은 호환성 제공

2. Wayland와 입력기의 관계

Wayland는 X11을 대체하기 위해 개발된 현대적인 디스플레이 서버 프로토콜입니다.

라즈베리파이 OS Bookworm에서 Wayland를 기본으로 채택한 이유는 보안성 향상, 더 나은 성능, 그리고 화면 찢어짐(Screen Tearing) 현상 방지 등 여러 장점이 있기 때문입니다. 그러나 Wayland로의 전환은 입력기 생태계에 상당한 영향을 미쳤으며, 특히 다국어 입력을 필요로 하는 사용자들에게는 새로운 도전 과제가 되었습니다.

Wayland 환경에서는 입력기가 text-input 프로토콜을 통해 컴포지터(Compositor)와 직접 통신해야 하는데, 이 프로토콜의 버전이 여러 가지(v1, v3 등)로 나뉘어 있고 아직 완전히 표준화되지 않은 상태입니다.

flowchart TB
    subgraph USER["사용자 입력"]
        KB[키보드 입력]
    end
    
    subgraph WAYLAND["Wayland 컴포지터"]
        COMP[Wayfire/labwc]
        TIP[text-input 프로토콜]
        IMP[input-method 프로토콜]
    end
    
    subgraph IME["입력기 프레임워크"]
        FCITX5[Fcitx5]
        HANGUL[fcitx5-hangul]
    end
    
    subgraph APPS["애플리케이션"]
        GTK[GTK 애플리케이션]
        QT[Qt 애플리케이션]
        CHROME[Chrome/Chromium]
        ELECTRON[Electron 앱]
    end
    
    KB --> COMP
    COMP --> TIP
    TIP --> FCITX5
    FCITX5 --> HANGUL
    FCITX5 --> IMP
    IMP --> COMP
    
    COMP --> GTK
    COMP --> QT
    COMP --> CHROME
    COMP --> ELECTRON
    
    style FCITX5 fill:#4a90d9,stroke:#6ba3e0,stroke-width:2px
    style CHROME fill:#e67e22,stroke:#f39c12,stroke-width:2px
    style COMP fill:#27ae60,stroke:#2ecc71,stroke-width:2px

IBus와 Fcitx5는 둘 다 리눅스에서 널리 사용되는 입력기 프레임워크이지만, Wayland 환경에서의 호환성 측면에서 차이가 있습니다. IBus는 GNOME 데스크톱 환경에서 기본 입력기로 채택되어 있어 GNOME의 Mutter 컴포지터에서는 잘 작동하지만, 라즈베리파이 OS Bookworm에서 사용하는 Wayfire나 labwc 컴포지터와의 호환성은 완벽하지 않습니다.

반면 Fcitx5는 다양한 Wayland 컴포지터를 지원하도록 설계되었으며, 특히 input-method 프로토콜 구현이 더 완성도 높게 되어 있습니다. 이러한 이유로 라즈베리파이 OS Bookworm에서 Chrome 브라우저의 한글 입력 문제를 해결하기 위해서는 IBus 대신 Fcitx5를 사용하는 것이 권장됩니다.

3. IBus 완전 제거하기

기존에 IBus를 설치하여 사용하고 있었다면, Fcitx5를 설치하기 전에 IBus와 관련된 모든 구성 요소를 완전히 제거해야 합니다. 두 입력기가 동시에 설치되어 있으면 환경 변수 충돌이나 프로세스 충돌로 인해 예기치 않은 문제가 발생할 수 있습니다. 단순히 패키지만 삭제하는 것이 아니라, 설정 파일과 환경 변수 설정까지 모두 정리해야 깔끔하게 전환할 수 있습니다. 아래의 과정을 순서대로 따라하시면 IBus를 완전히 제거할 수 있습니다.

IBus 패키지 삭제

먼저 터미널을 열고 다음 명령어를 실행하여 IBus 관련 패키지를 모두 제거합니다. purge 옵션을 사용하면 패키지와 함께 설정 파일까지 삭제되므로, 나중에 문제가 발생할 여지를 줄일 수 있습니다. autoremove 명령어는 IBus 설치 시 함께 설치되었던 의존성 패키지 중 더 이상 필요하지 않은 것들을 자동으로 정리해 줍니다.

# IBus 및 IBus 한글 패키지 완전 삭제
sudo apt purge ibus ibus-hangul -y

# 불필요한 의존성 패키지 자동 제거
sudo apt autoremove -y

# 패키지 캐시 정리 (선택사항)
sudo apt clean

위 명령어를 실행하면 IBus 핵심 패키지와 한글 입력 모듈이 삭제됩니다. 만약 "Package 'ibus' is not installed" 또는 "Package 'ibus-hangul' is not installed"와 같은 메시지가 표시되더라도 걱정하지 않으셔도 됩니다. 이는 해당 패키지가 이미 설치되어 있지 않다는 의미이며, 다음 단계로 진행하시면 됩니다. autoremove 명령어 실행 후에는 제거될 패키지 목록이 표시되는데, 이 목록을 확인하고 Y를 입력하여 진행합니다.

환경 변수 설정 정리

IBus를 설치할 때 .bashrc나 .profile 파일에 입력기 관련 환경 변수를 추가했을 수 있습니다. 이러한 환경 변수가 남아 있으면 Fcitx5 설치 후에도 시스템이 IBus를 찾으려 하여 문제가 발생할 수 있습니다. 텍스트 에디터로 .bashrc 파일을 열어 IBus 관련 설정을 찾아 삭제하거나 주석 처리해야 합니다. nano 에디터는 라즈베리파이 OS에 기본으로 설치되어 있어 별도의 설치 없이 바로 사용할 수 있습니다.

# .bashrc 파일 열기
nano ~/.bashrc

파일을 열면 화살표 키를 사용하여 아래로 스크롤하면서 다음과 같은 형태의 줄을 찾습니다. 이러한 줄이 있다면 해당 줄의 맨 앞에 # 문자를 추가하여 주석 처리하거나, 해당 줄 전체를 삭제합니다. 주석 처리를 권장하는 이유는 나중에 문제가 발생했을 때 원래 설정을 참고할 수 있기 때문입니다.

# 삭제하거나 주석 처리해야 할 IBus 관련 설정 예시
# export GTK_IM_MODULE=ibus
# export QT_IM_MODULE=ibus
# export XMODIFIERS=@im=ibus
# ibus-daemon -drx

파일 수정을 완료했다면 Ctrl+O를 눌러 저장하고, Enter를 눌러 파일명을 확인한 후, Ctrl+X를 눌러 nano 에디터를 종료합니다. 동일한 방법으로 ~/.profile 파일과 ~/.xprofile 파일도 확인하여 IBus 관련 설정이 있다면 정리해 주시기 바랍니다. 이렇게 하면 IBus의 흔적이 시스템에서 완전히 제거되어 Fcitx5와의 충돌 없이 깨끗한 상태에서 새로운 입력기를 설정할 수 있습니다.

4. Fcitx5 설치 및 기본 설정

IBus를 완전히 제거한 후에는 Fcitx5를 설치할 차례입니다. Fcitx5(Flexible Input Method Framework 5)는 Fcitx의 차세대 버전으로, 현대적인 아키텍처와 향상된 Wayland 지원을 특징으로 합니다. 라즈베리파이 OS Bookworm의 공식 저장소에는 Fcitx5와 한글 입력 모듈이 포함되어 있어 별도의 저장소 추가 없이 apt 명령어로 쉽게 설치할 수 있습니다. 설치 과정은 크게 패키지 설치, 기본 입력기 설정, 한글 입력기 추가의 세 단계로 나뉩니다.

Fcitx5 패키지 설치

터미널에서 다음 명령어를 실행하여 Fcitx5와 한글 입력 모듈, 그리고 입력기 설정 도구를 설치합니다. 패키지 목록을 먼저 업데이트하는 것은 최신 버전의 패키지를 설치하기 위함이며, 이 과정을 생략하면 오래된 버전이 설치되거나 의존성 문제가 발생할 수 있습니다. fcitx5-hangul 패키지는 libhangul 라이브러리를 기반으로 한글 입력 기능을 제공하며, 두벌식과 세벌식 자판을 모두 지원합니다.

# 패키지 목록 업데이트
sudo apt update

# Fcitx5 핵심 패키지 및 한글 입력 모듈 설치
sudo apt install fcitx5 fcitx5-hangul im-config -y

설치가 완료되면 fcitx5 패키지(입력기 프레임워크 핵심), fcitx5-hangul 패키지(한글 입력 엔진), im-config 패키지(입력기 설정 도구)가 시스템에 추가됩니다. 의존성에 의해 fcitx5-modules, fcitx5-frontend-gtk3, fcitx5-frontend-qt5 등의 추가 패키지도 함께 설치되는데, 이들은 각각 Fcitx5의 다양한 기능 모듈과 GTK/Qt 애플리케이션 연동을 담당합니다. 설치 과정에서 추가로 설치되는 패키지 목록이 표시되면 Y를 입력하여 진행합니다.

기본 입력기로 설정

Fcitx5를 시스템의 기본 입력기로 지정해야 부팅 시 자동으로 Fcitx5가 시작되고, 모든 애플리케이션에서 Fcitx5를 통해 한글을 입력할 수 있습니다. im-config 도구를 사용하면 간단한 명령어 한 줄로 기본 입력기를 설정할 수 있습니다. 이 설정은 현재 사용자에게만 적용되며, 다른 사용자 계정이 있다면 해당 계정에서도 동일한 명령어를 실행해야 합니다.

# Fcitx5를 기본 입력기로 설정
im-config -n fcitx5

위 명령어를 실행하면 아무런 출력 없이 명령 프롬프트로 돌아오는데, 이는 정상적인 동작입니다. im-config는 ~/.xinputrc 파일을 생성하거나 수정하여 입력기 설정을 저장합니다. 설정이 제대로 되었는지 확인하려면 cat ~/.xinputrc 명령어를 실행하여 파일 내용을 확인할 수 있으며, "run_im fcitx5"와 같은 내용이 포함되어 있어야 합니다. 이 설정이 적용되려면 시스템을 재부팅하거나 로그아웃 후 다시 로그인해야 합니다.

한글 입력기 추가

시스템 재부팅 후 Fcitx5가 자동으로 시작되면 화면 우측 상단의 시스템 트레이 영역에 키보드 아이콘이 나타납니다. 이 아이콘은 현재 입력 모드를 표시하며, 클릭하면 입력기 관련 메뉴에 접근할 수 있습니다. 한글 입력을 사용하려면 Fcitx5 설정에서 한글 입력기를 추가해야 합니다. 메인 메뉴에서 '기본 설정(Preferences)' 또는 '설정(Settings)'을 선택한 후 'Fcitx 5 Configuration'을 실행합니다.

sequenceDiagram
    participant U as 사용자
    participant M as 메인 메뉴
    participant F as Fcitx5 Configuration
    participant H as 한글 입력기
    
    U->>M: 딸기 아이콘 클릭
    M->>M: 기본 설정(Preferences) 선택
    M->>F: Fcitx 5 Configuration 실행
    F->>F: Input Method 탭 확인
    F->>F: Available Input Method에서<br/>Hangul 검색
    F->>H: Hangul을 Current Input Method로 이동
    H->>U: 한글 입력 준비 완료
    
    Note over U,H: Ctrl+Space로 한/영 전환 가능

Fcitx5 설정 창이 열리면 'Input Method' 탭에서 현재 등록된 입력기 목록을 확인할 수 있습니다. 기본적으로 'Keyboard - English (US)' 또는 시스템 언어에 따른 키보드만 등록되어 있을 것입니다. 우측의 'Available Input Method' 영역에서 'Hangul'을 검색하여 찾은 후, 화살표 버튼을 클릭하거나 드래그 앤 드롭으로 'Current Input Method' 영역으로 이동시킵니다. 'Only Show Current Language' 체크박스가 선택되어 있으면 Hangul이 보이지 않을 수 있으니, 이 옵션을 해제한 후 검색하시기 바랍니다.

한/영 전환 단축키 설정

한글 입력기를 추가한 후에는 한/영 전환 단축키를 설정하는 것이 편리합니다.

Fcitx5의 기본 한/영 전환 단축키는 Ctrl+Space이지만, 한국어 키보드의 '한/영' 키나 오른쪽 Alt 키를 사용하도록 변경할 수 있습니다. Fcitx5 설정 창에서 'Global Options' 탭을 선택하면 'Trigger Input Method' 항목에서 전환 단축키를 확인하고 수정할 수 있습니다. 오른쪽의 설정 버튼을 클릭한 후 원하는 키를 누르면 해당 키가 전환 단축키로 등록됩니다.

# 환경 변수 설정 (선택사항 - 일부 애플리케이션 호환성 향상)
# ~/.bashrc 파일 끝에 다음 내용 추가
nano ~/.bashrc

# 파일 끝에 아래 내용 추가
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx

위의 환경 변수 설정은 Wayland 환경에서 필수는 아니지만, 일부 레거시 애플리케이션이나 XWayland로 실행되는 프로그램에서 입력기 인식을 개선하는 데 도움이 됩니다. 특히 Chrome 브라우저에서 한글 입력이 되지 않는 문제를 해결하기 위해서는 이 환경 변수 설정이 중요합니다. 설정을 저장한 후 source ~/.bashrc 명령어를 실행하거나 새 터미널을 열면 변경 사항이 적용됩니다.

5. Chrome 브라우저 한글 입력 문제 해결

Fcitx5를 설치하고 기본 설정을 완료했음에도 불구하고 Chrome 브라우저에서 한글 입력이 되지 않는 경우가 있습니다. 이는 Chrome이 Wayland 환경에서 입력기와 통신하는 방식 때문에 발생하는 문제로, Chrome의 내부 설정(플래그)을 조정하여 해결할 수 있습니다. Chrome은 기본적으로 Ozone 플랫폼을 자동으로 감지하여 Wayland 또는 X11 모드로 실행되는데, 입력기와의 호환성을 위해 명시적으로 설정을 지정해야 하는 경우가 있습니다. 이미 터미널과 Chrome에서 한글이 제대로 보이고 입력이 가능하다면 아래의 절차는 생략하셔도 됩니다. 많은 경우 'Preferred Ozone Platform"이 보이지 않는 경우도 많습니다.

Chrome 플래그 설정

Chrome 브라우저를 실행한 후 주소창에 chrome://flags를 입력하고 Enter를 누르면 실험적 기능 설정 페이지가 열립니다. 이 페이지에서는 Chrome의 다양한 실험적 기능을 활성화하거나 비활성화할 수 있으며, Wayland 관련 설정도 이곳에서 조정합니다. 검색창에 'ozone'을 입력하면 관련 설정 항목이 필터링되어 표시됩니다. 'Preferred Ozone platform' 항목을 찾아 드롭다운 메뉴에서 'Wayland'를 선택합니다.

플래그 이름	설정값	설명
Preferred Ozone platform	Wayland	Chrome이 Wayland 네이티브 모드로 실행되도록 설정하여 입력기와의 직접 통신을 가능하게 합니다
Wayland text-input version 3	Enabled	최신 Wayland 텍스트 입력 프로토콜(v3)을 활성화하여 입력기 호환성을 개선합니다

'Wayland text-input version 3' 플래그가 검색 결과에 표시된다면 이 항목도 'Enabled'로 설정하는 것이 좋습니다. 이 플래그는 Chrome이 최신 Wayland 텍스트 입력 프로토콜을 사용하도록 하여 Fcitx5와의 통신을 더욱 원활하게 합니다. 다만 이 플래그는 Chrome 버전에 따라 존재하지 않을 수 있으며, 없는 경우에는 'Preferred Ozone platform' 설정만으로도 한글 입력이 가능합니다.

Chrome 재시작

플래그 설정을 변경한 후에는 Chrome을 완전히 재시작해야 설정이 적용됩니다. 페이지 하단에 나타나는 'Relaunch' 버튼을 클릭하면 Chrome이 자동으로 재시작됩니다. 재시작 후 아무 웹사이트에서나 텍스트 입력 필드를 클릭한 후 Ctrl+Space 또는 설정한 한/영 전환 단축키를 눌러 한글 모드로 전환하고 한글을 입력해 봅니다. 정상적으로 설정되었다면 한글이 입력되고, 입력 중인 글자 아래에 밑줄이 표시되는 조합 상태를 확인할 수 있습니다.

# Chrome 실행 옵션으로 직접 지정하는 방법 (대안)
# 플래그 설정이 작동하지 않는 경우 사용
google-chrome --enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime --gtk-version=4

# 또는 Chromium의 경우
chromium --enable-features=UseOzonePlatform --ozone-platform=wayland --enable-wayland-ime --gtk-version=4

만약 플래그 설정 후에도 한글 입력이 되지 않는다면, 위의 명령줄 옵션을 사용하여 Chrome을 실행해 볼 수 있습니다. 이 방법이 효과가 있다면 데스크톱 바로가기(.desktop 파일)의 Exec 항목을 수정하여 항상 이 옵션으로 Chrome이 실행되도록 설정할 수 있습니다. 일부 시스템에서는 --ozone-platform=x11 옵션으로 XWayland 모드로 실행하는 것이 더 안정적일 수 있으니, Wayland 옵션으로 문제가 지속된다면 이 대안도 시도해 보시기 바랍니다.

6. 한글 폰트 설정 및 최적화

한글 입력이 정상적으로 작동하더라도 기본 폰트가 보기 불편하거나 일부 한자가 이상하게 표시되는 경우가 있습니다. 라즈베리파이 OS의 기본 한글 폰트는 가독성이 좋지 않을 수 있으며, 특히 작은 크기에서는 글자가 뭉개져 보이기도 합니다. 예쁘고 가독성 좋은 한글 폰트를 설치하면 시스템 전반의 사용 경험이 크게 향상됩니다. 가장 많이 사용되는 한글 폰트로는 네이버에서 제공하는 나눔 폰트, D2Coding 폰트와 구글에서 제공하는 본고딕(Noto Sans CJK)이 있습니다.

6.1 한글 폰트 설치

터미널에서 다음 명령어를 실행하여 대표적인 한글 폰트를 설치합니다. fonts-nanum 패키지는 나눔고딕, 나눔명조, 나눔바른고딕 등 다양한 나눔 폰트를 포함하고 있으며, fonts-noto-cjk 패키지는 한중일(CJK) 문자를 모두 지원하는 본고딕 폰트를 제공합니다. 두 폰트 패키지를 모두 설치하면 상황에 따라 적절한 폰트를 선택하여 사용할 수 있습니다.

# 나눔 폰트 설치 (네이버 제공)
sudo apt install fonts-nanum -y

# D2Coding 폰트 설치 (네이버 제공)
sudo apt install fonts-naver-d2coding -y

# 나눔 코딩 폰트 설치 (프로그래밍용 고정폭 폰트)
sudo apt install fonts-nanum-coding -y

# 본고딕(Noto Sans CJK) 설치 (구글 제공)
sudo apt install fonts-noto-cjk -y

# 폰트 캐시 갱신
fc-cache -fv

폰트 설치 후 fc-cache 명령어를 실행하면 시스템의 폰트 캐시가 갱신되어 새로 설치한 폰트가 즉시 인식됩니다. 이 명령어를 실행하지 않아도 재부팅 후에는 폰트가 인식되지만, 캐시를 수동으로 갱신하면 재부팅 없이 바로 새 폰트를 사용할 수 있습니다. 명령어 실행 결과로 스캔된 폰트 디렉토리 목록과 캐시 파일 생성 정보가 출력되는데, 오류 메시지가 없다면 정상적으로 완료된 것입니다.

시스템 폰트 변경

설치한 폰트를 시스템 전체에 적용하려면 외관 설정(Appearance Settings)에서 폰트를 변경해야 합니다.

메인 메뉴(딸기 아이콘)에서 'Preferences' > 'Appearance Settings'를 선택하면 외관 설정 창이 열립니다. 'System' 탭을 선택한 후 'Font' 항목 옆의 버튼을 클릭하면 폰트 선택 대화상자가 나타납니다. 여기에서 'Nanum Gothic' 또는 'Noto Sans CJK KR'과 같은 한글 폰트를 선택하고 원하는 크기를 지정한 후 확인 버튼을 클릭합니다.

폰트 종류	패키지명	특징	권장 용도
나눔고딕	fonts-nanum	깔끔하고 현대적인 고딕체로 가독성이 뛰어남	시스템 UI, 일반 문서
나눔명조	fonts-nanum	전통적인 명조체로 인쇄물 느낌을 제공	문서 작성, 독서용
나눔바른고딕	fonts-nanum	나눔고딕의 변형으로 획이 더 또렷함	작은 크기 텍스트
본고딕(Noto Sans CJK)	fonts-noto-cjk	한중일 문자 통합 지원, 다양한 굵기 제공	다국어 환경, 웹 개발
나눔고딕코딩	fonts-nanum-coding	고정폭 폰트로 코드 가독성 최적화	프로그래밍, 터미널

Fcitx5 입력창 폰트 설정

한글을 입력할 때 나타나는 Fcitx5의 후보창(입력 중인 글자를 보여주는 작은 창) 폰트도 별도로 설정할 수 있습니다. 메인 메뉴에서 'Preferences' > 'Fcitx 5 Configuration'을 실행한 후 하단의 'Addons' 탭 또는 'Configure Addons' 버튼을 클릭합니다. 애드온 목록에서 'Classic User Interface'를 찾아 선택한 후 설정(톱니바퀴) 버튼을 클릭하면 UI 설정 창이 열립니다. 여기에서 'Font' 항목을 클릭하여 원하는 한글 폰트와 크기를 선택할 수 있습니다.

7. 문제 해결 및 팁

Fcitx5와 Chrome 한글 입력 설정을 완료한 후에도 일부 상황에서 문제가 발생할 수 있습니다. 이 섹션에서는 사용자들이 자주 겪는 문제와 그 해결 방법을 정리하였습니다. 대부분의 문제는 환경 변수 설정 누락, 프로세스 충돌, 또는 애플리케이션별 특수한 요구사항으로 인해 발생합니다. 문제가 발생했을 때 아래의 체크리스트를 순서대로 확인하면 원인을 빠르게 파악할 수 있습니다.

일반적인 문제 해결

한글 입력이 전혀 되지 않는 경우에는 먼저 Fcitx5가 정상적으로 실행 중인지 확인해야 합니다. 화면 우측 상단의 시스템 트레이에 키보드 아이콘이 표시되어 있는지 확인하고, 없다면 터미널에서 fcitx5 명령어를 실행하여 수동으로 시작해 봅니다. 또한 환경 변수가 올바르게 설정되었는지 env | grep -i fcitx 명령어로 확인할 수 있습니다. 출력 결과에 GTK_IM_MODULE=fcitx, QT_IM_MODULE=fcitx, XMODIFIERS=@im=fcitx가 포함되어 있어야 합니다.

# Fcitx5 실행 상태 확인
pgrep -l fcitx5

# Fcitx5 수동 시작 (데몬 모드)
fcitx5 -d

# 환경 변수 확인
env | grep -i fcitx

# Fcitx5 진단 도구 실행
fcitx5-diagnose

fcitx5-diagnose 명령어는 Fcitx5 설정의 전반적인 상태를 점검하고 잠재적인 문제를 보고하는 유용한 도구입니다. 이 명령어의 출력 결과에서 빨간색 또는 노란색으로 표시된 항목이 있다면 해당 부분에 문제가 있는 것이므로, 출력된 안내에 따라 설정을 수정합니다. 특히 'Environment' 섹션에서 환경 변수 관련 경고가 표시되거나, 'Input Method' 섹션에서 Hangul 입력기가 제대로 로드되지 않았다는 메시지가 있는지 주의 깊게 확인하시기 바랍니다.

Chrome 특정 문제 해결

Chrome에서만 한글 입력이 되지 않는 경우, 먼저 다른 애플리케이션(텍스트 에디터, 터미널 등)에서는 한글 입력이 정상적으로 되는지 확인합니다. 다른 애플리케이션에서는 잘 되는데 Chrome에서만 안 된다면 Chrome의 Ozone 플랫폼 설정 문제일 가능성이 높습니다. chrome://version 페이지에 접속하여 'Command Line' 섹션을 확인하면 Chrome이 어떤 플랫폼 모드로 실행 중인지 알 수 있습니다. '--ozone-platform=wayland'가 포함되어 있어야 Wayland 모드로 실행 중인 것입니다.

# Chrome 설정 초기화 후 재시도 (주의: 북마크, 확장프로그램 등 백업 필요)
# 이 방법은 최후의 수단으로만 사용

# Chrome 캐시만 삭제
rm -rf ~/.cache/google-chrome

# Chrome 데스크톱 파일 수정하여 실행 옵션 추가
sudo nano /usr/share/applications/google-chrome.desktop
# Exec= 줄을 찾아 다음과 같이 수정:
# Exec=/usr/bin/google-chrome-stable --enable-wayland-ime %U

Chrome 업데이트 후 갑자기 한글 입력이 안 되는 경우가 있습니다. 이는 Chrome의 Wayland 지원 관련 코드가 업데이트되면서 기존 설정과 호환되지 않게 된 것일 수 있습니다. 이런 경우 chrome://flags 페이지에서 'Preferred Ozone platform' 설정을 'Auto'로 변경하거나, 반대로 'X11'로 변경하여 XWayland 모드로 실행해 보시기 바랍니다. XWayland 모드는 Wayland 네이티브보다 약간의 성능 저하가 있을 수 있지만 입력기 호환성은 더 안정적인 경우가 많습니다.

유용한 팁

한/영 전환 시 화면에 표시되는 알림 팝업이 거슬린다면 Fcitx5 설정에서 비활성화할 수 있습니다. Fcitx5 Configuration에서 'Global Options' 탭의 'Behavior' 섹션에 있는 'Show Input Method Information when switch input method' 옵션을 해제하면 됩니다. 또한 'Show First Input Method Information'옵션을 해제하면 영문 입력 모드일 때는 알림이 표시되지 않고 한글 모드로 전환할 때만 표시됩니다.

# OS 버전 확인 (Bookworm인지 확인)
cat /etc/os-release

# 디스플레이 서버 확인 (Wayland/X11)
echo $XDG_SESSION_TYPE

# 설치된 입력기 관련 패키지 확인
dpkg -l | grep -E "(fcitx|ibus|im-config)"

# Fcitx5 로그 실시간 확인 (문제 진단용)
fcitx5 -d --verbose

시스템 재부팅 후 Fcitx5가 자동으로 시작되지 않는 경우, 자동 시작 설정이 필요할 수 있습니다. 라즈베리파이 OS Bookworm에서는 im-config 설정만으로 대부분 자동 시작이 되지만, 그렇지 않은 경우 메인 메뉴의 'Preferences' > 'Session and Startup' (또는 유사한 항목)에서 Fcitx5를 시작 프로그램으로 등록할 수 있습니다. 또는 ~/.config/autostart/ 디렉토리에 fcitx5-autostart.desktop 파일을 생성하여 수동으로 자동 시작을 설정할 수 있습니다.

마무리

본 가이드를 통해 라즈베리파이 OS Bookworm 환경에서 IBus의 Chrome 한글 입력 문제를 해결하고 Fcitx5로 성공적으로 전환하는 방법을 살펴보았습니다. Wayland 환경으로의 전환은 리눅스 데스크톱 생태계에서 중요한 변화이며, 이에 따라 입력기 설정 방법도 함께 변화하고 있습니다. Fcitx5는 이러한 변화에 잘 적응한 입력기 프레임워크로, 라즈베리파이뿐만 아니라 다양한 리눅스 배포판에서 안정적인 다국어 입력 환경을 제공합니다.

설정 과정을 간략히 요약하면 다음과 같습니다.

먼저 기존 IBus 패키지와 관련 환경 변수 설정을 완전히 제거하고,
Fcitx5와 fcitx5-hangul 패키지를 설치합니다.
im-config를 통해 Fcitx5를 기본 입력기로 설정하고,
Fcitx5 Configuration에서 한글 입력기를 추가합니다.
Chrome 브라우저에서는 chrome://flags의 'Preferred Ozone platform'을 Wayland로 설정하고,
필요에 따라 환경 변수(GTK_IM_MODULE, QT_IM_MODULE, XMODIFIERS)를 .bashrc에 추가합니다.
마지막으로 가독성 좋은 한글 폰트를 설치하여 사용 경험을 향상시킵니다.

이 가이드가 라즈베리파이에서 한글 입력 환경을 구축하는 데 도움이 되었기를 바랍니다. 라즈베리파이는 교육용, 홈 서버, IoT 프로젝트 등 다양한 용도로 활용되는데, 한글 입력이 원활하게 지원되면 활용 범위가 더욱 넓어집니다. 혹시 이 가이드를 따라했는데도 문제가 해결되지 않는다면, 라즈베리파이 공식 포럼이나 한국 리눅스 커뮤니티에 질문을 올려 도움을 받으실 수 있습니다. 앞으로도 라즈베리파이와 함께 즐거운 컴퓨팅 경험을 하시길 바랍니다.

참고 자료

Fcitx5 공식 위키: https://fcitx-im.org/wiki/Fcitx_5
ArchWiki 한국어 입력 가이드: https://wiki.archlinux.org/title/Localization_(한국어)/Korean_(한국어)
라즈베리파이 공식 문서: https://www.raspberrypi.com/documentation/
Debian fcitx5-hangul 패키지 정보: https://packages.debian.org/bookworm/fcitx5-hangul
Korean Input Issues GitHub: https://github.com/korean-input/issues

저작자표시 비영리 변경금지 (새창열림)

'AI 코딩' 카테고리의 다른 글

[라즈베리파이] 4대 클러스터로 Qwen3-30B 구동하기 (0)	2026.02.02
[라즈베리파이] 30B 파라미터 LLM 실시간 구동 (0)	2026.02.01
[라즈베리파이] 4K모니터에서 CLI폰트 키우기 (0)	2026.02.01
Cloudflare Zero Trust VPN을 사용해 봅시다 (0)	2026.01.25
Cloudflare Tunnel을 활용한 HTTPS 연결하기(3) - Obsidian (0)	2026.01.23

화이트 샌드박스

[라즈베리파이] Bookworm에서 Chrome 한글 입력 문제 해결하기

한글입력기 IBus에서 Fcitx5로 전환 완벽 가이드

목 차

1. 문제 상황 이해하기 | IBUS로 잘되던 한글입력에 문제가 있다?

2. Wayland와 입력기의 관계

3. IBus 완전 제거하기

IBus 패키지 삭제

환경 변수 설정 정리

4. Fcitx5 설치 및 기본 설정

Fcitx5 패키지 설치

기본 입력기로 설정

한글 입력기 추가

한/영 전환 단축키 설정

5. Chrome 브라우저 한글 입력 문제 해결

Chrome 플래그 설정

Chrome 재시작

6. 한글 폰트 설정 및 최적화

6.1 한글 폰트 설치

시스템 폰트 변경

Fcitx5 입력창 폰트 설정

7. 문제 해결 및 팁

일반적인 문제 해결

Chrome 특정 문제 해결

유용한 팁

마무리

참고 자료

'AI 코딩' 카테고리의 다른 글

티스토리툴바

[라즈베리파이] Bookworm에서 Chrome 한글 입력 문제 해결하기

한글입력기 IBus에서 Fcitx5로 전환 완벽 가이드

목 차

1. 문제 상황 이해하기 | IBUS로 잘되던 한글입력에 문제가 있다?

2. Wayland와 입력기의 관계

3. IBus 완전 제거하기

IBus 패키지 삭제

환경 변수 설정 정리

4. Fcitx5 설치 및 기본 설정

Fcitx5 패키지 설치

기본 입력기로 설정

한글 입력기 추가

한/영 전환 단축키 설정

5. Chrome 브라우저 한글 입력 문제 해결

Chrome 플래그 설정

Chrome 재시작

6. 한글 폰트 설정 및 최적화

6.1 한글 폰트 설치

시스템 폰트 변경

Fcitx5 입력창 폰트 설정

7. 문제 해결 및 팁

일반적인 문제 해결

Chrome 특정 문제 해결

유용한 팁

마무리

참고 자료

'AI 코딩' 카테고리의 다른 글

관련글

티스토리툴바