尧图网站建设 
学校网一到晚上就“转圈圈”视频课加载半天网页刷不出来。这时候你不能只会抱怨得有个工具把问题量化出来到底是延迟高、丢包多还是带宽本身就不够本文就用一套现成的模板搭一个属于自己的校园网测速与诊断面板整个过程不复杂代码都能直接复制。1. 校园网变卡问题可能出在哪1.1 校园网的典型架构先弄清楚一件事校园网和你家里光猫入户的宽带不一样。校园网通常是一个典型的大规模园区网络核心交换机、汇聚交换机、接入交换机分级部署再通过校内的出口网关访问互联网。想象一下你的电脑发出一个请求数据包要经过宿舍或教学楼的接入交换机楼宇汇聚交换机校园核心交换机校园网出口网关运营商骨干网目标服务器。这中间任何一个节点出现故障、拥塞或配置错误都会表现为“网很卡”。如果每个人都只知道刷新页面问题就永远定位不了。这也是为什么要搭建一个自己的测速面板把延迟、丢包、下载速度这些指标拆开看。1.2 常见的校园网卡顿原因从实际观察来看校园网卡顿的原因通常可以分成下面几类。第一类是高峰期拥塞。晚上 19:00 到 23:00 是宿舍区用网高峰视频、游戏、网课同时跑出口带宽被占满后所有业务都会变慢。这类卡顿的特点是白天正常晚上显著变差。第二类是无线信号干扰。宿舍里路由器密集2.4GHz 频段信道重叠严重。手机连着 2.4GHz Wi-Fi 时延迟高、速率低但换成 5GHz 或网线直连后明显好转。这类问题不是校园网出口的问题而是最后一跳的问题。第三类是 DNS 解析慢。部分校园网的 DNS 服务器在高峰期响应缓慢导致打开网页要等很久但一旦解析完成后续加载又正常。这种情况只有在测 DNS 解析耗时的时候才能发现。第四类是链路丢包严重。比如某段光纤衰减、某个交换机端口异常导致数据包丢失TCP 会不断重传表现为网页打不开、视频一直缓冲。丢包率是一个比延迟更隐蔽的指标。1.3 用测速模板能解决什么前面说了这么多原因最终都需要“数据”来验证。一个简单好用的测速面板可以帮你测量到公共 DNS 或学校网关的延迟统计丢包率判断链路稳定性测试 DNS 解析耗时判断是不是解析慢测试实际下载速度判断带宽是否达标把测试结果记录下来观察不同时段的网络变化。有了这些数据你就能判断卡顿是“整个出口拥堵”还是“自己周围网络环境差”反馈给网络中心时也能拿出具体证据。2. 项目目标与功能拆解2.1 项目最终效果我们先明确目标用 Python Flask 写一个后端接口用现成的 Bootstrap 后台模板做前端页面最终打开浏览器就能看到这样一个面板顶部有一个“一键诊断”按钮中间几张卡片分别显示 Ping 延迟、丢包率、DNS 解析耗时、下载速度所有测试结果以图表/表格形式直观呈现。这个项目叫做school-net-checker整体结构很小适合在自己的电脑或一台校内服务器上运行。2.2 功能清单功能模块说明延迟测试对指定主机执行 ping返回平均延迟和丢包率DNS 解析测试解析域名 IP计算解析耗时下载速度测试从指定 URL 下载文件计算平均速度本地测速文件后端生成测试文件避免依赖外网资源前端展示面板套用 Bootstrap 模板一键诊断需要注意前端无法直接发送 ICMP 协议中的 ping所以延迟和丢包统计必须通过后端完成前端通过接口请求拿到结果后展示。2.3 技术选型说明组件选型原因后端Python Flask轻量接口写起来简单适合快速搭建系统命令ping / nslookup直接复用系统网络工具结果可靠前端Bootstrap 5 原生 JavaScript模板丰富无需打包构建适合单页工具数据存储CSV / SQLite进阶监控部分使用轻量且方便分析3. 环境准备与项目结构3.1 运行环境实际运行环境需要根据你的项目情况调整下面以常见环境为例重点演示思路操作系统Windows / Linux / macOS 均可Python 版本3.8 以上包管理器pip浏览器Chrome / Edge 等现代浏览器。在 Linux 环境执行 ping 时需要有对应系统权限在 Windows 上ping 参数略有差异文后面会说明差异点。3.2 项目结构创建项目目录结构如下school-net-checker/ ├── app.py ├── requirements.txt ├── monitor.py ├── static/ │ └── index.html └── data/ └── network_monitor.csv其中app.pyFlask 主程序提供测速相关接口requirements.txt依赖清单monitor.py定时监控脚本用于长期记录网络质量static/index.html前端展示页面data/network_monitor.csv监控历史数据脚本自动生成。3.3 准备模板资源这里的“套模板”思路是这样的你不必从零写 UI去 Bootstrap 官网或免费后台模板站下载一个 Dashboard 模板放入static目录。模板的主结构一般是!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title校园网诊断面板/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body !-- 页面内容 -- /body /html直接用 CDN 引入 Bootstrap 也算一种极简“模板”。正文示例会基于这个结构展开你可以随时替换成自己喜欢的 AdminLTE 或 BootstrapStudio 风格模板。4. 核心实现前后端测速面板4.1 安装依赖在项目目录下创建requirements.txtflask2.0 requests2.25然后安装依赖pip install -r requirements.txt4.2 编写 Flask 后端接口在项目根目录创建app.py。这个文件承担所有网络诊断逻辑。文件路径school-net-checker/app.pyimport re import time import socket import subprocess import requests from flask import Flask, jsonify, request, Response, send_from_directory app Flask(__name__) # 默认下载测速地址可以改成校内镜像或本机生成的测试文件 SPEED_TEST_URL http://127.0.0.1:5000/download/test.bin def parse_loss(output: str) - str: 从 ping 输出中解析丢包率兼容中英文输出。 m re.search(r([\d.])%\s*(?:packet loss|丢包), output, re.IGNORECASE) return m.group(1) % if m else 未知 def parse_latency(output: str) - list: 从 ping 输出中解析所有延迟时间兼容 timexx ms 和 时间xx ms 两种格式。 times re.findall(r(?:time|时间)[]\s*([\d.])\s*ms, output, re.IGNORECASE) return [round(float(t), 2) for t in times] app.route(/) def index(): 返回前端页面。 return send_from_directory(static, index.html) app.route(/api/ping, methods[GET]) def api_ping(): 对目标主机执行 ping 测试返回延迟与丢包率。 host request.args.get(host, www.baidu.com) # 只允许主机名/域名/IP避免命令注入 if not re.match(r^[a-zA-Z0-9._-]$, host): return jsonify({code: 1, message: host参数包含非法字符}), 400 start time.time() try: # Linux/macOS 使用 -c 指定次数Windows 需要改成 -n cmd [ping, -c, 4, -W, 2000, host] result subprocess.run(cmd, capture_outputTrue, textTrue, timeout15) output result.stdout result.stderr times parse_latency(output) loss_rate parse_loss(output) return jsonify({ code: 0, host: host, times: times, loss_rate: loss_rate, elapsed_ms: round((time.time() - start) * 1000, 2) }) except subprocess.TimeoutExpired: return jsonify({code: 2, message: ping 命令执行超时}), 500 except Exception as e: return jsonify({code: 3, message: str(e)}), 500 app.route(/api/dns, methods[GET]) def api_dns(): 解析域名返回 IP 及解析耗时。 host request.args.get(host, www.baidu.com) if not re.match(r^[a-zA-Z0-9._-]$, host): return jsonify({code: 1, message: host参数包含非法字符}), 400 try: start time.time() ip socket.gethostbyname(host) cost_ms round((time.time() - start) * 1000, 2) return jsonify({ code: 0, host: host, ip: ip, dns_ms: cost_ms }) except socket.gaierror: return jsonify({code: 1, message: f无法解析域名 {host}}), 400 app.route(/api/speed, methods[GET]) def api_speed(): 从指定 URL 下载测速文件计算平均下载速度。 url request.args.get(url, SPEED_TEST_URL) try: start time.time() with requests.get(url, streamTrue, timeout10) as r: r.raise_for_status() total 0 for chunk in r.iter_content(chunk_size128 * 1024): total len(chunk) cost time.time() - start speed_mbps round(total * 8 / cost / 1000 / 1000, 2) return jsonify({ code: 0, url: url, download_bytes: total, cost_s: round(cost, 2), speed_mbps: speed_mbps }) except Exception as e: return jsonify({code: 1, message: str(e)}), 500 TEST_FILE_SIZE 50 * 1024 * 1024 # 50MB app.route(/download/test.bin) def download_test_file(): 生成一个 50MB 的测试文件用于局域网内测速。 def generate(): chunk b0123456789abcdef * (64 * 1024) sent 0 while sent TEST_FILE_SIZE: yield chunk sent len(chunk) return Response( generate(), mimetypeapplication/octet-stream, headers{Content-Length: str(TEST_FILE_SIZE)} ) if __name__ __main__: # 这里用 debugFalse避免调试进程重复执行网络测试 app.run(host0.0.0.0, port5000, debugFalse)4.2.1 代码中的几个关键点第一parse_latency和parse_loss使用正则表达式解析ping命令的输出。这是因为不同系统的ping输出格式不一样用正则匹配time或时间后面的数值兼容相对好一些。第二对host参数做了白名单校验。这里直接拼接系统命令如果不做校验传入; rm -rf /之类的内容会导致危险后果。生产环境必须对参数做严格限制。第三download/test.bin接口使用生成器返回固定大小的测试文件。这样在同一台机器上可以直接用/api/speed测试本机接口的速度也可以让局域网内其他设备访问。如果你用的是 Windows 系统需要把ping命令参数改一下cmd [ping, -n, 4, -w, 2000, host]-w后面单位是毫秒。macOS / Linux 使用-W单位也是毫秒但参数名大小写不同。4.3 编写前端模板页面前端页面static/index.html是整个项目里最有“模板感”的部分。我们使用 Bootstrap 5 的卡片和表格组件把测速结果分区展示。文件路径school-net-checker/static/index.html!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title校园网诊断面板/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body classbg-light div classcontainer py-4 div classrow mb-4 div classcol h4 classmb-0校园网诊断面板/h4 p classtext-muted延迟、丢包、DNS、下载速度一键检测/p /div div classcol-auto button idbtnStart classbtn btn-primary btn-lg onclickstartDiagnose() 开始诊断 /button /div /div div classrow g-3 div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-title平均延迟/h6 p idavgLatency classdisplay-6--/p span classtext-muted单位ms/span /div /div /div div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-title丢包率/h6 p idlossRate classdisplay-6--/p span classtext-muted越低越好/span /div /div /div div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-titleDNS 解析/h6 p iddnsMs classdisplay-6--/p span classtext-muted单位ms/span /div /div /div div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-title下载速度/h6 p idspeedMbps classdisplay-6--/p span classtext-muted单位Mbps/span /div /div /div /div div classcard shadow-sm mt-4 div classcard-header当前结果/div div classcard-body pre idrawResult classmb-0等待诊断.../pre /div /div /div script const DEFAULT_HOST www.baidu.com; const SPEED_URL /download/test.bin; async function requestJSON(url) { const resp await fetch(url); if (!resp.ok) { throw new Error(HTTP ${resp.status}); } return resp.json(); } async function startDiagnose() { const btn document.getElementById(btnStart); btn.disabled true; btn.innerText 诊断中...; const raw document.getElementById(rawResult); raw.innerText 正在对 DEFAULT_HOST 执行 ping...; try { // 1. Ping 测试 const pingData await requestJSON(/api/ping?host${DEFAULT_HOST}); const avg pingData.times.length 0 ? (pingData.times.reduce((a, b) a b, 0) / pingData.times.length).toFixed(2) : --; document.getElementById(avgLatency).innerText avg; document.getElementById(lossRate).innerText pingData.loss_rate; // 2. DNS 测试 raw.innerText \n正在进行 DNS 解析...; const dnsData await requestJSON(/api/dns?host${DEFAULT_HOST}); document.getElementById(dnsMs).innerText dnsData.dns_ms; // 3. 下载测速 raw.innerText \n正在进行下载测速...; const speedData await requestJSON(/api/speed?url${SPEED_URL}); document.getElementById(speedMbps).innerText speedData.speed_mbps; raw.innerText JSON.stringify({ ping: pingData, dns: dnsData, speed: speedData }, null, 2); } catch (e) { raw.innerText 诊断失败 e.message; } finally { btn.disabled false; btn.innerText 开始诊断; } } /script /body /html4.3.1 前端页面的逻辑说明点击“开始诊断”按钮后前端依次调用三个接口/api/ping测试指定域名的延迟和丢包/api/dns解析域名计算 DNS 耗时/api/speed从后端下载测试文件算出网速。每个请求完成后再更新对应卡片。你可能会问为什么下载测速要使用后端转发而不是直接下载文件因为如果直接在浏览器里用a标签下载页面会跳转或触发浏览器下载管理器不方便自动化获取实时速率。让后端请求测试文件并统计字节数最后返回 JSON前端只需要解析结果即可。4.4 运行与验证在项目根目录执行python app.py然后浏览器打开http://127.0.0.1:5000点击“开始诊断”正常情况下会依次输出延迟、DNS 解析耗时和下载速度。如果你在局域网内想让手机也测试需要把app.py中host0.0.0.0保持现状然后手机浏览器访问http://你的电脑局域网IP:5000例如http://192.168.1.100:50004.5 结果说明假设测试结果如下{ ping: { code: 0, host: www.baidu.com, times: [12.3, 10.8, 11.5, 11.2], loss_rate: 0%, elapsed_ms: 52.1 }, dns: { code: 0, host: www.baidu.com, ip: 110.242.68.66, dns_ms: 8.5 }, speed: { code: 0, url: /download/test.bin, download_bytes: 52428800, cost_s: 6.21, speed_mbps: 67.56 } }平均延迟 11ms 左右说明网络链路质量好丢包率 0%说明没有明显丢包DNS 解析 8.5ms解析服务器响应正常下载速度 67.56Mbps对于校园网来说处于正常水平。5. 进阶网络质量定时监控脚本手动点击诊断只能看到当前时刻的网络状态。要判断校园网到底是“一直卡”还是“某个时段卡”建议写一个定时监控脚本把每次测量结果写入 CSV方便之后用 Excel 或 Python 分析。5.1 设计思路监控脚本每 30 秒执行一次每次做三件事ping 目标地址记录平均延迟和丢包率解析目标域名的 DNS 耗时把时间和结果追加写入 CSV。后台用nohup或任务计划程序保持运行。CSV 文件按行追加不覆盖历史数据。5.2 数据采集代码文件路径school-net-checker/monitor.pyimport csv import re import time import socket import subprocess import datetime TARGET_HOST www.baidu.com INTERVAL 30 OUTPUT_FILE data/network_monitor.csv # 确保 data 目录存在 import os os.makedirs(data, exist_okTrue) def get_ping_result(host: str) - tuple: 执行 ping返回 (平均延迟ms, 丢包率) try: cmd [ping, -c, 4, -W, 2000, host] result subprocess.run(cmd, capture_outputTrue, textTrue, timeout15) output result.stdout result.stderr times re.findall(r(?:time|时间)[]\s*([\d.])\s*ms, output, re.IGNORECASE) times [float(t) for t in times] avg_ms round(sum(times) / len(times), 2) if times else loss_match re.search(r([\d.])%\s*(?:packet loss|丢包), output, re.IGNORECASE) loss_rate loss_match.group(1) if loss_match else return avg_ms, loss_rate except Exception: return , def get_dns_cost(host: str) - float: 解析域名耗时单位 ms try: start time.time() socket.gethostbyname(host) return round((time.time() - start) * 1000, 2) except Exception: return def write_row(row: list): file_exists os.path.exists(OUTPUT_FILE) with open(OUTPUT_FILE, a, newline, encodingutf-8) as f: writer csv.writer(f) if not file_exists: writer.writerow([timestamp, host, avg_latency_ms, loss_rate, dns_ms]) writer.writerow(row) if __name__ __main__: print(f开始监控 {TARGET_HOST}每 {INTERVAL} 秒记录一次...) while True: now datetime.datetime.now().strftime(%Y-%m-%d %H:%M:%S) avg_ms, loss_rate get_ping_result(TARGET_HOST) dns_ms get_dns_cost(TARGET_HOST) write_row([now, TARGET_HOST, avg_ms, loss_rate, dns_ms]) print(f[{now}] 延迟{avg_ms}ms 丢包{loss_rate}% DNS{dns_ms}ms) time.sleep(INTERVAL)5.3 启动与数据分析Linux / macOS 后台运行nohup python monitor.py monitor.log 21 Windows 可以直接开着命令行窗口或者用任务计划程序开机启动。运行一段时间后用 Python 读取 CSV 并绘图import pandas as pd import matplotlib.pyplot as plt df pd.read_csv(data/network_monitor.csv) df[timestamp] pd.to_datetime(df[timestamp]) df.set_index(timestamp, inplaceTrue) df[avg_latency_ms].plot() plt.title(校园网延迟变化) plt.ylabel(ms) plt.show()如果缺少 pandas先安装pip install pandas matplotlib把延迟变化曲线画出来之后你会很直观地看到哪些时间段延迟高、哪些时间段丢包率高这就是校园网“卡顿规律”的第一手证据。6. 使用 LibreSpeed 快速自建测速服务器如果你不想写代码还有一个更“模板化”的现成方案LibreSpeed。它是一个开源测速程序界面做得比较完善后端也支持 PHP 和 Docker 两种部署方式。6.1 LibreSpeed 是什么LibreSpeed 是一个轻量级自托管速度测试工具前端界面非常像 Speedtest但它没有第三方记录数据完全部署在自己的服务器上。由于测速文件在自己手里测试结果更能反映到当前服务器之间的链路质量。6.2 模板式部署如果学校有一台 Linux 服务器已经装了 Docker最简单的部署方式是docker run -d --name librespeed -p 8080:80 adolfintel/speedtest浏览器访问http://服务器IP:8080如果 8080 端口被占用改成其他端口比如docker run -d --name librespeed -p 9000:80 adolfintel/speedtest本机访问http://localhost:9000没有 Docker 的情况下也可以下载官方源码放到 PHP 环境的 Web 目录中运行。官方 GitHub 仓库会提供最新的部署说明。由于项目迭代较快请以官方文档为准。6.3 与自建面板的配合LibreSpeed 适合给自己和同学提供“快速测速”入口但它不提供延迟、丢包、DNS 解析这些网络诊断指标。如果你想实现“一键诊断 实时监控”还是建议用前面的 Flask 面板。两者可以共存LibreSpeed 负责测速Flask 面板负责诊断和记录历史。7. 常见问题与排查思路问题现象常见原因解决思路Ping 测试提示“无法解析域名”系统 DNS 配置异常先执行nslookup www.baidu.com确认 DNS 是否工作下载速度为 0测速文件 URL 无法访问检查/download/test.bin是否能直接访问浏览器报跨域错误前端和后端端口不一致把前端页面直接由 Flask 托管而不是另开静态服务器页面样式丢失Bootstrap CDN 被墙或加载慢下载 Bootstrap 文件到本地static目录引用高峰期测得速度低出口带宽拥塞对比非高峰时段的数据确认是时段性问题局域网手机测速很慢Wi-Fi 信号差或连接的是 2.4GHz改用 5GHz Wi-Fi 或网线直连测试后台日志出现大量超时探测目标主机不允许 ping更换探测目标为校内网关或公共 DNS如 223.5.5.57.1 关于命令注入的提醒后端接口里的host参数直接拼接进了ping命令这是很多新手容易忽略的安全点。虽然示例代码做了白名单校验但如果你要在公网或半公开环境部署不要放松这块的防护。更严谨的做法是只允许从配置文件中读取目标地址前端只能选择预设的测试目标不能任意输入。7.2 关于校园网合法性的说明校园网通常由学校网络中心统一管理测试网络质量是你作为使用者的正当需求。使用本文方案时请确保只在你自己有权使用的设备和网络范围内测试不要绕过学校网络认证或计费系统不要在校园网内做持续高压测速影响公共带宽长期监控脚本只在个人电脑上运行不部署到未授权服务器。8. 工程建议与注意事项8.1 测速文件应该放在哪里下载速度测试的准确性很大程度上取决于测速文件和服务器的距离。想让测试反映宿舍到校园网出口的真实带宽最好把测速文件放在校园网内部一台带宽充裕的服务器上。这样测出的速度代表“你到校内节点的速度”。如果放在外网测出来的其实是“你到该外网站点的端到端速度”受国际出口、运营商互联等影响。8.2 使用反向代理Flask 内置的开发服务器并不适合长时间对外提供访问。如果要在宿舍或服务器上长期跑建议使用 Nginx 反向代理server { listen 80; server_name your-server-ip; location / { proxy_pass http://127.0.0.1:5000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }Nginx 负责处理静态文件和并发连接Flask 只负责提供接口稳定性会好很多。8.3 监控数据保留与清理长期监控会产生大量 CSV 数据。建议设置一个保留周期比如只保留最近 30 天# 每天 03:00 删除 30 天前的监控数据Linux crontab 示例 0 3 * * * find /path/to/school-net-checker/data -name *.csv -mtime 30 -exec rm {} \;8.4 不要滥用并发请求有人在宿舍开多个线程同时跑测速想“逼出”更高带宽。这种做法既不能证明带宽不够还可能被网络中心判定为异常流量。正确做法是单线程测速并且多次测量取平均值。8.5 数据解读大于数据展示面板上显示的数字本身没有太大意义关键是学会对比白天和晚上同一时段对比有线网和无线网对比自己电脑和室友电脑对比不同 DNS 服务器对比。只有形成对比才能知道卡顿发生在哪一层。9. 总结这次用 Flask 加 Bootstrap 模板做的校园网测速面板已经实现了延迟、丢包、DNS、下载速度四个核心指标的测试。代码量不大它最大的价值在于把“感觉网卡”变成了可量化的数据。建议先在自己电脑上跑通然后把它部署到一台常开的机器上配合定时监控脚本记录几天数据。等发现明显规律后再带着数据和学校网络中心沟通问题定位会高效很多。下一步可以继续学习的内容包括用 Grafana 做更漂亮的监控大屏、用 SQLite 替代 CSV 存储历史数据、增加多目标节点测速等。网络排查这件事数据越丰富结论越接近真相。 自建校园网测速诊断面板：量化延迟、丢包与DNS解析
学校网一到晚上就“转圈圈”视频课加载半天网页刷不出来。这时候你不能只会抱怨得有个工具把问题量化出来到底是延迟高、丢包多还是带宽本身就不够本文就用一套现成的模板搭一个属于自己的校园网测速与诊断面板整个过程不复杂代码都能直接复制。1. 校园网变卡问题可能出在哪1.1 校园网的典型架构先弄清楚一件事校园网和你家里光猫入户的宽带不一样。校园网通常是一个典型的大规模园区网络核心交换机、汇聚交换机、接入交换机分级部署再通过校内的出口网关访问互联网。想象一下你的电脑发出一个请求数据包要经过宿舍或教学楼的接入交换机楼宇汇聚交换机校园核心交换机校园网出口网关运营商骨干网目标服务器。这中间任何一个节点出现故障、拥塞或配置错误都会表现为“网很卡”。如果每个人都只知道刷新页面问题就永远定位不了。这也是为什么要搭建一个自己的测速面板把延迟、丢包、下载速度这些指标拆开看。1.2 常见的校园网卡顿原因从实际观察来看校园网卡顿的原因通常可以分成下面几类。第一类是高峰期拥塞。晚上 19:00 到 23:00 是宿舍区用网高峰视频、游戏、网课同时跑出口带宽被占满后所有业务都会变慢。这类卡顿的特点是白天正常晚上显著变差。第二类是无线信号干扰。宿舍里路由器密集2.4GHz 频段信道重叠严重。手机连着 2.4GHz Wi-Fi 时延迟高、速率低但换成 5GHz 或网线直连后明显好转。这类问题不是校园网出口的问题而是最后一跳的问题。第三类是 DNS 解析慢。部分校园网的 DNS 服务器在高峰期响应缓慢导致打开网页要等很久但一旦解析完成后续加载又正常。这种情况只有在测 DNS 解析耗时的时候才能发现。第四类是链路丢包严重。比如某段光纤衰减、某个交换机端口异常导致数据包丢失TCP 会不断重传表现为网页打不开、视频一直缓冲。丢包率是一个比延迟更隐蔽的指标。1.3 用测速模板能解决什么前面说了这么多原因最终都需要“数据”来验证。一个简单好用的测速面板可以帮你测量到公共 DNS 或学校网关的延迟统计丢包率判断链路稳定性测试 DNS 解析耗时判断是不是解析慢测试实际下载速度判断带宽是否达标把测试结果记录下来观察不同时段的网络变化。有了这些数据你就能判断卡顿是“整个出口拥堵”还是“自己周围网络环境差”反馈给网络中心时也能拿出具体证据。2. 项目目标与功能拆解2.1 项目最终效果我们先明确目标用 Python Flask 写一个后端接口用现成的 Bootstrap 后台模板做前端页面最终打开浏览器就能看到这样一个面板顶部有一个“一键诊断”按钮中间几张卡片分别显示 Ping 延迟、丢包率、DNS 解析耗时、下载速度所有测试结果以图表/表格形式直观呈现。这个项目叫做school-net-checker整体结构很小适合在自己的电脑或一台校内服务器上运行。2.2 功能清单功能模块说明延迟测试对指定主机执行 ping返回平均延迟和丢包率DNS 解析测试解析域名 IP计算解析耗时下载速度测试从指定 URL 下载文件计算平均速度本地测速文件后端生成测试文件避免依赖外网资源前端展示面板套用 Bootstrap 模板一键诊断需要注意前端无法直接发送 ICMP 协议中的 ping所以延迟和丢包统计必须通过后端完成前端通过接口请求拿到结果后展示。2.3 技术选型说明组件选型原因后端Python Flask轻量接口写起来简单适合快速搭建系统命令ping / nslookup直接复用系统网络工具结果可靠前端Bootstrap 5 原生 JavaScript模板丰富无需打包构建适合单页工具数据存储CSV / SQLite进阶监控部分使用轻量且方便分析3. 环境准备与项目结构3.1 运行环境实际运行环境需要根据你的项目情况调整下面以常见环境为例重点演示思路操作系统Windows / Linux / macOS 均可Python 版本3.8 以上包管理器pip浏览器Chrome / Edge 等现代浏览器。在 Linux 环境执行 ping 时需要有对应系统权限在 Windows 上ping 参数略有差异文后面会说明差异点。3.2 项目结构创建项目目录结构如下school-net-checker/ ├── app.py ├── requirements.txt ├── monitor.py ├── static/ │ └── index.html └── data/ └── network_monitor.csv其中app.pyFlask 主程序提供测速相关接口requirements.txt依赖清单monitor.py定时监控脚本用于长期记录网络质量static/index.html前端展示页面data/network_monitor.csv监控历史数据脚本自动生成。3.3 准备模板资源这里的“套模板”思路是这样的你不必从零写 UI去 Bootstrap 官网或免费后台模板站下载一个 Dashboard 模板放入static目录。模板的主结构一般是!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title校园网诊断面板/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body !-- 页面内容 -- /body /html直接用 CDN 引入 Bootstrap 也算一种极简“模板”。正文示例会基于这个结构展开你可以随时替换成自己喜欢的 AdminLTE 或 BootstrapStudio 风格模板。4. 核心实现前后端测速面板4.1 安装依赖在项目目录下创建requirements.txtflask2.0 requests2.25然后安装依赖pip install -r requirements.txt4.2 编写 Flask 后端接口在项目根目录创建app.py。这个文件承担所有网络诊断逻辑。文件路径school-net-checker/app.pyimport re import time import socket import subprocess import requests from flask import Flask, jsonify, request, Response, send_from_directory app Flask(__name__) # 默认下载测速地址可以改成校内镜像或本机生成的测试文件 SPEED_TEST_URL http://127.0.0.1:5000/download/test.bin def parse_loss(output: str) - str: 从 ping 输出中解析丢包率兼容中英文输出。 m re.search(r([\d.])%\s*(?:packet loss|丢包), output, re.IGNORECASE) return m.group(1) % if m else 未知 def parse_latency(output: str) - list: 从 ping 输出中解析所有延迟时间兼容 timexx ms 和 时间xx ms 两种格式。 times re.findall(r(?:time|时间)[]\s*([\d.])\s*ms, output, re.IGNORECASE) return [round(float(t), 2) for t in times] app.route(/) def index(): 返回前端页面。 return send_from_directory(static, index.html) app.route(/api/ping, methods[GET]) def api_ping(): 对目标主机执行 ping 测试返回延迟与丢包率。 host request.args.get(host, www.baidu.com) # 只允许主机名/域名/IP避免命令注入 if not re.match(r^[a-zA-Z0-9._-]$, host): return jsonify({code: 1, message: host参数包含非法字符}), 400 start time.time() try: # Linux/macOS 使用 -c 指定次数Windows 需要改成 -n cmd [ping, -c, 4, -W, 2000, host] result subprocess.run(cmd, capture_outputTrue, textTrue, timeout15) output result.stdout result.stderr times parse_latency(output) loss_rate parse_loss(output) return jsonify({ code: 0, host: host, times: times, loss_rate: loss_rate, elapsed_ms: round((time.time() - start) * 1000, 2) }) except subprocess.TimeoutExpired: return jsonify({code: 2, message: ping 命令执行超时}), 500 except Exception as e: return jsonify({code: 3, message: str(e)}), 500 app.route(/api/dns, methods[GET]) def api_dns(): 解析域名返回 IP 及解析耗时。 host request.args.get(host, www.baidu.com) if not re.match(r^[a-zA-Z0-9._-]$, host): return jsonify({code: 1, message: host参数包含非法字符}), 400 try: start time.time() ip socket.gethostbyname(host) cost_ms round((time.time() - start) * 1000, 2) return jsonify({ code: 0, host: host, ip: ip, dns_ms: cost_ms }) except socket.gaierror: return jsonify({code: 1, message: f无法解析域名 {host}}), 400 app.route(/api/speed, methods[GET]) def api_speed(): 从指定 URL 下载测速文件计算平均下载速度。 url request.args.get(url, SPEED_TEST_URL) try: start time.time() with requests.get(url, streamTrue, timeout10) as r: r.raise_for_status() total 0 for chunk in r.iter_content(chunk_size128 * 1024): total len(chunk) cost time.time() - start speed_mbps round(total * 8 / cost / 1000 / 1000, 2) return jsonify({ code: 0, url: url, download_bytes: total, cost_s: round(cost, 2), speed_mbps: speed_mbps }) except Exception as e: return jsonify({code: 1, message: str(e)}), 500 TEST_FILE_SIZE 50 * 1024 * 1024 # 50MB app.route(/download/test.bin) def download_test_file(): 生成一个 50MB 的测试文件用于局域网内测速。 def generate(): chunk b0123456789abcdef * (64 * 1024) sent 0 while sent TEST_FILE_SIZE: yield chunk sent len(chunk) return Response( generate(), mimetypeapplication/octet-stream, headers{Content-Length: str(TEST_FILE_SIZE)} ) if __name__ __main__: # 这里用 debugFalse避免调试进程重复执行网络测试 app.run(host0.0.0.0, port5000, debugFalse)4.2.1 代码中的几个关键点第一parse_latency和parse_loss使用正则表达式解析ping命令的输出。这是因为不同系统的ping输出格式不一样用正则匹配time或时间后面的数值兼容相对好一些。第二对host参数做了白名单校验。这里直接拼接系统命令如果不做校验传入; rm -rf /之类的内容会导致危险后果。生产环境必须对参数做严格限制。第三download/test.bin接口使用生成器返回固定大小的测试文件。这样在同一台机器上可以直接用/api/speed测试本机接口的速度也可以让局域网内其他设备访问。如果你用的是 Windows 系统需要把ping命令参数改一下cmd [ping, -n, 4, -w, 2000, host]-w后面单位是毫秒。macOS / Linux 使用-W单位也是毫秒但参数名大小写不同。4.3 编写前端模板页面前端页面static/index.html是整个项目里最有“模板感”的部分。我们使用 Bootstrap 5 的卡片和表格组件把测速结果分区展示。文件路径school-net-checker/static/index.html!DOCTYPE html html langzh-CN head meta charsetUTF-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 title校园网诊断面板/title link hrefhttps://cdn.jsdelivr.net/npm/bootstrap5.3.0/dist/css/bootstrap.min.css relstylesheet /head body classbg-light div classcontainer py-4 div classrow mb-4 div classcol h4 classmb-0校园网诊断面板/h4 p classtext-muted延迟、丢包、DNS、下载速度一键检测/p /div div classcol-auto button idbtnStart classbtn btn-primary btn-lg onclickstartDiagnose() 开始诊断 /button /div /div div classrow g-3 div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-title平均延迟/h6 p idavgLatency classdisplay-6--/p span classtext-muted单位ms/span /div /div /div div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-title丢包率/h6 p idlossRate classdisplay-6--/p span classtext-muted越低越好/span /div /div /div div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-titleDNS 解析/h6 p iddnsMs classdisplay-6--/p span classtext-muted单位ms/span /div /div /div div classcol-md-3 div classcard shadow-sm div classcard-body h6 classcard-title下载速度/h6 p idspeedMbps classdisplay-6--/p span classtext-muted单位Mbps/span /div /div /div /div div classcard shadow-sm mt-4 div classcard-header当前结果/div div classcard-body pre idrawResult classmb-0等待诊断.../pre /div /div /div script const DEFAULT_HOST www.baidu.com; const SPEED_URL /download/test.bin; async function requestJSON(url) { const resp await fetch(url); if (!resp.ok) { throw new Error(HTTP ${resp.status}); } return resp.json(); } async function startDiagnose() { const btn document.getElementById(btnStart); btn.disabled true; btn.innerText 诊断中...; const raw document.getElementById(rawResult); raw.innerText 正在对 DEFAULT_HOST 执行 ping...; try { // 1. Ping 测试 const pingData await requestJSON(/api/ping?host${DEFAULT_HOST}); const avg pingData.times.length 0 ? (pingData.times.reduce((a, b) a b, 0) / pingData.times.length).toFixed(2) : --; document.getElementById(avgLatency).innerText avg; document.getElementById(lossRate).innerText pingData.loss_rate; // 2. DNS 测试 raw.innerText \n正在进行 DNS 解析...; const dnsData await requestJSON(/api/dns?host${DEFAULT_HOST}); document.getElementById(dnsMs).innerText dnsData.dns_ms; // 3. 下载测速 raw.innerText \n正在进行下载测速...; const speedData await requestJSON(/api/speed?url${SPEED_URL}); document.getElementById(speedMbps).innerText speedData.speed_mbps; raw.innerText JSON.stringify({ ping: pingData, dns: dnsData, speed: speedData }, null, 2); } catch (e) { raw.innerText 诊断失败 e.message; } finally { btn.disabled false; btn.innerText 开始诊断; } } /script /body /html4.3.1 前端页面的逻辑说明点击“开始诊断”按钮后前端依次调用三个接口/api/ping测试指定域名的延迟和丢包/api/dns解析域名计算 DNS 耗时/api/speed从后端下载测试文件算出网速。每个请求完成后再更新对应卡片。你可能会问为什么下载测速要使用后端转发而不是直接下载文件因为如果直接在浏览器里用a标签下载页面会跳转或触发浏览器下载管理器不方便自动化获取实时速率。让后端请求测试文件并统计字节数最后返回 JSON前端只需要解析结果即可。4.4 运行与验证在项目根目录执行python app.py然后浏览器打开http://127.0.0.1:5000点击“开始诊断”正常情况下会依次输出延迟、DNS 解析耗时和下载速度。如果你在局域网内想让手机也测试需要把app.py中host0.0.0.0保持现状然后手机浏览器访问http://你的电脑局域网IP:5000例如http://192.168.1.100:50004.5 结果说明假设测试结果如下{ ping: { code: 0, host: www.baidu.com, times: [12.3, 10.8, 11.5, 11.2], loss_rate: 0%, elapsed_ms: 52.1 }, dns: { code: 0, host: www.baidu.com, ip: 110.242.68.66, dns_ms: 8.5 }, speed: { code: 0, url: /download/test.bin, download_bytes: 52428800, cost_s: 6.21, speed_mbps: 67.56 } }平均延迟 11ms 左右说明网络链路质量好丢包率 0%说明没有明显丢包DNS 解析 8.5ms解析服务器响应正常下载速度 67.56Mbps对于校园网来说处于正常水平。5. 进阶网络质量定时监控脚本手动点击诊断只能看到当前时刻的网络状态。要判断校园网到底是“一直卡”还是“某个时段卡”建议写一个定时监控脚本把每次测量结果写入 CSV方便之后用 Excel 或 Python 分析。5.1 设计思路监控脚本每 30 秒执行一次每次做三件事ping 目标地址记录平均延迟和丢包率解析目标域名的 DNS 耗时把时间和结果追加写入 CSV。后台用nohup或任务计划程序保持运行。CSV 文件按行追加不覆盖历史数据。5.2 数据采集代码文件路径school-net-checker/monitor.pyimport csv import re import time import socket import subprocess import datetime TARGET_HOST www.baidu.com INTERVAL 30 OUTPUT_FILE data/network_monitor.csv # 确保 data 目录存在 import os os.makedirs(data, exist_okTrue) def get_ping_result(host: str) - tuple: 执行 ping返回 (平均延迟ms, 丢包率) try: cmd [ping, -c, 4, -W, 2000, host] result subprocess.run(cmd, capture_outputTrue, textTrue, timeout15) output result.stdout result.stderr times re.findall(r(?:time|时间)[]\s*([\d.])\s*ms, output, re.IGNORECASE) times [float(t) for t in times] avg_ms round(sum(times) / len(times), 2) if times else loss_match re.search(r([\d.])%\s*(?:packet loss|丢包), output, re.IGNORECASE) loss_rate loss_match.group(1) if loss_match else return avg_ms, loss_rate except Exception: return , def get_dns_cost(host: str) - float: 解析域名耗时单位 ms try: start time.time() socket.gethostbyname(host) return round((time.time() - start) * 1000, 2) except Exception: return def write_row(row: list): file_exists os.path.exists(OUTPUT_FILE) with open(OUTPUT_FILE, a, newline, encodingutf-8) as f: writer csv.writer(f) if not file_exists: writer.writerow([timestamp, host, avg_latency_ms, loss_rate, dns_ms]) writer.writerow(row) if __name__ __main__: print(f开始监控 {TARGET_HOST}每 {INTERVAL} 秒记录一次...) while True: now datetime.datetime.now().strftime(%Y-%m-%d %H:%M:%S) avg_ms, loss_rate get_ping_result(TARGET_HOST) dns_ms get_dns_cost(TARGET_HOST) write_row([now, TARGET_HOST, avg_ms, loss_rate, dns_ms]) print(f[{now}] 延迟{avg_ms}ms 丢包{loss_rate}% DNS{dns_ms}ms) time.sleep(INTERVAL)5.3 启动与数据分析Linux / macOS 后台运行nohup python monitor.py monitor.log 21 Windows 可以直接开着命令行窗口或者用任务计划程序开机启动。运行一段时间后用 Python 读取 CSV 并绘图import pandas as pd import matplotlib.pyplot as plt df pd.read_csv(data/network_monitor.csv) df[timestamp] pd.to_datetime(df[timestamp]) df.set_index(timestamp, inplaceTrue) df[avg_latency_ms].plot() plt.title(校园网延迟变化) plt.ylabel(ms) plt.show()如果缺少 pandas先安装pip install pandas matplotlib把延迟变化曲线画出来之后你会很直观地看到哪些时间段延迟高、哪些时间段丢包率高这就是校园网“卡顿规律”的第一手证据。6. 使用 LibreSpeed 快速自建测速服务器如果你不想写代码还有一个更“模板化”的现成方案LibreSpeed。它是一个开源测速程序界面做得比较完善后端也支持 PHP 和 Docker 两种部署方式。6.1 LibreSpeed 是什么LibreSpeed 是一个轻量级自托管速度测试工具前端界面非常像 Speedtest但它没有第三方记录数据完全部署在自己的服务器上。由于测速文件在自己手里测试结果更能反映到当前服务器之间的链路质量。6.2 模板式部署如果学校有一台 Linux 服务器已经装了 Docker最简单的部署方式是docker run -d --name librespeed -p 8080:80 adolfintel/speedtest浏览器访问http://服务器IP:8080如果 8080 端口被占用改成其他端口比如docker run -d --name librespeed -p 9000:80 adolfintel/speedtest本机访问http://localhost:9000没有 Docker 的情况下也可以下载官方源码放到 PHP 环境的 Web 目录中运行。官方 GitHub 仓库会提供最新的部署说明。由于项目迭代较快请以官方文档为准。6.3 与自建面板的配合LibreSpeed 适合给自己和同学提供“快速测速”入口但它不提供延迟、丢包、DNS 解析这些网络诊断指标。如果你想实现“一键诊断 实时监控”还是建议用前面的 Flask 面板。两者可以共存LibreSpeed 负责测速Flask 面板负责诊断和记录历史。7. 常见问题与排查思路问题现象常见原因解决思路Ping 测试提示“无法解析域名”系统 DNS 配置异常先执行nslookup www.baidu.com确认 DNS 是否工作下载速度为 0测速文件 URL 无法访问检查/download/test.bin是否能直接访问浏览器报跨域错误前端和后端端口不一致把前端页面直接由 Flask 托管而不是另开静态服务器页面样式丢失Bootstrap CDN 被墙或加载慢下载 Bootstrap 文件到本地static目录引用高峰期测得速度低出口带宽拥塞对比非高峰时段的数据确认是时段性问题局域网手机测速很慢Wi-Fi 信号差或连接的是 2.4GHz改用 5GHz Wi-Fi 或网线直连测试后台日志出现大量超时探测目标主机不允许 ping更换探测目标为校内网关或公共 DNS如 223.5.5.57.1 关于命令注入的提醒后端接口里的host参数直接拼接进了ping命令这是很多新手容易忽略的安全点。虽然示例代码做了白名单校验但如果你要在公网或半公开环境部署不要放松这块的防护。更严谨的做法是只允许从配置文件中读取目标地址前端只能选择预设的测试目标不能任意输入。7.2 关于校园网合法性的说明校园网通常由学校网络中心统一管理测试网络质量是你作为使用者的正当需求。使用本文方案时请确保只在你自己有权使用的设备和网络范围内测试不要绕过学校网络认证或计费系统不要在校园网内做持续高压测速影响公共带宽长期监控脚本只在个人电脑上运行不部署到未授权服务器。8. 工程建议与注意事项8.1 测速文件应该放在哪里下载速度测试的准确性很大程度上取决于测速文件和服务器的距离。想让测试反映宿舍到校园网出口的真实带宽最好把测速文件放在校园网内部一台带宽充裕的服务器上。这样测出的速度代表“你到校内节点的速度”。如果放在外网测出来的其实是“你到该外网站点的端到端速度”受国际出口、运营商互联等影响。8.2 使用反向代理Flask 内置的开发服务器并不适合长时间对外提供访问。如果要在宿舍或服务器上长期跑建议使用 Nginx 反向代理server { listen 80; server_name your-server-ip; location / { proxy_pass http://127.0.0.1:5000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }Nginx 负责处理静态文件和并发连接Flask 只负责提供接口稳定性会好很多。8.3 监控数据保留与清理长期监控会产生大量 CSV 数据。建议设置一个保留周期比如只保留最近 30 天# 每天 03:00 删除 30 天前的监控数据Linux crontab 示例 0 3 * * * find /path/to/school-net-checker/data -name *.csv -mtime 30 -exec rm {} \;8.4 不要滥用并发请求有人在宿舍开多个线程同时跑测速想“逼出”更高带宽。这种做法既不能证明带宽不够还可能被网络中心判定为异常流量。正确做法是单线程测速并且多次测量取平均值。8.5 数据解读大于数据展示面板上显示的数字本身没有太大意义关键是学会对比白天和晚上同一时段对比有线网和无线网对比自己电脑和室友电脑对比不同 DNS 服务器对比。只有形成对比才能知道卡顿发生在哪一层。9. 总结这次用 Flask 加 Bootstrap 模板做的校园网测速面板已经实现了延迟、丢包、DNS、下载速度四个核心指标的测试。代码量不大它最大的价值在于把“感觉网卡”变成了可量化的数据。建议先在自己电脑上跑通然后把它部署到一台常开的机器上配合定时监控脚本记录几天数据。等发现明显规律后再带着数据和学校网络中心沟通问题定位会高效很多。下一步可以继续学习的内容包括用 Grafana 做更漂亮的监控大屏、用 SQLite 替代 CSV 存储历史数据、增加多目标节点测速等。网络排查这件事数据越丰富结论越接近真相。