feat: PKGBUILD + Install-/Usage-Doku + AUR-Repo-Setup
Neue Dateien: - PKGBUILD: AUR-Paket mit Hook-Installation - INSTALL.md: Installations-Guide mit eigenem AUR-Repo - USAGE.md: Befehlsreferenz + Troubleshooting Features: - ALPM-Hook Installation via aegisaur install-hook - Eigenes pacman-Remote auf Gitea - Config/Cache Pfad-Dokumentation Repository: https://gitea.die-heimatlosen.eu/arch_agent/aegisaur
This commit is contained in:
Thuumate 👻
+75
@@ -0,0 +1,75 @@
|
||||
# 📦 Installation Guide
|
||||
|
||||
## Schnellstart
|
||||
|
||||
```bash
|
||||
# Als AUR-Paket installieren (empfohlen)
|
||||
makepkg -si PKGBUILD
|
||||
|
||||
# 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
|
||||
```
|
||||
|
||||
### Als pacman-Remote hinzufügen
|
||||
|
||||
Bearbeite `/etc/pacman.conf`:
|
||||
|
||||
```ini
|
||||
[aegisaur]
|
||||
SigLevel = Optional TrustAll
|
||||
Server = https://gitea.die-heimatlosen.eu/arch_agent/$repo/releases/download/latest
|
||||
```
|
||||
|
||||
### Oder manuell
|
||||
|
||||
```bash
|
||||
# PKGBUILD herunterladen
|
||||
curl -O https://gitea.die-heimatlosen.eu/arch_agent/aegisaur/raw/branch/master/PKGBUILD
|
||||
|
||||
# Bauen und installieren
|
||||
makepkg -si
|
||||
```
|
||||
|
||||
## ALPM-Hook (systemweit)
|
||||
|
||||
```bash
|
||||
# Installiert Hook nach /usr/share/libalpm/hooks/
|
||||
sudo aegisaur install-hook
|
||||
|
||||
# Deinstalliert Hook
|
||||
sudo aegisaur remove-hook
|
||||
```
|
||||
|
||||
## Konfiguration
|
||||
|
||||
```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` |
|
||||
| ALPM-Hook | `/usr/share/libalpm/hooks/99-aegisaur.hook` |
|
||||
| Hook-Script | `/usr/share/libalpm/hooks/aegisaur-check.sh` |
|
||||
| Dokumentation | `/usr/share/doc/aegisaur/` |
|
||||
| Config | `~/.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` |
|
||||
@@ -0,0 +1,72 @@
|
||||
# Maintainer: Thuumate <thuumate@ghost.local>
|
||||
# AUR-Repo: https://gitea.die-heimatlosen.eu/arch_agent/aegisaur
|
||||
|
||||
pkgname=aegisaur
|
||||
pkgver=0.1.0
|
||||
pkgrel=1
|
||||
pkgdesc="Trust-Scoring + IOC-Scanner für Arch Linux AUR-Pakete"
|
||||
arch=('x86_64' 'x86_64_v3' 'x86_64_v4' 'aarch64')
|
||||
url="https://gitea.die-heimatlosen.eu/arch_agent/aegisaur"
|
||||
license=('MIT')
|
||||
makedepends=('rust' 'cargo')
|
||||
depends=('pacman' 'libalpm')
|
||||
optdepends=(
|
||||
'sudo: für install-hook und ALPM-Integration'
|
||||
'nodejs: für IOC-Checks mit npm-Paketen'
|
||||
)
|
||||
source=("$pkgname-$pkgver.tar.gz::$url/archive/refs/tags/v$pkgver.tar.gz")
|
||||
sha256sums=('SKIP')
|
||||
|
||||
build() {
|
||||
cd "$srcdir/$pkgname-$pkgver"
|
||||
export RUSTFLAGS="-C target-cpu=${CARCH}"
|
||||
cargo build --release --locked
|
||||
}
|
||||
|
||||
package() {
|
||||
cd "$srcdir/$pkgname-$pkgver"
|
||||
|
||||
# Binary
|
||||
install -Dm755 "target/release/$pkgname" "$pkgdir/usr/bin/$pkgname"
|
||||
|
||||
# ALPM Hook
|
||||
install -Dm644 "src/hook/hook.install" "$pkgdir/usr/share/libalpm/hooks/99-aegisaur.hook"
|
||||
install -Dm755 "src/hook/check.sh" "$pkgdir/usr/share/libalpm/hooks/aegisaur-check.sh"
|
||||
|
||||
# Dokumentation
|
||||
install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
|
||||
install -Dm644 TODO.md "$pkgdir/usr/share/doc/$pkgname/TODO.md"
|
||||
install -Dm644 INSTALL.md "$pkgdir/usr/share/doc/$pkgname/INSTALL.md"
|
||||
install -Dm644 USAGE.md "$pkgdir/usr/share/doc/$pkgname/USAGE.md"
|
||||
|
||||
# Config Beispiel
|
||||
install -Dm644 "config/example.toml" "$pkgdir/usr/share/$pkgname/config.example.toml"
|
||||
|
||||
# Licence
|
||||
install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
|
||||
}
|
||||
|
||||
post_install() {
|
||||
echo "╔══════════════════════════════════════════════════════════════╗"
|
||||
echo "║ AegisAUR wurde installiert! ║"
|
||||
echo "╚══════════════════════════════════════════════════════════════╝"
|
||||
echo ""
|
||||
echo "Nutzer-Spezifisches Setup:"
|
||||
echo " aegisaur config → Erstellt ~/.config/aegisaur/config.toml"
|
||||
echo ""
|
||||
echo "Systemweites Setup (ALPM-Hook):"
|
||||
echo " sudo aegisaur install-hook"
|
||||
echo ""
|
||||
echo "Schnellstart:"
|
||||
echo " aegisaur scan-all → Scannt alle installierten AUR-Pakete"
|
||||
echo " aegisaur check-ioc → Prüft gegen aktuelle IOC-Listen"
|
||||
echo ""
|
||||
echo "Mehr Infos: https://gitea.die-heimatlosen.eu/arch_agent/aegisaur"
|
||||
}
|
||||
|
||||
pre_remove() {
|
||||
echo "AegisAUR Hook wird entfernt..."
|
||||
if command -v aegisaur >/dev/null 2>&1; then
|
||||
aegisaur remove-hook 2>/dev/null || true
|
||||
fi
|
||||
}
|
||||
@@ -0,0 +1,129 @@
|
||||
# 📖 AegisAUR Usage Guide
|
||||
|
||||
## Befehls-Übersicht
|
||||
|
||||
```bash
|
||||
# Einzelnes Paket scannen
|
||||
aegisaur scan <paketname> [--verbose]
|
||||
|
||||
# Alle AUR-Pakete scannen
|
||||
aegisaur scan-all [--verbose]
|
||||
|
||||
# IOC-Check (wie aurvulntest)
|
||||
aegisaur check-ioc [--list atomicarch|all]
|
||||
|
||||
# Whitelist-Verwaltung
|
||||
aegisaur allow <paketname>
|
||||
aegisaur deny <paketname>
|
||||
|
||||
# System-Konfiguration
|
||||
aegisaur config
|
||||
aegisaur cache
|
||||
|
||||
# ALPM-Hook (root nötig)
|
||||
sudo aegisaur install-hook
|
||||
sudo aegisaur remove-hook
|
||||
```
|
||||
|
||||
## Beispiel-Workflows
|
||||
|
||||
### Vor Installation eines AUR-Pakets
|
||||
```bash
|
||||
# 1. Scannen
|
||||
aegisaur scan neues-paket
|
||||
|
||||
# 2. Wenn IOC erkannt → NICHT installieren
|
||||
# 3. Wenn verdächtig → PKGBUILD prüfen
|
||||
# 4. Wenn OK → installieren (mit Hook automatisch)
|
||||
|
||||
yay -S neues-paket # Hook scannt automatisch
|
||||
```
|
||||
|
||||
### Regelmäßige Checks
|
||||
```bash
|
||||
# Alle 48h (via cron/systemd)
|
||||
aegisaur check-ioc
|
||||
```
|
||||
|
||||
### Volle Systemprüfung
|
||||
```bash
|
||||
# Alle AUR-Pakete scannen + IOC-Listen checken
|
||||
aegisaur scan-all && aegisaur check-ioc
|
||||
```
|
||||
|
||||
## Exit Codes
|
||||
|
||||
| Code | Bedeutung |
|
||||
|------|-----------|
|
||||
| 0 | Erfolg |
|
||||
| 1 | Allgemeiner Fehler |
|
||||
| 2 | IOC erkannt / Kritisch |
|
||||
| 3 | Scan-Fehler |
|
||||
|
||||
## Konfiguration
|
||||
|
||||
```toml
|
||||
# ~/.config/aegisaur/config.toml
|
||||
[settings]
|
||||
auto_check_iocs = true
|
||||
auto_check_pkgbuild = true
|
||||
ioc_cache_ttl_minutes = 60
|
||||
warning_threshold = 60
|
||||
critical_threshold = 30
|
||||
block_install_on_critical = false
|
||||
block_install_on_ioc = true
|
||||
notify_desktop = true
|
||||
|
||||
[sources.atomic_arch]
|
||||
name = "Atomic Arch Gist"
|
||||
url = "https://gist.githubusercontent.com/Kidev/85756c3dcad3623ca5604a8135bafd14/raw"
|
||||
enabled = true
|
||||
|
||||
[sources.community]
|
||||
name = "AUR Community Blocklist"
|
||||
url = "https://raw.githubusercontent.com/Kidev/AUR-Blocklist/main/blocklist.txt"
|
||||
enabled = true
|
||||
```
|
||||
|
||||
## Wichtige Pfade
|
||||
|
||||
| Zweck | Lokaler Pfad | Gitea URL |
|
||||
|-------|-------------|-----------|
|
||||
| Quellcode | `/home/arch_agent_system/.openclaw/workspace/aegisaur/` | `https://gitea.die-heimatlosen.eu/arch_agent/aegisaur` |
|
||||
| Binary (Release) | `target/release/aegisaur` | Releases Tab |
|
||||
| PKGBUILD | `./PKGBUILD` | Raw view |
|
||||
| Dokumentation | `./README.md`, `./USAGE.md` | Wiki/Raw |
|
||||
| Issues/Feedback | - | `https://gitea.die-heimatlosen.eu/arch_agent/aegisaur/issues` |
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Hook funktioniert nicht
|
||||
```bash
|
||||
# Rechte prüfen
|
||||
ls -la /usr/share/libalpm/hooks/aegisaur*
|
||||
|
||||
# Manuell ausführen
|
||||
sudo bash /usr/share/libalpm/hooks/aegisaur-check.sh
|
||||
```
|
||||
|
||||
### Cache-Probleme
|
||||
```bash
|
||||
# Cache leeren
|
||||
rm -rf ~/.cache/aegisaur/
|
||||
|
||||
# Neu befüllen
|
||||
aegisaur check-ioc
|
||||
```
|
||||
|
||||
### Netzwerk-Fehler
|
||||
```bash
|
||||
# Proxy-Config prüfen
|
||||
env | grep -i proxy
|
||||
|
||||
# Test-Request
|
||||
curl -I https://gist.githubusercontent.com/Kidev/...
|
||||
```
|
||||
|
||||
---
|
||||
*Built with ❤️ (and some 👻 magic)*
|
||||
*Quasi & Thuumate — 2026*
|
||||
Reference in New Issue
Block a user