chinux/theProx
0
0
Fork 0
Code Issues 40 Pull requests Projects Releases Packages Wiki Activity Actions
Page: Windows VM Guest Agent
Pages
API Agent Update Mechanik Agents Übersicht Architecture Backend Deployment Public Deployment Development Frontend Home Node Agent RBAC Security Endpoint Audit Security Self Update Signing VM Guest Agent Windows VM Guest Agent
1 Windows VM Guest Agent
Claude edited this page 2026-06-29 21:38:23 +00:00
Table of Contents

Windows-VM-Guest-Agent

Eigenständiges, Windows-natives Rust-Crate (theprox-vm-agent-windows, v1.9.0). Funktional analog zum Linux/FreeBSD-Agent, aber als Windows-Dienst und mit nativen Windows-APIs statt Shell/PowerShell.

Allgemeines Protokoll/Enrollment siehe Agents (Übersicht).

Aufbau

  • src/main.rs — Config-Load, Connect/Enroll zum Node-Agent (:9100), Metrik-/Log-/Scan-Loops, Command-Empfang.
  • src/svc.rs — Integration als Windows-Dienst (Crate windows-service).
  • src/collect.rs — Telemetrie über native Windows-APIs.
  • src/wu.rs — Updates über die Windows Update Agent (WUA) COM-API (IUpdateSession/IUpdateSearcher …) statt PowerShell.
  • src/logs.rs — Log-Tail.
  • Abhängigkeiten Windows-spezifisch via [target.'cfg(windows)'.dependencies] (windows 0.62, Features Com/Ole/Variant/UpdateAgent).

Funktionen

  • Metriken/Scan/Logs: gleiches Frame-Modell wie der Linux-Agent (vm_metrics, vm_scan, Log-Entries) mit vmid.
  • Updates: run_update über die WUA-COM-API — sucht, lädt und installiert Windows-Updates ohne PowerShell-Abhängigkeit.
  • Dienstbetrieb: läuft als Windows-Service, automatischer Neustart über die Dienststeuerung.

Deployment

  • NSIS-Installer: installer/installer.nsi + installer/build-installer.sh → theprox-vm-agent-installer-windows-x86_64.exe. Installiert das Binary und registriert den Dienst.
  • Konfiguration über agent.conf (proxy_ip, proxy_port=9100, token, vmid).
  • Release-Profil wie die anderen Agenten (strip, lto, opt-level=z).

Hinweis (Build)

Das Crate ist Windows-only — ein Build gegen einen Nicht-Windows-Target schlägt erwartungsgemäß fehl. Auf eine saubere #[cfg(windows)]-Gating aller Windows-spezifischen Referenzen (u. a. wu) ist beim Cross-Setup zu achten.