How fosrl/pangolin works
Pangolin is a unified SASE control plane for private networking, identity-aware proxy access, and AI traffic. Users and administrators manage access through the dashboard and APIs; the server applies identity and policy controls, then supports traffic routing, DNS, certificates, and audit/usage workflows. The README documents the product’s major capabilities; sampled source confirms server startup, API wiring, Traefik certificate/exit-node interactions, and log-streaming provider behavior. Several domain branches are represented at their exact enclosing directories because their implementations were not sampled.
Main entry points: TraefikConfigManager.ts Proxy routing · LogStreamingManager.ts Log streaming · pipeline.ts AI gateway · apiServer.ts Core API
Components 23
Product interfaces
- Dashboard UI
src/app/setup/page.tsx - Server startup
server/index.ts - Core API
server/apiServer.ts - Integration API
server/integrationApiServer.ts
Identity and policy
- Authentication
server/auth - Access policies
server/middlewares - Identity providers
server/private/routers/orgIdp
Network access
- Sites and clients
server/private/routers/remoteExitNode - Resource access
server/private/routers/resource - Proxy routing
server/lib/traefik/TraefikConfigManager.ts - Routing rules
server/lib/traefik/rule.ts - DNS service
server/private/lib/dns/server.ts - Exit nodes
server/private/lib/exitNodes/exitNodes.ts - Certificates
server/private/lib/certificates
AI gateway
- AI gateway
server/routers/aiGateway/pipeline.ts - AI model catalog
server/lib/aiModelCatalog.ts - AI budgets
server/routers/aiBudget
Operations and audit
- Audit records
server/private/routers/auditLogs - Log streaming
server/private/lib/logStreaming/LogStreamingManager.ts - Destination providers
server/private/lib/logStreaming/providers/LogDestinationProvider.ts - HTTP destination
server/private/lib/logStreaming/providers/HttpLogDestination.ts - S3 destination
server/private/lib/logStreaming/providers/S3LogDestination.ts
Other components
- Admin and users
Connections 25
- Admin and users → Dashboard UI: manages access
README.md - Dashboard UI → Core API: uses APIs
- Server startup → Core API: starts
server/index.ts - Server startup → Integration API: starts optionally
server/index.ts - Admin and users → Integration API: integrates
README.md - Core API → Authentication: protects requests
- Authentication → Access policies: authorizes access
- Identity providers → Authentication: supplies identity
- Admin and users → Sites and clients: configures networks
README.md - Admin and users → Resource access: grants access
README.md - Resource access → Proxy routing: publishes resources
README.md - Proxy routing → Routing rules: uses rules
server/lib/traefik/TraefikConfigManager.ts - Proxy routing → Certificates: fetches certificates
server/lib/traefik/TraefikConfigManager.ts - Proxy routing → Exit nodes: updates exit node
server/lib/traefik/TraefikConfigManager.ts - Sites and clients → DNS service: resolves resources
- Admin and users → AI gateway: configures gateway
README.md - AI gateway → AI model catalog: uses model catalog
- AI gateway → AI budgets: enforces budgets
- Admin and users → Audit records: reviews activity
README.md - Audit records → Log streaming: streams events
- Log streaming → Destination providers: creates providers
server/private/lib/logStreaming/LogStreamingManager.ts - Log streaming → HTTP destination: dispatches batches
server/private/lib/logStreaming/LogStreamingManager.ts - Log streaming → S3 destination: dispatches batches
server/private/lib/logStreaming/LogStreamingManager.ts - HTTP destination → Destination providers: implements interface
server/private/lib/logStreaming/providers/HttpLogDestination.ts - S3 destination → Destination providers: implements interface
server/private/lib/logStreaming/providers/S3LogDestination.ts