Skip to content

Serviços LAN prontos para usar ao iniciar o Windows ​

Exponha qualquer serviço do WSL — MySQL (3306), Redis (6379), Nginx (80), etc. — aos colegas da rede local e garanta que os serviços fiquem prontos automaticamente assim que o Windows iniciar: sem fazer login na área de trabalho, sem abrir um terminal, sem memorizar comandos e sem reconfigurar tudo após cada reinício.

Toda a configuração leva apenas dois passos e só precisa ser feita uma vez; depois, a cada inicialização, o aplicativo inicia o Linux, os serviços de negócio e o encaminhamento de portas em sequência.

Antes de começar, confirme dois pequenos detalhes:

  1. O WSL usa o modo de rede NAT padrão (se o modo espelhado networkingMode=mirrored estiver habilitado, o encaminhamento de portas não é necessário; acesse diretamente pelo IP do host);
  2. O serviço que você deseja compartilhar escuta em 0.0.0.0 e não em 127.0.0.1 (uma armadilha comum com bind-address do MySQL e bind do Redis).

1. Configuração em dois passos ​

Passo 1: Iniciar a distribuição com o Windows e iniciar automaticamente os serviços de negócio ​

Na lista de distribuições Linux instaladas, clique no botão "Configurações" da distribuição de destino:

  1. Marque "Iniciar automaticamente esta distribuição quando o Windows for iniciado." — para colocar o ambiente Linux em funcionamento junto com o Windows;
  2. Em "Executar um script após o início da distribuição (opcional)", insira o caminho absoluto do script de inicialização (por exemplo, /home/dev/init-services.sh) — para que serviços como MySQL e Redis iniciem junto com o Linux;
  3. Clique em Salvar.

O script precisa atender aos seguintes requisitos: o arquivo precisa existir de verdade, ter permissão de execução (chmod +x) e não usar um caminho reservado do sistema. O script é executado em segundo plano como root; para saber como escrevê-lo e ver exemplos, consulte Início automático de serviços na distribuição. A seguir há um exemplo mínimo funcional:

bash
#!/bin/bash
# /home/dev/init-services.sh

LOG_FILE="/var/log/wsl-services.log"
echo "$(date): boot hook start" >> "$LOG_FILE"

service mysql start >> "$LOG_FILE" 2>&1
service redis-server start >> "$LOG_FILE" 2>&1
nginx >> "$LOG_FILE" 2>&1

echo "$(date): boot hook done" >> "$LOG_FILE"

TIP

A saída do script de inicialização é descartada por padrão, por isso o exemplo grava em um arquivo de log. Mais tarde, para confirmar "se o serviço realmente iniciou", consultar esse log é a forma mais direta.

Passo 2: Adicionar regras de encaminhamento de portas ​

Volte a "Rede" → "Encaminhamento de portas", clique em "Adicionar regra" e preencha a janela "Adicionar regra de encaminhamento de portas":

CampoValor de exemploDescrição
Distribuição alvoUbuntuDistribuição em que o serviço realmente é executado
IP de escuta0.0.0.0Acessível pela rede local; se você inserir 127.0.0.1, apenas a máquina local poderá acessar
Porta de escuta3306Porta exposta para fora no lado do Windows
Porta de destino3306Porta em que o serviço escuta dentro da distribuição; pode ser diferente da porta de escuta
Adicionar regra de firewallMarcadoPermite automaticamente o tráfego de entrada; caso contrário, as conexões da rede local serão bloqueadas

Adicione outra regra 6379 → 6379 para o Redis. Depois de adicionar as regras, clique em "Aplicar regra" nessa linha ou diretamente em "Aplicar todas as regras" na parte inferior (uma única elevação de privilégios aplica todas as regras).

IMPORTANT

A porta de escuta não deve entrar em conflito com um programa já existente no Windows. Se o MySQL já estiver instalado na máquina Windows e ocupar a 3306, você pode alterar a porta de escuta para 13306 e manter a porta de destino em 3306; os usuários da rede local só precisarão se conectar a 192.168.1.10:13306.

Indicadores de conclusão ​

  • Nas configurações da distribuição, "Iniciar automaticamente esta distribuição quando o Windows for iniciado." está marcado;
  • Na lista de encaminhamento de portas, as regras aparecem como aplicadas;
  • Após reiniciar o Windows, os serviços continuam acessíveis a partir de outra máquina da rede local.

2. Verificar se está funcionando (opcional) ​

Recomenda-se verificar na ordem "máquina local → rede local → cliente"; cada passo indica imediatamente em qual camada está o problema.

① Máquina Windows: o serviço está realmente em execução no WSL?

powershell
Test-NetConnection 127.0.0.1 -Port 3306

Se a conexão falhar, o problema está dentro do WSL (serviço não iniciado, escutando apenas em 127.0.0.1, portas diferentes) e não tem relação com as regras de encaminhamento.

② Outra máquina da rede local: o encaminhamento e o firewall permitem a passagem?

powershell
Test-NetConnection 192.168.1.10 -Port 3306

Se funciona na máquina local mas não na rede local, normalmente falta uma regra de firewall, o IP de escuta não é 0.0.0.0 ou as duas máquinas não estão na mesma sub-rede.

③ Conectar com um cliente real

bash
mysql -h 192.168.1.10 -P 3306 -u <usuário> -p
redis-cli -h 192.168.1.10 -p 6379

④ Visualizar as regras de encaminhamento atualmente em vigor

powershell
netsh interface portproxy show all

Saída esperada (o endereço em Connect to ipv4 à direita é o IP atual da distribuição WSL e muda após reiniciar):

Listen on ipv4:             Connect to ipv4:

Address         Port        Address         Port
--------------- ----------  --------------- ----------
0.0.0.0         6379        172.28.78.41    6379
0.0.0.0         3306        172.28.78.41    3306

3. Problemas comuns de relance ​

SintomaCausa mais provávelSolução
É preciso esperar alguns minutos após a inicialização para conseguir acessarEm algumas máquinas, a máquina virtual do WSL inicia a frio muito lentamente (consulte #125)Aguarde alguns minutos; o processo automatizado terminará sozinho, sem necessidade de intervenção manual
Após reiniciar, não é possível conectar pela rede localA distribuição não foi iniciada com o Windows e a sincronização das regras foi ignoradaConfirme se o passo 1 está marcado; clique novamente em "Aplicar todas as regras"
Funciona localmente, mas não pela rede localO IP de escuta está definido como 127.0.0.1 ou a regra de firewall não está marcadaAltere a regra para 0.0.0.0 e aplique novamente
Também não funciona localmenteO serviço escuta apenas em 127.0.0.1 ou não foi iniciado de forma algumaAltere o endereço de escuta do serviço; consulte o log do script de inicialização
A regra está aplicada, mas a conexão ainda chega ao endereço antigowsl --shutdown foi executado manualmente e o IP mudouClique novamente em "Aplicar todas as regras"
A porta já está em usoUm programa no Windows está usando a mesma porta de escutaLocalize-o com netstat -ano | findstr :3306 e escolha outra porta de escuta
A elevação de privilégios foi negadaO aviso de autorização do Windows foi recusado ao salvar as configurações ou aplicar regrasSalve as configurações novamente e permita a autorização