sorack — 홈랩 컨트롤 플레인

기능

홈랩의 모든 것을 캔버스 하나에.

셀프 호스팅 인프라가 실제로 동작하는 방식을 그대로 옮긴 기본 요소입니다. 다른 개념으로 바꿔 생각할 필요가 없습니다.

인벤토리 + 토폴로지

그래프를 직접 편집

캔버스에서 바로 노드를 만들고, 이름을 바꾸고, 부모를 옮기고, 타입이 있는 엣지를 그립니다. 배치는 dagre가 자동으로 합니다.

create reparenttyped edge

2축 노드 모델

인프라 × 소프트웨어

모든 노드는 인프라 타입 하나와 0개 이상의 소프트웨어로 이루어집니다. 상세 정보와 모니터링 슬롯은 두 축에서 합쳐집니다.

infra

host

+

software

Proxmox VE

축별 모니터링

축마다 프로브 하나

인프라 도달성 확인과 소프트웨어 API 확인이 나란히 실행됩니다. StatusLine이 주 축을 고르고, 버튼 줄로 다른 축을 볼 수 있습니다.

cpu34%

reachable pve api

내장 어댑터

무엇이든 확인합니다. 어댑터 추가는 파일 하나면 됩니다

tcp, http, k8s(클러스터 내), proxmox(PVE API), system(node_exporter)이 기본으로 들어 있습니다. 새 어댑터는 파일 하나와 등록 호출 한 줄이면 됩니다.

tcphttpk8sproxmoxsystem+ register()

런북

노드에 연결된 마크다운

앱 안의 CodeMirror 분할 편집기, [[node:]] 링크, git 동기화, 파일 첨부를 지원합니다.

## restart [[node:pve-01]]
see [[runbook:backup]]

앱 화면

사이트에 보이는 화면이 곧 앱입니다.

sorack의 실제 화면입니다. 홈랩을 토폴로지 그래프로 보는 화면과 노드의 2축 상세 화면입니다.

sorack / topology

sorack / node/k8s-cluster

빠른 시작

몇 분이면 실행할 수 있습니다.

React, Hono, Postgres로 만든 앱입니다. 로컬에서 실행하거나 쿠버네티스에 직접 호스팅할 수 있습니다. 자세한 안내는 문서에 있습니다.

전체 안내 →

bash — sorack

# Node 22와 PostgreSQL 인스턴스가 필요합니다
$ git clone https://github.com/sdin99/sorack && cd sorack
$ pnpm install

# Postgres 접속 정보를 설정하고 web과 api를 시작합니다
$ export POSTGRES_HOST=localhost POSTGRES_PASSWORD=...
$ pnpm dev
✓ web → http://localhost:5173 · api → :3001

실제로 운영하는 홈랩을 위한 컨트롤 플레인.