[coming-soon]

xcluster

ホームラボ向けオーケストレーション基盤。クラスター、SSH ターミナル、Docker、監視を一つのダッシュボードで管理。Kubernetes 対応を開発中。

xcluster

課題

ホームラボを運用するということは、マシンごとに 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 並みのメトリクスダッシュボード。


非公開プロジェクトです。詳しくはご連絡ください。