한국어
Appearance
한국어
Appearance
WSL 안의 MySQL(3306), Redis(6379), Nginx(80) 등 임의의 서비스를 LAN 내 동료에게 공개하고, Windows를 켜면 서비스가 자동으로 준비되도록 만듭니다. 데스크톱 로그인도, 터미널 실행도, 명령어를 외울 필요도, 재부팅할 때마다 다시 설정할 필요도 없습니다.
전체 설정은 두 단계이며 한 번만 하면 됩니다. 이후로는 부팅할 때마다 소프트웨어가 Linux, 업무 서비스, 포트 포워딩을 차례로 올립니다.
시작하기 전에 두 가지를 확인하세요:
networkingMode=mirrored를 켠 경우에는 포트 포워딩이 필요 없으며 호스트 IP로 직접 접속하면 됩니다);127.0.0.1이 아니라 0.0.0.0에서 리스닝하는지 (MySQL의 bind-address, Redis의 bind에서 흔히 겪는 문제입니다)."설치된 Linux 배포판" 목록에서 대상 배포판의 "설정" 버튼을 클릭합니다:
/home/dev/init-services.sh)를 입력——MySQL, Redis 등의 서비스를 Linux와 함께 시작합니다;스크립트는 다음 조건을 만족해야 합니다: 파일이 실제로 존재할 것, 실행 권한이 있을 것(chmod +x), 시스템 예약 경로를 사용하지 않을 것. 스크립트는 root 권한으로 백그라운드에서 실행되며, 작성 방법과 예시는 배포판 내 자동 시작 서비스를 참조하세요. 아래는 최소한으로 동작하는 예시입니다:
#!/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
시작 스크립트의 출력은 기본적으로 버려지므로 예시에서는 로그 파일에 기록합니다. 나중에 "서비스가 실제로 시작되었는지" 확인하려면 이 로그를 보는 것이 가장 확실합니다.
"네트워크" → "포트 포워딩" 으로 돌아가 "규칙 추가" 를 클릭하고, 대화 상자에 다음을 입력합니다:
| 항목 | 예시 값 | 설명 |
|---|---|---|
| 대상 배포판 | Ubuntu | 서비스가 실제로 실행 중인 배포판 |
| 리스닝 IP | 0.0.0.0 | LAN에서 접근 가능; 127.0.0.1을 입력하면 로컬에서만 접근 가능 |
| 리스닝 포트 | 3306 | Windows 쪽에서 외부에 노출하는 포트 |
| 대상 포트 | 3306 | 배포판 내부에서 서비스가 리스닝하는 포트이며, 리스닝 포트와 달라도 됩니다 |
| 방화벽 규칙 추가 | 선택 | 인바운드 트래픽을 자동으로 허용; 선택하지 않으면 LAN 연결이 차단됩니다 |
Redis를 위해 6379 → 6379 규칙을 하나 더 추가합니다. 규칙을 추가한 뒤 해당 행의 "규칙 적용" 을 클릭하거나, 하단의 "모든 규칙 적용" 을 직접 클릭합니다(한 번의 권한 상승으로 모든 규칙을 적용할 수 있습니다).
IMPORTANT
리스닝 포트가 Windows에 이미 있는 프로그램과 충돌하지 않도록 하세요. Windows 로컬에 MySQL이 설치되어 3306을 점유하고 있다면 리스닝 포트를 13306으로 바꾸고 대상 포트는 3306으로 두면 되며, LAN 사용자는 192.168.1.10:13306에 연결하면 됩니다.
"로컬 → LAN → 클라이언트" 순서로 점검하는 것을 권장합니다. 한 단계만으로 문제가 어느 계층에 있는지 파악할 수 있습니다.
① Windows 로컬: 서비스가 WSL 안에서 실제로 실행 중인지
Test-NetConnection 127.0.0.1 -Port 3306연결되지 않는다면 문제는 WSL 내부(서비스 미시작, 127.0.0.1에서만 리스닝, 포트 불일치)에 있으며 포워딩 규칙과는 관련이 없습니다.
② LAN 내 다른 컴퓨터: 포워딩과 방화벽이 허용되는지
Test-NetConnection 192.168.1.10 -Port 3306로컬은 되고 LAN은 되지 않는다면, 일반적으로 방화벽 규칙 누락, 리스닝 IP가 0.0.0.0이 아님, 또는 두 컴퓨터가 같은 네트워크 세그먼트에 없기 때문입니다.
③ 실제 클라이언트로 연결
mysql -h 192.168.1.10 -P 3306 -u <사용자> -p
redis-cli -h 192.168.1.10 -p 6379④ 현재 적용 중인 포워딩 규칙 확인
netsh interface portproxy show all예상 출력(오른쪽 Connect to ipv4 주소는 WSL 배포판의 현재 IP이며 재부팅 후 변경됩니다):
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| 증상 | 가장 가능성 높은 원인 | 처리 방법 |
|---|---|---|
| 부팅 후 몇 분이 지나야 접근 가능 | 일부 컴퓨터에서 WSL 가상 머신의 콜드 스타트가 매우 느림(자세한 내용은 #125) | 몇 분 기다리면 자동화 흐름이 스스로 완료되며 수동 조작은 필요 없습니다 |
| 재부팅 후 LAN에서 연결 불가 | 배포판이 부팅 시 함께 시작되지 않아 규칙 동기화가 건너뛰어짐 | 1 단계를 선택했는지 확인; "모든 규칙 적용"을 다시 클릭 |
| 로컬은 되는데 LAN이 안 됨 | 리스닝 IP에 127.0.0.1을 입력했거나 방화벽 규칙을 선택하지 않음 | 규칙을 0.0.0.0으로 변경하고 다시 적용 |
| 로컬도 안 됨 | 서비스가 127.0.0.1에서만 리스닝하거나 서비스가 시작되지 않음 | 서비스 리스닝 주소 수정; 시작 스크립트 로그 확인 |
| 규칙은 적용되었는데 오래된 주소로 연결됨 | 수동으로 wsl --shutdown을 실행해 IP가 변경됨 | "모든 규칙 적용"을 다시 클릭 |
| 포트가 이미 사용 중 | Windows의 프로그램이 동일한 리스닝 포트를 점유 | netstat -ano | findstr :3306으로 확인 후 리스닝 포트 변경 |
| 권한 상승이 거부됨 | 설정 저장 또는 규칙 적용 시 Windows 승인 프롬프트를 거부함 | 설정을 다시 저장하고 승인을 허용 |