
einfach Knoten und Graphen
Sieh deine Infrastruktur. Zero Config.
Richte graph-go auf deinen Stack und erhalte eine live, interaktive Karte jeder Datenbank, Tabelle, jedes Dienstes und jedes Storage-Buckets — mit Echtzeit-Health-Monitoring.
graph-go ist ein CLI-first Infrastructure Mapper. Er entdeckt deine Infrastruktur automatisch, indem er sich mit dem Docker-Daemon verbindet, laufende Container inspiziert und Datenbanken sowie Storage-Dienste sondiert. Die UI wird vom Backend ausgeliefert und spiegelt den echten Backend-Zustand wider — kein manuelles Inventar nötig.
| Fähigkeit | Details |
|---|---|
| Auto-Discovery | Erkennt Infrastruktur aus Docker-Containern und Kubernetes-Clustern — kein manuelles Inventar nötig |
| Kubernetes | Namespaces, Deployments, StatefulSets, DaemonSets, Pods, Services — mit informer-basiertem Echtzeit-Watching |
| Docker | Klassifiziert laufende Container, extrahiert Zugangsdaten, überwacht Docker-Events, respektiert graphgo.*-Labels zum Überschreiben von Typ/DSN/Node-Typ/Name oder zum Ignorieren eines Containers |
| PostgreSQL | Tabellen, Fremdschlüsselbeziehungen, Schema-Topologie |
| MongoDB | Datenbanken und Collections |
| MySQL | Tabellen, Fremdschlüsselbeziehungen |
| Redis | Keyspaces und Schlüsselverteilung |
| Elasticsearch | Indizes, Cluster-Health, Shard-Status |
| S3 / MinIO | Buckets und Top-Level-Präfixe |
| HTTP-Dienste | Health-Endpunkte, Abhängigkeitszuordnung zwischen Diensten |
| Echtzeit-Health | WebSocket-gestützte Live-Status-Updates alle 5 Sekunden |
| Interaktiver Graph | Swimlane-Layout, Namespace-Gruppencontainer, Pan/Zoom, Filter nach Typ/Health, Knotensuche |
graph-go respektiert eine kleine Auswahl von graphgo.*-Container-Labels (setze sie auf jedem Container, den du steuern möchtest):
| Label | Wirkung |
|---|---|
graphgo.ignore=true | Diesen Container vollständig überspringen |
graphgo.type=postgres | Den Adapter-Typ erzwingen (postgres, mongodb, mysql, redis, elasticsearch, s3, http) |
graphgo.dsn=... | Einen Connection-String injizieren (DSN für postgres/mysql, URI für mongodb, andernfalls Rückfall auf dsn) |
graphgo.node-type=gateway | Den visuellen Knotentyp überschreiben (service, gateway, auth, api, queue, cache) |
graphgo.name=... | Den im Graphen angezeigten Knotennamen überschreiben, der in Knoten-IDs / Logs verwendet wird |
Nutze diese, um falsch klassifizierte Container zu retten, graph-go auf eine benutzerdefinierte DSN zu richten oder einen Container aus dem Graphen auszublenden, ohne ihn zu entfernen.
Starte den vorbefüllten Demo-Stack mit der CLI. Dies ist der schnellste Weg, graph-go in einer realistischen Umgebung zu sehen, und der vorgesehene Onboarding-Pfad für Erstnutzer:
git clone https://github.com/guilherme-grimm/graph-go.git
cd graph-go
go run ./cmd/app demo
Öffne http://localhost:8080. Der Befehl läuft angehängt über Docker Compose. Drücke Ctrl+C, um die angehängte Sitzung zu beenden.
Der erste Lauf kann auf einer kalten Maschine mehrere Minuten dauern, da Docker möglicherweise Basis-Images herunterladen und die lokalen Demo-Images erstellen muss. Spätere Läufe sind deutlich schneller.
Der Demo-Stack erwartet, dass diese Host-Ports frei sind: 8080, 5432, 27017, 9000 und 9001.
Wenn du danach ein explizites Teardown benötigst:
docker compose -f docker-compose.demo.yml down
Ein Container, ein Port. Binden Sie den Docker-Socket schreibgeschützt ein, und graph-go erkennt automatisch alles, was auf dem Host läuft:
docker run -d -p 8080:8080 \
-v /var/run/docker.sock:/var/run/docker.sock:ro \
--group-add "$(stat -c %g /var/run/docker.sock)" \
ghcr.io/guilherme-grimm/graph-go:latest
Das Image läuft als Nicht-root-Benutzer, daher gewährt
--group-addihm die Gruppe des Sockets (stat -cist Linux; unter macOS beginnt man mit--group-add 0). Wenn die Docker-Erkennung weiterhin nur auf YAML zurückfällt, gibt das Startprotokoll an, was geändert werden muss (einschließlich des exakten--group-add-Werts, wenn dies die Lösung ist).graph-go liest nur über die Docker-API (list, inspect, events).
:roschränkt API-Aufrufe jedoch nicht ein: Alles, was den Socket erreichen kann, kann den Daemon steuern. Für minimale Rechte sollte man einen schreibgeschützten API-Proxy wietecnativa/docker-socket-proxyvor den Socket setzen und graph-go mitDOCKER_HOST=tcp://<proxy>:2375darauf verweisen (kein Socket-Mount oder--group-adderforderlich).docker-compose.demo.ymlzeigt eine funktionierende Einrichtung.
Öffne http://localhost:8080. Die automatische Erkennung übernimmt Docker-Container und (wenn eine kubeconfig oder ein In-Cluster-Servicekonto auf einen erreichbaren Cluster verweist) Kubernetes-Ressourcen ohne jegliche Konfigurationsdatei.
Für Dienste, die außerhalb von Docker/Kubernetes liegen (Remote-Datenbanken, verwaltete Cloud-Dienste), binde eine Konfigurationsdatei ein — siehe Konfiguration.
Einzelnes eigenständiges Binary — die UI ist eingebettet, aber der Einstiegspunkt ist weiterhin die CLI.
# Linux amd64 (requires the GitHub CLI; browse Releases for other platforms)
gh release download --repo guilherme-grimm/graph-go --pattern 'graph-go_*_linux_amd64.tar.gz' --clobber
tar xzf graph-go_*_linux_amd64.tar.gz
./graph-go serve # or just `./graph-go` - same thing
Öffne http://localhost:8080. Andere Plattformen auf der Releases-Seite.
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.