Impact-Site-Verification: 578d421e-1081-463d-918b-ec5e29c5b9db
<戻る

コンテナベースの多機能ホームサーバー

個人プロジェクト

概要

Raspberry Pi 5(8GB RAM)+NVMe SSD 2TB上にUbuntu Server 24.04 LTS arm64を載せ,Docker Composeに10サービスを定義し,シェルスクリプトとあわせてホームサーバーをInfrastructure as Codeとして構築した.スマートホームハブ,Time Machineバックアップ,Web変更検知,死活監視,Tailscaleによる外出先からの接続を単一筐体に同居させ,設定をGitで管理して再構築できるようにした.

アーキテクチャ

Docker Compose profiles(`phase1`〜`phase4`および`full`)で依存関係順に段階起動する構成にした.検証中は特定フェーズのみを立ち上げ,通常運用では`full`で全サービスを起動する.各フェーズにセットアップスクリプトを1対1で対応させ,フェーズごとに再実行できる.

Bridge / Host の2種ネットワークを用途別に明示的に使い分けた.SMB・mDNS・Bluetoothを使うコンテナ(Samba,Homebridge,Home Assistant)はHostネットワークに配置し,それ以外のHTTP系はBridgeに隔離した.Homepageダッシュボードの`siteMonitor`は,Bridgeサービスはコンテナ名で,HostサービスはDocker bridgeのゲートウェイIPで解決する二層の命名規則を実装し,両方を1か所で監視できるようにした.

Nginx Proxy ManagerのREST API(Bearerトークン)でプロキシホストを操作する手順を,リポジトリのドキュメントに記録した.AvahiのCNAMEパブリッシャー(`/etc/avahi/cname.d/services.conf`)で`<service>.local → ubuntu-pi.local`を動的発行し,家庭内DNSを汚さず全サービスに`.local`ドメインを付与した.

  1. phase1 基盤: Nginx Proxy Manager / Docker Socket Proxy(Homepageを読み取り専用でソケット露出)/ Homepage / MkDocs Material
  2. phase2 ファイル: Samba(Time Machine,`vfs_fruit`を有効化)
  3. phase3 スマートホーム: Homebridge(HomeKit)/ Home Assistant(`privileged` + host net + D-Bus)
  4. phase4 監視: Playwright Chrome(JS描画)/ Changedetection.io / Uptime Kuma
  5. ホスト直接導入: Tailscale(Exit Node・サブネットルート)/ Rclone(cron日次バックアップ)

運用・可観測性

`phase0-prereq.sh`から`phase4-utility.sh`までのスクリプトは,インストールや設定ファイルの作成の前に既存の状態を確認し,再実行しても重複しない.

`verify-all.sh`で12項目(Docker,8サービスのHTTP応答またはコンテナの状態,Samba,Tailscale,Rclone)を確認し,1件でも失敗すれば終了コード1を返す.

Rcloneのcronで毎日Google Driveへバックアップするようにした(`--bwlimit 5M`で帯域を制限).永続データはGit管理外の`~/data/`,設定は`configs/`に分けた.

ハードウェアとOSの導入

OSの導入もstep1〜step7のスクリプトにした.SHA256で検証したUbuntuのイメージをNVMeに書き込み,cloud-initで初期設定し,EEPROMのブート順をNVMe優先にする.

使用技術

Raspberry Pi 5Ubuntu Server 24.04DockerDocker ComposeNginx Proxy ManagerSamba (vfs_fruit)HomebridgeHome AssistantTailscaleRcloneAvahi (mDNS)MkDocs MaterialChangedetection.ioPlaywrightUptime KumaBashIaC