Português
Appearance
Português
Appearance
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:
networkingMode=mirrored estiver habilitado, o encaminhamento de portas não é necessário; acesse diretamente pelo IP do host);0.0.0.0 e não em 127.0.0.1 (uma armadilha comum com bind-address do MySQL e bind do Redis).Na lista de distribuições Linux instaladas, clique no botão "Configurações" da distribuição de destino:
/home/dev/init-services.sh) — para que serviços como MySQL e Redis iniciem junto com o Linux;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:
#!/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.
Volte a "Rede" → "Encaminhamento de portas", clique em "Adicionar regra" e preencha a janela "Adicionar regra de encaminhamento de portas":
| Campo | Valor de exemplo | Descrição |
|---|---|---|
| Distribuição alvo | Ubuntu | Distribuição em que o serviço realmente é executado |
| IP de escuta | 0.0.0.0 | Acessível pela rede local; se você inserir 127.0.0.1, apenas a máquina local poderá acessar |
| Porta de escuta | 3306 | Porta exposta para fora no lado do Windows |
| Porta de destino | 3306 | Porta em que o serviço escuta dentro da distribuição; pode ser diferente da porta de escuta |
| Adicionar regra de firewall | Marcado | Permite 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.
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?
Test-NetConnection 127.0.0.1 -Port 3306Se 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?
Test-NetConnection 192.168.1.10 -Port 3306Se 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
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
netsh interface portproxy show allSaí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| Sintoma | Causa mais provável | Solução |
|---|---|---|
| É preciso esperar alguns minutos após a inicialização para conseguir acessar | Em 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 local | A distribuição não foi iniciada com o Windows e a sincronização das regras foi ignorada | Confirme se o passo 1 está marcado; clique novamente em "Aplicar todas as regras" |
| Funciona localmente, mas não pela rede local | O IP de escuta está definido como 127.0.0.1 ou a regra de firewall não está marcada | Altere a regra para 0.0.0.0 e aplique novamente |
| Também não funciona localmente | O serviço escuta apenas em 127.0.0.1 ou não foi iniciado de forma alguma | Altere 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 antigo | wsl --shutdown foi executado manualmente e o IP mudou | Clique novamente em "Aplicar todas as regras" |
| A porta já está em uso | Um programa no Windows está usando a mesma porta de escuta | Localize-o com netstat -ano | findstr :3306 e escolha outra porta de escuta |
| A elevação de privilégios foi negada | O aviso de autorização do Windows foi recusado ao salvar as configurações ou aplicar regras | Salve as configurações novamente e permita a autorização |