Skip to content

開機即用的區域網路服務 ​

將 WSL 中的 MySQL(3306)、Redis(6379)、Nginx(80)等任意服務開放給區域網路內的同事,並做到 Windows 一開機服務就自動就緒:不用登入桌面、不用開啟終端機、不用記指令,也不用每次重新啟動後重新設定一遍。

整個設定只需兩步,且只需做一次;之後再開機,軟體會自己把 Linux、業務服務和連接埠轉發依序拉起來。

開始前,確認兩件小事:

  1. WSL 使用預設的 NAT 網路模式(若已開啟鏡像模式 networkingMode=mirrored,則不需要連接埠轉發,直接用主機 IP 存取即可);
  2. 你要分享的服務監聽在 0.0.0.0 而不是 127.0.0.1(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.0區域網路可存取;填 127.0.0.1 則只有本機可存取
監聽連接埠3306Windows 側對外暴露的連接埠
目標連接埠3306發行版內部服務監聽的連接埠,可與監聽連接埠不同
新增防火牆規則勾選自動放行入站流量,否則區域網路連線會被攔截

為 Redis 再加一條 6379 → 6379 的規則。規則加好後,點擊該行的 「套用規則」,或直接點底部 「全部套用」(一次提權即可套用全部規則)。

IMPORTANT

監聽連接埠不要與 Windows 上已有程式衝突。如果 Windows 本機已安裝 MySQL 並佔用 3306,可以把監聽連接埠改成 13306、目標連接埠仍填 3306,區域網路使用者連線 192.168.1.10:13306 即可。

完成標誌 ​

  • 發行版設定裡「在 Windows 啟動時自動啟動該發行版」為勾選狀態;
  • 連接埠轉發清單中規則顯示已套用;
  • 重新啟動 Windows 後,在區域網路另一台機器上仍能連上服務。

2. 驗證是否生效(可選) ​

建議按「本機 → 區域網路 → 用戶端」的順序檢查,一步就能定位問題出在哪一層。

① Windows 本機:服務在 WSL 裡是否真的在執行

powershell
Test-NetConnection 127.0.0.1 -Port 3306

不通說明問題在 WSL 內部(服務沒啟動、只監聽了 127.0.0.1、連接埠不一致),與轉發規則無關。

② 區域網路另一台機器:轉發與防火牆是否放行

powershell
Test-NetConnection 192.168.1.10 -Port 3306

本機通、區域網路不通,通常是防火牆規則缺少、監聽 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)等待數分鐘,自動化流程會自行完成,無需手動介入
重新啟動後區域網路連不上發行版沒有隨開機啟動,規則同步被跳過確認第 1 步已勾選;再點一次「全部套用」
本機通、區域網路不通監聽 IP 填了 127.0.0.1,或沒勾選防火牆規則規則改為 0.0.0.0 並重新套用
本機也不通服務只監聽 127.0.0.1,或服務根本沒啟動修改服務監聽位址;查看啟動指令碼的日誌
規則已套用卻連到舊位址手動執行過 wsl --shutdown,IP 變了重新點一次「全部套用」
連接埠被佔用Windows 上有程式佔用了同一監聽連接埠netstat -ano | findstr :3306 定位,換個監聽連接埠
提權被拒絕儲存設定或套用規則時的 Windows 授權提示被拒絕重新儲存一次設定並允許授權