コンテナベースの多機能ホームサーバー
個人プロジェクト
概要
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`ドメインを付与した.
- phase1 基盤: Nginx Proxy Manager / Docker Socket Proxy(Homepageを読み取り専用でソケット露出)/ Homepage / MkDocs Material
- phase2 ファイル: Samba(Time Machine,`vfs_fruit`を有効化)
- phase3 スマートホーム: Homebridge(HomeKit)/ Home Assistant(`privileged` + host net + D-Bus)
- phase4 監視: Playwright Chrome(JS描画)/ Changedetection.io / Uptime Kuma
- ホスト直接導入: 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優先にする.