NCUT Auto WiFi Reconnector v2.0

📖 專案簡介

給我朋友做的。
本專案是一個專為 國立勤益科技大學 (NCUT) 打造的校園網路自動重連工具。
當偵測到網路斷線時，程式會自動尋找當前的預設閘道 (Default Gateway)，並利用 Selenium 驅動隱形瀏覽器 (Headless Chrome) 自動完成驗證頁面登入，確保網路連線維持不斷線。

✨ 核心功能

• 自動化網路偵測：定時發送 HTTP 請求確認與 Google 的連線狀態。
• 動態閘道解析：自動呼叫作業系統 ipconfig 指令，即時獲取當前的網路閘道位址。
• VPN 排除機制：可自定義過濾清單（如 26.0.0.1），避免在開啟 VPN 時發生衝突。
• 無頭模式執行：採用 --headless 參數運行 Chrome，不干擾使用者正常操作電腦。
• 效能優化管理：具備自動清理終端機輸出文字的機制，維持監控介面的整潔。

🛠️ 環境配置需求

為確保 run.py 正常運作，請確保您的開發環境符合以下配置：

1. 必要軟體與驅動

• Python 3.8+
• Chrome 可攜式瀏覽器：需放置於 ./chrome-win64/chrome.exe 。
• Chrome 驅動程式 (ChromeDriver)：需與瀏覽器版本對應，放置於 ./chromedriver.exe 。

2. 專案目錄結構

Python-NUCT-auto-wifi-connector/
├── run.py                 # 核心執行程式碼
├── chromedriver.exe       # Chrome 驅動程式
└── chrome-win64/          # Chrome 可攜式瀏覽器資料夾
    └── chrome.exe

⚙️ 自定義參數說明

您可以在 run.py 的 *** 自訂義參數 *** 區段直接修改以下變數以調整行為：

變數名稱	預設值	說明
wait_detect_timeout	1	網路斷線偵測的時間間隔（秒）。
loop_mode	1	1: 持續監控自動重連 / 0: 僅執行一次重連。
vpn_bypass_default_gateway	['26.0.0.1']	略過不處理的虛擬閘道 IP 清單。
clear_count	100	累計輸出訊息達此數目時，自動清理終端機畫面。
wait_load_timeout	10	網頁載入與尋找元件的超時上限。

🚀 快速上手

1. 安裝依賴套件：

pip install selenium requests

2. 執行監控程式：

python run.py

3. 觀察輸出：

• 系統： 網路運行 code 200：表示網路目前運作正常。
• 系統： 網路運行 code 404：偵測到斷線，準備啟動自動重連程序 。

⚠️ 安全警告與注意事項

• 明文密碼：目前程式碼將帳號與密碼 (ncutvip@ncut.edu.tw / 23924505) 不要太招搖，我秘密獲得的。
• SSL 憑證：程式目前會強制解除 SSL 驗證 (WDM_SSL_VERIFY = '0') 以增加相容性。
• 法律遵循：請遵守國立勤益科技大學校園網路使用規範，本工具僅供學術交流與個人便利使用。