結局どう直したか(先に言っておきます)
自宅の Raspberry Pi 5 に、SSH でも画面ログインでも入れなくなっちゃいました。パスワードを忘れて、鍵も通らない。完全な締め出しです。
で、結論から言うと——OSは入れ直していません。起動ディスク(うちは SSD)を Pi から抜いて Mac に挿し、ブート領域に「初回起動スクリプト」を1枚置くだけで、鍵を入れ直して復旧できました。設定もセンサーの環境もぜんぶ残ったままです。
同じように「Piに入れない、でも中身は消したくない」という人に向けて、やったことを残しておきます。
どう詰んでいたか
きっかけは OS の再構築でした。入れ直したあとに、管理ユーザーのパスワードが記憶と食い違っていて、しかも以前 Mac から登録していた SSH の公開鍵も新しい環境からは消えている。
ssh user@raspi→Permission denied(publickey,password)- VNC / デスクトップのログイン画面 → パスワードが通らない
ダッシュボード自体(:8000 で動いているやつ)は生きていて、ブラウザからは見えるんです。動いているのに、中には入れない。地味に一番きついやつですよね。
「もう入れ直すか……」と一瞬なりました。でも、動かしているコードは GitHub にも Mac にも揃っていたので消えて困るのは本体側の設定だけ。だったら、そこを残す方向で粘ってみることにしました。
調べたこと(と、ハマったところ)
昔ながらの手だと、cmdline.txt に init=/bin/sh を足してシングルユーザーで起動して passwd、というのがあります。でもこれ、キーボードとモニターを Pi に直結して手で打つ必要がある。うちはヘッドレス運用なので手元に無い。
じゃあディスクを Mac に挿して直接いじろう、と思ったんですが、ここで壁。
- ブート領域(FAT32)は Mac から読み書きできる
- でも 本体の Linux 領域(ext4)は 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も設定もセンサー環境も、何ひとつ入れ直さずに済みました。
学んだこと・気をつけること
- 可逆にしておく。 失敗しても
cp cmdline.txt.orig cmdline.txtで戻せる状態を先に作ったから、安心して踏み込めました。ブート系をいじるときはこれに尽きます。 - 消して困るのは「本体側の設定」だけ、と切り分ける。 コードが GitHub にあるなら、最悪入れ直してもコードは無事。今回もし復旧できなくても詰みではなかった、と分かっていたのは大きかったです。
- そもそも締め出されない準備を。 Raspberry Pi Imager で焼くときに、ユーザー名と SSH 公開鍵を最初から埋め込んでおけば、鍵を失う事故そのものが起きにくい。今回の復旧手順は、その保険が無かったときの最後の手、くらいに考えておくのがいいと思います。
- ついでに、サービスの起動定義(systemd の unit)や I2C の有効化みたいな「本体にしか無い設定」は、リポジトリの
deploy/にでも控えておくと、次に何かあっても一発で戻せます。今回それをやっていなかったのを反省して、復旧のついでに足しました。
同じ「動いてるのに入れない」で固まっている人の役に立てば。入れ直す前に、ブート領域からもう一手、あります。