Share
Embed
RaspberryPi 5で軽くはじめるk3sとtailscaleを用いたホームサーバー構築 (1)
自鯖缶で発表したRaspberry Pi 5とk3sでホームサーバーを作成する発表です
https://jisaba.sh/sessions/8accc474-7961-437b-b415-e16e668d24a2/
Masaya Nasu
November 15, 2026
Transcript
30 slides
-
WHO AM I? ⾃⼰紹介 普段の役割 ソフトウェアエンジニア(Web アプリケーション開発) アカウント X:@nasum GitHub:@nasum
masaya nasu @nasum 趣味 3D プリンタ、ガンプラ‧模型 2 -
導⼊ | 動機と⽬指したもの なぜクラウド時代に⾃宅サーバーなのか? クラウドの恩恵 ボタンひとつで⼿に⼊る AWS / GCP を使えば、マネージ
ド K8s‧ALB‧VPC がすぐ揃う 抱いた違和感‧衝動 裏側の⼿触り感を確かめ たい 便利な抽象化の裏で「パケット はどう流れ、DNS はどう引かれ アプローチ 机に置ける SBC 1台から Raspberry Pi 5 で、物理世界の サーバー運⽤を体験してみる るのか?」 3 -
導⼊ | 動機と⽬指したもの ⾃宅サーバーで⽬指したい姿 01 02 03 ⽐較的⼿軽に実現できる 実⽤的なアプリを動かす環境 にしたい
セキュリティ周りはちゃんと したい 「動かして終わり」の検証環境で はなく、サブドメイン+HTTPSで ⾃宅ネットワークの隔離と最⼩限 の権限‧ポート制御。外出先から 普段使いできるサービス基盤に もルーターに⽳を開けない ⼤掛かりな設備や何台ものサー バーを並べず、机に置けるサイズ ‧コスト感で軽く始める 4 -
導⼊ | 動機と⽬指したもの ⽬指したい姿の前と課題 課題1 | ⼿軽さの壁 課題2 | 実⽤環境の壁
課題3 | セキュリティの壁 K8sを試したいが、複数台並べるの は敷居が⾼すぎる(電気代‧場 ポート管理がだるい。:30080 や :8080 をブラウザに直打ちしたく 外出先からもアクセスしたいが、 ルーターに⽳(ポート開放)を開 所) ない けたくない 解決の鍵 解決の鍵 解決の鍵 Raspberry Pi 5 × 1台 ローカルDNS & Traefik Cloudflare & Tailscale 今⽇のゴール:この3つの課題を、Raspberry Pi 5 1台から順番に解決する 5 -
取り組み① | 課題1の解決 システム構成全体図 ⾃宅ルーター SBC(1台) Pi 5 の上で動かす軽量Kubernetes UDM
SE Raspberry Pi 5 k3s VLAN隔離 PoE給電 + NVMe SSD DHCP予約で固定IP LANケーブル1本の省スペース 構成 ローカルDNSでサブドメイ ンを名前解決 Traefik L7ルーティング Tailscale Subnet Router UFW で最⼩限のポートだけ許 可 外部から安全に⾃宅VLANへ 各WebサービスのPod 6 -
取り組み① | 課題1の解決 Raspberry Pi 5 内部のソフトウェアスタック レイヤー3 アプリ層 レイヤー2
k3s基盤層 Homepage(ダッシュボード) Traefik L7ルーティング cert-manager 証明書⾃動管理 Ubuntu Server UFW 各種WebサービスPod Tailscale Subnet Router VPNゲートウェイ レイヤー1 ホストOS層 開放ポートは 22 / 80 / 443 / 6443 のみ ルーター側のVLAN隔離 + ホストOSのUFWで多層防御。すべて k3s 上のマニフェストで宣⾔的に管理 9 -
取り組み① | 課題1の解決 なぜ Raspberry Pi 5 × k3s なのか?
オールインワン設計 1台運⽤の⾝軽さ 怠惰 単⼀バイナリ‧省リソースの k3s 1台‧省スペース その辺に転がってたから PoE給電 + NVMe SSD で ACアダプ タ不要。ケーブル1本で部屋に馴染 買ったはいいけど腐らせてた Traefik と ServiceLB が標準搭 載。構築直後から追加インフラな しでサブドメイン運⽤の⼟台が揃 う むミニマム構成 ある意味いちばんの理由か も 8 -
取り組み② | 課題2の解決 ポート直打ち運⽤の限界と⽬指す姿 Before After http://192.168.1.210:30080 http://dash.example.com IPとポート番号を直打ち。サービスが増えるほど、ど のポートがどのアプリか覚えられない
http://a.example.com 単⼀の80番ポートで待ち受け、サブドメインごとにア プリPodへ⾃動振り分け ※example.comは適宜任意のドメイン名に 読み替えてください 10 -
取り組み② | 課題2の解決 ドメインからアプリPodへ届くまでのルーティング ブラウザ ① UDM SE ② Traefik
dash.example.com Local DNS L7 Ingress Controller homepage-service(:3000) どのサブドメインも 192.168.1.210 を応答 ③ ダッシュボード Pod Host ヘッダを⾒て振り分 け a.example.com app-service(:8080) ③ Webアプリ Pod 単⼀の80番ポートのまま、複数のアプリケーションへシームレスにルーティング ※example.comは適宜任意のドメイン名に 読み替えてください 11 -
取り組み② | 課題2の解決 Ingress を書くだけで Traefik がルーティング apiVersion: networking.k8s.io/v1 kind:
Ingress metadata: name: homepage-ingress namespace: default spec: rules: - host: dash.example.com http: paths: - path: / pathType: Prefix backend: service: name: homepage-service port: number: 3000 ① kubectl apply ingress.yaml を適⽤する ② Traefik が⾃動検知 簡単にルールを反映 ③ 振り分け開始 dash.example.com → homepage-service:3000 アプリPod側はポートやドメインを意識せず、素のHTTPアプリのまま ※example.comは適宜任意のドメイン名に 読み替えてください 12 -
取り組み③ | 課題3の解決 セキュリティ周りの2つのテーマ テーマ① テーマ② 通信の暗号化(HTTPS化) 外部からの安全なアクセス(VPN化) ブラウザの「保護されていない通信」警告をなくし、 セキュアにしたい
外出先から⾃宅サービスへ繋ぎたい。でもルーターに⽳ は開けたくない 13 -
取り組み③ | 課題3の解決 | DNS-01チャレンジ ワイルドカード証明書の発⾏ Cloudflare は、ドメインの持ち主証明をするためだけの認証⽤窓⼝として使う 1 2
3 4 cert-manager Cloudflare DNS Let’s Encrypt Secret に格納 Let’s Encrypt へ証明書の発 ⾏をリクエスト APIトークンで _acme-challenge の TXT レ コードを⾃動書込 TXT レコードを検証して持 ち主確認 ワイルドカード証明書 (*.example.com)を発 ⾏。更新も⾃動 認証局が⾃宅サーバーへアクセスしないので、ルーターの⽳あけは不要 ※example.comは適宜任意のドメイン名に 読み替えてください 14 -
取り組み③ | 課題3の解決 | DNS-01チャレンジ Let’s Encrypt と Cloudflare をつなぐ
ClusterIssuer apiVersion: cert-manager.io/v1 kind: ClusterIssuer metadata: name: letsencrypt-prod spec: acme: server: https://acme-v02.api.letsencrypt.org/directory email: [email protected] privateKeySecretRef: name: letsencrypt-prod-account-key solvers: - dns01: cloudflare: apiTokenSecretRef: name: cloudflare-api-token-secret key: api-token acme.server Let’s Encrypt の本番環境に発⾏を依頼 letsencrypt-prod という名前で、クラスタ全体から使える solvers.dns01 持ち主証明は DNS-01 で⾏う Cloudflare API 経由で _acme-challenge の TXT レコードを書き 込む apiTokenSecretRef Cloudflare の APIトークンは Secret で渡 す 権限は example.com に限定した Zone:Read と Zone:DNS:Edit ※example.comは適宜任意のドメイン名に 読み替えてください 15 -
取り組み③ | 課題3の解決 | DNS-01チャレンジ 証明書は Certificate マニフェストで宣⾔する apiVersion: cert-manager.io/v1
kind: Certificate metadata: name: wildcard-example-com namespace: default spec: secretName: wildcard-example-com-tls issuerRef: name: letsencrypt-prod kind: ClusterIssuer dnsNames: - "example.com" - "*.example.com" dnsNames example.com と *.example.com をまとめて発⾏ ワイルドカードなので、サブドメインを⾜しても発⾏し直す必要がない issuerRef ClusterIssuer「letsencrypt-prod」が発⾏を担当 Cloudflare の APIトークン(Zone:Read + Zone:DNS:Edit)を Secret で渡し、 DNS-01 で持ち主証明 secretName 発⾏された証明書の保存先 Traefik が Ingress からこの Secret を参照して TLS終端する ※example.comは適宜任意のドメイン名に 読み替えてください 16 -
取り組み③ | 課題3の解決 | TLS終端 発⾏した証明書でHTTPS接続する 普段のWebアクセスでは Cloudflare は使わず、⾃宅のローカルDNSが応答する ブラウザ
UDM SE(Local DNS) Traefik アプリPod https://dash.example.com を開く dash.example.com → 192.168.1.210 を応答 Secret のワイルドカード証 明書を読み込み、TLS終端 平⽂HTTPのまま。証明書の 設定は不要 HTTPS通信は⼊り⼝の Traefik が⼀⼿に引き受ける ※example.comは適宜任意のドメイン名に 読み替えてください 17 -
取り組み③ | 課題3の解決 | TLS終端 Ingress の tls で証明書を参照する apiVersion:
networking.k8s.io/v1 kind: Ingress metadata: name: homepage-ingress namespace: default spec: tls: - hosts: - "dash.example.com" secretName: wildcard-example-com-tls rules: - host: dash.example.com # 以下のルーティング設定は前出の通り spec.tls 発⾏済みの Secret を指定するだけ cert-manager が⾃動発⾏‧更新した wildcard-example-com--tls を参照 *.example.com サブドメインを⾜しても発⾏待ちゼロ ワイルドカード証明書なので、新しい Ingress でもすぐ HTTPS 化できる Secret 証明書と秘密鍵はクラスタ内に保管 tls.crt と tls.key は OS 上のファイルではなく Secret にあり、更新時も cert-manager が書き換える ※example.comは適宜任意のドメイン名に 読み替えてください 18 -
取り組み③ | 課題3の解決 ルーターに⽳を開けずに外出先からアクセスする ⼀般的な⽅法 採⽤した⽅法 ポートフォワーディング メッシュVPN「Tailscale」 ルーターに⽳を開けることになる 外向き通信のみで、⾃宅VLANへ暗号化トンネルを確
⽴ 攻撃⾯の拡⼤ ポート開放ゼロのまま ⾃宅IPの露出リスク カフェのPCや移動中のスマホから安全に 19 -
取り組み③ | 課題3の解決 Tailscale を「Subnet Router」として⽴てる 通常の Tailscale クライアント Subnet
Router Pi 5 単体と1対1でしか繋がらない ⾃宅VLAN全体への「橋渡し役」 仮想IP(100.64.x.x)のみ。UDM SE や LAN側IP (192.168.1.210)に到達できない TS_ROUTES="192.168.1.0/24" 外出先から Local DNS(192.168.1.1)や Traefik (192.168.1.210)へそのままアクセス k3s の Pod として動かす:ホストOSを汚さず、マニフェスト(tailscale-router.yaml)で⼀元管理&⾃動復旧 21 -
取り組み③ | 課題3の解決 Subnet Router は Deployment マニフェストで管理 # tailscale-router.yaml(spec.template.spec
抜 hostNetwork: true 粋) dnsPolicy: ClusterFirstWithHostNet containers: - name: tailscale image: tailscale/tailscale:latest env: - name: TS_AUTHKEY valueFrom: secretKeyRef: name: tailscale-auth key: TS_AUTHKEY - name: TS_ROUTES value: "192.168.1.0/24" - name: TS_USERSPACE value: "true" TS_ROUTES ⾃宅 VLAN 全体への経路を広告 外出先から UDM SE(192.168.1.1)や Traefik(192.168.1.210)へそのまま届く TS_USERSPACE ユーザー空間モードで動かす コンテナ内で iptables に触れずパケット転送に失敗する罠を回避 hostNetwork / dnsPolicy 戻りパケットの迷⼦を防ぐ ホストのネットワークに直接つなぎつつ、クラスタ内の名前解決も維持 22 -
取り組み③ | 課題3の解決 Split DNS と外出先からの通信フロー Split DNS:example.com の問い合わせ先だけを、⾃宅 UDM
SE(192.168.1.1)へ指定 1 2 3 4 5 DNSクエリ送信 ⾃宅LANへ橋渡し ローカル名前解決 HTTPS&TLS終端 アプリPodへ到達 Split DNS Subnet Router UDM SE Traefik Homepage example.com 宛てと検 知し、VPNトンネル経由 で⾃宅側へ転送 Pi 5 上の Tailscale Pod が受け取り、UDM SE へ 代理送信 192.168.1.210 を応答 し、トンネル経由でスマ ホへ返却 192.168.1.210:443 へア クセス。ワイルドカード 証明書で復号 平⽂HTTPで転送。⾃宅 Wi-Fiと全く同じ画⾯を表 ⽰ ⾃宅Wi-Fiでもモバイル回線でも、全く同じURLでシームレスに使える ※example.comは適宜任意のドメイン名に 読み替えてください 23 -
取り組みの成果 実際に動いているワークロード ⾃宅の Wi-Fi でも外出先でも、同じ URL‧HTTPS で開ける Pi 5 1台で動かしているもの
k3s Traefik cert-manager Tailscale Subnet Router Homepage 24 -
ハマりどころ | THE HARD THINGS 罠① ホストOS × k3s の競合「UFW
vs iptables」 事象 ホストOS側でUFWを有効化した瞬間、k3sのPod間通信が全滅(CreateContainerError) 原因 UFW と k3s(Flannel)による iptables ルールの奪い合い。UFWリロード時に k3s のルールが消える 解決策 内部CIDR(10.42.0.0/16 等)を許可 DEFAULT_FORWARD_POLICY="ACCEPT" UFW操作後は必ず systemctl restart k3s 25 -
ハマりどころ | THE HARD THINGS 罠② コンテナVPN‧DNS 周りのハマり集 Tailscale コンテナ内の
iptables エラー&⾮対称ルーティング UDM SE Local DNS のワイルド カード⾮対応(NXDOMAIN) 原因 Cloudflare APIトークンの権限不 ⾜(Found no Zones) 原因 コンテナ内でカーネルモジュールに触れず パケット転送不可。さらに戻りパケットが 迷⼦に 原因 *.example.com の登録に⾮対応のため、名 前解決に失敗 DNS編集権限だけでゾーンを照会できず、 DNS-01 が pending のまま。ネームサー バーも未切り替えだった 解決 解決 解決 TS_USERSPACE="true"(ユーザー空間モー ド)と hostNetwork: true の指定で開通 サブドメインごとに個別FQDNレコードを 明⽰的に登録 NS を Cloudflare へ変更し、対象ゾーン限 定で Zone:Read + Zone:DNS:Edit を付与 ※example.comは適宜任意のドメイン名に 読み替えてください 26