メインコンテンツまでスキップ

FreeBSD から始める

リリースアーカイブの導入から rc.d、rc.conf.d、pf、dnsmasq、mpd5 の生成と適用検証へ進む FreeBSD 入門の流れ

FreeBSD は、Ubuntu と同じ routerd リソースモデルを使います。 ただし、生成されるホスト成果物は FreeBSD の機構に合わせたものになります。 routerd は rc.conf.d、rc.d スクリプト、pf.conf、dhclient.conf、dnsmasq 設定、mpd5.conf、DS-Lite 用の動的な ifconfig gif 操作を扱います。

このチュートリアルは、FreeBSD 14 系を前提とします。 リリースインストーラーの配置先は /usr/local 配下です。 参照設定として examples/freebsd-edge.yaml を使います。

1. リリースアーカイブから導入する​

GitHub Releases から FreeBSD 用の アーカイブを取得し、ルーター上で同梱のインストーラーを実行します。

fetch https://github.com/imksoo/routerd/releases/latest/download/routerd-freebsd-amd64.tar.gz
fetch https://github.com/imksoo/routerd/releases/latest/download/routerd-freebsd-amd64.tar.gz.sha256
cat routerd-freebsd-amd64.tar.gz.sha256
sha256 routerd-freebsd-amd64.tar.gz
tar -xzf routerd-freebsd-amd64.tar.gz
sudo ./install.sh

install.sh は、通常必要になる FreeBSD パッケージを導入します。 対象は ca_root_nss、curl、dnsmasq、wireguard-tools、mpd5、bind-tools、tcpdump、jq、chrony、strongswan です。 Tailscale もあわせて入れる場合は sudo ./install.sh --with-tailscale を使います。 FreeBSD の基本システムには ifconfig、route、sysctl、service、sysrc、pfctl、pflog0、netstat、sockstat、ping、traceroute が含まれています。 依存パッケージの一覧は ./install.sh --list-deps で確認できます。

2. ルーター設定を配置する​

sudo install -d -m 0755 /usr/local/etc/routerd
sudo install -m 0600 examples/freebsd-edge.yaml /usr/local/etc/routerd/router.yaml

適用する前に、インターフェース名、アドレス、秘密値を編集してください。 初回は管理用の SSH を別のインターフェースに置くか、ハイパーバイザーのコンソールを用意しておいてください。

3. 検証し、生成ファイルを確認する​

まず設定を検証します。

routerctl validate -f /usr/local/etc/routerd/router.yaml --replace

次に、FreeBSD 用の成果物を一時ディレクトリへ生成します。

rm -rf /tmp/routerd-freebsd-render
routerd render freebsd \
  --config /usr/local/etc/routerd/router.yaml \
  --out-dir /tmp/routerd-freebsd-render

主な出力は次のとおりです。

  • rc.conf.d-routerd
  • dhclient.conf
  • mpd5.conf
  • pf.conf
  • dnsmasq.conf
  • install-packages.sh
  • rc.d-*

実ホストへ反映する前に、内容を確認します。

less /tmp/routerd-freebsd-render/rc.conf.d-routerd
less /tmp/routerd-freebsd-render/pf.conf
less /tmp/routerd-freebsd-render/dnsmasq.conf

4. FreeBSD 側の役割を理解する​

routerd は、リソースを次の FreeBSD の機構へ対応付けます。

機構役割
rc.conf.d-routerdインターフェース別名、転送、複製インターフェース、静的経路、pf、pflog、mpd5 の有効化
rc.d-* スクリプトdnsmasq、firewall logger、healthcheck、Tailscale、DHCP クライアントなどの管理対象デーモン
pf.confゾーンフィルター、管理対象サービス用の許可、NAT、ファイアウォールログ
pflog0routerd-firewall-logger が読むファイアウォールログ
dnsmasq.confDHCPv4、DHCPv6、DHCP 中継、RA
dhclient.conf引き継いだ上流インターフェースの DHCPv4 クライアント動作
mpd5.confPPPoE の bundle、link、認証、MTU/MRU、既定経路
ifconfig gif静的な rc.conf だけでは足りない DS-Lite トンネルの動的な適用

5. 適用する​

先に計画を確認します。

routerctl plan -f /usr/local/etc/routerd/router.yaml --replace

生成ファイルと計画が想定どおりなら、適用します。

sudo routerctl apply -f /usr/local/etc/routerd/router.yaml --replace

routerd は、pf.conf を読み込む前に pfctl -nf で検証します。 dnsmasq も、再起動の前に dnsmasq --test で検証します。

6. 状態とログを確認する​

routerd の状態を確認します。

routerctl status
routerctl events --limit 20

システムログを追います。

tail -f /var/log/routerd.log

pf の状態を確認します。

sudo pfctl -ss -v

pflog0 でファイアウォールログを確認します。

sudo tcpdump -n -e -ttt -i pflog0

FirewallEventLog を有効にすると、routerd は pflog0 の内容を取り込みます。 取り込んだログは routerctl と Web 管理画面から確認できます。

関連項目​