また手順が変わったみたいなので、メモも更新。
(2023/10/15 最新版での試行結果を反映)

SDカードへの書き込み

Raspberry Pi Imager なるツールを使うようになったらしい。
使い方はあちこちに書いてあるけど、例えばこちら。

• Raspberry Pi Imagerの使い方 ― v1.7.2以降 対応版
• Raspberry Pi Imagerが新しくなった！Lite版もらくらくHeadless Setup

これを使うと、最初のユーザを自由に設定できるので、これまでのpiユーザを変更するなんてことはやらなくて済む。
Wi-Fiの設定やSSHの設定も(なんかWindowsが適切に設定されてれば公開鍵が自動で設定されるみたい)ここでできる。

パスワードが設定ファイルに書き出されるので(さすがに平文ではない、最初の起動が終わったら削除される)、
セキュリティ上気になる場合は仮パスワードを設定しておいて
最初にログインしたときに変更する、なんてことをやった方が良いと言ってる解説ページもあった。

[!WARNING] なぜかSSHの認証方法が毎回「パスワード認証を使う」になってしまうので、公開鍵を使うときは再度設定が必要。 (1.7.5では改善された模様)

[!WARNING] (少なくとも)2023/10以降のバージョンはopenSSHのバージョンがRSA非対応になっているので、 鍵ファイル作成の際はRSA以外(ed25519など)で作成する必要がある。
(2023/10/21 誤解してたので書き直し)
(少なくとも)2023/10以降のバージョンはopenSSHのバージョンが SSH-RSA 非対応になっているので、
Teraterm Ver4.106以前など RSA-SHA2未対応の環境ではRSA鍵では繋がらない。 その場合は RSA以外(ed25519など)で作成すれば良い。
ssh-keygenのデフォルトはRSAなので、ssh-keygen -t ed25519 などとする。
もちろん、Teraterm Ver4.107以降に変更するという手もある。

ブート前の設定

ブートの前にSDカードのFATパーティションのファイルをいじっておく。

UARTコンソールの有効化

UARTをコンソールとして使用するためにconfig.txt の 最後の [all] の行の下に以下を追加

# enable uart
enable_uart=1

IPv6の無効化

IPv6を無効化しておきたいときは、 cmdline.txt に ipv6.disable=1を追加する。
このファイルは1行で書かないといけないので、改行してはいけない。

[!WARNING] 以前はこれで無効化できていたはずだけど、2023/10現在 この手順では無効化できないらしい。
下でセットアップスクリプトで無効化処理を実行するように変更した。
(2023/10/21 間違ってたので削除)

ブートログの表示

ブートログが見えないと不安な人は、
cmdline.txt から quiet splash plymouth.ignore-serial-consoles を削除しておくとよい。

[!NOTE] LITE版ではquietを削除(それ以外は指定されていないので)

最初の起動

書き込んだSDカードをRaspberry Piに挿入して電源ON。
ごちょごちょと設定したあと、起動する(途中2回ほどrebootしてるらしい)

あとは起動後の設定。

何はともあれ、最新版へ

# アップデート実行
sudo apt update
sudo apt upgrade

# リブート
sudo reboot

カスタマイズ

[!NOTE] 以降の処理をスクリプトにまとめました。
Raspberry Pi セットアップスクリプト
以下の手順で実行できます。

wget https://gist.githubusercontent.com/ippei8jp/8053f0804a694c34cb18cd4035e0993c/raw/pi_setup1.sh
bash pi_setup1.sh

LITE版を使うときは変数LITE_OSに1を設定して実行します。

 LITE_OS=1 bash pi_setup1.sh

途中でパスワード入力しないといけないので、完全自動じゃないけど、かなり手間は省けるはず。
実行後、pi_setup1.shは不要なので削除して可。
実行が終わったらリブートすること。

sudo reboot

resizeスクリプトの取得

シリアルコンソールを使用する場合、コンソールサイズがあってなくてイライラするので、シリアルコンソールの設定用スクリプトを以下の手順で取得。

cd ~
wget https://gist.githubusercontent.com/ippei8jp/8179edb10867faf98e233a52965a9e53/raw/4f39afbcd8471426421944b597f3a5f2963984c6/resize.py

chmod +x resize.py

./resize.py

ロケールの変更

日本語表示のため、ロケールを変更する。
(imagerだとキーボードレイアウトの変更はやってくれるけど、ロケールの変更はやってくれないらしいので)

# ロケールの変更
sudo raspi-config nonint do_change_locale ja_JP.UTF-8

# リブートまでとりあえずLANGのみ変更で日本語表示
export LANG=ja_JP.UTF-8

.bashrc の変更

~/.bashrcを必要に応じて修正。 例えば、以下を追記。

# プロンプトの設定
PS1="\w\$ "

# キーバインドの設定
bind '"\C-n": history-search-forward'
bind '"\C-p": history-search-backward'

# ディレクトリスタックの表示改善
function pushd() {
    command pushd $* > /dev/null
    command dirs -v
}
function popd() {
    command popd $* > /dev/null
    command dirs -v
}
function dirs() {
    command dirs -v
}

# 表示色変更
export LS_COLORS='di=01;32:ln=01;36:ex=01;31:'
export GREP_COLORS='mt=01;31:ml=:cx=:fn=01;32:ln=32:bn=32:se=36'

# lessのオプション
export LESS="-iMR"

# reset console size
case "$TERM" in
    vt220) ~/resize.py ;;
esac

# pyenv 設定
export PYENV_ROOT=/proj/.pyenv
if [ -e $PYENV_ROOT ]; then
    export PATH=$PYENV_ROOT/bin:$PATH
    # Raspbian向け対策(numpyでundefined symbol: PyFPE_jbuf)
    export PYTHON_CONFIGURE_OPTS="\
     --enable-ipv6\
     --enable-unicode=ucs4\
     --enable-shared\
     --with-dbmliborder=bdb:gdbm\
     --with-system-expat\
     --with-system-ffi\
     --with-fpectl"

    eval "$(pyenv init --path)"          # pyenv 2.0以降で必要
    eval "$(pyenv init -)"
    eval "$(pyenv virtualenv-init -)"
fi

# nodenv 設定
export NODENV_ROOT=/proj/.nodenv
if [ -e $NODENV_ROOT ]; then
    export PATH=$NODENV_ROOT/bin:$PATH
    eval "$(nodenv init -)"
fi


# DISPLAY変数が未定義(MobaXterm使用でない)ならDISPLAYを設定する
if [ -v $DISPLAY ]; then
    export DISPLAY=192.168.78.200:0.0
fi
echo DISPLAY="$DISPLAY"

キーボードのCAPS - CTRLの入れ替え

物理キーボード接続で使わないなら設定不要

参考： https://qiita.com/Pseudonym/items/12e447557a5234bb265b

/etc/default/keyboardファイルの以下の部分を修正

XKBOPTIONS=""
    ↓
# XKBOPTIONS="ctrl:nocaps"        # CapsLock --> Ctrl
XKBOPTIONS="ctrl:swapcaps"      # CapsLock <-> Ctrl

[!WARNING]
これでできるハズなんだけど、なんかうまく行かない。。。
VNCしか使わないから、ま、いっか。

bashのクリップボードの挙動が以前と異なるようになったので対策

bashでクリップボードからペーストするとペーストした文字が選択状態になったり、改行がその場で入力されなかったりするようになった。
こればbash 5.1からブラケットペーストモード というのがデフォルトで有効になったためらしい。
(余計なことをしてくれる…😩💨)
これを回避するには/etc/inputrcの最後に以下を追記する。

# disable bracked-paste mode
set enable-bracketed-paste off

起動済みのbashには効かないが、設定以降に起動したbashでは有効になる(システムの再起動は不要)。

参考： シェル - bash - ブラケットペーストモード（Bracketed Paste Mode）

ワークディレクトリの作成とsambaの設定

まずはワークディレクトリの作成

sudo mkdir /work
sudo mkdir /proj
sudo chown $USER:$USER /work /proj

sambaのインストールと設定

sudo apt install samba
sudo smbpasswd -a $USER
    パスワードを設定

設定変更のため、/etc/samba/smb.conf を編集

[global] の下に以下を追加

map archive = no

[homes] の下の以下を修正

read only = no

[!NOTE] home は一旦log inしないと見えない

最後に以下を追加

[work]
path = /work
guest ok = no
writable = yes
map archive = no
share modes = yes
dos filetimes = yes
force group = <ユーザ名>
force create mode = 0664

[proj]
path = /proj
guest ok = no
writable = yes
map archive = no
share modes = yes
dos filetimes = yes
force group = <ユーザ名>
force create mode = 0664

サービスの再起動

sudo service smbd reload
sudo service smbd restart

VNCサーバの有効化

リモートデスクトップを使うために、VNCサーバの有効化を行う。
LITE版では不要。

sudo raspi-config
    # VNCサーバの有効化
    3 Interfacing Options
        I3 VNC
            Would you like the VNC Server to be enabled?
            と聞かれるので <Yes>
            The VNC Server is enabled
            と表示されるので <Ok>

    # VNC解像度の設定
    2 Display Options
        D5 VNC Resolution
        
            解像度が色々表示されるので、
            使いたい解像度を選択(例えば 1920x1080 )して<Select>
            The resolution is set to «選択した解像度»
            と表示されるので <Ok>
    # 設定終了
    <Finish>

IPv6 の無効化

cmdline.txtでの設定では無効化できなくなったと思ったけど、勘違いだった。
なので、上記のcmdline.txt にipv6.disable=1を追加する方法でOK。

でも、その時にmncliコマンドで無効化するスクリプトを作ったので、せっかくなので残しておく。

接続名一覧を取得し、 それぞれに対して無効化するコマンドを実行する。
接続名に「有線接続 1」と空白が含まれている接続があるので、一時的に空白をセミコロンに置換して処理を行っている。
(これをやらないと「有線接続」と「1」に分けて処理されてしまう)

# 接続一覧を取得
conn_data=$(nmcli -t connection)

# 空白を";"に置換(配列代入時に誤動作するのを防止)
conn_data=${conn_data// /";"}

# ':'区切りで1列目をconnections配列に格納
connections=($(echo "$conn_data" | cut -d":" -f1))

# 配列の要素を処理
for connection in "${connections[@]}"; do
    # 上で;に置換した空白を戻す
    connection=${connection//";"/" "}

    if [[ "$connection" != 'lo' ]]; then    # loデバイスは無効にできないので除外
      echo "disable \"${connection}\"" 
      cmd="sudo nmcli connection modify \"${connection}\" ipv6.method \"disabled\""
      # 有効にする場合はこちら
      # cmd="sudo nmcli connection modify \"${connection}\" ipv6.method \"auto\""
      echo $cmd
      eval $cmd
    fi
done

Splash screenの再有効化

セットアップ時にブートログが表示されるようにしたけど、
やっぱり表示したくなくなった(Splash screenを表示)、てなときは以下で。

sudo raspi-config
    1 System Options
        S6 Splash Screen
            Would you like to show the splash screen at boot?
            と聞かれるので有効化するときは <Yes> を選択
            Splash screen at boot is enabled)
            と表示されるので <Ok>

    Would you like to reboot now?
    と聞かれるので、その場でリブートしてよければ<Yes>

[!NOTE] 直接/boot/cmdline.txt に quiet splash plymouth.ignore-serial-consoles を追加しても良い。
LITE版では quietのみ追加。