How greepar/cfspeedtest works
CfSpeedtest coordinates recurring, carrier-specific Cloudflare IP tests: an operator configures pools and test settings in the WebUI; the server assigns tasks, clients measure candidate IPs and report Top-N results, and the server records rounds and may update DNS. The server also exposes client management, history, notifications, authentication, and update controls. The tree and README establish these capabilities; sampled excerpts confirm several service interactions, but not every route-to-service wiring, so uncertain links are omitted.
Main entry points: App.tsx Admin UI · CfSpeedtest.Server/Program.cs HTTP server · CfSpeedtest.Client/Program.cs Test agent · RoundCoordinatorService.cs Round coordinator
Components 27
Test client
- Test agent
src/CfSpeedtest.Client/Program.cs
Server runtime
- HTTP server
src/CfSpeedtest.Server/Program.cs - Round coordinator
src/CfSpeedtest.Server/Services/RoundCoordinatorService.cs - IP pool service
src/CfSpeedtest.Server/Services/IpPoolService.cs - Persistent state
src/CfSpeedtest.Server/Services/DataStore.cs - Client WebSocket hub
src/CfSpeedtest.Server/Services/ClientWsHub.cs - DNS updater
src/CfSpeedtest.Server/Services/DnsUpdateService.cs - Web authentication
src/CfSpeedtest.Server/Services/WebUiAuthService.cs - Webhook service
src/CfSpeedtest.Server/Services/WebhookNotificationService.cs - Server updater
src/CfSpeedtest.Server/Services/ServerUpdateService.cs - Shared contracts
src/CfSpeedtest.Shared/Models.cs
Web management
- Admin UI
src/CfSpeedtest.Web/src/App.tsx - Overview
src/CfSpeedtest.Web/src/pages/Overview.tsx - Test history
src/CfSpeedtest.Web/src/pages/HistoryPage.tsx - Client admin
src/CfSpeedtest.Web/src/pages/ClientsPage.tsx - IP pools
src/CfSpeedtest.Web/src/pages/IpPoolPage.tsx - DNS settings
src/CfSpeedtest.Web/src/pages/DnsPage.tsx - Server config
src/CfSpeedtest.Web/src/pages/ConfigPage.tsx - Notifications
src/CfSpeedtest.Web/src/pages/NotificationsPage.tsx - API client
src/CfSpeedtest.Web/src/lib/api.ts
External systems
- Test endpoints
- IP source APIs
- DoH resolver
- Huawei DNS
- Webhook receiver
- GitHub Releases
Other components
- Operator
Connections 31
- Operator → Admin UI: manages
- Admin UI → API client: requests
- API client → HTTP server: calls API
- HTTP server → Web authentication: authenticates
- HTTP server → Persistent state: reads/writes
- HTTP server → Client WebSocket hub: dispatches
- HTTP server → Round coordinator: coordinates
- Round coordinator → IP pool service: refreshes pool
- Round coordinator → DNS updater: updates records
- Round coordinator → Persistent state: stores results
- IP pool service → Persistent state: reads/writes
- IP pool service → IP source APIs: fetches addresses
- IP pool service → DoH resolver: resolves A records
- DNS updater → Huawei DNS: updates DNS
- Webhook service → Webhook receiver: sends notices
- HTTP server → Webhook service: notifies
- HTTP server → Server updater: checks/installs
- Server updater → GitHub Releases: fetches release
- Test agent → HTTP server: registers/reports
- Test agent → Client WebSocket hub: connects
- Client WebSocket hub → Test agent: sends tasks
- Test agent → Test endpoints: tests IPs
- Admin UI → Overview: shows
- Admin UI → Test history: shows
- Admin UI → Client admin: shows
- Admin UI → IP pools: shows
- Admin UI → DNS settings: shows
- Admin UI → Server config: shows
- Admin UI → Notifications: shows
- Shared contracts → HTTP server: defines contracts
- Shared contracts → Test agent: defines contracts