docs: agent-bsd README scp durch fetch + Git-Clone ersetzt

This commit is contained in:
cynfo3000 2026-03-06 09:49:53 +01:00
parent b24b91b686
commit 72dadf19b1

View File

@ -9,19 +9,28 @@ Systemdaten via Heartbeat sowie Remote-Commands über WebSocket.
## Installation via OPNsense Plugin
Das Plugin (`os-rmm-agent-*.pkg`) wird über das OPNsense-Paketmanagement installiert:
### 1. Repo klonen und Plugin bauen (auf dem Backend-Server)
```bash
# Auf der OPNsense-Firewall (SSH)
git clone https://git.cynfo.net/christian/rmm2.git /tmp/rmm
cd /tmp/rmm
scp opnsense-plugin/install.sh root@FIREWALL_IP:/tmp/
ssh root@FIREWALL_IP "/bin/sh /tmp/install.sh"
git clone https://git.cynfo.net/christian/rmm2.git /opt/rmm
cd /opt/rmm
make agent # Baut das FreeBSD-Binary
make plugin # Paketiert das OPNsense-Plugin (.pkg)
```
Anschliessend im OPNsense WebGUI unter **Services → RMM Agent** konfigurieren.
### 2. Installationsskript auf der Firewall ausführen
## Konfiguration (WebGUI)
Das Skript lädt Binary und Plugin direkt vom Backend-Server per `fetch` (FreeBSD-nativ):
```bash
# Auf der OPNsense-Firewall (SSH als root)
fetch -o /tmp/install.sh https://BACKEND_IP:8443/api/v1/installers/freebsd/install.sh
/bin/sh /tmp/install.sh
```
### 3. Im WebGUI konfigurieren
**Services → RMM Agent** öffnen und eintragen:
| Feld | Beschreibung |
|------|-------------|
@ -29,19 +38,6 @@ Anschliessend im OPNsense WebGUI unter **Services → RMM Agent** konfigurieren.
| API Key | API-Key aus `backend/config.yaml` |
| Agent Name | Anzeigename im RMM-Frontend |
## Manuell kompilieren & deployen
```bash
# Auf dem Entwicklungsrechner (mit Go 1.24+)
cd /opt/rmm
make agent
# Binary auf Firewall kopieren und installieren
scp build/rmm-agent root@FIREWALL_IP:/tmp/
scp agent-bsd/install.sh root@FIREWALL_IP:/tmp/
ssh root@FIREWALL_IP "/bin/sh /tmp/install.sh"
```
## Konfigurationsdatei
```yaml