mirror of https://github.com/axieyangb/aegis.git synced 2026-09-10 01:35:40 +00:00

Files

T

Yang Yang Xie d28702b5e7 Add Aegis logo to repo and README header

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-19 00:34:08 -07:00

6.3 KiB

Raw Blame History

Aegis

Self-hosted Envoy gateway with AI threat analysis, TLS automation, and a real-time security dashboard.

Aegis sits between the internet and your services. It controls Envoy Proxy via xDS, watches all traffic in real time, blocks malicious IPs automatically, manages TLS certificates, and lets you chat with your gateway through an AI assistant — all in a single Docker container.

Quick start

docker run -d \
  --name aegis \
  -p 8765:8765 \
  -v aegis_data:/data \
  -e ADMIN_PASSWORD=changeme \
  axieyangb/aegis:latest

Open http://localhost:8765 — default login: admin / changeme

With Envoy (recommended)

curl -O https://raw.githubusercontent.com/axieyangb/aegis/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/axieyangb/aegis/main/configs/starter.json
docker compose up -d

Features in Action

Live Traffic Dashboard

Real-time request feed, top-IP leaderboard, world traffic map, and live blocking activity — all in one view.

Owl AI Assistant

Ask your gateway anything in plain English. Owl analyses current traffic, surfaces threats, and recommends exactly what to tighten — no dashboards to dig through.

IP Intelligence

Every IP automatically profiled: geolocation, ASN, VPN/Tor detection, AbuseIPDB reputation score, and full request history. Click any IP to deep-dive, then ask Owl to triage it in context.

Gateway Control Plane

Full Envoy xDS control — live topology view, listeners, filter chains, clusters, and extensions. See exactly which clusters are in use and by how many chains. No YAML editing required.

TLS Certificate Automation

ACME auto-renewal via Let's Encrypt or ZeroSSL, delivered straight to Envoy SDS. Stuck on HTTP-01 prerequisites? Ask Owl to walk you through it step by step.

AI Patrol Sweeps

Scheduled AI sweeps monitor your traffic around the clock. Threats get triaged automatically and pushed to your notification channels — Telegram, Discord, Slack, or webhook.

Mobile: Owl on the Go

Open the dashboard on your phone, ask Owl what happened in the last two hours, and watch it triage the threats, block the bad IPs, and confirm the blocks — all from a single chat.

Features

	Feature	Description
🛡	Envoy xDS Control Plane	Visual editor for listeners, clusters, filter chains — pushed live via gRPC
📊	Real-time Analytics	Live request feed, top IPs, world map, device + status breakdown
🤖	AI Threat Analysis	Background IP classification using Gemini / Claude / GPT / Ollama. Auto-blocks attackers
🦉	Owl AI Assistant	Chat with your gateway — ask about traffic, threats, config, anything
🔒	TLS Automation	ACME (Let's Encrypt, ZeroSSL), HTTP-01 & DNS-01 challenges, auto-renewal via Envoy SDS
🔔	Notifications	Telegram, Discord, Slack webhooks — alert on blocks, anomalies, daily digest
🌍	Geo Analytics	Country-level traffic breakdown, remote or local MaxMind GeoIP
🔑	Auth & SSO	Built-in login + optional OIDC/SSO (Google, Authentik, Keycloak, etc.)
🔍	IP Intelligence	Per-IP profiles with ASN, ISP, VPN/Tor detection, AbuseIPDB reputation
📱	Mobile-ready	Full dashboard + Owl chat from any device — no native app required

Architecture

Internet ──▶ Envoy Proxy ──▶ Your services
                  │
          gRPC xDS (port 18000)
                  │
             ┌────▼─────┐
             │  Aegis   │  port 8765
             │          │
             │ xDS CP   │  controls Envoy live
             │ Analytics│  reads Envoy ALS logs
             │ AI Engine│  classifies IPs
             │ Cert Mgr │  ACME → Envoy SDS
             │ Dashboard│  web UI + REST API
             └──────────┘

Configuration

Environment variables

Variable	Default	Description
`PORT`	`8765`	Dashboard + API port
`XDS_PORT`	`18000`	Envoy gRPC xDS port
`DATA_DIR`	`/data`	Persistent data directory
`ADMIN_USERNAME`	`admin`	Admin username
`ADMIN_PASSWORD`	`aegis`	Admin password — change this
`AUTH_ENABLED`	`true`	Require login
`BLOCK_ENABLED`	`true`	Enable auto IP blocking
`NODE_ID`	`home`	Envoy node ID (must match envoy.yaml)

Data volume

Mount a volume or directory to /data:

/data/
├── aegis.db        ← SQLite (traffic, certs, config, alerts)
└── skills/         ← Optional: override Owl AI knowledge files
    └── site.md     ← Custom context injected into Owl's system prompt

Docs

Multi-arch

linux/amd64 and linux/arm64 — runs on x86 servers, Raspberry Pi, Synology NAS, and Apple Silicon.

# Pin a specific version
docker pull axieyangb/aegis:v1.0.0

# Always latest
docker pull axieyangb/aegis:latest

License

Aegis is distributed as a compiled binary. Source code is proprietary. See LICENSE.

Community tier is free forever. A Pro license unlocks unlimited notification channels, longer log retention, and unlimited AI patrol sweeps.

Support & Enterprise

Issues & feature requests: GitHub Issues
Enterprise licensing, custom integrations, SLA: yyangxie@gmail.com

6.3 KiB Raw Blame History