[coming-soon]

xcluster

Homelab orchestration platform — quản lý cluster, SSH terminal, Docker, monitoring từ một dashboard duy nhất. Đang phát triển cho Kubernetes.

xcluster

Vấn đề

Quản lý homelab nghĩa là SSH vào từng máy, chạy command, check metrics, restart services — lặp đi lặp lại cho mỗi node. 5 máy thì mở 5 terminal. 10 máy thì chaos.

Các giải pháp enterprise như Rancher hay Portainer thì quá nặng cho homelab. Ansible thì chỉ giải quyết provisioning, không có real-time dashboard.

Giải pháp

xcluster là control plane cho homelab — một dashboard duy nhất để quản lý tất cả máy, cluster, container, và terminal. Wake máy bằng 1 click, SSH trực tiếp từ browser, monitor metrics real-time — không cần mở terminal nào.

Private project. Đang phát triển mở rộng cho Kubernetes cluster management. Liên hệ nếu quan tâm.

Tính năng chính

  • Machine management — đăng ký máy, auto-discovery qua SSH, multi-auth (password, PEM, SSH keys), encrypted credential storage (AES-256-GCM)
  • Wake-on-LAN — gửi magic packet đánh thức máy từ xa, bulk wake cho toàn cluster
  • Cluster orchestration — nhóm máy thành cluster, phân vai master/worker, bulk operations với smart ordering (workers first, master last khi reboot)
  • Web SSH terminal — interactive shell trực tiếp từ browser qua WebSocket, full PTY support — chạy vim, htop, tmux bình thường
  • Docker management — quản lý containers, images, volumes, networks, inspect objects, lifecycle operations, scheduled tasks
  • Real-time monitoring — background worker thu thập CPU, RAM, Disk, Temperature, Uptime mỗi 30 phút, live updates qua Pusher WebSocket
  • Auto SSH provisioning — tự generate SSH keys, exchange keys, setup passwordless access
  • Type-safe API client — auto-generated TypeScript SDK từ OpenAPI spec, CI/CD tự sync

Kiến trúc & Công nghệ

Backend (Go): Gin framework · Domain-Driven Design · Dependency Injection container · GORM + PostgreSQL · Gorilla WebSocket (SSH proxy) · AES-256-GCM encryption · Zerolog structured logging · Swagger/OpenAPI 3.0 auto-generation · Cron scheduler · Multi-stage Alpine Docker build

Frontend (React): Vite 6 · React 19 · TypeScript · Tailwind CSS v4 · xterm.js interactive terminal emulator · Monaco Editor (YAML/JSON config editing) · Pusher real-time events · React Router · Lucide icons

Shared SDK (TypeScript): Auto-generated từ OpenAPI spec · openapi-fetch client · Type-safe API calls · Bun build tooling

CI/CD pipeline: Backend push → Generate Swagger → Push types to SDK lib → Trigger frontend rebuild → Docker image → Container registry. Fully automated, zero manual steps.

Roadmap: Kubernetes cluster provisioning, pod management, Helm chart deployment, log streaming, Grafana-level metrics dashboard.

Private project — liên hệ để biết thêm chi tiết.