xcluster
ホームラボ向けオーケストレーション基盤。クラスター、SSH ターミナル、Docker、監視を一つのダッシュボードで管理。Kubernetes 対応を開発中。
課題
ホームラボを運用するということは、マシンごとに SSH で入り、コマンドを実行し、メトリクスを確認し、サービスを再起動することを、ノードの数だけ繰り返すことです。5 台ならターミナルは 5 つ。10 台ならカオスです。
Rancher や Portainer のようなエンタープライズ向けツールはホームラボには重すぎます。Ansible はプロビジョニングしか扱わず、リアルタイムのダッシュボードがありません。
解決策
xcluster は ホームラボのためのコントロールプレーン です。すべてのマシン、クラスター、コンテナ、ターミナルを一つのダッシュボードで管理します。ワンクリックでマシンを起動し、ブラウザから直接 SSH し、メトリクスをリアルタイムで見られます。ターミナルを一つも開く必要はありません。
非公開プロジェクトです。Kubernetes クラスター管理 への拡張を開発中。興味があればご連絡ください。
主な機能
- マシン管理: マシンの登録、SSH による自動検出、複数の認証方式(パスワード、PEM、SSH キー)、暗号化された認証情報の保存(AES-256-GCM)
- Wake-on-LAN: マジックパケットでマシンをリモート起動。クラスター全体の一括起動
- クラスターのオーケストレーション: マシンをクラスターにまとめ、master/worker の役割を割り当て、賢い順序で一括操作(再起動時は worker が先、master が最後)
- Web SSH ターミナル: WebSocket 経由でブラウザから直接使える対話型シェル。完全な PTY 対応で、vim、htop、tmux もいつも通り動きます
- Docker 管理: コンテナ、イメージ、ボリューム、ネットワーク、オブジェクトの詳細表示、ライフサイクル操作、定期タスク
- リアルタイム監視: バックグラウンドのワーカーが 30 分ごとに CPU、RAM、ディスク、温度、稼働時間を収集し、Pusher WebSocket でライブ更新
- SSH の自動プロビジョニング: SSH キーを生成・交換し、パスワードなしのアクセスを設定
- 型安全な API クライアント: OpenAPI 仕様から自動生成される TypeScript SDK。CI/CD で自動同期
アーキテクチャと技術
Backend (Go): Gin フレームワーク · ドメイン駆動設計 · DI コンテナ · GORM + PostgreSQL · Gorilla WebSocket(SSH プロキシ) · AES-256-GCM 暗号化 · Zerolog の構造化ログ · Swagger/OpenAPI 3.0 の自動生成 · Cron スケジューラ · マルチステージの Alpine Docker ビルド
Frontend (React): Vite 6 · React 19 · TypeScript · Tailwind CSS v4 · xterm.js 対話型ターミナルエミュレータ · Monaco Editor(YAML/JSON の設定編集) · Pusher リアルタイムイベント · React Router · Lucide アイコン
Shared SDK (TypeScript): OpenAPI 仕様から自動生成 · openapi-fetch クライアント · 型安全な API 呼び出し · Bun でビルド
CI/CD pipeline: Backend の push → Swagger 生成 → 型を SDK ライブラリに push → Frontend の再ビルド → Docker イメージ → コンテナレジストリ。完全自動、手作業はゼロ。
Roadmap: Kubernetes クラスターのプロビジョニング、Pod 管理、Helm チャートのデプロイ、ログのストリーミング、Grafana 並みのメトリクスダッシュボード。
非公開プロジェクトです。詳しくはご連絡ください。