Remnawave Node
Remnawave Node es un contenedor ligero que incluye Xray-core.
Remnawave Panel no incluye Xray-core, por lo que necesita instalar Remnawave Node en un servidor separado para usar todas las funciones de Remnawave.
Instalar Docker
Instala Docker si no está instalado todavía.
sudo curl -fsSL https://get.docker.com | sh
Paso 1 — Crear directorio del proyecto
mkdir /opt/remnanode && cd /opt/remnanode
Paso 2 - Agregar Node
Navegue a Nodes -> Management y haga clic en el botón + para agregar un nuevo nodo.
Complete el formulario.
Preste atención al campo Node Port. Será utilizado por Remnawave Node para escuchar las solicitudes internas de API de Remnawave Panel. No se utilizará de ninguna otra manera.
Haga clic en el botón Copy docker-compose.yml para copiar la configuración al portapapeles.

Paso 3 — Crear archivo docker-compose.yml
cd /opt/remnanode && nano docker-compose.yml
Pegue la configuración del portapapeles y guarde.
Paso 4 — Iniciar los contenedores
Inicie los contenedores ejecutando el siguiente comando:
docker compose up -d && docker compose logs -f -t
Paso 5 - Finalizar
En la tarjeta de creación de Node, haga clic en Next, seleccione el Config Profile deseado y luego haga clic en el botón Create.
Recuerde cerrar NODE_PORT en el firewall del nodo solo para la IP del panel.
Uso avanzado
Cargar archivos geosite y geoip modificados
- Este ejemplo utiliza nombres de marcador de posición para los archivos
*-zapret.daty las categorías:zapret. Los nombres de archivo y categorías reales serán diferentes. - El enrutamiento configurado en el servidor (nodo) controla el tráfico del lado del servidor y no afectará las conexiones DIRECT del cliente. Para gestionar el enrutamiento del tráfico del cliente, configure el enrutamiento en el lado del cliente.
Puede agregar archivos geosite y geoip adicionales montándolos en el directorio /usr/local/share/xray/ dentro del contenedor.
No monte toda la carpeta, esto sobrescribirá los archivos geosite y geoip predeterminados de Xray. En su lugar, monte cada archivo por separado.
Agregue lo siguiente al archivo docker-compose.yml:
services:
remnanode:
container_name: remnanode
hostname: remnanode
image: remnawave/node:latest
restart: always
network_mode: host
environment:
- NODE_PORT=2222
- SECRET_KEY="supersecretkey"
volumes:
- './geo-zapret.dat:/usr/local/share/xray/geo-zapret.dat'
- './ip-zapret.dat:/usr/local/share/xray/ip-zapret.dat'
Uso en la configuración de Xray:
"routing": {
"rules": [
// Otras reglas
{
"type": "field",
"domain": [ // Llamando al archivo geosite
"ext:geo-zapret.dat:zapret"
],
"inboundTag": [ // Opcional
"VLESS_TCP_REALITY"
],
"outboundTag": "NOT_RU_OUTBOUND"
},
{
"type": "field",
"ip": [ // Llamando al archivo geoip
"ext:ip-zapret.dat:zapret"
],
"inboundTag": [ // Opcional
"VLESS_TCP_REALITY"
],
"outboundTag": "NOT_RU_OUTBOUND"
}
// Otras reglas
]
}
Registros de Node
Puede acceder a los registros del Node montándolos en el sistema de archivos host.
Debe configurar la rotación de registros, ¡de lo contrario los registros llenarán su disco!
Agregue lo siguiente al archivo docker-compose.yml:
services:
remnanode:
container_name: remnanode
hostname: remnanode
image: remnawave/node:latest
restart: always
network_mode: host
environment:
- NODE_PORT=2222
- SECRET_KEY="supersecretkey"
volumes:
- '/var/log/remnanode:/var/log/remnanode'
Uso en la configuración de Xray:
"log": {
"error": "/var/log/remnanode/error.log",
"access": "/var/log/remnanode/access.log",
"loglevel": "warning"
}
En el servidor que aloja el nodo, cree la carpeta /var/log/remnanode ejecutando:
mkdir -p /var/log/remnanode
Instale logrotate (si no está ya instalado):
sudo apt update && sudo apt install logrotate
Cree un archivo de configuración de logrotate:
nano /etc/logrotate.d/remnanode
Pegue la siguiente configuración de logrotate para RemnaNode:
/var/log/remnanode/*.log {
size 50M
rotate 5
compress
missingok
notifempty
copytruncate
}
Ejecute logrotate para probar la configuración:
logrotate -vf /etc/logrotate.d/remnanode
Certificado SSL XRay para Node
Este paso es necesario si implementa transporte TLS, por ejemplo 'VLESS-Vision-TLS'. Para el transporte Reality, esto no es necesario.
Si está utilizando certificados para su configuración de Xray, necesita montarlos en el panel.
Monte la carpeta usando volúmenes Docker y haga referencia a la ruta interna en su configuración.
Dentro del contenedor, hay un directorio dedicado (vacío) para certificados:
/var/lib/remnawave/configs/xray/ssl/
Agregue lo siguiente al archivo docker-compose.yml:
remnawave:
image: remnawave/backend:latest
container_name: 'remnawave'
hostname: remnawave
restart: always
ports:
- '127.0.0.1:3000:3000'
env_file:
- .env
networks:
- remnawave-network
volumes:
- '/opt/remnawave/nginx:/var/lib/remnawave/configs/xray/ssl'
depends_on:
remnawave-db:
condition: service_healthy
remnawave-redis:
condition: service_healthy
Cuando el Panel envía la configuración al Node, leerá automáticamente los archivos montados y enviará los certificados al Node.
Uso en la configuración de Xray:
"certificates": [
{
"keyFile": "/var/lib/remnawave/configs/xray/ssl/privkey.key",
"certificateFile": "/var/lib/remnawave/configs/xray/ssl/fullchain.pem"
// Otros campos
}
]
Preste atención a las extensiones .key y .pem.