137 lines
3.2 KiB
Markdown
137 lines
3.2 KiB
Markdown
# RMM Agent Linux
|
|
|
|
Linux/Proxmox Agent für das RMM-System. Sammelt Systemdaten und ermöglicht Remote-Management über WebSocket.
|
|
|
|
## Features
|
|
|
|
- **System-Monitoring**: CPU, Memory, Disk, Network, Services, Updates
|
|
- **Proxmox-Integration**: VMs, Container, Storage, Cluster, Subscription, ZFS Pools
|
|
- **Remote-Commands**: `exec` (beliebige Befehle), `reboot`
|
|
- **Agent-Updates**: Automatische Binary-Updates über WebSocket
|
|
- **Cross-Platform**: Funktioniert auf normalen Linux-Systemen und Proxmox VE
|
|
|
|
## Unterstützte Systeme
|
|
|
|
- Debian/Ubuntu (mit apt)
|
|
- Proxmox VE
|
|
- Andere Linux-Distributionen mit systemd
|
|
|
|
## Installation
|
|
|
|
1. **Repo auf dem Zielsystem klonen und Binary bauen:**
|
|
```bash
|
|
apt install -y git golang-go
|
|
git clone https://git.cynfo.net/christian/rmm2.git /opt/rmm
|
|
cd /opt/rmm
|
|
make agent-linux VERSION=1.0.0
|
|
```
|
|
|
|
2. **Installationsskript ausführen:**
|
|
```bash
|
|
cd /opt/rmm/agent-linux
|
|
chmod +x install.sh
|
|
./install.sh
|
|
```
|
|
|
|
3. **Konfiguration anpassen:**
|
|
```bash
|
|
nano /etc/rmm/config.yaml
|
|
```
|
|
|
|
4. **Service starten:**
|
|
```bash
|
|
systemctl start rmm-agent-linux
|
|
systemctl status rmm-agent-linux
|
|
journalctl -u rmm-agent-linux -f
|
|
```
|
|
|
|
## Konfiguration
|
|
|
|
```yaml
|
|
backend_url: "https://your-rmm-backend.example.com"
|
|
api_key: "your-api-key-here"
|
|
interval_seconds: 60
|
|
agent_name: "linux-server-01"
|
|
insecure: true # Für Entwicklung, false für Produktion
|
|
```
|
|
|
|
## CLI-Flags
|
|
|
|
```bash
|
|
rmm-agent-linux [flags]
|
|
|
|
Flags:
|
|
-config string
|
|
Path zur Konfigurationsdatei (default "/etc/rmm/config.yaml")
|
|
-insecure
|
|
TLS-Zertifikatpruefung deaktivieren
|
|
-version
|
|
Version anzeigen
|
|
```
|
|
|
|
## Proxmox-Features
|
|
|
|
Wenn auf Proxmox VE installiert, sammelt der Agent zusätzlich:
|
|
|
|
- **VMs/Container**: Status, Ressourcen-Usage, Uptime
|
|
- **Storage**: Verfügbarer Platz, Typen (ZFS, LVM, NFS, etc.)
|
|
- **Cluster**: Node-Status, Quorum
|
|
- **Subscription**: Lizenz-Status
|
|
- **ZFS**: Pool-Health, Scrub-Status, Größen
|
|
|
|
## Systemd Service
|
|
|
|
- Service Name: `rmm-agent-linux`
|
|
- Config: `/etc/rmm/config.yaml`
|
|
- Agent ID: `/etc/rmm/agent_id` (automatisch generiert)
|
|
- Logs: `journalctl -u rmm-agent-linux`
|
|
|
|
## Remote-Commands
|
|
|
|
Über WebSocket unterstützte Commands:
|
|
|
|
- **exec**: Beliebige Shell-Befehle ausführen
|
|
- **reboot**: System-Neustart
|
|
- **agent_update**: Agent-Binary aktualisieren
|
|
|
|
## Entwicklung
|
|
|
|
```bash
|
|
# Dependencies installieren
|
|
cd agent-linux
|
|
go mod tidy
|
|
|
|
# Entwicklung
|
|
go run . -config config.yaml.example
|
|
|
|
# Cross-compile für Linux
|
|
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -o rmm-agent-linux .
|
|
|
|
# Mit Version
|
|
go build -ldflags "-X main.Version=1.0.0" -o rmm-agent-linux .
|
|
```
|
|
|
|
## Unterschiede zum FreeBSD/OPNsense Agent
|
|
|
|
- **OS-Detection**: Linux-spezifische `/proc`-Dateien und `systemd`
|
|
- **Package-Updates**: `apt list --upgradable` statt `pkg`
|
|
- **Services**: `systemctl` statt `service`
|
|
- **Proxmox**: Zusätzliche `pvesh`-Integration für VMs/Container
|
|
- **Keine OPNsense-Features**: Kein WireGuard, DHCP, Certificates, etc.
|
|
|
|
## Troubleshooting
|
|
|
|
```bash
|
|
# Service Status
|
|
systemctl status rmm-agent-linux
|
|
|
|
# Live-Logs
|
|
journalctl -u rmm-agent-linux -f
|
|
|
|
# Config testen
|
|
rmm-agent-linux -config /etc/rmm/config.yaml -version
|
|
|
|
# Manuelle Registrierung testen
|
|
rm /etc/rmm/agent_id
|
|
systemctl restart rmm-agent-linux
|
|
``` |