Add SearchTool documentation

This commit is contained in:
Daniel Krause
2026-05-22 23:25:43 +02:00
parent 6e70de5fe2
commit d4ecff222a
+59
View File
@@ -15,6 +15,7 @@ Netcup-Server erreichbar per SSH-Key:
| Chatwoot | http://185.162.249.159:3001/ | /opt/chatwoot (docker compose) |
| Open WebUI | http://185.162.249.159:3002/ | /opt/openwebui (docker compose) |
| Ollama | localhost:11434 | systemd service, user: ollama |
| SearchTool | https://search.datenhimmel.work | /opt/search-tool (docker compose) |
## OpenCode API-Zugang
@@ -29,6 +30,28 @@ Gepatchte Dateien (in docker-compose.yml als Volume gemountet):
- `/opt/openwebui/middleware.py` — None-Checks vor `metadata['chat_id'].startswith()`
- `/opt/openwebui/socket_main.py``(request_info.get('chat_id') or '').startswith()`
## SearchTool (Eigene Web-Suche)
Selbst gehostete Such-API mit SearXNG (5 Engine: Google, Brave, DDG, Bing, Wikipedia) + Playwright-Fallback für JS-Seiten + Redis-Cache + Tor-Proxy (optional).
- **URL:** https://search.datenhimmel.work
- **API Key:** 375f7a6d3fa09c45a76df8d497ca14c9aafc60ee931fc17fdb7e602d5074589b
- **Pfad:** /opt/search-tool (docker compose)
- **Repo:** git@185.162.249.159:danielkrause/search-tool.git
- **Endpoints:** POST /search (Web-Suche), POST /extract (Content-Extraction), GET /health
- **Hermes-Integration:** Plugin in /home/hermes/hermes-agent/plugins/web/searchtool/ — web.search_backend: searchtool
```bash
# Suche
curl -X POST https://search.datenhimmel.work/search \
-H "Authorization: Bearer 375f7a6d3fa09..." \
-H "Content-Type: application/json" \
-d '{"q": "Suchbegriff", "include_content": true}'
# Steuern
ssh root@185.162.249.159 'cd /opt/search-tool && docker compose up -d'
```
## Docker
Alle Docker-Dienste in /opt/<name>/ mit docker compose steuern:
@@ -76,6 +99,42 @@ ssh hermes@185.162.249.159 '/home/hermes/venv/bin/hermes config edit'
Authentifiziert via SSH-Key (~ollama/.ollama/id_ed25519).
Modelle werden per `ollama pull <name>:cloud` bezogen.
## Hermes Agent (Server)
Läuft als systemd-Service auf dem `hermes` User. Vollständig isoliert, kein sudo.
- **Pfad:** /home/hermes/hermes-agent (git clone)
- **Config:** /home/hermes/.hermes/config.yaml + .env
- **Service:** `systemctl start/stop/restart hermes-gateway`
- **Gateway-Log:** journalctl -u hermes-gateway -f
- **Agent-Log:** /home/hermes/.hermes/logs/agent.log
### Hermes warten
```bash
# Service steuern
ssh root@185.162.249.159 systemctl stop hermes-gateway # Stoppen
ssh root@185.162.249.159 systemctl start hermes-gateway # Starten
ssh root@185.162.249.159 systemctl status hermes-gateway # Status
# Update via pip
ssh root@185.162.249.159 'su - hermes -c "/home/hermes/venv/bin/pip install --upgrade -e /home/hermes/hermes-agent"'
# Config editieren
ssh hermes@185.162.249.159 'nano /home/hermes/.hermes/.env'
ssh hermes@185.162.249.159 '/home/hermes/venv/bin/hermes config edit'
```
### Sicherheitskonzept
- Hermes hat nur einen SSH-Key (dein Laptop-Key)
- Kein sudo-Zugriff (via sudoers blockiert)
- Keine outbound-Ports zu anderen Diensten (systemd hardening)
- PrivateTemp, ProtectSystem=strict, keine Capabilities
- Keine Messaging-Plattformen (Telegram/Discord/Slack deaktiviert)
- API-Key geschützt in .env (chmod 600)
- Ollama Cloud Auth via SSH-Key (~hermes/.ollama/id_ed25519, Kopie von ollama user)
## Server-User
- stephan, steffen (Passwort-Login)