Как изменить раскладку клавиатуры на Raspberry Pi

Клавиатура, подключённая к Raspberry Pi

Raspberry Pi — популярный одноплатный компьютер для обучения, хобби и профессиональных прототипов. У каждой модели свои характеристики, но всем им необходима операционная система для запуска приложений. Официальная ОС — Raspberry Pi OS (ранее Raspbian) — поддерживает все модели и поставляется в трёх вариациях: с рабочим столом и рекомендованным ПО, с рабочим столом и без набора рекомендованных приложений, и Lite (без графического интерфейса).

Независимо от модели и сценария использования, правильно настроенная раскладка клавиатуры — одна из базовых задач при первом запуске. Неправильная раскладка особенно заметна при наборе специальных символов (например, @, #, €, «») и может замедлить работу или привести к ошибкам при вводе паролей.

Кому это нужно и когда менять раскладку

Если вы используете локальную клавиатуру, отличную от английской (US/UK).
Если ввод специальных символов вызывает ошибки.
Если вы подключаетесь к Raspberry Pi удалённо и хотите, чтобы локальная клавиатура соответствовала ожидаемой раскладке.

Важно: если вы используете нестандартную клавиатуру (мультимедийную, с нестандартной раскладкой или Dvorak), выбирайте правильный Model/Variant.

Краткий обзор доступных методов

Через интерфейс рабочего стола (подходит для версий с GUI).
Через утилиту raspi-config (подходит для Lite и когда GUI недоступен).
Редактируя файл конфигурации /etc/default/keyboard (низкоуровневый метод, работает всегда).

Следующие разделы подробно описывают каждый метод, включают контрольный список, советы по отладке и таблицу соответствий кодов раскладки (XKB).

1. Изменение раскладки через рабочий стол Raspberry Pi OS

Этот способ самый простой, если у вас установлена версия с рабочим столом.

Запустите Raspberry Pi и войдите в рабочий стол.
Нажмите на значок Raspberry Pi в левом верхнем углу экрана.
В меню выберите «Preferences» → «Mouse and Keyboard Settings» (Мышь и клавиатура). Если этого пункта нет, откройте «Raspberry Pi Configuration».
В окне Mouse and Keyboard Settings переключитесь на вкладку «Keyboard», затем нажмите кнопку «Keyboard Layout».
В открывшемся окне вы увидите три основных параметра:
- Model (Модель): обычно выберите Generic 105-key PC (intl) — это универсальная модель для современных клавиатур.
- Layout (Раскладка): выберите страну/регион, соответствующий вашей раскладке (например, Russian, English (US), German).
- Variant (Вариант): определяет альтернативные варианты раскладки (например, для американской раскладки — QWERTY, для некоторых — Dvorak).
После выбора нажмите OK и закройте окна.
При необходимости перезагрузите Raspberry Pi.

Совет: если вы подключаете клавиатуру по USB и она определяется неправильно, попробуйте другой USB-порт или другую клавиатуру, чтобы исключить аппаратную несовместимость.

2. Изменение раскладки через raspi-config (для Raspberry Pi OS Lite или при отсутствии GUI)

Если у вас версия Lite или вы работаете через SSH/терминал, используйте raspi-config.

Подключитесь к Raspberry Pi локально или через SSH.
Выполните команду:

sudo raspi-config

В меню с помощью стрелок выберите Localisation Options (Параметры локализации).
Выберите Change Keyboard Layout (Изменить раскладку клавиатуры).
Убедитесь, что модель клавиатуры установлена в Generic 105-key PC (intl.), затем выберите нужную Layout (например, us, gb, ru) и Variant (QWERTY/другое).
Оставьте остальные параметры по умолчанию, если не уверены.
Завершите настройки и перезагрузите систему, если потребуется.

Примечание: если raspi-config запускается автоматически при первом старте, вы увидите похожий экран сразу после установки.

3. Правка файла конфигурации /etc/default/keyboard

Этот метод работает в любом случае и полезен, когда два предыдущих не дают результата.

Подключитесь к Raspberry Pi локально или по SSH.
Откройте файл конфигурации в текстовом редакторе, например nano:

sudo nano /etc/default/keyboard

Найдите и отредактируйте значения, чтобы они соответствовали желаемой раскладке. Пример для английской раскладки США:

XKBMODEL="pc105"
XKBLAYOUT="us"
XKBVARIANT=""
XKBOPTIONS=""
BACKSPACE="guess"

Сохраните изменения: CTRL+O, нажмите Enter; выйти — CTRL+X.
Перезагрузите Raspberry Pi:

sudo reboot

Совет: для русской раскладки используйте XKBLAYOUT=”ru”. Для немецкой — “de”, французской — “fr” и т.д. Полный список кодов XKB можно найти в официальной документации XKB (в системе он обычно доступен в /usr/share/X11/xkb/rules/).

Чек-лист перед изменением раскладки

Убедитесь, что у вас права sudo.
Для удалённого доступа проверьте, что клавиатура на клиентской стороне настроена корректно.
Идентифицируйте модель клавиатуры (pc105 для стандартных 104/105-клавишных клавиатур).
Сделайте снимок экрана или запишите старые значения файла /etc/default/keyboard перед изменением.

Быстрый справочник XKB-кодов (часто используемые)

us — English (US)
gb — English (UK)
ru — Russian
de — German
fr — French
es — Spanish
it — Italian

Эти коды подходят для параметра XKBLAYOUT в /etc/default/keyboard и для выбора в raspi-config.

Отладка: что делать, если раскладка не меняется

Проверьте, не перекрывает ли локальный X-сервер или менеджер клавиатуру (например, если вы используете VNC, раскладка может применяться на стороне клиента).
Убедитесь, что после изменения файла /etc/default/keyboard выполнена перезагрузка.
Проверьте, не установлены ли дополнительные XKB-опции в файлах /etc/X11/xorg.conf.d/ или в пользовательских конфигурациях среды рабочего стола.
Для SSH-подключений: клавиатура, используемая в эмуляторе терминала, может транслировать символы по-разному; проверьте настройки локальной машины.
Если используете Wayland/особую среду — проверьте документацию окружения рабочего стола, так как некоторые среды управляют раскладкой самостоятельно.

Если проблема остаётся, выполните проверку текущих настроек:

localectl status
setxkbmap -print -verbose 10

Эти команды покажут активные параметры локализации и XKB.

Когда прописывать настройки вручную предпочтительнее

При массовом развёртывании образов (автоматизация через скрипты).
В headless-сценариях, где GUI отсутствует.
Когда raspi-config недоступен (пользователь удалённого образа, кастомный минимальный образ).

Мини-методология выбора подхода:

Есть GUI? — Да → Меню рабочего стола.
Нет GUI, есть доступ к терминалу? — Да → raspi-config.
raspi-config не помогает или нужен скрипт? — Редактировать /etc/default/keyboard.

graph TD
  A[Есть GUI?] -->|Да| B[Настройка через рабочий стол]
  A -->|Нет| C[Есть доступ к терминалу?]
  C -->|Да| D[raspi-config]
  C -->|Нет| E[Использовать другой доступ 'SSH/монитор']
  D --> F{Работает?}
  F -->|Да| G[Готово]
  F -->|Нет| H[Редактировать /etc/default/keyboard]
  H --> G
  E --> I[Подключиться локально и повторить]
  I --> D

Роли и чек-листы (кратко)

Хоббист / новичок:
- Используйте GUI-метод.
- Выберите Generic 105-key PC и нужную страну.
- Перезагрузите систему.
Разработчик / инженер:
- Предпочтение raspi-config или /etc/default/keyboard для автоматизации.
- Сохраните конфигурацию в репозитории как скрипт развертывания.
Системный администратор:
- Автоматизируйте с помощью Ansible/скриптов: изменяйте /etc/default/keyboard и перезагружайте службы.
- Документируйте используемые XKB-коды в стандартах конфигурации.
Преподаватель / класс:
- Настройте образ со стандартной локалью для курса и распечатайте инструкции для студентов.

Критерии приёмки

Раскладка клавиатуры соответствует ожидаемым символам при вводе латиницы и специальных символов.
При входе в систему пароли вводятся корректно (особенно важно для администратора).
Для удалённых сеансов раскладка совпадает на клиенте и сервере или документировано отличие.

Частые вопросы и решения

Q: После изменения в GUI раскладка остаётся старой. Что делать? A: Проверьте /etc/default/keyboard и запустите sudo reboot. Если используется VNC, проверьте настройки клиента VNC.

Q: Как вернуть предыдущую конфигурацию, если новый вариант не подходит? A: Вручную восстановите файл /etc/default/keyboard из резервной копии или выберите прежние параметры в raspi-config.

Q: Что если у меня нестандартная клавиатура (медиа-клавиши, макро-клавиши)? A: Для функциональных клавиш может потребоваться дополнительная настройка в X11/udev или установка специфичных драйверов.

Шпаргалка команд

Запустить raspi-config:

sudo raspi-config

Редактировать файл раскладки:

sudo nano /etc/default/keyboard

Перезапустить систему:

sudo reboot

Проверить текущую локаль и раскладку:

localectl status
setxkbmap -query

Итог

Правильная раскладка клавиатуры на Raspberry Pi — небольшая, но важная часть настройки рабочей среды. Основные варианты изменения: через графический интерфейс для рабочих столов, через raspi-config для систем без GUI и прямое редактирование /etc/default/keyboard для точечного контроля или автоматизации. Выполните перезагрузку после изменения и проверьте ввод специальных символов, чтобы убедиться, что система работает ожидаемо.

Важно: при удалённом подключении учитывайте поведение клиента (SSH/VNC) — иногда «проблема с раскладкой» оказывается на стороне локальной машины.

Краткие рекомендации:

Для большинства пользователей: выбрать «Generic 105-key PC (intl)» и Layout, соответствующую вашей стране.
Для автоматизации: изменять /etc/default/keyboard в скрипте развёртывания.

Спасибо за внимание — теперь клавиатура вашего Raspberry Pi будет работать так, как вы ожидаете.