How sasha33396/remnanode-setup-bot works
Remnanode Setup Bot is a Telegram-operated Remnawave node deployment and maintenance service. Operators use the bot to prepare and provision nodes, then manage node IPs, DNS, certificates, host moves, inventory, and deployment recovery. The orchestration layer coordinates UI requests with panel APIs, SSH operations, certificate management, and persistent workflow state. The README documents these major capabilities; source excerpts show selected implementations and executable wiring, so some subsystem links are documented rather than directly verified in sampled calls.
Main entry points: service.go Workflow orchestration · controller.go Bot UI and wizard · ip_change.go IP change workflows · client.go Remnawave client
Components 28
Operator interface
- Bot UI and wizard
internal/telegram/controller.go - Node inventory
internal/telegram/node_inventory.go - Node monitor
internal/telegram/node_monitor.go
Deployment workflows
- Workflow orchestration
internal/orchestrator/service.go - Telegram adapter
internal/orchestrator/telegram.go - Provisioning stages
internal/provisioner/stages.go - SSH preflight
internal/provisioner/preflight.go - Remna to DNS sync
internal/orchestrator/dns_sync.go - Host migration
internal/orchestrator/node_host_move.go - IP change workflows
internal/orchestrator/ip_change.go
Node integrations
- Remnawave client
internal/remnawave/client.go - DNS balancer
internal/dnsbalancer/client.go - Cherry IP setup
internal/cherryip/service.go - Royal IP setup
internal/royalip/service.go - SSH access
internal/ssh/client.go - Certificate manager
internal/certmanager/manager.go - Telegram Bot API
- Remnawave panel
- DNS service
- Managed VPS
Persistence and recovery
- PostgreSQL repository
internal/repository/postgres/postgres.go - Deployment recovery
internal/recovery/service.go - Stage engine
internal/provisioner/engine.go
Runtime services
- Configuration
internal/config/config.go - Service executable
cmd/deployer/main.go - Health endpoint
internal/health/server.go - Metrics registry
internal/metrics/registry.go
Other components
- Telegram operator
Connections 36
- Telegram operator → Bot UI and wizard: operates
README.md - Bot UI and wizard → Telegram Bot API: polls and replies
README.md - Bot UI and wizard → Telegram adapter: invokes application
README.md - Telegram adapter → Workflow orchestration: adapts requests
README.md - Workflow orchestration → Provisioning stages: runs provisioning
README.md - Provisioning stages → Stage engine: executes stages
internal/provisioner/engine.go - Provisioning stages → SSH preflight: preflights VPS
README.md - SSH preflight → SSH access: checks access
README.md - Workflow orchestration → Remnawave client: manages nodes
internal/orchestrator/service.go - Workflow orchestration → DNS balancer: updates DNS
internal/orchestrator/service.go - Workflow orchestration → Certificate manager: checks readiness
internal/orchestrator/service.go - Workflow orchestration → PostgreSQL repository: persists workflow
README.md - Stage engine → PostgreSQL repository: records steps
internal/provisioner/engine.go - Workflow orchestration → Deployment recovery: recovers deployments
README.md - Bot UI and wizard → Node inventory: opens node views
README.md - Node monitor → Bot UI and wizard: sends alerts
README.md - Bot UI and wizard → IP change workflows: starts IP changes
README.md - IP change workflows → Remnawave client: updates node address
README.md - IP change workflows → DNS balancer: updates matching zones
README.md - IP change workflows → Cherry IP setup: configures Cherry IP
README.md - IP change workflows → Royal IP setup: configures Royal IP
README.md - Cherry IP setup → SSH access: connects to server
internal/cherryip/service.go - Royal IP setup → SSH access: connects to server
internal/royalip/service.go - Host migration → Remnawave client: updates host mapping
README.md - Host migration → Certificate manager: obtains SNI certificate
README.md - Host migration → SSH access: activates server config
README.md - Remna to DNS sync → Remnawave client: reads node address
README.md - Remna to DNS sync → DNS balancer: repairs zone
README.md - Remnawave client → Remnawave panel: calls panel API
internal/remnawave/client.go - DNS balancer → DNS service: calls DNS API
internal/dnsbalancer/client.go - SSH access → Managed VPS: runs remote commands
README.md - Service executable → Configuration: loads settings
cmd/deployer/main.go - Service executable → Bot UI and wizard: starts bot controller
cmd/deployer/main.go - Service executable → Health endpoint: starts endpoint
cmd/deployer/main.go - Health endpoint → PostgreSQL repository: checks database
- Service executable → Metrics registry: wires registry
cmd/deployer/main.go