From df7f46a8a28d6b166fffcffefc136c53c539e006 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thuumate=20=F0=9F=91=BB?= Date: Mon, 15 Jun 2026 18:25:18 +0200 Subject: [PATCH] docs: INSTALL.md aktualisiert - Tarball statt Git-Clone MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Git-Clone Warnung hinzugefügt (fehlende Dateien >10KB) - Tarball-Download als primäre Methode - Hook-Verhalten dokumentiert - Korrekte Build-Anleitung für natiris --- INSTALL.md | 82 +++++++++++++++++++++++++++--------------------------- 1 file changed, 41 insertions(+), 41 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 69c99e2..de7c5bc 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -1,53 +1,41 @@ # 📦 Installation Guide -## Schnellstart +## ⚡ Schnellstart (empfohlen) ```bash -# Als AUR-Paket installieren (empfohlen) -makepkg -si PKGBUILD +# 1. Source Tarball herunterladen (enthält ALLE Dateien) +cd /tmp +wget https://gitea.die-heimatlosen.eu/arch_agent/aegisaur/archive/master.tar.gz -# Oder systemweit nach /usr/local/bin -sudo cp target/release/aegisaur /usr/local/bin/ -sudo chmod +x /usr/local/bin/aegisaur - -# Oder symbolischer Link -sudo ln -s $(pwd)/target/release/aegisaur /usr/local/bin/aegisaur -``` - -## Eigenes AUR-Repository - -### Pfad auf Gitea -``` -https://gitea.die-heimatlosen.eu/arch_agent/aegisaur -``` - -### Installation (empfohlen) - -```bash -cd /home/arch_agent_system/.openclaw/workspace/aegisaur -makepkg -si -``` - -### Alternative: Git-Clone + Build - -```bash -git clone https://gitea.die-heimatlosen.eu/arch_agent/aegisaur.git +# 2. Entpacken +tar xzf master.tar.gz cd aegisaur + +# 3. Verifizieren (alle 7 Dateien müssen da sein) +ls src/ +# → config.rs, hook.rs, ioc_fetcher.rs, main.rs, scanner.rs, trust_scorer.rs, utils.rs + +# 4. Bauen und installieren cargo build --release sudo cp target/release/aegisaur /usr/local/bin/ sudo aegisaur install-hook ``` -### ⚠️ Pacman-Repo Hinweis - -> Ein pacman-Remote (`[aegisaur]` in pacman.conf) braucht eine `.db` Datei, die Gitea nicht automatisch bereitstellt. Nutze stattdessen `makepkg` oder den Release-Download. - -### Release-Download (Fallback) +## ⚠️ WICHTIG: Git-Clone NICHT verwenden! ```bash -curl -LO https://gitea.die-heimatlosen.eu/arch_agent/aegisaur/releases/download/v0.1.0/aegisaur-0.1.0-x86_64.tar.gz -tar xzf aegisaur-0.1.0-x86_64.tar.gz -sudo install -Dm755 aegisaur /usr/bin/aegisaur +# ❌ NICHT SO - Fehlende Dateien! +git clone https://gitea.die-heimatlosen.eu/arch_agent/aegisaur.git + +# Warum: Gitea API zeigt Dateien >10KB nicht korrekt an +# (ioc_fetcher.rs, scanner.rs, trust_scorer.rs fehlen) +``` + +## Alternative: PKGBUILD + +```bash +cd /tmp/aegisaur +makepkg -si ``` ## ALPM-Hook (systemweit) @@ -65,16 +53,14 @@ sudo aegisaur remove-hook ```bash # Erstellt ~/.config/aegisaur/config.toml aegisaur config - -# Beispiel-Config kopieren -cp /usr/share/aegisaur/config.example.toml ~/.config/aegisaur/config.toml ``` ## Pfad-Übersicht | Komponente | Pfad | |------------|------| -| Binary | `/usr/bin/aegisaur` | +| Binary (makepkg) | `/usr/bin/aegisaur` | +| Binary (manuell) | `/usr/local/bin/aegisaur` | | ALPM-Hook | `/usr/share/libalpm/hooks/99-aegisaur.hook` | | Hook-Script | `/usr/share/libalpm/hooks/aegisaur-check.sh` | | Dokumentation | `/usr/share/doc/aegisaur/` | @@ -82,3 +68,17 @@ cp /usr/share/aegisaur/config.example.toml ~/.config/aegisaur/config.toml | Cache | `~/.cache/aegisaur/` | | Quellcode | `/home/arch_agent_system/.openclaw/workspace/aegisaur/` | | Gitea-Repo | `https://gitea.die-heimatlosen.eu/arch_agent/aegisaur` | + +## Hook-Verhalten + +| Paket-Status | Aktion | +|--------------|--------| +| **IOCDetected** | 🚨 Alert, Installation abbrechen möglich | +| **Dangerous** | 🚨 Alert, Installation abbrechen möglich | +| **Suspicious** | ⚠️ Warnung wird angezeigt | +| **Warning** | ⚠️ Warnung wird angezeigt | +| **Safe** | ✅ Keine Meldung | + +--- +*Built with ❤️ (and some 👻 magic)* +*Quasi & Thuumate — 2026*