1. 项目概述与核心价值校园网登录尤其是像深澜Srun这类需要跳转认证页面的系统对于需要长时间保持网络连接的用户来说是个不大不小的痛点。手动打开浏览器、输入账号密码、点击登录这套流程每天重复几次不仅繁琐更关键的是一旦网络波动导致掉线如果人不在电脑前工作流就可能被打断。我最初做这个自动化脚本就是因为写代码时网络突然断开远程连接掉线差点丢失了未保存的进度。基于Python的Selenium库配合ChromeDriver本质上是在模拟一个真实用户的操作让程序代替我们完成打开浏览器、导航到登录页、填写表单、点击按钮这一系列动作。这个方案的优势在于它处理的是渲染后的网页能应对绝大多数带有JavaScript动态加载的登录页面通用性极强。对于学生、研究人员或者任何需要稳定校园网环境的用户一个稳定可靠的自动化登录工具能省下大量重复劳动的时间确保网络连接的后顾无忧。2. 环境准备与核心组件解析在Windows系统下搭建这套自动化环境核心就是三件套Python、Selenium库、以及匹配你Chrome浏览器版本的ChromeDriver。很多新手卡在第一步不是因为步骤多复杂而是没理清它们之间的关系。2.1 Python安装与环境变量配置Python是这一切的基石。现在直接从官网下载安装包是最稳妥的方式。安装时务必勾选“Add Python to PATH”这个选项这能省去后续手动配置环境变量的麻烦。安装完成后打开命令提示符CMD或PowerShell输入python --version或python -V如果能正确显示版本号比如Python 3.11.4就说明安装和PATH配置成功了。如果提示“不是内部或外部命令”那就需要手动添加。手动添加的路径通常是安装目录如C:\Users\你的用户名\AppData\Local\Programs\Python\Python311和其下的Scripts目录如C:\Users\你的用户名\AppData\Local\Programs\Python\Python311\Scripts。添加到系统环境变量的PATH中然后重新打开一个命令行窗口再测试。注意有些教程会推荐使用Anaconda等科学计算发行版。对于这个项目我个人更推荐使用官方原生Python。原因很简单环境更干净依赖冲突少最终打包成exe时也更容易控制体积和兼容性。2.2 Selenium库的安装与验证Selenium是一个用于Web应用程序测试的工具但它的浏览器自动化能力正好被我们用来模拟登录。安装它非常简单只需要一条pip命令。在配置好Python环境后打开命令行输入pip install selenium如果下载速度慢可以临时使用国内镜像源例如pip install selenium -i https://pypi.tuna.tsinghua.edu.cn/simple安装完成后可以写一个最简单的脚本来验证。创建一个test_selenium.py文件内容如下from selenium import webdriver print(“Selenium 导入成功准备测试...”) # 这里先不执行因为ChromeDriver还没配置运行这个脚本不报错说明Selenium库安装成功。2.3 ChromeDriver连接Selenium与Chrome的桥梁这是最容易出问题的一环。ChromeDriver是一个独立的可执行文件Selenium通过它来控制和通信真实的Chrome浏览器。版本必须严格对应你的Chrome浏览器版本。查看Chrome版本打开Chrome浏览器点击右上角三个点 - 帮助 - 关于Google Chrome就能看到版本号例如124.0.6367.91。下载ChromeDriver前往ChromeDriver的官方下载站点或国内可靠的镜像站。根据你的Chrome主版本号例如124选择对应的ChromeDriver版本下载。如果你的Chrome版本较新官方可能只提供稍早的版本通常选择版本号最接近的即可主版本号一致最佳。放置与配置下载的是一个chromedriver.exe文件。你有两种方式让Python找到它方法一推荐尤其对后续打包友好将chromedriver.exe放在你的项目目录下。在代码中指定其路径。方法二将chromedriver.exe所在目录例如D:\Tools\chromedriver添加到系统的PATH环境变量中。或者更简单粗暴地将其复制到C:\Windows目录下。这样系统在任何位置都能找到它。验证ChromeDriver是否可用可以运行以下脚本from selenium import webdriver from selenium.webdriver.chrome.service import Service # 指定chromedriver路径如果放在项目目录或已知路径 service Service(‘./chromedriver.exe’) # 或 ‘D:\path\to\chromedriver.exe’ driver webdriver.Chrome(serviceservice) driver.get(“http://www.baidu.com”) print(driver.title) # 应该打印出“百度一下你就知道” driver.quit()如果浏览器成功打开并跳转到百度且没有报错那么整个基础环境就搭建完成了。3. 深澜Srun登录页面分析与元素定位自动化操作的前提是程序能找到页面上的输入框和按钮。我们需要像侦探一样审查登录页面的HTML结构。3.1 页面结构探查打开你的校园网登录页面通常是网关地址如http://10.0.0.1或http://192.168.1.1。在登录页面按下F12打开开发者工具。点击左上角的箭头图标或按CtrlShiftC然后用鼠标去点击“用户名”输入框。开发者工具的“Elements”面板会自动定位到对应的HTML代码。通常深澜Srun的登录表单会包含以下几个关键元素用户名输入框可能是一个input标签其name属性可能是username、user或accountid属性也可能是类似的。密码输入框同样是一个input type“password”标签name可能是password、pass。登录按钮可能是一个input type“submit”或一个button标签。例如你可能会看到类似这样的代码input type“text” id“username” name“username” placeholder“请输入学号/工号” input type“password” id“password” name“password” button id“login-btn” onclick“doLogin()”登录/button你需要记录下这些元素最稳定的定位标识。优先顺序通常是idnameclassXPath。id通常是唯一的是最佳选择。3.2 Selenium元素定位方法实战Selenium提供了多种定位元素的方法。假设我们以上面的HTML为例from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.chrome.service import Service import time service Service(‘./chromedriver.exe’) driver webdriver.Chrome(serviceservice) try: driver.get(“你的校园网登录地址”) # 等待页面加载简单粗暴但有效的方式 time.sleep(2) # 方法1通过ID定位最可靠 user_input driver.find_element(By.ID, “username”) pass_input driver.find_element(By.ID, “password”) login_button driver.find_element(By.ID, “login-btn”) # 方法2通过NAME定位如果ID不存在 # user_input driver.find_element(By.NAME, “username”) # pass_input driver.find_element(By.NAME, “password”) # 方法3通过CSS选择器定位 # user_input driver.find_element(By.CSS_SELECTOR, “input[name‘username’]”) # login_button driver.find_element(By.CSS_SELECTOR, “button#login-btn”) # 方法4通过XPath定位最灵活但可能随页面结构变化而失效 # user_input driver.find_element(By.XPATH, “//input[placeholder‘请输入学号/工号’]”) # 输入凭据 user_input.send_keys(“你的用户名”) pass_input.send_keys(“你的密码”) # 点击登录 login_button.click() # 等待登录完成可以根据页面跳转或出现特定元素来判断 time.sleep(5) # 可以添加一些验证逻辑比如检查页面标题或某个登录成功后的元素 # if “登录成功” in driver.page_source: # print(“登录成功”) except Exception as e: print(f“登录过程中出现错误{e}”) finally: # 注释掉 quit方便调试时查看浏览器状态 # driver.quit() pass实操心得time.sleep是一种简单的等待但在网络不稳定或页面加载慢时可能不够或浪费。更优的做法是使用Selenium提供的“显式等待”WebDriverWait它会在指定时间内持续检查某个条件是否成立如元素出现、可点击条件满足立即继续效率更高。例如from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC wait WebDriverWait(driver, 10) # 最多等10秒 user_input wait.until(EC.presence_of_element_located((By.ID, “username”)))4. 构建健壮的自动化登录脚本一个能投入实际使用的脚本不能只是简单的定位和点击。我们需要考虑异常处理、登录状态判断、以及如何安全地管理敏感信息。4.1 核心脚本结构与错误处理下面是一个更加健壮的脚本框架import time from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.chrome.service import Service from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.common.exceptions import TimeoutException, NoSuchElementException class SrunAutoLogin: def __init__(self, login_url, username, password, driver_path‘./chromedriver.exe’): self.login_url login_url self.username username self.password password self.service Service(driver_path) self.driver None # 定义元素定位器根据你的实际页面修改 self.locators { ‘username_input’: (By.ID, ‘username’), # 替换为你的实际ID ‘password_input’: (By.ID, ‘password’), # 替换为你的实际ID ‘login_button’: (By.ID, ‘login-btn’), # 替换为你的实际ID ‘success_indicator’: (By.XPATH, “//*[contains(text(), ‘登录成功’)]”) # 登录成功后的页面特征 } def start_browser(self): “”“启动浏览器并访问登录页面”“” try: # 可以添加Chrome选项如无头模式、禁用GPU等 options webdriver.ChromeOptions() # options.add_argument(‘--headless’) # 无头模式不显示浏览器窗口 # options.add_argument(‘--disable-gpu’) # options.add_argument(‘--no-sandbox’) self.driver webdriver.Chrome(serviceself.service, optionsoptions) self.driver.get(self.login_url) print(“浏览器启动成功已导航至登录页面。”) except Exception as e: print(f“启动浏览器失败{e}”) raise def login(self): “”“执行登录操作”“” if not self.driver: print(“浏览器未启动。”) return False try: wait WebDriverWait(self.driver, 15) # 等待用户名输入框出现并输入 user_elem wait.until(EC.presence_of_element_located(self.locators[‘username_input’])) user_elem.clear() user_elem.send_keys(self.username) print(“用户名已输入。”) # 等待密码输入框出现并输入 pass_elem wait.until(EC.presence_of_element_located(self.locators[‘password_input’])) pass_elem.clear() pass_elem.send_keys(self.password) print(“密码已输入。”) # 等待登录按钮可点击并点击 login_elem wait.until(EC.element_to_be_clickable(self.locators[‘login_button’])) login_elem.click() print(“已点击登录按钮。”) # 等待登录结果 time.sleep(3) # 给页面跳转或AJAX请求一点时间 # 尝试寻找登录成功的标识 try: success_elem WebDriverWait(self.driver, 10).until( EC.presence_of_element_located(self.locators[‘success_indicator’]) ) print(“登录成功”) return True except TimeoutException: # 如果没有找到成功标识检查页面是否有错误信息 if “错误” in self.driver.page_source or “失败” in self.driver.page_source: print(“登录可能失败页面包含错误信息。”) # 可以在这里截图保存方便排查 # self.driver.save_screenshot(‘login_error.png’) else: print(“登录操作完成但未检测到明确成功标识。请手动确认网络状态。”) return False except TimeoutException as e: print(f“等待页面元素超时{e}”) return False except NoSuchElementException as e: print(f“未找到页面元素{e}”) return False except Exception as e: print(f“登录过程中发生未知错误{e}”) return False def close(self): “”“关闭浏览器”“” if self.driver: self.driver.quit() print(“浏览器已关闭。”) # 使用示例 if __name__ “__main__”: # 重要请勿将真实账号密码直接写在代码中 LOGIN_URL “http://10.0.0.1” # 替换为你的校园网登录地址 USERNAME “your_username” PASSWORD “your_password” auto_login SrunAutoLogin(LOGIN_URL, USERNAME, PASSWORD) try: auto_login.start_browser() success auto_login.login() if success: # 登录成功后可以保持浏览器打开或者执行其他操作 print(“自动化登录流程结束。”) else: print(“自动化登录未成功请检查。”) finally: # 注释掉 close() 以便调试时查看页面状态 # auto_login.close() pass4.2 安全地管理账号密码将账号密码明文写在脚本里是极不安全的尤其是如果你打算分享代码或将其放置在可能被他人访问的目录。有几种更安全的方式环境变量将账号密码设置为系统的环境变量。import os USERNAME os.environ.get(‘SRUN_USERNAME’) PASSWORD os.environ.get(‘SRUN_PASSWORD’)在运行脚本前在命令行中设置临时set SRUN_USERNAMEyour_id set SRUN_PASSWORDyour_pw或者在Windows系统属性中永久添加。配置文件使用config.ini或config.json文件存储并在.gitignore中忽略此文件防止提交到代码仓库。config.json示例{ “login_url”: “http://10.0.0.1”, “username”: “your_username”, “password”: “your_password” }代码中读取import json with open(‘config.json’, ‘r’, encoding‘utf-8’) as f: config json.load(f) USERNAME config[‘username’] PASSWORD config[‘password’]使用 keyring 库更安全将密码存储在系统的密钥管理器中如Windows Credential Manager。import keyring # 保存密码只需运行一次 # keyring.set_password(“srun_campus_net”, “username”, “your_password”) # 获取密码 PASSWORD keyring.get_password(“srun_campus_net”, USERNAME)5. 进阶定时任务、后台运行与打包分发基础脚本完成后我们可以让它更智能、更易用。5.1 实现网络状态检测与断线重连一个完整的自动化工具不应该只登录一次。理想状态是它能定时检查网络是否通畅如果发现掉线就自动重连。一个简单的思路是定期尝试访问一个公网稳定地址如http://www.baidu.com或http://connectivitycheck.gstatic.com如果失败则触发登录流程。import requests import time def check_network_connection(test_url“http://connectivitycheck.gstatic.com/generate_204”, timeout5): “”“检查网络是否连通”“” try: response requests.get(test_url, timeouttimeout) # 对于 generate_204 状态码 204 表示成功 if response.status_code in [200, 204]: return True else: return False except (requests.ConnectionError, requests.Timeout): return False def main_loop(login_instance, check_interval60): “”“主循环定期检查网络断线则重连”“” print(“开始网络监控循环...”) while True: if not check_network_connection(): print(“网络连接断开尝试重新登录...”) # 确保浏览器是打开的 if not login_instance.driver: login_instance.start_browser() login_success login_instance.login() if login_success: print(“重连成功”) else: print(“重连失败等待下次检查。”) else: print(“网络连接正常。”) time.sleep(check_interval) # 等待一段时间后再次检查 # 在主程序中整合 if __name__ “__main__”: # ... 初始化 auto_login ... auto_login.start_browser() # 先登录一次 auto_login.login() # 进入监控循环 main_loop(auto_login, check_interval300) # 每5分钟检查一次注意事项频繁请求可能会对网关服务器造成压力检查间隔check_interval建议设置在5分钟300秒或更长。requests库需要额外安装pip install requests。5.2 将脚本打包为独立的EXE文件为了让脚本在没有Python环境的Windows电脑上也能运行我们可以使用PyInstaller将其打包成单个.exe文件。安装 PyInstallerpip install pyinstaller处理 ChromeDriver 打包问题这是打包过程中的一个关键点。PyInstaller默认不会将chromedriver.exe打包进去。我们需要通过修改.spec文件或使用命令行参数来包含它。方法一推荐使用.spec文件 首先生成一个初始的.spec文件pyinstaller --onefile your_script.py这会在当前目录生成your_script.spec。编辑这个文件在a Analysis(...)部分找到datas[]修改为datas[(‘./chromedriver.exe’, ‘.’)], # 将当前目录的chromedriver.exe打包到exe的同级目录然后使用这个.spec文件重新打包pyinstaller your_script.spec方法二命令行参数适用于简单情况pyinstaller --onefile --add-data “chromedriver.exe;.” your_script.py--add-data参数格式是源文件;目标文件夹。.表示解压到exe所在的临时目录。打包命令示例pyinstaller --onefile --add-data “chromedriver.exe;.” --hidden-import selenium.webdriver.common.by --clean --name “校园网自动登录器” main.py--onefile打包成单个exe。--hidden-import显式导入某些PyInstaller可能分析不到的模块。--clean清理临时文件。--name指定生成的exe文件名。打包完成后在dist文件夹下会生成校园网自动登录器.exe。注意你需要将chromedriver.exe和这个打包后的exe放在同一个目录下运行如果用了方法一或方法二或者确保代码中能找到chromedriver.exe的路径比如使用sys._MEIPASS来获取打包后的临时资源路径。5.3 设置开机自启与后台静默运行对于需要长期后台运行的服务我们可以将其设置为Windows服务或计划任务。使用计划任务更简单创建一个批处理文件start_login.bat内容如下echo off cd /d “C:\path\to\your\script\folder” “校园网自动登录器.exe”按WinR输入taskschd.msc打开“任务计划程序”。创建基本任务触发器设置为“当用户登录时”或“计算机启动时”。操作选择“启动程序”指向上面创建的.bat文件。在“条件”和“设置”选项卡可以取消“只有在计算机使用交流电源时才启动此任务”等选项确保任务能后台执行。实现后台静默运行无头模式 在初始化ChromeOptions时添加--headlessnew参数新版Chrome推荐或--headless。options webdriver.ChromeOptions() options.add_argument(‘--headlessnew’) # 无头模式不显示GUI options.add_argument(‘--disable-gpu’) options.add_argument(‘--no-sandbox’) # 在某些Windows环境下可能需要 options.add_argument(‘--disable-dev-shm-usage’) # 解决共享内存问题 driver webdriver.Chrome(serviceservice, optionsoptions)这样浏览器将在后台运行不会弹出任何窗口非常适合部署在服务器或作为后台服务。6. 常见问题排查与优化技巧实录在实际部署和运行中你几乎一定会遇到下面这些问题。这里是我踩过坑后总结的解决方案。6.1 ChromeDriver版本不匹配或自动更新问题今天还能用的脚本明天突然报错This version of ChromeDriver only supports Chrome version XXX。原因Chrome浏览器自动更新了但ChromeDriver没有更新。解决方案禁用Chrome自动更新不推荐长期通过组策略或服务设置但可能影响安全。脚本启动时自动检测并下载推荐使用第三方库如webdriver-manager。pip install webdriver-manager修改代码from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager # 自动下载和管理匹配的ChromeDriver service Service(ChromeDriverManager().install()) driver webdriver.Chrome(serviceservice)这个库会自动检查本地Chrome版本并下载对应的ChromeDriver彻底解决版本问题。6.2 页面元素加载缓慢或动态加载导致定位失败问题使用time.sleep固定等待有时等不够有时等太久。find_element直接报NoSuchElementException。解决方案全面使用显式等待WebDriverWait这是Selenium最佳实践之一。from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC from selenium.webdriver.common.by import By wait WebDriverWait(driver, 10) # 最长等待10秒 # 等待元素出现在DOM中 element wait.until(EC.presence_of_element_located((By.ID, “dynamic-element”))) # 等待元素可见并可点击 element wait.until(EC.element_to_be_clickable((By.ID, “login-btn”))) # 等待元素包含特定文本 element wait.until(EC.text_to_be_present_in_element((By.ID, “status”), “登录成功”))显式等待比隐式等待driver.implicitly_wait和固定等待time.sleep更智能、更高效。6.3 登录后页面跳转或弹窗处理问题点击登录后页面可能跳转到新页面或者弹出认证成功的提示框。解决方案跳转使用WebDriverWait等待新页面的某个特定元素出现。弹窗AlertSelenium 可以切换到弹窗并接受或关闭。try: WebDriverWait(driver, 5).until(EC.alert_is_present()) alert driver.switch_to.alert print(f“弹窗文本{alert.text}”) alert.accept() # 点击“确定” # alert.dismiss() # 点击“取消” except TimeoutException: print(“未出现弹窗”)6.4 反爬虫机制与浏览器指纹识别问题少数校园网系统可能有简单的反自动化措施检测到Selenium的特征。应对技巧添加User-Agent模拟普通浏览器。options.add_argument(‘user-agentMozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...’)禁用自动化控制标志新版Chrome会被检测到navigator.webdriver属性。可以尝试添加实验性选项来隐藏它此方法可能随Chrome版本失效。options.add_experimental_option(“excludeSwitches”, [“enable-automation”]) options.add_experimental_option(‘useAutomationExtension’, False)使用 undetected-chromedriver这是一个专门用于绕过检测的第三方库效果很好。pip install undetected-chromedriverimport undetected_chromedriver as uc driver uc.Chrome()它的API与Selenium的webdriver.Chrome基本兼容可以作为替代方案。6.5 打包后的exe文件运行报错或找不到ChromeDriver问题在PyInstaller打包后运行exe提示WebDriverException: Message: ‘chromedriver’ executable needs to be in PATH。原因打包时资源文件路径发生了变化。在打包后的环境中需要通过sys._MEIPASS访问临时解压的资源。解决方案在代码中动态判断运行环境。import os import sys def get_chromedriver_path(): “”“获取 chromedriver.exe 的路径”“” if getattr(sys, ‘frozen’, False): # 如果是打包后的exe运行环境 base_path sys._MEIPASS else: # 如果是正常的Python脚本运行环境 base_path os.path.dirname(os.path.abspath(__file__)) chromedriver_path os.path.join(base_path, ‘chromedriver.exe’) return chromedriver_path # 使用 service Service(get_chromedriver_path())同时确保你的PyInstaller命令正确包含了chromedriver.exe文件如前面5.2节所述。6.6 登录逻辑优化与状态持久化对于需要频繁检查的脚本每次检查都打开关闭浏览器开销很大。可以优化为浏览器常驻启动浏览器后除非登录失败或遇到严重错误否则不关闭。在检查网络时复用同一个浏览器实例和页面。会话保持登录成功后Selenium持有的Cookie等会话信息会保留在浏览器实例中。只要不调用driver.quit()登录状态通常可以维持一段时间。异常恢复在main_loop中增加更健壮的异常捕获。如果浏览器意外关闭WebDriverException则尝试重新启动浏览器并登录。def robust_main_loop(login_instance, check_interval300): while True: try: # 检查浏览器是否还活着 if not login_instance.driver or not is_browser_alive(login_instance.driver): print(“浏览器会话丢失尝试重启...”) login_instance.close() # 确保清理 time.sleep(2) login_instance.start_browser() login_instance.login() # 重新登录 # 正常的网络检查逻辑 if not check_network_connection(): print(“网络断开尝试重登...”) if login_instance.login(): print(“重登成功。”) else: print(“重登失败可能页面已变化尝试重启浏览器...”) login_instance.close() time.sleep(3) continue # 跳过本次循环剩余部分下次循环会触发重启 else: print(“网络正常。”) time.sleep(check_interval) except Exception as e: print(f“主循环发生严重错误{e}”) import traceback traceback.print_exc() # 尝试清理并等待一段时间后重启 try: login_instance.close() except: pass time.sleep(60) # 等待一分钟再尝试重启循环 def is_browser_alive(driver): “”“简单检查浏览器驱动会话是否有效”“” try: # 尝试获取当前URL如果会话无效会抛出异常 driver.current_url return True except: return False这个框架将自动化脚本从一个简单的“登录工具”升级成了一个具备自我恢复能力的“网络守护进程”。它能够应对浏览器崩溃、网络波动、页面微小变化等多种异常情况真正实现无人值守的稳定运行。