본문 바로가기
트러블 슈팅 노트

Debian 설치는 끝났는데 한글 입력이 안 됐어요. ibus-hangul로 해결했습니다.

by 크리에이터 독타 (Creator Dokta) 2026. 10. 2.

 

Debian 설치는 끝났는데 한글 입력이 안 됐어요, ibus-hangul로 해결했습니다

지난 편에서 Ventoy USB를 빼고 X MINI를 재부팅해서 F7 파란 부트 메뉴에 Windows Boot Manager와 Debian이 같이 뜨는 걸 확인했어요.

Debian Xfce 첫 화면까지 들어갔고, Firefox도 정상적으로 실행됐습니다.

인터넷 연결도 잘 됐어요.

여기까지는 꽤 순조로웠습니다.

그런데 브라우저에서 글자를 입력해보다가 바로 하나 걸렸어요.

화면은 분명 한국어인데, 한글 입력이 안 됐어요.

Debian은 잘 켜졌는데 한글이 안 써졌어요

Debian에 처음 로그인하고 나서는 좌측 상단 메뉴부터 하나씩 둘러봤어요.

터미널이 어디 있는지도 확인했고, Firefox도 실행해봤고요.

그런데 Firefox 주소창에서 글자를 입력해보다가 바로 문제가 보였습니다.

한글 입력이 안 됐어요.

설치할 때 언어도 한국어로 선택했고 화면 메뉴도 한글로 나오고 있었기 때문에, 저는 당연히 한글 입력도 바로 될 거라고 생각했어요.

그런데 키보드를 눌러보면 영문만 입력됐습니다.

“화면은 한글인데 왜 입력은 안 되지?”

처음에는 키보드 설정을 잘못했나 싶었어요.

Windows에서는 한/영 키 하나만 누르면 바로 바뀌는 게 너무 익숙했기 때문에 더 헷갈렸습니다.

찾아보니 입력기가 따로 필요했어요

조금 찾아보니 Debian에서는 화면 언어와 실제 문자 입력 환경이 꼭 같은 건 아니었어요.

한글을 입력하려면 입력기 설정이 따로 필요했습니다.

여기서 처음 본 이름이 두 개 있었어요.

  • IBus
  • ibus-hangul

제가 이해한 바로는 IBus가 여러 언어의 입력 방식을 관리하는 틀이고, ibus-hangul은 그 안에서 실제 한글 입력을 담당하는 구성 요소였어요.

즉 Debian을 한국어로 설치한 것과 한글 입력기가 실제로 준비돼 있는 것은 다른 문제였던 거예요.

화면 언어는 한국어일 수 있어도,
한글을 조합해서 입력하는 기능은 별도로 준비해야 했어요.

터미널부터 열었어요

15편에서 메뉴를 둘러보면서 터미널 위치를 미리 확인해둔 게 여기서 바로 도움이 됐어요.

터미널을 열고 먼저 패키지 정보를 업데이트해보기로 했습니다.

그런데 여기서 아주 작은 실수를 하나 했어요.

처음에는 그냥 이렇게 입력했습니다.

update

당연히 안 됐어요.

터미널에는 이런 메시지가 나왔습니다.

bash: update: command not found

Windows에서 프로그램 메뉴를 누르는 것처럼 생각하면 안 되는 거였어요.

그래서 다시 제대로 입력했습니다.

sudo apt update

이번에는 Debian 저장소 정보를 확인하면서 정상적으로 진행됐어요.

별것 아닌 실수처럼 보이지만 Linux를 처음 배우는 입장에서는 이런 게 오히려 기억에 잘 남더라고요.

비슷하게 보이는 명령이라도 정확하게 입력해야 했어요.

ibus와 ibus-hangul을 확인했어요

패키지 정보를 업데이트한 다음에는 한글 입력에 필요한 패키지를 확인했습니다.

제가 사용한 명령은 이거였어요.

sudo apt install ibus ibus-hangul

설치 결과를 보니 IBus는 이미 최신 버전으로 들어 있었어요.

그래서 입력기 자체가 전혀 없는 상태는 아니었습니다.

제가 필요한 건 그 안에서 한글 입력을 담당하는 ibus-hangul 쪽이었어요.

Windows에서는 이런 구성 요소를 따로 의식하지 않고 사용했는데, Linux에서는 입력 환경도 하나씩 확인하고 맞추는 느낌이 들었습니다.

설치했다고 바로 한글이 되는 건 아니었어요

ibus-hangul을 확인했으니 이제 바로 한글이 입력될 줄 알았어요.

그런데 여기서 끝이 아니었습니다.

이번에는 IBus 환경설정을 열어야 했어요.

패키지를 설치해도 실제로 어떤 입력 방식을 사용할 것인지 등록해줘야 했습니다.

IBus 환경설정을 열어보니 몇 가지 탭이 있었어요.

  • 일반
  • 입력기
  • 이모지
  • 고급

처음에는 어디로 들어가야 하는지 잠깐 살펴봤지만, 이름 그대로 입력기 탭으로 들어갔어요.

한국어 - Hangul을 추가했어요

입력기 목록을 확인해보니 한국어 관련 항목을 추가할 수 있었습니다.

여기서 제가 사용할 입력기로 한국어 - Hangul을 추가했어요.

화면에는 한글 입력기와 함께 한국어 키보드 호환 항목도 보였습니다.

이걸 보니까 조금씩 구조가 이해됐어요.

키보드 배열이 한국어인 것과 실제로 한글 자모를 조합해서 입력하는 건 또 다른 일이었던 거예요.

한/영 전환 키도 확인했어요

IBus 설정을 둘러보다가 입력기를 전환하는 단축키도 확인했습니다.

기본 설정에는 이렇게 표시돼 있었어요.

Super + Space

Super 키는 일반적인 키보드에서 Windows 키가 있는 위치의 키라고 보면 됐어요.

Windows에서는 한/영 키를 누르는 방식에 익숙했는데, Debian에서는 입력기 전환 방법 자체가 조금 달랐습니다.

처음에 한/영 키를 눌러도 생각한 대로 움직이지 않으니까 또 문제가 생긴 줄 알았어요.

Linux를 처음 쓰면서 느낀 건, 안 되는 게 아니라 제가 Windows 방식으로 생각하고 있었던 경우가 꽤 많다는 거였어요.

설정했는데 바로 안 되면 로그아웃 한번

입력기를 설치하고 설정까지 바꿨는데도 바로 적용되지 않을 수 있었어요.

그래서 현재 세션을 한번 다시 시작해보기로 했습니다.

좌측 메뉴에서 로그아웃 화면을 열었어요.

로그아웃, 다시 시작, 시스템 종료, 사용자 전환 같은 항목들이 보였습니다.

처음에는 아예 재부팅까지 해야 하나 생각했어요.

그런데 입력기 설정 정도라면 우선 로그아웃한 뒤 다시 로그인해서 확인해보면 될 것 같았어요.

Linux에서는 설정을 바꾼 뒤 현재 세션에 바로 반영되지 않는 경우가 있다는 것도 여기서 조금씩 배우기 시작했습니다.

다시 Firefox를 열었어요

다시 로그인한 다음 Firefox를 열었습니다.

이번에는 주소창이나 검색창에 한글을 다시 입력해봤어요.

처음에는 조심스럽게 짧게 쳐봤습니다.

“잘 돼”

이번에는 한글이 들어갔어요.

생각보다 반가웠습니다.

사실 Debian 설치 자체와 비교하면 아주 작은 설정이에요.

그런데 실제로 컴퓨터를 쓰려면 이런 작은 부분이 훨씬 중요할 때가 있잖아요.

Debian이 아무리 정상적으로 부팅돼도 제가 한글을 입력할 수 없다면 일상적으로 사용하기는 불편하니까요.

처음에는 update 명령부터 틀렸지만, ibus-hangul을 설정한 뒤 Firefox에서 실제 한글 입력까지 확인했습니다.
출처: 독타의 디지털 장난감

제가 한 순서를 다시 정리해봤어요

  • 터미널 열기
    15편에서 위치를 미리 확인해뒀어요.
  • 패키지 정보 업데이트
    sudo apt update
    처음에는 update만 입력해서 에러가 났어요.
  • 입력기 준비
    sudo apt install ibus ibus-hangul
    IBus는 이미 최신 상태였습니다.
  • IBus 환경설정
    입력기 탭에서 한국어 - Hangul을 추가했어요.
  • 전환키 확인
    Super + Space를 확인했습니다.
  • 로그아웃 후 재로그인
    바꾼 입력기 설정이 제대로 적용됐는지 다시 확인했어요.
  • Firefox에서 실제 테스트
    한글 입력이 정상적으로 되는 걸 확인했습니다.

한국어 화면과 한글 입력은 같은 게 아니었어요

이번에 가장 확실하게 알게 된 건 이거였어요.

Debian을 한국어로 설치했다고 해서 한글 입력 환경까지 모두 자동으로 끝나는 건 아니었습니다.

화면 언어는 한국어일 수 있고, 키보드 배열도 한국어일 수 있어요.

그와 별개로 실제 한글을 조합해서 입력하는 입력기도 필요했습니다.

저처럼 Windows만 오래 사용했던 사람에게는 이 구분 자체가 조금 낯설었어요.

그런데 직접 한번 겪고 나니까 이제는 왜 화면은 한글인데 입력은 안 됐는지 이해가 됐습니다.

이제 다음은 Docker를 설치해보려고요

Debian도 정상적으로 부팅됐고 한글 입력까지 해결했어요.

이제야 조금씩 실제로 사용할 수 있는 Linux 환경이 만들어지는 느낌이 들었습니다.

그런데 제가 X MINI에 Debian을 설치한 진짜 목적은 데스크톱 Linux를 구경하는 데서 끝나는 게 아니었어요.

이 작은 N100 미니PC를 자동화 서버로 써보고 싶었어요.

그러려면 다음으로 필요한 게 Docker였습니다.

다음에는 Debian에 Docker를 설치하고 실제로 서비스가 실행되는지 확인해보려고요.

그런데 여기서도 한 번에 끝나지는 않았어요.

Docker는 설치됐는데, 이번에는 compose가 없다고 하더라고요.

※ 본 글은 Debian Xfce 환경에서 한글 입력이 되지 않아 직접 설정해본 개인적인 경험을 기록한 글입니다. IBus와 ibus-hangul 설치 및 설정 방법은 Debian 버전과 데스크톱 환경에 따라 다를 수 있습니다. 동일한 환경에서도 설정 상태에 따라 과정이 달라질 수 있으니 실제 사용 환경을 함께 확인해주세요.