Raspberry Pi から締め出された — OSを入れ直さずに、SSDのブート領域から復旧した話

結局どう直したか(先に言っておきます)

自宅の Raspberry Pi 5 に、SSH でも画面ログインでも入れなくなっちゃいました。パスワードを忘れて、鍵も通らない。完全な締め出しです。

で、結論から言うと——OSは入れ直していません。起動ディスク(うちは SSD)を Pi から抜いて Mac に挿し、ブート領域に「初回起動スクリプト」を1枚置くだけで、鍵を入れ直して復旧できました。設定もセンサーの環境もぜんぶ残ったままです。

同じように「Piに入れない、でも中身は消したくない」という人に向けて、やったことを残しておきます。


どう詰んでいたか

きっかけは OS の再構築でした。入れ直したあとに、管理ユーザーのパスワードが記憶と食い違っていて、しかも以前 Mac から登録していた SSH の公開鍵も新しい環境からは消えている。

ダッシュボード自体(:8000 で動いているやつ)は生きていて、ブラウザからは見えるんです。動いているのに、中には入れない。地味に一番きついやつですよね。

「もう入れ直すか……」と一瞬なりました。でも、動かしているコードは GitHub にも Mac にも揃っていたので消えて困るのは本体側の設定だけ。だったら、そこを残す方向で粘ってみることにしました。


調べたこと(と、ハマったところ)

昔ながらの手だと、cmdline.txt に init=/bin/sh を足してシングルユーザーで起動して passwd、というのがあります。でもこれ、キーボードとモニターを Pi に直結して手で打つ必要がある。うちはヘッドレス運用なので手元に無い。

じゃあディスクを Mac に挿して直接いじろう、と思ったんですが、ここで壁。

つまり「authorized_keys に鍵を書き足す」を Mac から直接やる、ができないんです。

で、思い出したのが Raspberry Pi Imager が初回セットアップに使っている仕組み。あれ、ブート領域に firstrun.sh を置いて、cmdline.txt に「初回だけこのスクリプトを root で走らせてね」という指示を書き込んでいるんですね。この仕組みに相乗りすれば、キーボードなしで・非対話で・root 権限で好きな処理を1回だけ実行できる。鍵の登録なんてまさにうってつけです。


やったこと

Pi から起動ディスクを抜いて、Mac に接続。ブート領域(/Volumes/bootfs)が見えます。

まずバックアップ。 これ大事です。戻せる道を先に用意しておく。

cp /Volumes/bootfs/cmdline.txt /Volumes/bootfs/cmdline.txt.orig

初回起動スクリプトを置く。 中身は「自分の公開鍵を管理ユーザーの authorized_keys に足す → SSH を有効化 → 最後に自分の痕跡を消す」だけ。

cat > /Volumes/bootfs/firstrun.sh <<'EOF'
#!/bin/bash
set +e
install -d -m 700 -o USER -g USER /home/USER/.ssh
KEY='ssh-ed25519 AAAA...ここに ~/.ssh/xxx.pub の中身...'
grep -qxF "$KEY" /home/USER/.ssh/authorized_keys 2>/dev/null || echo "$KEY" >> /home/USER/.ssh/authorized_keys
chmod 600 /home/USER/.ssh/authorized_keys
chown USER:USER /home/USER/.ssh/authorized_keys
systemctl enable ssh; systemctl start ssh
rm -f /boot/firmware/firstrun.sh
sed -i 's| systemd.run.*||g' /boot/firmware/cmdline.txt
exit 0
EOF

USER は自分の管理ユーザー名に、KEY は自分の公開鍵(~/.ssh/なんとか.pub の中身)に置き換えてください。

cmdline.txt に「初回だけ走らせる」指示を1行で足す。 ここは改行を入れず、必ず1行に保つのがコツ。

printf '%s systemd.run=/boot/firmware/firstrun.sh systemd.run_success_action=reboot systemd.unit=kernel-command-line.target init=/usr/lib/raspberrypi-sys-mods/firstboot\n' \
  "$(cat /Volumes/bootfs/cmdline.txt.orig)" > /Volumes/bootfs/cmdline.txt

あとはディスクを安全に取り出して、Pi に戻して電源オン。

diskutil eject /dev/diskN

初回起動で firstrun.sh が一度だけ走って、勝手に1回リブートします。「起動が長いな、あれ再起動した?」というのが正常な挙動なので、慌てず2〜3分待ちます。


直りました

再起動後、鍵であっさり入れました。

$ ssh user@raspi 'whoami; hostname'
user
raspi-server

確認すると、firstrun.sh はちゃんと自分で消えていて、cmdline.txt も元通り(足した指示が自動で除去されている)。痕跡が残らないの、地味に気持ちいいんですよね。

管理ユーザーは sudo がパスワードなしで通る設定だったので、そのままデスクトップ用のパスワードも入れ直しておきました。

echo 'user:あたらしいパスワード' | sudo chpasswd

これで SSH も画面ログインも復活。OSも設定もセンサー環境も、何ひとつ入れ直さずに済みました。


学んだこと・気をつけること

同じ「動いてるのに入れない」で固まっている人の役に立てば。入れ直す前に、ブート領域からもう一手、あります。