Skip to content

Windows 부팅과 동시에 사용하는 LAN 서비스 ​

WSL 안의 MySQL(3306), Redis(6379), Nginx(80) 등 임의의 서비스를 LAN 내 동료에게 공개하고, Windows를 켜면 서비스가 자동으로 준비되도록 만듭니다. 데스크톱 로그인도, 터미널 실행도, 명령어를 외울 필요도, 재부팅할 때마다 다시 설정할 필요도 없습니다.

전체 설정은 두 단계이며 한 번만 하면 됩니다. 이후로는 부팅할 때마다 소프트웨어가 Linux, 업무 서비스, 포트 포워딩을 차례로 올립니다.

시작하기 전에 두 가지를 확인하세요:

  1. WSL이 기본 NAT 네트워크 모드를 사용하는지 (미러 모드 networkingMode=mirrored를 켠 경우에는 포트 포워딩이 필요 없으며 호스트 IP로 직접 접속하면 됩니다);
  2. 공유하려는 서비스가 127.0.0.1이 아니라 0.0.0.0에서 리스닝하는지 (MySQL의 bind-address, Redis의 bind에서 흔히 겪는 문제입니다).

1. 두 단계 설정 ​

1 단계: 배포판을 Windows와 함께 시작하고 업무 서비스도 자동 시작하기 ​

"설치된 Linux 배포판" 목록에서 대상 배포판의 "설정" 버튼을 클릭합니다:

  1. "Windows가 시작될 때 이 배포판을 자동으로 시작합니다." 를 선택——Linux 환경을 Windows와 함께 올립니다;
  2. "배포판 시작 후 스크립트 실행 (선택 사항)" 에 시작 스크립트의 절대 경로(예: /home/dev/init-services.sh)를 입력——MySQL, Redis 등의 서비스를 Linux와 함께 시작합니다;
  3. 저장을 클릭합니다.

스크립트는 다음 조건을 만족해야 합니다: 파일이 실제로 존재할 것, 실행 권한이 있을 것(chmod +x), 시스템 예약 경로를 사용하지 않을 것. 스크립트는 root 권한으로 백그라운드에서 실행되며, 작성 방법과 예시는 배포판 내 자동 시작 서비스를 참조하세요. 아래는 최소한으로 동작하는 예시입니다:

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

시작 스크립트의 출력은 기본적으로 버려지므로 예시에서는 로그 파일에 기록합니다. 나중에 "서비스가 실제로 시작되었는지" 확인하려면 이 로그를 보는 것이 가장 확실합니다.

2 단계: 포트 포워딩 규칙 추가하기 ​

"네트워크" → "포트 포워딩" 으로 돌아가 "규칙 추가" 를 클릭하고, 대화 상자에 다음을 입력합니다:

항목예시 값설명
대상 배포판Ubuntu서비스가 실제로 실행 중인 배포판
리스닝 IP0.0.0.0LAN에서 접근 가능; 127.0.0.1을 입력하면 로컬에서만 접근 가능
리스닝 포트3306Windows 쪽에서 외부에 노출하는 포트
대상 포트3306배포판 내부에서 서비스가 리스닝하는 포트이며, 리스닝 포트와 달라도 됩니다
방화벽 규칙 추가선택인바운드 트래픽을 자동으로 허용; 선택하지 않으면 LAN 연결이 차단됩니다

Redis를 위해 6379 → 6379 규칙을 하나 더 추가합니다. 규칙을 추가한 뒤 해당 행의 "규칙 적용" 을 클릭하거나, 하단의 "모든 규칙 적용" 을 직접 클릭합니다(한 번의 권한 상승으로 모든 규칙을 적용할 수 있습니다).

IMPORTANT

리스닝 포트가 Windows에 이미 있는 프로그램과 충돌하지 않도록 하세요. Windows 로컬에 MySQL이 설치되어 3306을 점유하고 있다면 리스닝 포트를 13306으로 바꾸고 대상 포트는 3306으로 두면 되며, LAN 사용자는 192.168.1.10:13306에 연결하면 됩니다.

완료 확인 ​

  • 배포판 설정에서 "Windows가 시작될 때 이 배포판을 자동으로 시작합니다."가 선택된 상태;
  • 포트 포워딩 목록에서 규칙이 적용됨으로 표시됨;
  • Windows를 재부팅한 뒤에도 LAN 내 다른 컴퓨터에서 서비스에 연결할 수 있음.

2. 적용 여부 확인(선택 사항) ​

"로컬 → LAN → 클라이언트" 순서로 점검하는 것을 권장합니다. 한 단계만으로 문제가 어느 계층에 있는지 파악할 수 있습니다.

① Windows 로컬: 서비스가 WSL 안에서 실제로 실행 중인지

powershell
Test-NetConnection 127.0.0.1 -Port 3306

연결되지 않는다면 문제는 WSL 내부(서비스 미시작, 127.0.0.1에서만 리스닝, 포트 불일치)에 있으며 포워딩 규칙과는 관련이 없습니다.

② LAN 내 다른 컴퓨터: 포워딩과 방화벽이 허용되는지

powershell
Test-NetConnection 192.168.1.10 -Port 3306

로컬은 되고 LAN은 되지 않는다면, 일반적으로 방화벽 규칙 누락, 리스닝 IP가 0.0.0.0이 아님, 또는 두 컴퓨터가 같은 네트워크 세그먼트에 없기 때문입니다.

③ 실제 클라이언트로 연결

bash
mysql -h 192.168.1.10 -P 3306 -u <사용자> -p
redis-cli -h 192.168.1.10 -p 6379

④ 현재 적용 중인 포워딩 규칙 확인

powershell
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

3. 자주 발생하는 문제 빠른 조회 ​

증상가장 가능성 높은 원인처리 방법
부팅 후 몇 분이 지나야 접근 가능일부 컴퓨터에서 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 승인 프롬프트를 거부함설정을 다시 저장하고 승인을 허용