Remnawave Node
Remnawave Node é um contêiner leve que inclui o Xray-core.
O Painel Remnawave não inclui o Xray-core, portanto você precisa instalar o Remnawave Node em um servidor separado para usar todos os recursos do Remnawave.
Instalar Docker
Instale o Docker se ainda não estiver instalado.
sudo curl -fsSL https://get.docker.com | sh
Passo 1 — Criar diretório do projeto
mkdir /opt/remnanode && cd /opt/remnanode
Passo 2 - Adicionar Node
Navegue até Nodes -> Management e clique no botão + para adicionar um novo nó.
Preencha o formulário.
Preste atenção ao campo Node Port. Ele será usado pelo Remnawave Node para escutar as requisições internas de API do Remnawave Panel. Não será usado de nenhuma outra forma.
Clique no botão Copy docker-compose.yml para copiar a configuração para a área de transferência.

Passo 3 — Criar arquivo docker-compose.yml
cd /opt/remnanode && nano docker-compose.yml
Cole a configuração da área de transferência e salve.
Passo 4 — Iniciar os contêineres
Inicie os contêineres executando o seguinte comando:
docker compose up -d && docker compose logs -f -t
Passo 5 - Finalizar
No cartão de criação de Node, clique em Next, selecione o Config Profile desejado e depois clique no botão Create.
Lembre-se de fechar o NODE_PORT no firewall do nó apenas para o IP do panel.
Uso avançado
Carregando arquivos geosite e geoip modificados
- Este exemplo usa nomes de espaço reservado para os arquivos
*-zapret.date as categorias:zapret. Os nomes de arquivos e categorias reais serão diferentes. - O roteamento configurado no servidor (nó) controla o tráfego do lado do servidor e não afetará as conexões DIRECT do cliente. Para gerenciar o roteamento do tráfego do cliente, configure o roteamento no lado do cliente.
Você pode adicionar arquivos geosite e geoip adicionais montando-os no diretório /usr/local/share/xray/ dentro do contêiner.
Não monte a pasta inteira, pois isso sobrescreverá os arquivos geosite e geoip padrão do Xray. Em vez disso, monte cada arquivo separadamente.
Adicione o seguinte ao arquivo 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 na configuração do Xray:
"routing": {
"rules": [
// Outras regras
{
"type": "field",
"domain": [ // Chamando o arquivo geosite
"ext:geo-zapret.dat:zapret"
],
"inboundTag": [ // Opcional
"VLESS_TCP_REALITY"
],
"outboundTag": "NOT_RU_OUTBOUND"
},
{
"type": "field",
"ip": [ // Chamando o arquivo geoip
"ext:ip-zapret.dat:zapret"
],
"inboundTag": [ // Opcional
"VLESS_TCP_REALITY"
],
"outboundTag": "NOT_RU_OUTBOUND"
}
// Outras regras
]
}
Logs do Node
Você pode acessar os logs do Node montando-os no sistema de arquivos do host.
Você deve configurar a rotação de logs, caso contrário os logs preencherão seu disco!
Adicione o seguinte ao arquivo 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 na configuração do Xray:
"log": {
"error": "/var/log/remnanode/error.log",
"access": "/var/log/remnanode/access.log",
"loglevel": "warning"
}
No servidor que hospeda o nó, crie a pasta /var/log/remnanode executando:
mkdir -p /var/log/remnanode
Instale o logrotate (se ainda não estiver instalado):
sudo apt update && sudo apt install logrotate
Crie um arquivo de configuração do logrotate:
nano /etc/logrotate.d/remnanode
Cole a seguinte configuração do logrotate para o RemnaNode:
/var/log/remnanode/*.log {
size 50M
rotate 5
compress
missingok
notifempty
copytruncate
}
Execute o logrotate para testar a configuração:
logrotate -vf /etc/logrotate.d/remnanode
Certificado SSL XRay para Node
Esta etapa é necessária se você implementar transporte TLS, por exemplo 'VLESS-Vision-TLS'. Para o transporte Reality, isso não é necessário.
Se você estiver usando certificados para sua configuração do Xray, precisa montá-los no panel.
Monte a pasta usando volumes Docker e referencie o caminho interno em sua configuração.
Dentro do contêiner, há um diretório dedicado (vazio) para certificados:
/var/lib/remnawave/configs/xray/ssl/
Adicione o seguinte ao arquivo 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
Quando o Panel envia a configuração para o Node, ele lerá automaticamente os arquivos montados e enviará os certificados para o Node.
Uso na configuração do Xray:
"certificates": [
{
"keyFile": "/var/lib/remnawave/configs/xray/ssl/privkey.key",
"certificateFile": "/var/lib/remnawave/configs/xray/ssl/fullchain.pem"
// Outros campos
}
]
Preste atenção às extensões .key e .pem.