우분투 24.04 LTS에서 한글 입력 환경을 구축하고 Microsoft Edge 브라우저를 설치하는 완전 가이드다. 특히 외산 키보드 사용자들이 겪는 Hangul 키 인식 문제를 해결하는 방법을 포함했다.

포스팅 시점이 늦은 감은 있지만, 신규 프로젝트에 돌입하였기 때문에, 이 작업을 몇번이나 반복하게 될지 몰라 25년 6월 현재 기준으로 안정적인 설정을 메모해두기 위해 정리해본다.


1. 키보드 매핑 확인 및 설정

1-1. 실제 키 입력값 확인

먼저 키보드의 실제 키 코드를 확인한다.

# evtest 설치
sudo apt update
sudo apt install evtest

# 키보드 장치 확인 및 테스트
sudo evtest

장치를 선택한 후 오른쪽 Alt와 오른쪽 Ctrl 키를 눌러 키 코드를 확인한다.

일반적인 외산 키보드 결과:

  • 오른쪽 Alt: KEY_RIGHTALT (100)
  • 오른쪽 Ctrl: KEY_RIGHTCTRL (97)

1-2. 키 매핑 설정

확인된 키 코드를 바탕으로 한글 키로 매핑한다.

# 키 매핑 파일 생성
cat > ~/.Xmodmap << 'EOF'
! 오른쪽 Alt (keycode 100)를 Hangul로 매핑
keycode 100 = Hangul
! 오른쪽 Ctrl (keycode 97)을 Hangul_Hanja로 매핑  
keycode 97 = Hangul_Hanja
EOF

# 키 매핑 즉시 적용
xmodmap ~/.Xmodmap

# 적용 결과 확인
xmodmap -pke | grep -E "(100|97)"

1-3. 부팅시 자동 적용 설정

# .profile에 자동 실행 추가
echo 'xmodmap ~/.Xmodmap 2>/dev/null' >> ~/.profile

# 또는 autostart 설정
mkdir -p ~/.config/autostart
cat > ~/.config/autostart/xmodmap.desktop << 'EOF'
[Desktop Entry]
Type=Application
Name=Xmodmap Korean Keys
Exec=xmodmap %h/.Xmodmap
Hidden=false
NoDisplay=false
X-GNOME-Autostart-enabled=true
Comment=Korean keyboard mapping
EOF

2. 한글 입력기 설치 및 설정

2-1. IBus 한글 패키지 설치

# IBus 한글 입력기 설치
sudo apt install ibus-hangul

# 한국어 언어팩 설치
sudo apt install language-pack-ko language-pack-ko-base

# 한글 폰트 설치
sudo apt install fonts-nanum fonts-nanum-coding fonts-nanum-extra fonts-baekmuk

# 추가 유용한 패키지
sudo apt install im-config

2-2. 환경 변수 설정

# 한글 입력 환경 변수 추가
cat >> ~/.profile << 'EOF'

# 한글 입력 환경 변수
export GTK_IM_MODULE=ibus
export QT_IM_MODULE=ibus
export XMODIFIERS=@im=ibus
export QT4_IM_MODULE=ibus
export CLUTTER_IM_MODULE=ibus
EOF

# 현재 세션에 즉시 적용
source ~/.profile

2-3. IBus 설정

# IBus 데몬 시작
ibus-daemon -drx

# IBus 설정 실행
ibus-setup

IBus 설정 창에서:

  1. Input Method 탭 → AddKoreanHangul 선택 후 추가
  2. General 탭에서 기본 단축키들 비활성화 또는 변경

2-4. IBus Hangul 세부 설정

# IBus Hangul 설정 실행
/usr/libexec/ibus-setup-hangul

설정 항목:

  • 한글 키: Alt_R (수동 등록)
  • 한자 키: Control_R (수동 등록)
  • 키보드 레이아웃: 2벌식
  • 초기 입력 모드: 영문

주의: 외산 키보드의 경우 Hangul, Hangul_Hanja로 자동 인식되지 않으므로 Alt_R, Control_R로 직접 등록해야 한다.

2-5. 시스템 입력 소스 설정

# 시스템 설정 열기
gnome-control-center region

GUI 설정:

  1. 설정지역 및 언어입력 소스
  2. + 버튼 클릭 → Korean (Hangul) 추가

3. Microsoft Edge 설치

3-1. GPG 키 및 리포지토리 추가 (2025년 최신 방법)

# GPG 키를 keyrings 디렉토리에 추가 (권장 방법)
curl -fSsL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor | sudo tee /usr/share/keyrings/microsoft-edge.gpg > /dev/null

# Microsoft Edge 리포지토리 추가
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft-edge.gpg] https://packages.microsoft.com/repos/edge stable main' | sudo tee /etc/apt/sources.list.d/microsoft-edge.list

3-2. Edge 설치

# 패키지 목록 업데이트 및 설치
sudo apt update
sudo apt install microsoft-edge-stable

3-3. Edge 실행

# 터미널에서 실행
microsoft-edge-stable &

또는 애플리케이션 메뉴에서 "Microsoft Edge" 검색하여 실행한다.

4. 한글 입력 테스트

4-1. 기본 테스트

  1. 텍스트 에디터에서 테스트
  2. gedit &
  3. 테스트 순서
    • 오른쪽 Alt 키로 한/영 전환
    • 한글 입력 (예: "안녕하세요")
    • 오른쪽 Ctrl 키로 한자 변환
    • 다시 오른쪽 Alt 키로 영문 모드 전환

4-2. Edge 브라우저에서 테스트

  1. Edge 실행 후 검색창 클릭
  2. 오른쪽 Alt로 한/영 전환 확인
  3. 한글 입력 및 한자 변환 테스트
  4. 다양한 웹사이트에서 테스트

5. 문제 해결

5-1. 한글 입력이 안 되는 경우

# IBus 재시작
ibus-daemon -drx

# 키 매핑 재적용
xmodmap ~/.Xmodmap

# IBus 상태 확인
ibus list-engine | grep hangul

# 환경 변수 확인
echo $GTK_IM_MODULE

5-2. 시스템 재시작 후 키 매핑이 안 되는 경우

# .profile에 xmodmap 명령어가 있는지 확인
grep xmodmap ~/.profile

# 수동으로 키 매핑 재적용
xmodmap ~/.Xmodmap

5-3. 충돌 방지

현재 설정은 오른쪽 Alt/Ctrl을 사용하므로 왼쪽 Alt/Ctrl을 사용하는 기본 시스템 단축키와 충돌하지 않는다. 만약 문제가 발생하면:

# 시스템 단축키 확인
gsettings list-recursively | grep -i "alt\|control"

6. 정리

이제 우분투 24.04 LTS에서 외산 키보드로도 완벽한 한글 입력 환경을 구축했다.

설정된 키 매핑:

  • 한/영 전환: 오른쪽 Alt (keycode 100)
  • 한자 변환: 오른쪽 Ctrl (keycode 97)

주요 파일 위치:

  • 키 매핑: ~/.Xmodmap
  • 환경 변수: ~/.profile
  • IBus 설정: ~/.config/ibus/

유지 관리:

  • 시스템 업데이트시 Edge는 자동 업데이트됨
  • 한글 설정은 재부팅 후에도 자동 적용됨
  • 문제 발생시 ibus-daemon -drx 명령어로 재시작

이제 Edge 브라우저와 모든 애플리케이션에서 자유롭게 한글과 영문을 전환하며 사용할 수 있다.

+ Recent posts