How hariantoatwork/dns01-proxy works
dns01-proxy is an all-in-one DNS-01 certificate stack: its operator UI configures domains and accounts, then certificate jobs perform ACME issuance and write PEMs for consumers. Its runtime also serves authoritative DNS, manages settings and backups, and provides an edge reverse proxy; Tiny shared mode and the lab issuer are additional capabilities. The README documents the principal service boundaries; sampled source confirms selected DNS, authentication, storage, and job-planning details. Other feature links are dashed where implementation was not sampled.
Main entry points: index.vue Operator UI · executor.ts Certificate job queue · apply.post.ts Certificate API · acmeIssueSteps.ts ACME issue steps
Components 24
Operator control plane
- Operator UI
src/dns01-proxy/plugins/client/runtime/pages/index.vue - UI authentication
src/dns01-proxy/plugins/client/runtime/server/utils/adminAuth.ts - Settings service
src/dns01-proxy/plugins/client/runtime/server/utils/settingsService.ts - Backup management
src/dns01-proxy/plugins/client/runtime/server/utils/backup.ts - Client storage
src/dns01-proxy/plugins/client/runtime/server/utils/storage.ts
Certificate lifecycle
- Domain planning
src/dns01-proxy/plugins/client/runtime/shared/utils/domains.ts - Certificate API
src/dns01-proxy/plugins/client/runtime/server/api/certs/apply.post.ts - Certificate job queue
src/dns01-proxy/plugins/client/runtime/server/utils/certJobQueue/executor.ts - ACME issue steps
src/dns01-proxy/plugins/client/runtime/shared/utils/acmeIssueSteps.ts - Certificate files
src/dns01-proxy/plugins/client/runtime/server/utils/letsencryptFs.ts - Renew scheduler
src/dns01-proxy/plugins/client/runtime/server/utils/certRenewScheduler.ts
DNS identity service
- Authoritative DNS
src/dns01-proxy/server/dns/server.ts - ACME DNS accounts
src/dns01-proxy/server/utils/auth.ts - Account and TXT store
src/dns01-proxy/server/utils/db.ts - Tiny shared DNS
src/dns01-proxy/plugins/client/runtime/shared/utils/tinyModeDns.ts
Edge proxy
- Reverse proxy runtime
src/dns01-proxy/server/proxy/handle.ts - Proxy host configuration
src/dns01-proxy/plugins/proxy/runtime/server/utils/proxyHostsFile.ts
Operations and extensions
- Lab issuer
src/dns01-proxy/plugins/dns01-lab/runtime/shared/utils/labIssueSteps.ts - DNS diagnostics
src/dns01-proxy/plugins/client/runtime/server/utils/dnsQuery.ts
Other components
- Operator
- Let's Encrypt
- Certificate consumers
- Public DNS clients
- Public app visitors
Connections 24
- Operator → Operator UI: operates
README.md - Operator UI → UI authentication: authenticates through
- Operator UI → Certificate API: submits certificate actions
- Operator UI → Settings service: manages settings
- Operator UI → Backup management: manages backups
- Operator UI → Client storage: reads and writes
README.md - Operator UI → Domain planning: edits certificate domains
README.md - Certificate API → Domain planning: validates domains
- Certificate API → Certificate job queue: starts jobs
- Certificate job queue → ACME issue steps: tracks issue steps
- ACME issue steps → Let's Encrypt: requests certificates
README.md - Let's Encrypt → Authoritative DNS: queries DNS-01
README.md - Authoritative DNS → Account and TXT store: reads TXT values
src/dns01-proxy/server/dns/server.ts - ACME DNS accounts → Account and TXT store: reads and updates accounts
src/dns01-proxy/server/utils/auth.ts - ACME issue steps → Client storage: uses account credentials
README.md - Certificate job queue → Certificate files: writes issued PEMs
README.md - Renew scheduler → Certificate job queue: schedules renewals
- Certificate consumers → Certificate files: mounts read-only
README.md - Public DNS clients → Authoritative DNS: queries port 53
README.md - Public app visitors → Reverse proxy runtime: visits public apps
README.md - Reverse proxy runtime → Proxy host configuration: uses host configuration
- Operator UI → Lab issuer: runs lab issuance
- Operator UI → DNS diagnostics: requests DNS checks
- Tiny shared DNS → Account and TXT store: supports shared accounts
src/dns01-proxy/server/utils/db.ts