feat: integrate hbbs and hbbr management with node agents

.env.example

@@ -19,5 +19,8 @@
 # DB_PASSWORD=
 # DB_DATABASE=rustdesk_console
 
+# Optional server management nodes (tokens are backend-only; minimum 32 characters).
+# RUSTDESK_NODES=[{"id":"local","name":"Local server","url":"http://rustdesk-agent:3001","token":"replace-with-a-random-token-at-least-32-characters"}]
+
 # Docker only: set to 0 when a separate single migration job runs before all replicas.
 # DB_MIGRATE_ON_START=1

.env.integrated.example

@@ -0,0 +1,4 @@
+JWT_SECRET=replace-with-an-independent-random-secret
+NODE_AGENT_TOKEN=replace-with-an-independent-random-token-at-least-32-characters
+SERVER_MANAGEMENT_TOKEN=replace-with-an-independent-random-token-at-least-32-characters
+RUSTDESK_RELAY_ADDRESS=rustdesk.example.com:21117

.github/workflows/ci.yml

@@ -11,6 +11,30 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  test:
+    name: Backend and node agent tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version-file: '.nvmrc'
+          cache: npm
+      - run: npm ci
+      - run: npm test -- --runInBand
+      - run: node --test agent/*.test.mjs
+
+  agent-build:
+    name: Node agent image
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+      - uses: docker/setup-buildx-action@v4
+      - uses: docker/build-push-action@v7
+        with:
+          context: ./agent
+          push: false
+
   lint:
     name: Lint
     runs-on: ubuntu-latest

README.md

@@ -154,3 +154,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, coding conventions
 <p align="center">
   <strong>Built with ❤️ using NestJS | Data Block</strong>
 </p>
+
+### Integrated hbbs / hbbr management
+
+See [Server management](docs/server-management.md) for the authenticated server APIs, Docker node agent, server permissions, integrated Compose deployment and CI validation.

agent/Dockerfile

@@ -0,0 +1,6 @@
+FROM node:24-alpine
+WORKDIR /app
+COPY *.mjs schema.json ./
+USER root
+EXPOSE 3001
+CMD ["node", "index.mjs"]