Восстановление headless Raspberry Pi через Mac

Когда Pi не загружается, нет доступа по SSH, а клавиатуры/мыши нет — recovery возможен через подключение его системного SSD к Mac.

Что доступно

Быстрый процесс

# 1. Извлечь SSD из Pi → подключить к Mac через SATA-USB переходник
# 2. Проверить что появилось:
diskutil list external
 
# 3. boot (FAT32) монтируется автоматически в /Volumes/boot
# 4. ext4 — через Paragon или вручную:
sudo /Library/Filesystems/ufsd_ExtFS.fs/Contents/Resources/mount_ufsd_ExtFS /dev/disk4s2 /tmp/pi_root
 
# 5. Сделать правки
 
# 6. Перед извлечением:
diskutil unmount /Volumes/boot
diskutil unmount /Volumes/rootfs   # или /tmp/pi_root

Частые правки

Правки только в FAT32 (без Paragon)

В /Volumes/boot/cmdline.txt (одна строка, LF в конце, без CR):

• systemd.mask=UNIT — отключить проблемный юнит (подробнее)
• usb-storage.quirks=...:u — отключить UAS для USB-SATA моста (для Argon)
• init=/bin/sh — boot в root shell (но требует клавиатуру для команд)
• fsck.mode=skip — пропустить fsck на этот boot
• systemd.unit=rescue.target или emergency.target (требует root password)

В /Volumes/boot/config.txt:

• dtoverlay= — device tree overlays
• arm_freq=, arm_boost= — частоты CPU
• Hardware enables (i2c, spi)

Правки в ext4 (требуется Paragon)

• /etc/systemd/system.conf — RuntimeWatchdogSec (лимит на Pi 4)
• /etc/fstab — добавить nofail (паттерн)
• /etc/lvm/lvm.conf — activation_mode = degraded для RAID1 (подробнее)
• /etc/systemd/system/multi-user.target.wants/SERVICE — отключить через rename
• /var/log/journal/<id>/*.journal~ — почистить corrupt journals

Перед извлечением

Обязательно diskutil unmount на оба раздела — иначе FAT32 dirty bit может вызвать Dependency failed for /boot → emergency mode на следующем boot.

Проверка после возврата SSD

ping <pi-host>          # сеть поднялась?
ssh <pi-host> "uptime; systemctl is-system-running"

Связано

• Pi 4 BCM2835 watchdog лимит таймаута
• Ext4 на macOS чтение и запись
• Диагностика boot loop systemd на Raspberry Pi

Мета

Область:: 00 Linux