How remnawave/node works
Remnawave Node is the panel-managed runtime for a Remnawave server node. The main workflow is panel requests entering the node’s HTTP API, then reaching user-management, statistics, plugin, or Xray operations and returning responses. Xray startup also gathers node/interface data, synchronizes integrations, builds configuration, and controls the Xray process. The graph preserves documented API capabilities and major subsystems; several service internals were not sampled, so their relationships are omitted unless the source index or excerpts establish them.
Main entry points: xray.service.ts Xray Lifecycle · nft.service.ts Firewall Rules · plugin.controller.ts Plugin API · main.ts HTTP Bootstrap
Components 22
Node Runtime
- HTTP Bootstrap
src/main.ts - Application Modules
src/app.module.ts - Internal Operations
src/modules/internal/internal.service.ts - Integrations
src/integration-modules/integrations.service.ts
Panel API
- API Route Contract
libs/contract/api/routes.ts - User Operations
src/modules/handler/handler.service.ts - Xray API
src/modules/xray-core/xray.controller.ts - Plugin API
src/modules/_plugin/plugin.controller.ts
Xray Core
- Xray Lifecycle
src/modules/xray-core/xray.service.ts - Core Loader
src/modules/xray-core/core-loader.service.ts - Geodata
src/modules/xray-core/geodata.service.ts - Xray Process
src/modules/xray-core/xray-process.service.ts
Plugins
- Plugin Management
src/modules/_plugin/plugin.service.ts - Firewall Rules
src/modules/_plugin/services/nft.service.ts - Plugin State
src/modules/_plugin/services/plugin-state.service.ts - Connection Drop Event
src/modules/_plugin/events/drop-connections/drop-connections.handler.ts
Stats and Data
- Stats Operations
src/modules/stats/stats.service.ts - Geo Check
src/modules/stats/geocheck.service.ts - Network Stats
src/modules/network-stats/network-stats.service.ts - ASN Prefix Lookup
src/modules/asn-lmdb/asn-lmdb.service.ts - ASN LMDB
src/modules/asn-lmdb/asn-lmdb.service.ts
Other components
- Remnawave Panel
Connections 18
- Remnawave Panel → HTTP Bootstrap: requests
- HTTP Bootstrap → Application Modules: bootstraps
src/main.ts - Remnawave Panel → API Route Contract: uses endpoints
libs/contract/api/routes.ts - User Operations → Internal Operations: calls
src/modules/handler/handler.service.ts - Xray API → Xray Lifecycle: dispatches
src/modules/xray-core/xray.controller.ts - Xray Lifecycle → Core Loader: uses
src/modules/xray-core/xray.service.ts - Xray Lifecycle → Geodata: uses
src/modules/xray-core/xray.service.ts - Xray Lifecycle → Xray Process: controls
src/modules/xray-core/xray.service.ts - Xray Lifecycle → Internal Operations: calls
src/modules/xray-core/xray.service.ts - Xray Lifecycle → Network Stats: queries
src/modules/xray-core/xray.service.ts - Xray Lifecycle → Integrations: synchronizes
- Plugin API → Plugin Management: dispatches
src/modules/_plugin/plugin.controller.ts - Plugin API → Firewall Rules: dispatches
src/modules/_plugin/plugin.controller.ts - Firewall Rules → Plugin State: updates
src/modules/_plugin/services/nft.service.ts - Firewall Rules → Connection Drop Event: publishes
src/modules/_plugin/services/nft.service.ts - Connection Drop Event → Plugin State: uses
src/modules/_plugin/events/drop-connections/drop-connections.handler.ts - Stats Operations → Network Stats: queries
- ASN Prefix Lookup → ASN LMDB: reads
src/modules/asn-lmdb/asn-lmdb.service.ts