毎月恒例のタイムセール祭りは4/24〜26迄

Raspberry Pi のWi-Fi設定(初期設定)

wifi-setting公式Raspberry Pi OS

Raspberry Pi にOS(旧Raspbian)をインストールした後、Wi-Fiに繋げるセットアップ方法をご紹介します。

Wi-Fiの設定方法は、GUIとCUIと分けています。
モニター、キーボード、マウスなど用意できればGUIの方が初心者でも難しくありません。

現在のRaspberry Pi OSは、従来のWindowsやMacと同様に、簡単な操作で設定できます。Wi-Fiの環境によっては設定ファイルを直接書き換える必要があります。

追記:ifdown、ifupコマンドの箇所を修正しました。
追記:RaspbianからRaspberry Pi OSに名前が変更になり修正しました。

(※大変人気の記事です。ありがとうございます。情報は随時、加筆・修正しております。)

スポンサーリンク

今回の環境

環境は当時の「RASPBIAN JESSIE」です。最新のRaspberry Pi OSでもほぼ同じです。

2020年6月からはOSの表記がRaspbian→「Raspberry Pi OS」に統一されました。実は名称だけの問題で中身が変わった訳ではありません。※2020年はコードネームBusterです。

改名DEATH!

  • Raspberry Pi OS(画像はRASPBIAN JESSIE WITH DESKTOP)
  • PCモニターに繋ぎ、キーボード、マウスも用意
  • 操作するマシンが必要(今回はmacOS)

Raspberry Pi Zero W/WHと3B/3B+、4BならばWi-Fiが装備されていますので同じ手順です。今回はHDMI接続でモニターに接続し、キーボード、マウスも用意したフルセットで行いました。

Wi-Fiの設定(GUI編)

追記:2020年にコードネームBusterでセットアップウィザードがかなり親切になりました。最初のセットアップ時、順番に答えて行けばWi-Fiの接続もそれほど難しくなくなりました。
Raspberry Pi 4 スタートガイド【2021】セットアップと初期設定

Wi-Fiに接続できていないRaspberry Pi OSのタスクバーには、線が2本赤いバツ印2個が表示されていると思います。ここで主に説明しているのは、この状態のからWi-Fiを設定する方法です。

wifi disable
図:Wi-Fiが未接続状態

このアイコンの時、アイコンを左クリックでWi-Fiのアクセスポイントが表示された場合は、使用したい任意のアクセスポイントを選んでください。

Wi-Fiのパスフレーズを入力する小さなウィンドウが出ますのでそこに入力すれば設定は可能です。

アクセスポイントの名前が見える?見えない?(IPアドレスの固定)

アイコンをクリックした時、アクセルポイント名が検出されズラズラと表示されるなら選ぶことになります。

アクセスポイントが見えない場合は、別設定が必要です。※見えている人は飛ばしてください。

下図の左から2個目のアイコンを右クリックして、Wireless&Wired Network Settingをクリックし設定画面を出します。

Wi-Fi設定
図:右クリックメニュー
Wi-Fi IPアドレス
図:IPアドレスの入力

ConfigureのプルダウンメニューからWi-FiなのでSSIDを選びます。

本来、その右側のプルダウンメニューにWi-FiのAP(アクセスポイント)を選びます。

※仮に何も選べない場合は、検出できていません。一度再起動しても同じ状態であれば、別途、設定ファイルに明示的にAPを記入しないとなりません。(※後程のCUIの設定を参考にしてください)

IPアドレスの設定方法

固定IPアドレスで設定した方が初心者は無難かも知れません。

(SSIDの名称が長いと画面の大きさが変わってしまいます。ウィンドウサイズは無視してください)

IPアドレスの入力
図:IPアドレスの入力

Automatically Configure empty Optionのチェックを外します。手動にするという意味です。

下の項目を埋めます。(例:ルーターが192.168.0.1の場合)

IPアドレス:192.168.0.51 <−− 任意のアドレス
Router:192.168.0.1 <−− ルーターのアドレス
DNS Server:192.168.0.1 <−− ルーターのアドレス
DNS Search:(空欄で構いません)

ここでの設定はIPアドレスを固定することになります。本来はルーターのDHCPサーバ機能から自動的に受信し、IPアドレスを決定させるのですが、最初に何もアクセスポイント名が出てこなかったため、明示的に繋げるルーターの設定しています。

任意のアドレスと記載したIPアドレスには、ルーターと同じセグメントである「192.168.X.XXX」で統一します。XやXXXの部分はご自宅の環境により異なります。

例えば、192.168.0.〜であればそこまで同じにします。
その後、最後の3桁部分は既存の数字と被らない数字を適当に選びます。通常であれば、2〜254の範囲です。何台かWi-Fiの機器を使用していると、若い番号から自動で振られます。ご自宅すべての機器が関係あるので、仮に10台程度はあるとして、20番台〜選んだ方が無難でしょう。

※ケースバイケースです。自宅のルーターの説明書を確認してください。

画像の場合は51番にしています。分かりやすいように200番とか、100番とか、2桁なら99番とか振ってあげると分かりやすいですね。

個人的に好んで使うのは、51、49、99、39、などです。
理由は他の器機とあまり被らず覚えやすいから。

既に割り振っている番号は避けないとなりません。分からない場合は大きめの数字(例えば20以上)を割り振るとバッティングする確率は減るでしょう。

後でDHCPから自動的にIPアドレスを振る状態に戻すことも可能です。

ただ、RaspberryPiではSSHなど固定のIPアドレスで接続したいことも多いのでこの設定をおすすめしています。

※もしもDHCPから自動で番号を振ってSSHしたい時は、別途、ホスト名を設定すれば、それでも接続可能です。(例:http://ホスト名.local/

これも正確には「名前解決できる」という前提になりますが、一般的なパソコンのWindows10やmacOSであれば問題なく名前解決できます。

Raspberry Pi の場合は、sudo raspi-configまたはメインメニューのRaspberry Pi の設定から行えます。

IPアドレスを入力したら適用します。適用 ーー> 閉じる

最後にパスフレーズの入力が促されます。これで接続完了です。

パスフレーズの入力
図:パスフレーズの入力
Wi-Fi接続完了
図:Wi-Fi接続完了

繋がらないと思ったら?

こちらも念のため一度チェックしてください。

Wi-Fiの設定(CUI編)

Wi-Fiの設定で必要なファイルは主に2つあります。

wpa_supplicant.confとdhcpcd.confの2つです。それぞれ/etc以下にあります。

/etc/wpa_supplicant/wpa_supplicant.conf
/etc/dhcpcd.conf

自動的にIPアドレスを割り振る場合は1ファイルもしくは2ファイルで設定は完了します。環境によることもあるので、順番にお試しください。

RaspbianのバージョンStretch以降では、interfacesは使用しないことになりました。

もう一度書きます。
/etc/network/interfacesは使用しないことになりました。

他のサイトでも古い情報がまだ公開されています。

固定IPにしたい場合、/etc/dhcpcd.confの設定は随分と長いです。間違えずに入力設定しましょう。

Wi-Fi情報の設定はwpa_supplicant.conf

Terminalからwpa_supplicant.confを編集しますが、一度中身を見てみましょう。

catコマンドはターミナル内にファイルの中身をターミナル内に表示してくれます。

sudo cat /etc/wpa_supplicate/wpa_supplicant.conf
network情報の追記
図:追加されたnetwork情報

Wi-FiのパスワードとなるPSK=の部分は予め暗号化すると良いでしょう。セキュリティの観点からも暗号化した方が良いと思います。

もちろん平文のパスワードは、そのままabc...なら"abc..."でOKです。

※平文のままの場合はダブルクォーテーション("")で囲みます。暗号化のパスフレーズは囲わないままでOKです。扱う場所でダブルクォーテーションの役割も多少異なりますが、当時このwpa_supplicantではダブルクォーテーションなしでは平文のパスワードがエラーでした。

Wi-Fiのパスワード暗号化について
暗号化は同じRaspbianの環境で作成出来ます。Linux以外の環境では難しいので、分からない人は平文のパスワード(パスワードそのままの記載)で設定してください。
セキュリティ云々はありますが、そこまで神経質にならなくても個人利用なら問題ありませんよ。

追記方法

wpa_supplicant.confの中身

sudo nano /etc/wpa_supplicate/wpa_supplicant.conf

nanoで開いて以下を記述する。

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=JP

network={
ssid="ssid" #接続する予定のWi-FiのSSID””で括る
psk="password" #パスワード
key_mgmt=WPA-PSK
}

key_mgmt=WPA-PSKの部分は、暗号方式により異なります。使用しているWi-Fiルーターの暗号方式に合わせます。

ここでのWPA-PSKは「WPA/WPA2-PSK(AES)」という暗号化モードです。

すべてではありませんが、家庭用のWi-Fiルーターではよくある形式です。

※豆知識。
" "(ダブルコーテーション)で囲うのは、空白文字がある場合です。英数字続きなら" "は必要ありません。逆に空白がないのに付けていても問題はありません。

コピペ用(平文パスワードの場合)

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=JP

network={
ssid="ssid"
psk="password"
key_mgmt=WPA-PSK
}

この辺は、環境によって書き方がたくさんあります。

私が試行錯誤した結果、最低限にWi-Fiを認識させるのは、この7行で問題ありませんでした!
key_mgmt=は環境に合わせてください。

これでも繋がらない場合は、この設定ファイルの記述ミスも疑ってください。ケアレスミスは良くあります。

※例外として、ルーター側の個別設定の違いもありますので全てではないことはご理解ください。

確認事項
  • コピーしたコードに無駄な空白が入っている?
    (TABとスペースが混在していないか?)
  • ダブルコーテーションが全角だった?
  • スペルミス(特に自宅のSSID)
  • 最後の }の記述漏れ

中の記述はコメントを除き、すべて半角英数字です。ちょっと気にしてみてください。

特に初心者が陥るのは、行の最後に空白スペースが入っていたりすることです。文章などのテキストファイルとは違いまして、このような記述には厳密なルールがあります。

同じ環境なら事前に用意してコピーもできる

Raspberry Pi OS(旧Raspbian)をインストールする度に設定するのも大変・・・。その場合は、こちらの準備で次から簡単になります。

いつも同じWi-Fi内なら、この作成したファイルを、書き込んだmicroSDカード直下へコピーするだけで簡単に開始できます。オススメです!詳しくは上記記事内容で確認してください。

パスフレーズの暗号化

初めての人は無理に暗号化する必要はありません。一応、やり方を載せておきます。

PSK暗号化は同じくTerminalにて以下のコマンド書式です。MacやWindowsでは、そのままできませんので、他のRaspberry Pi環境(Linux)にて用意してください。

wpa_passphrase "XXXX(SSID)" "hogehoge(PASSWORD)"

これはコピー&ペーストして追記しても良いのですが、コマンドから追記することができます。
nanoの使い方が解らない場合は、以下のコマンドで追記することが簡単で確実です。

sudo wpa_passphrase "SSID" "pass" | sudo tee -a /etc/wpa_supplicant/wpa_supplicant.conf

上手く出来ない? 暗号化が解らない?

ただ、どうしても暗号化が難しいという場合は、先ずは平文のまま繋げてみてください。その後から暗号化にトライして書き換えてもOKです。

暗号化については別の記事でも解説してみました。

暗号化が解らない時や上手く出来ない時は平文で大丈夫

先程も記載したように、平文のパスワードであっても、そこまで神経質にならなくても大丈夫です。

業務用であったりWi-Fi接続を他人と共有している場合や、自宅サーバーなどを公開している人は、むしろ暗号化してください。

個人で家庭内の利用なら、あまり恐れなくてOKと私は考えています。

もう一度、ここに wpa_supplicant.conf の記述を載せておきます。

ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=JP

network={
        ssid="ssid"
        psk="password"
        key_mgmt=WPA-PSK
}

記載のSSIDとパスワードは、当たり前ですけど、あなたの自宅の環境によりますので変更してください。

SSDドライブ起動させたRaspberry Pi 4 サクサクと愛用中!

コスパが抜群のSSDドライブは内蔵型でいい
Crucial SSD 480GB BX500 SATA3 内蔵2.5インチ 7mm

Raspberry Pi4はメモリー8GBモデルなら余裕
【国内正規代理店品】Raspberry Pi4 ModelB 8GB 技適対応品

USBブートの構築方法を実践
ラズパイ4をUSB接続のSSDから起動する方法(USBブート)

ネットワークのインターフェイス設定は必要無い

前述したように、基本的にRaspberry Pi OS (旧Raspbian)で、単にWi-Fiへ繋げるだけであれば、コマンドでの設定は必要ありません。初回のセットアップウィザードで設定できる場合がほとんどです。

以前は、どうしても設定ファイルをイジらないとなりませんでした。

【確認】/etc/network/interfaces の中身例

# interfaces(5) file used by ifup(8) and ifdown(8)
# Please note that this file is written to be used with dhcpcd
# For static IP, consult /etc/dhcpcd.conf and 'man dhcpcd.conf'
# Include files from /etc/network/interfaces.d:
source-directory /etc/network/interfaces.d

ここに記載のとおり、dhcpcdを使ってくれとあります。

固定IPの場合はdhcpcd.confに記述するようにとありますので、固定IPでなければdhcpcd.confの設定も必要なくなりました。

Wi-Fiの再起動(コマンド)

Wi-Fiの起動・停止のコマンドは「ifup」と「ifdown」です。よく間違えます。 ifconfigです。

追記:コメント欄でご指摘ありました。ありがとうございます。修正しました。

ネットワークの扱いが変更になってから、ifコマンドも通らなくなりました。
ただ、ifコマンドは存在しています。

現行のRaspberry Pi OSでは、ifconfig を使ったコマンドで同じことが可能です。

—— ifqueryのステータスではloしか出ず、eth0やwlan0がありません。

以下のコマンドでWi-Fiの接続と切断(upとdown)が可能です。

sudo ifconfig wlan0 down
sudo ifconfig wlan0 up

sudoを忘れずに。

sudo を忘れても、直前の操作なら、sudo !!とすることで、再度sudo付きでコマンドが実行されます。

ifdown wlan0 現在は効かない
ifup wlan0 現在は効かない

Wi-Fiは無線LANなので、wlan0を参照します。(有線ケーブル接続ならeth0)
おかしいなと思ったらdown、upしてWi-Fiの再起動をしてみることをオススメします。

※sshで接続しているときは繋がらなくなります。ラズパイにキーボードを繋げてあれば大丈夫です。

dhcpで固定IPの設定(CUI編)

こちらは固定のIPアドレスを振りたい時に利用します。それもCUI、コマンドで行うケースです。

ラズパイを使用する時、いちいちキーボードやマウス、ディスプレイを取り付けるのも面倒です。複数台のラズパイを所持していると更に面倒に感じます。

そのため、ラズパイ自体は電源アダプターのみで稼働させ、設定も操作も自宅内LANで他のマシンからSSHで接続して行うのがとても便利です。

固定IP化してあれば、SSHで接続するIPアドレスを決め打ちできるので便利です。

これが固定ではない場合、電源を落としてからIPアドレスが変更になることがあります。(そのまま変わらないこともあります)

少なくても、ルーターの機器を再起動すると割り振りが変わります。

IPアドレスを調べるのは初心者には敷居が高いと思います。初めの設定は面倒ですけど、初心者こそ固定IP化して運用してみてください。その後が楽ですよ。

先程と同じようにcatコマンドでdhcpcd.conf中身を見てみます。

sudo cat /etc/dhcpcd.conf
dhcp
図:/etc/dhcpcd.conf

どうやって記述するのか? 数行に渡る書式の例をみてみましょう。

最下部デフォルトの例

#It is possible to fall back to a static IP if DHCP fails: # define static profile
#profile static_eth0
#static ip_address=192.168.1.23/24
#static routers=192.168.1.1
#static domain_name_servers=192.168.1.1
#fallback to static profile on eth0
#interface eth0
#fallback static_eth0

では、実際に編集してみましょう。

dhcpcd.confの再下段まで移動して記述してください。(追記します)

sudo nano /etc/dhcpcd.conf

nanoで開きます。

下記例は、IPアドレスを192.168.0.51にしてルーターが192.168.0.1の場合です。それぞれのWi-Fi環境に合わせて変更してください。

結果として以下のように最下部へ追記してください。この例だと#fallback static_eth0の次の行から追記する形です。

例:IPアドレス=192.168.0.51、ルーター=192.168.0.1

interface wlan0
static ip_address=192.168.0.51/24
static routers=192.168.0.1
static domain_name_servers=192.168.0.1

static=固定という意味です。Wi-Fiなのでwlan0としましたが、有線LANならeth0です。

これで一度再起動してください。起動後、有効になっています。

主に設定する2つのファイル

長々と書きましたが、設定するのはたったの2つのファイルだけです。

  1. wpa_supplicant.conf
  2. 固定IPにするなら、dhcpcd.confへ追記

間違えてしまった場合、初めてだと一体どこが違うのか本人でも解らなくなることもあるでしょう。

先ずはマウスとキーボードを使いGUIで設定しましょう。それでも繋がらない場合は、設定の例を参考にCUIで直接設定します。

コードネームBuster、2021年初頭のバージョンでは、Wi-Fiの設定は wpa_supplicant.conf だけで可能です。(※固定IPにする場合はdhcpcd.confも必要)

——例外として、Wi-Fiを出力と入力を同時に使いたい場合などは、従来のように/ete/network/interfacesにも別の記述が必要です。通常では必要ありません。

どうしても上手く行かない場合は、wpa_supplicant.confを上書き保存することで何度でもトライしてみてください。

他の設定も間違えて変えてしまった?

Raspberry Pi は、OSの準備に伴う手間が少なくなったので、新しいmicroSDカードで再トライするのも悪くありません。順番に確認して行えば、作業量は少ないのでスグに理解できると思います。

2020年からは、初回のセットアップウィザードが親切になったため、順番に進めて行けばWi-Fi接続で困ることはあまり無くなりました。

もう一度セットアップウィザードを呼び出す方法もあります。

お疲れ様でした。以上でGUIとCUIの設定が終わります。

ルーターは難しいかも

Raspberry PiのWi-Fiとうよりも、ルーターの設定が難しいと思われるのではないでしょうか?

ここではルーターの設定には触れていません。メーカーによってもデフォルトの情報が異なるためです。勉強した人やエンジニアさんでないと、ネットワークの設定というのは素人には難しい部類だと思っています。

別の記事でも書いていますが、私の経験上、ルーターが2台あるような人が多いのに驚きます。

ルーティングしているルーターが2台あるなら、そういった設定が必要なんです。でも、実際に家庭でルーターは2台も必要ありません。(わざと2台使いたいなら必要ですが)

増設するなら、Wi-Fiを飛ばす中継器やルーティング機能が無いブースターのような器機でしょう。

手軽に購入できるようになったルーターを増設する場合、1台はルーティング機能をオフにするブリッジ接続(APモードとも言う)が分かりやすいと思います。つまり、内蔵のWi-Fiだけ使う。

ルーターのモードスイッチ(ルーターモードとAPモード)

この辺は、上手くまとめられたら別に記事でご紹介していこうと思います。

ルーターの設定を参考にしたい場合が多いと思いますので、それなら超有名な機種をオススメします。必ず同じことを書いているサイトが見つかるハズです。

866+300Mbps IPv6対応 デュアルバンド 3LDK 2階建向け。バッファローの無線LAN製品は日本国内販売台数18年連続第1位を受賞。(無線)11ac/n/a/g/b (有線)Giga。一人暮らしにもおすすめ。シンプル機能のIPv6対応エントリーモデル

個人的には、家庭用ならいつもバッファロー製です。(安いので)

コメント ご感想をお願いします。

  1. アバター通りすがり より:

    最新のRaspberry Pi OSでも同じではないですね。
    ifup, ifdown コマンドは使えませんでした。

    • ご指摘をありがとうございました。気が付きませんでした。
      該当部分は追記しておきました。
      sudo ifconfig wlan0 down
      現行はifconfigに統一されています。

      試してみてください。