Пост

Установка RabbitMQ на Raspberry Pi Zero 2 W с Geekworm X301 и выносом данных на SSD

В этой статье описан проверенный на практике процесс установки и настройки RabbitMQ на Raspberry Pi Zero 2 W с платой расширения Geekworm X301 и SSD. Операционная система Raspberry Pi OS Lite остаётся на microSD, а все данные RabbitMQ (очереди, сообщения, логи) переносятся на SSD. Это защищает карту памяти от интенсивного износа и обеспечивает стабильную работу сервера для IoT-устройств, домашней автоматизации и учебных проектов. Инструкция учитывает ограничения платформы: 512 МБ ОЗУ и одноядерный (4-поточный) CPU, поэтому включает обязательную оптимизацию памяти и планировщика Erlang.

Установка RabbitMQ на Raspberry Pi Zero 2 W с Geekworm X301 и выносом данных на SSD

В этой статье описан проверенный на практике процесс установки и настройки RabbitMQ на Raspberry Pi Zero 2 W с платой расширения Geekworm X301 и SSD. Операционная система Raspberry Pi OS Lite остаётся на microSD, а все данные RabbitMQ (очереди, сообщения, логи) переносятся на SSD. Это защищает карту памяти от интенсивного износа и обеспечивает стабильную работу сервера для IoT-устройств, домашней автоматизации и учебных проектов. Инструкция учитывает ограничения платформы: 512 МБ ОЗУ и одноядерный (4-поточный) CPU, поэтому включает обязательную оптимизацию памяти и планировщика Erlang.

Рекомендации перед началом

Убедитесь, что источник питания выдаёт не менее 3 А при 5 В — это требование Geekworm X301. Загрузка системы с SSD через X301 на Raspberry Pi Zero 2 W невозможна, поэтому microSD остаётся системным носителем. SSD используется только для данных RabbitMQ. Все команды выполняются по SSH; фиксированный IP-адрес уже настроен на шлюзе.

Подготовка SSD и автоматическое монтирование

После физического подключения SSD к X301 определите устройство командой lsblk. Обычно SSD определяется как /dev/sda, а microSD — как /dev/mmcblk0. Создайте таблицу разделов и отформатируйте раздел в ext4:

1
2
3
sudo fdisk /dev/sda
# в интерактивном режиме: d (удалить старые), n (новый), p (primary), Enter, w (записать)
sudo mkfs.ext4 /dev/sda1

Получите UUID файловой системы:

1
sudo blkid /dev/sda1

Скопируйте значение UUID="..." (не PARTUUID). Создайте точку монтирования и добавьте запись в /etc/fstab:

1
2
sudo mkdir -p /mnt/ssd
sudo nano /etc/fstab

Строка должна выглядеть так (подставьте свой UUID):

1
UUID=ваш-uuid /mnt/ssd ext4 defaults,noatime,nofail,x-systemd.device-timeout=30 0 2

Опции nofail и x-systemd.device-timeout=30 обязательны для headless-системы: они позволяют Raspberry Pi загрузиться, даже если SSD не будет готов вовремя. После сохранения перечитайте конфигурацию systemd и смонтируйте раздел:

1
2
3
4
sudo systemctl daemon-reload
sudo mount -a
findmnt /mnt/ssd
sudo findmnt --verify

Команда findmnt --verify должна показать 0 errors.

Установка RabbitMQ и Erlang

Обновите систему и установите пакеты из стандартного репозитория Raspberry Pi OS:

1
2
sudo apt update && sudo apt full-upgrade -y
sudo apt install -y erlang rabbitmq-server

Установка на Zero 2 W занимает несколько минут. После завершения проверьте статус сервиса:

1
systemctl status rabbitmq-server --no-pager

Если сервис не запущен автоматически, включите и запустите его:

1
sudo systemctl enable --now rabbitmq-server

Перенос данных RabbitMQ на SSD

Остановите RabbitMQ перед переносом:

1
sudo systemctl stop rabbitmq-server

Создайте каталоги для mnesia и логов на SSD, передайте права пользователю

rabbitmq:

1
2
3
sudo mkdir -p /mnt/ssd/rabbitmq/mnesia
sudo mkdir -p /mnt/ssd/rabbitmq/log
sudo chown -R rabbitmq:rabbitmq /mnt/ssd/rabbitmq

Укажите новые пути в файле /etc/rabbitmq/rabbitmq-env.conf:

1
sudo nano /etc/rabbitmq/rabbitmq-env.conf

Добавьте строки:

1
2
RABBITMQ_MNESIA_BASE=/mnt/ssd/rabbitmq/mnesia
RABBITMQ_LOG_BASE=/mnt/ssd/rabbitmq/log

Запустите сервис и проверьте, что база узла создана на SSD:

1
2
sudo systemctl start rabbitmq-server
sudo ls -la /mnt/ssd/rabbitmq/mnesia/

В каталоге должна появиться папка вида rabbit@rabbitmq01.

Оптимизация памяти и CPU для 512 МБ ОЗУ

Без ограничения памяти RabbitMQ может исчерпать ОЗУ и подвесить систему. Установите абсолютный лимит 200 МБ:

1
sudo rabbitmqctl set_vm_memory_high_watermark absolute 200MB

Чтобы настройка сохранялась после перезапуска, пропишите её в /etc/rabbitmq/rabbitmq.conf:

1
sudo nano /etc/rabbitmq/rabbitmq.conf

Добавьте:

1
vm_memory_high_watermark.absolute = 200MB

Для одноядерного (4-поточного) CPU ограничьте планировщик Erlang и отключите busy-waiting. В том же файле rabbitmq-env.conf добавьте строку:

1
RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS="+S 1:1 +sbwt none +sbwtdcpu none +sbwtdio none"

Перезапустите сервис:

1
sudo systemctl restart rabbitmq-server

Проверьте, что лимит применился:

1
sudo rabbitmqctl status | grep -A5 "Memory"

В выводе должно быть vm_memory_high_watermark: 209715200 bytes (200.0 MiB).

Создание пользователя и включение веб-интерфейса

Создайте отдельного пользователя и удалите гостевую учётную запись:

1
2
3
4
sudo rabbitmqctl add_user iot_user 'StrongPassword123'
sudo rabbitmqctl set_user_tags iot_user administrator
sudo rabbitmqctl set_permissions -p / iot_user ".*" ".*" ".*"
sudo rabbitmqctl delete_user guest

Включите плагин управления для мониторинга:

1
sudo rabbitmq-plugins enable rabbitmq_management

Веб-интерфейс доступен по адресу http://<фиксированный_IP>:15672 (логин iot_user, ваш пароль).

Типичные проблемы и решения

Проблема: findmnt --verify сообщает unreachable on boot required source: UUID=..., и SSD не монтируется.

Решение: В /etc/fstab по ошибке указан PARTUUID вместо UUID файловой системы. Выполните sudo blkid /dev/sda1 и скопируйте значение именно UUID="...". Замените строку в fstab, затем выполните sudo systemctl daemon-reload и sudo mount -a.

Проблема: После правки /etc/fstab система предупреждает, что systemd использует старую версию.

Решение: Выполните sudo systemctl daemon-reload, затем sudo mount -a. Предупреждение исчезнет.

Проблема: Настройка set_vm_memory_high_watermark сбрасывается после перезапуска RabbitMQ.

Решение: Пропишите vm_memory_high_watermark.absolute = 200MB в /etc/rabbitmq/rabbitmq.conf — эта настройка переживает рестарты.

Проблема: RabbitMQ не запускается после переноса данных, в логах ошибки доступа к /mnt/ssd/rabbitmq.

Решение: Убедитесь, что каталоги принадлежат пользователю rabbitmq: sudo chown -R rabbitmq:rabbitmq /mnt/ssd/rabbitmq. Проверьте, что SSD смонтирован (findmnt /mnt/ssd) и в fstab нет ошибок.

Проблема: Установка erlang или rabbitmq-server через apt завершается ошибкой зависимостей на ARM64.

Решение: Используйте официальные репозитории Team RabbitMQ и Erlang из Launchpad, либо повторите установку после sudo apt update && sudo apt full-upgrade -y. Для большинства IoT-задач версии из репозитория Raspberry Pi OS достаточно.

После выполнения всех шагов вы получите стабильный сервер RabbitMQ: система и загрузчик остаются на microSD, очереди, сообщения и логи размещены на SSD, потребление памяти ограничено 200 МБ, а планировщик Erlang оптимизирован под маломощный CPU. Такая конфигурация подходит для сбора данных с датчиков, домашней автоматизации и учебных проектов и обеспечивает предсказуемое поведение даже при кратковременных пиковых нагрузках.

Авторский пост защищен лицензией CC BY 4.0 .

© evdokimoff. Некоторые права защищены.

Использует тему Chirpy для Jekyll