DevBoxNSA Brain

server-infrastruktur

3 min read

Claude Based Knowledge: Server-Infrastruktur

Vollständige technische Dokumentation des DevBox NSA Servers.

Server-Spezifikationen

EigenschaftWert
Hostnamevmd181486
OSUbuntu 24.04 LTS (Kernel 6.8.0-71-generic)
CPU6 Cores
RAM11 GB
IPv4207.180.207.183
IPv62a02:c207:3018:1486::1
Domaindevboxnsa.org
DNSCloudflare
Usernsa (UID 1000)

Subdomains & Routing

Alle Subdomains werden über Nginx als Reverse Proxy terminiert. SSL wird über Let’s Encrypt (Certbot) bereitgestellt.

Subdomain→ UpstreamServiceSSL-Zertifikat
jobs.devboxnsa.org127.0.0.1:3000Job Tracker Frontendjobs.devboxnsa.org-0001
git.devboxnsa.org127.0.0.1:3003Forgejogit.devboxnsa.org
n8n.devboxnsa.org127.0.0.1:5678n8nn8n.devboxnsa.org
rss.devboxnsa.org127.0.0.1:8080Minifluxrss.devboxnsa.org
status.devboxnsa.org127.0.0.1:3001Uptime Kumastatus.devboxnsa.org
intel.devboxnsa.org127.0.0.1:3002Intel Platformintel.devboxnsa.org
vault.devboxnsa.org127.0.0.1:3013Vaultwardenvault.devboxnsa.org
wiki.devboxnsa.org127.0.0.1:6875BookStackwiki.devboxnsa.org
vinyl.devboxnsa.org127.0.0.1:3012Outlinevinyl.devboxnsa.org
auth.devboxnsa.org127.0.0.1:9000Authentikauth.devboxnsa.org
vpn.devboxnsa.org127.0.0.1:8085Headscalevpn.devboxnsa.org
docs.devboxnsa.org127.0.0.1:6875BookStackdocs.devboxnsa.org
kb.devboxnsa.org127.0.0.1:8090MkDocs Materialkb.devboxnsa.org

Docker-Container

Job Tracker Stack (~/projects/job-tracker/docker-compose.yml)

ContainerImagePortNetzwerkFunktion
jobtracker-frontendjob-tracker-frontend3000hostNext.js 16 Frontend
jobtracker-appjob-tracker-tracker3005hostExpress API + Puppeteer
jobtracker-dbpostgres:16-alpine5432bridgePostgreSQL Datenbank
jobtracker-n8nn8nio/n8n:latest5678bridgeWorkflow-Automation

Intel Platform Stack (~/projects/intel-platform/docker-compose.yml)

ContainerImagePortFunktion
intel-platform-frontend-1intel-platform-frontend3002Next.js Frontend
intel-platform-backend-1intel-platform-backend8002FastAPI Backend
intel-platform-postgres-1postgis/postgis:16-3.45433PostGIS Datenbank
intel-platform-redis-1redis:7-alpine—Cache
intel-platform-libretranslate-1libretranslate/libretranslate—Übersetzung

Standalone Services

ContainerImagePortFunktion
forgejocodeberg.org/forgejo/forgejo:93003 + SSH:2222Git Hosting
minifluxminiflux/miniflux:latest8080RSS Reader
miniflux-dbpostgres:15-alpine—Miniflux DB
uptime-kumalouislam/uptime-kuma:13001 (host)Monitoring
vaultwardenvaultwarden/server:latest3013Passwort-Manager
bookstacklinuxserver/bookstack:latest6875Wiki
bookstack-dblinuxserver/mariadb:latest—BookStack DB
outline-appoutlinewiki/outline:latest3012Wiki
outline-dbpostgres:16—Outline DB
outline-miniominio/minio:latest9002S3 Storage
outline-redisredis:7—Outline Cache
silverbulletzefhemel/silverbullet:latest3010PKM
authentik-servergoauthentik/server:latest9000SSO/Auth
authentik-workergoauthentik/server:latest—Background Worker
authentik-dbpostgres:16—Authentik DB
authentik-redisredis:7—Authentik Cache
headscaleheadscale/headscale:latest8085/9090VPN Coordinator
portainerportainer/portainer-ce:latest9443Container Management
mkdocssquidfunk/mkdocs-material8090Diese Dokumentation

Gesamt: ~27 Container

systemd-Services

Neben Docker laufen folgende relevante systemd-Services:

ServiceFunktion
nginxReverse Proxy, SSL Termination
dockerContainer Runtime
sshRemote Access
tailscaledTailscale VPN Agent
fail2banBrute-Force-Schutz
containerdContainer Runtime (low-level)
cronScheduled Tasks
systemd-resolvedDNS
systemd-timesyncdNTP
unattended-upgradesAuto Security Updates

Datenbanken

DatenbankEngineContainerPortGenutzt von
jobtrackerPostgreSQL 16jobtracker-db5432Job Tracker Frontend + Backend
intel-platformPostGIS 16intel-platform-postgres-15433Intel Platform
minifluxPostgreSQL 15miniflux-db—Miniflux
outlinePostgreSQL 16outline-db—Outline Wiki
authentikPostgreSQL 16authentik-db—Authentik SSO
bookstackMariaDBbookstack-db—BookStack Wiki

Verzeichnisstruktur

/home/nsa/
├── projects/
│   ├── job-tracker/          # Mono-Repo (Git: nsa/job-tracker-mono)
│   │   ├── frontend/         # Next.js 16 (Submodule: nsa/job-tracker)
│   │   ├── tracker/          # Express API + Puppeteer
│   │   ├── docker-compose.yml
│   │   └── .env
│   ├── intel-platform/       # OSINT Platform (Git: nsa-lg/intel-platform)
│   │   ├── frontend/         # Next.js
│   │   ├── backend/          # FastAPI
│   │   └── docker-compose.yml
│   ├── dotfiles/             # Shell-Configs
│   │   ├── server/
│   │   └── laptop/
│   ├── uptime-kuma/          # Kuma Data + docker-compose
│   └── MASTER-DESIGN.md      # Design-System (Catppuccin Mocha + Tokyo Night)
├── mkdocs/                   # Diese Dokumentation
│   ├── docs/
│   ├── mkdocs.yml
│   └── docker-compose.yml
├── bin/                      # Eigene Scripts (job.sh, cmd.sh, devbox-session.sh)
└── archive/2026-02-06/       # 11 archivierte Projekte

Git-Repositories (Forgejo)

RepoSichtbarkeitBeschreibung
nsa/job-trackerPrivateFrontend Submodule (Next.js)
nsa/job-tracker-monoPrivateParent Repo (Frontend + Tracker + Docker)
nsa/devbox-docsPrivateInfrastruktur-Dokumentation
nsa-lg/intel-platformPublicOSINT Intelligence Platform

Forgejo API: http://localhost:3003/api/v1 Forgejo SSH: ssh://git@localhost:2222/

Sicherheit

  • SSL: Alle Subdomains über Let’s Encrypt (auto-renew via Certbot)
  • Binding: Alle Services binden auf 127.0.0.1 (außer SSH, Nginx, Portainer)
  • Fail2Ban: Aktiv für SSH
  • VPN: Headscale + Tailscale für sicheren Remote-Zugang
  • Auth: Authentik als zentraler Identity Provider
  • Passwörter: Vaultwarden (Bitwarden-kompatibel)
  • Firewall: Nur Ports 22, 80, 443, 2222, 9443 öffentlich

Claude Kontext

Dieser Abschnitt dient als Prompt-Kontext für Claude in neuen Chat-Sessions.

Schnell-Referenz für Claude

Server: Ubuntu 24.04, 6 Cores, 11 GB RAM
User: nsa, Home: /home/nsa
Domain: devboxnsa.org (Cloudflare DNS)
Docker: ~27 Container, verwaltet über mehrere docker-compose.yml
Nginx: Reverse Proxy für alle Subdomains auf 127.0.0.1:PORT
SSL: Let's Encrypt via Certbot

Wichtige Pfade:
- Job Tracker: ~/projects/job-tracker/ (docker-compose)
- Intel Platform: ~/projects/intel-platform/ (docker-compose)
- Nginx Configs: /etc/nginx/sites-available/*.devboxnsa.org
- SSL Certs: /etc/letsencrypt/live/*.devboxnsa.org/
- Design System: ~/projects/MASTER-DESIGN.md
- Memory Files: ~/.claude/projects/*/memory/

Forgejo API: http://localhost:3003/api/v1
Token: in ~/.claude/projects/*/memory/forgejo.md

Bekannte Fallstricke:
- sudo braucht Passwort (nicht aus Claude Code nutzbar ohne User)
- Forgejo SSH Host-Key ändert sich bei Docker-Restart
- Uptime Kuma braucht network_mode: host
- Miniflux bindet nur auf 127.0.0.1
- Node.js bevorzugt IPv6 → immer 127.0.0.1 statt localhost
- NIEMALS docker volume prune (PostgreSQL-Daten!)

Graph View

Backlinks