潮汐 Tidal · 在线网络工具箱
测网速、查延迟、看局域网里谁在线上
打开网页就能用
不用安装任何东西。手机、平板、电脑打开同一个网址， 就能测延迟与丢包、跑带宽测试，看看局域网里有哪些设备在线。
无需安装客户端
手机 / 平板 / 电脑同一网址
当前延迟 -- ms
数据来自服务器实时探测
技术详情
Reactor 运行中 · epoll LT · 2 workers
HTTP :8080
HTTPS :443 · Let's Encrypt 证书
keep-alive 60s
LOCAL TELEMETRY / CONNECTING
网络运行态势
所有数字均来自服务器实时探测，每 15 秒刷新一次，刷新时间与数据来源标注在本卡片底部。
活跃连接--
引擎运行时长--
累计请求--
探测目标健康度
--
等待本地接口响应
以下为 基准测试结果 · 2026-09-19，服务器单机实测，不是当前实时指标。
并发连接稳定
0+
峰值吞吐
0 req/s
P99 延迟
0 ms
测试通过
0/6
网络诊断
延迟 · 测速 · 目标探测
设备监控
配对 · 在线状态 · 主机视角
性能测试
压测数据 · 极限指标
资产与链路
AIDC · 硬件清单 · 物理链路 · 一键排障
设备接入
AIDC · 交换机厂商识别
跨层监控平台
检测集群状态中… · CPU/GPU/网络曲线 · 告警 · 拓扑
最近任务
诊断任务自动归档 · 本地保存最近 50 条还没有诊断任务。开始一次检测，系统会自动生成报告和证据链。
连通性测试
发送 /ping 请求，测量往返延迟
点击按钮开始测试
服务健康
运行时长、连接数、总请求数
—
客户端信息
你的公网出口 IP、端口和请求头
—
下载测速
下载 2 MiB 数据，计算带宽
—
上传测速
上传 1 MiB 数据，计算带宽
—
请求头回显
查看服务器收到的 Header
—
目标探测
服务器主动探测目标主机可达性
输入目标后开始探测
宽带测速
延迟抖动 → 下载 → 上传，实时仪表盘；测量浏览器与本机服务器之间的真实吞吐
0.00
Mbps
点击下方按钮开始
⬇ 下载速率
—
⬆ 上传速率
—
⏱ 延迟（RTT）
—
〰 抖动（Jitter）
—
当前连接信息
历史记录（本机保存最近 10 次）
测速完成后自动记录
说明：测速结果为浏览器 ↔ 本服务器之间的吞吐，受本机网络栈限制。
若部署到公网服务器，则测得的是你到该服务器的真实网速。下载大小 2 MiB，上传大小 1 MiB。
目标探测由服务器以非阻塞 connect + poll 发起（worker 线程执行，超时默认 3s），可探测任意 host:port。
主机视角
哪台设备登录，哪台就是主机（不限于电脑）；登录后可查看已配对设备并生成配对码
未登录
本机上报（自动）
打开本页即已自动开始心跳，无需任何操作；改个名字立即生效
未开启自动上报 —— 点击右侧按钮开始
我管理的主机组（下属设备）
你是主机：可看到所有绑定到你名下的设备 · 每 3 秒刷新| 设备名称 | IP 地址 | MAC 地址 | 网络延迟 | 登录地址 | 网速 | 状态 | 最后心跳 | 操作 |
|---|---|---|---|---|---|---|---|---|
我加入的上级主机组
你是成员：只能看到主机与你自己 · 可随时退出该组| 角色 | 设备名称 | IP 地址 | MAC 地址 | 网络延迟 | 登录地址 | 网速 | 状态 | 最后心跳 | 操作 |
|---|---|---|---|---|---|---|---|---|---|
配对机制（保持不变）：① 任何设备都可点「生成设备配对码」，它就成为主机，得到一个 6 位一次性码（5 分钟有效）；
② 其他设备点「输入配对码加入上级主机组」，输入码即绑定到该主机名下，此后自动心跳上报；
③ 主机可随时「移除」下属设备，设备也可自行「退出上级组」。
层级与可见性：主机本身也可以加入别的主机组，两个身份互不影响，分两个板块显示。 主机能看到自己名下全部下级（含下级的下级）；成员只能看到主机和自己。
字段来源：名称可自定义；IP 为连接对端地址；MAC 从服务器 ARP 表实时查询（对方近期无通信时可能查不到）； 网络延迟为浏览器请求 RTT；登录地址为设备访问本系统的网址；网速取自该设备在「宽带测速」里的最近一次真实结果（未测速则显示未测速）。 注册表保存在服务器内存，服务重启后需重新配对。
层级与可见性：主机本身也可以加入别的主机组，两个身份互不影响，分两个板块显示。 主机能看到自己名下全部下级（含下级的下级）；成员只能看到主机和自己。
字段来源：名称可自定义；IP 为连接对端地址；MAC 从服务器 ARP 表实时查询（对方近期无通信时可能查不到）； 网络延迟为浏览器请求 RTT；登录地址为设备访问本系统的网址；网速取自该设备在「宽带测速」里的最近一次真实结果（未测速则显示未测速）。 注册表保存在服务器内存，服务重启后需重新配对。
局域网设备（自动发现）
类似家用路由器的"已连接设备"页 · 无需其他设备安装或上报
这是什么？主机登录后，服务器读取本机的 ARP 表（WSL2 下同时读取 Windows 的
arp.exe -a，两者是同一个局域网的视角），再对所在网段做一轮并发 ping 扫描，
让沉默的设备也进入 ARP 缓存。结果列出最近与网络通信过的设备：IP、MAC、厂商（OUI 识别）、主机名（尽力反解）。
手机随机化 MAC、路由器开启 AP 隔离、或网段较大时可能发现不全——这是真实网络的物理限制，不是程序错误。
权限与使用范围：此操作由服务器发起网络探测（ARP 读取 + ICMP ping 扫描）。
仅对你拥有管理权限的网络使用，未经授权扫描他人网络可能违反法律法规。
需要主机登录 · 扫描约需 5–30 秒
| IP 地址 | MAC 地址 | 厂商 | 主机名 | 标记 | 来源 |
|---|---|---|---|---|---|
| 登录主机视角后可扫描 | |||||
目标监控状态
C++ Scheduler 周期检测 · 每 5 秒自动刷新
这是什么？服务器每 5 秒主动"敲门"检查一批公共服务的连通性：
Ping 检测网络可达（223.5.5.5 是阿里公共 DNS）、TCP 检查端口是否开放、HTTP(S) 检查网站是否正常响应。
ONLINE = 正常 · OFFLINE = 对方拒绝连接 · TIMEOUT = 无响应。
目标分三组：核心目标计入首页健康度总分；本机可选自检（如容器内 HTTPS——
容器部署时 TLS 由前置 Nginx 终结，8443 本就不监听）显示「未启用」不标红；
fault-probe 是故意保留的演示故障探针（端口上恒无服务），显示「✓ 预期离线」，
与真实故障严格区分，不计入健康度。
| 目标 | 类型 | 状态 | 延迟 | 详情 / 错误 | 最后检测 |
|---|---|---|---|---|---|
历史统计
检测次数 / 成功失败 / 失败率 / 延迟分布（内存保留最近 120 条）| 目标 | 检测 | 成功 | 失败 | 失败率 | 最小 | 平均 | 最大 |
|---|---|---|---|---|---|---|---|
服务器连接明细
每连接 IP/端口/时长/收发流量/请求数| #ID | 客户端 | 时长 | RX | TX | 请求数 | 类型 | 状态 |
|---|---|---|---|---|---|---|---|
网卡与 TCP 状态
实时读取 /proc/net/dev 与 /proc/net/tcp网卡流量
TCP 状态
说明：目标列表由 config/targets.json 配置（type 支持 ping / tcp / http(s)），
Scheduler 线程每 interval 秒把全部目标并发提交到线程池检测（支持 timeout 与 retry），
核心检测逻辑全部由 C++ 完成。ping 使用 ICMP（/bin/ping 子进程）；tcp 为非阻塞 connect + poll；
http/https 走真实 DNS → TCP → TLS 握手 → HTTP 请求链路并分段计时。
客户端
TCP/IPv4
TCP/IPv4
→
epoll Reactor
单线程
单线程
→
HTTP 解析
GET/Content-Length
GET/Content-Length
→
线程池队列
文件 I/O
文件 I/O
Worker 线程
→
完成队列 + eventfd
→
Reactor 发送响应
→
客户端
设计要点：Reactor 是唯一操作 Socket 和 epoll_ctl 的线程。
Worker 只读取已验证的静态文件并构造响应，结果通过 eventfd 唤醒 Reactor。
连接世代 ID + 请求 ID 防止 fd 复用时旧结果落到新连接上。
运行时状态
事件模型epoll LT / ET
监听端口本机 8080 · 公网 80 / 443
工作线程2
完成通知eventfd
优雅退出SIGINT / SIGTERM
已实现能力
非阻塞 Socket✓
HTTP/1.1 GET✓
HTTPS / TLS 1.2+✓
keep-alive 持久连接✓
400 / 404 / 500✓
路径穿越防护✓
尚未测试 —— 登录主机视角后点击按钮发起第一次实测（约 30 秒），本页不预留任何结果
这张表在测什么？用压测脚本
每一列的含义： Requests = 5 秒内完成的总请求数； RPS = 每秒完成的请求数（吞吐量，越高越好）； 平均 / P95 / P99 (ms) = 请求耗时。平均是"一般感受"，P95/P99 是"最差的 5%/1% 请求也不慢于多少毫秒"—— P99 更能暴露卡顿：平均值很低但 P99 很高，说明偶发掉队； CPU % = 压测期间服务器进程平均占用一个核的百分比； RSS KB = 进程峰值内存占用。
五行模式的区别： epoll LT / ET 是两种事件通知方式：LT（水平触发，默认）"没处理完会一直提醒"，稳妥； ET（边缘触发）"只在状态变化时提醒一次"，代码必须一次把数据读写完，理论上更省系统调用； 0 workers 表示不用线程池，Reactor 单线程亲自读文件、拼响应（同步基线）； 1 / 2 workers 把文件读取和响应拼装交给线程池，Reactor 专职收发事件； keep-alive 表示一个连接可以连续发多个请求，省去每个请求一次的 TCP 三次握手。
怎么读这张表：重点看三组对比—— ① 0 workers → 2 workers：线程池带来的吞吐提升； ② LT → ET：事件模型差异在本机场景下是否明显； ③ 短连接 → keep-alive：连接复用省掉握手的收益（延迟通常显著下降）。 每台机器的绝对数值不同（CPU、文件大小都会影响），但相对趋势在任何机器上是一致的。
scripts/benchmark.py 在服务器本机启动一个压测客户端，
以 16 个并发连接持续 5 秒反复请求同一个静态文件，然后统计服务器在 5 种并发模型下的表现。
请求走本机回环（127.0.0.1，不经过外部网络），所以它衡量的是服务器软件自身的调度与 I/O 开销，
而不是你家宽带的速度。每一列的含义： Requests = 5 秒内完成的总请求数； RPS = 每秒完成的请求数（吞吐量，越高越好）； 平均 / P95 / P99 (ms) = 请求耗时。平均是"一般感受"，P95/P99 是"最差的 5%/1% 请求也不慢于多少毫秒"—— P99 更能暴露卡顿：平均值很低但 P99 很高，说明偶发掉队； CPU % = 压测期间服务器进程平均占用一个核的百分比； RSS KB = 进程峰值内存占用。
五行模式的区别： epoll LT / ET 是两种事件通知方式：LT（水平触发，默认）"没处理完会一直提醒"，稳妥； ET（边缘触发）"只在状态变化时提醒一次"，代码必须一次把数据读写完，理论上更省系统调用； 0 workers 表示不用线程池，Reactor 单线程亲自读文件、拼响应（同步基线）； 1 / 2 workers 把文件读取和响应拼装交给线程池，Reactor 专职收发事件； keep-alive 表示一个连接可以连续发多个请求，省去每个请求一次的 TCP 三次握手。
怎么读这张表：重点看三组对比—— ① 0 workers → 2 workers：线程池带来的吞吐提升； ② LT → ET：事件模型差异在本机场景下是否明显； ③ 短连接 → keep-alive：连接复用省掉握手的收益（延迟通常显著下降）。 每台机器的绝对数值不同（CPU、文件大小都会影响），但相对趋势在任何机器上是一致的。
| 模式 | Requests | RPS | 平均 ms | P95 ms | P99 ms | CPU % | RSS KB |
|---|---|---|---|---|---|---|---|
|
尚无测试结果 点击上方「在当前主机开始实测」，服务器才会真实压测并回传第一批数据 |
|||||||
测试脚本为
scripts/benchmark.py，仅使用 Python 标准库。
短连接模式每次请求新建 TCP 连接；keep-alive 模式每个客户端复用一条连接。
固定 5 秒、并发 16，服务器单独运行，五行数据来自同环境同批次实测。
数据为 WSL2 本地单次快照，非生产容量承诺。
高峰期不卡顿
上百人同时访问也互不拖慢——慢的连接不会影响别人。背后是 epoll 非阻塞 I/O（LT/ET 双模式）。
越用越快
连接用完不立即断开，下一次请求直接复用、免去重复握手。实测吞吐提升约 3 倍（keep-alive）。
传输全程加密
支持 HTTPS，数据在网络上不可被窃听、篡改（TLS 1.2+，浏览器地址栏小锁标志）。
重活后台干
大文件与网络探测交给后台线程处理，不耽误接待新访客（线程池 + eventfd 完成通知）。
什么设备都能用
手机、平板、电脑打开同一个网址即可，还能自动识别并区分不同设备（HTTP/HTTPS 双端口）。
抗折腾
半途断开、恶意请求、超大报文都会被安全处理，服务不中断（请求校验 + 防护限制）。
全程留痕
每次访问、每次检测、每次异常都有日志记录，出了问题可以回溯（结构化 KV 日志）。
配置即改即用
端口、线程数、监控密码写在配置文件里，改完重启生效，不用动一行代码（server.conf）。
改坏有报警
自动化测试覆盖核心流程，每次改动都跑回归验证，质量有保障（CTest 6/6 · ASan/UBSan）。
这个页面在讲什么：实施路线是潮汐引擎本身的建造时间线——
按顺序讲述它怎样从一个最简单的 socket 程序，逐步长出 epoll 事件循环、HTTP 解析、
线程池、TLS 与 keep-alive，每一步做了什么、用什么方式验证。它不是
「连接主机 / 检查主机」的操作过程；设备如何接入、如何检查，请见
「开发者说明」中的全栈解释与接入指南。
Phase 1
TCP 服务器 — socket/bind/listen/accept/recv/send，单客户端收发与异常断开处理。
Phase 2
epoll 事件循环 — 非阻塞 fd、epoll_create/ctl/wait，LT/ET 双模式实验，100+ 连接稳定。
Phase 3
HTTP 解析 — 请求行/Header/Content-Length 解析，GET、404、400、500 响应。
Phase 4
线程池 — worker 线程、任务队列、互斥锁、条件变量、优雅停止。
Phase 5
工程化 — CMake、config、logger、signal、RAII、统一错误码、单元测试。
Phase 6
性能测试 — 三组对比（同步 / epoll / epoll+线程池），记录 RPS、延迟、CPU、内存。
追加
HTTPS/TLS — 双端口监听、非阻塞 SSL_accept 握手状态机、TLS 1.2+；keep-alive — RFC 7230 持久连接、空闲超时扫描（默认 60s，0 禁用）。
后续
sendfile 零拷贝、静态文件缓存、Docker 部署。
// Reactor 主循环 while (!g_stop_requested) { const int ready = epoll_wait(epoll_fd_, events, kMaxEvents, 1000); for (int i = 0; i < ready; ++i) { if (fd == listen_fd_) accept_clients(); else if (fd == completion_fd_) handle_completion_event(); else handle_client_event(fd, events); } } // Worker 完成后通过 eventfd 通知 Reactor enqueue_completion({fd, conn_id, req_id, status, std::move(response)}); const uint64_t signal = 1; write(completion_fd_, &signal, sizeof(signal));
关键约束：worker 绝不直接操作 Socket 或调用 epoll_ctl。所有连接状态变更由 Reactor 单线程完成。
开发者说明
这个网页是怎么来的 · 面向好奇者与开发者这是什么
潮汐 Tidal 是一台用 C++17 从零手写的 Linux 网络服务器。 没有 Web 框架，也没有第三方网络库：从 epoll 原语起步，亲手实现 HTTP 解析、 线程池、TLS 加密与实时监控。你现在看到的这个页面，就是由它直接返回的单文件 HTML，没有任何前端框架与外部依赖；页面上的每一次检测，都是真实发生的网络请求。
它同时也是一个面向数据中心网络的实验与诊断平台：本网址把三件事放在一起—— 引擎本体（潮汐）、真实数据中心场景（AIDC：硬件清单 / 设备接入 / 链路诊断）、 数据中心网络实验室（DC-Lab：学习档案 / 光链路排错）。本页按全栈视角解释它们如何协同、如何使用。
一次请求的完整旅程
以你刚才打开本页为例，从敲下网址到看到画面，数据走过了这样一条全链路：
- 建立连接：浏览器向服务器发起 TCP 三次握手（走 HTTPS 时还会先完成 TLS 握手）。监听 socket 上的事件由
epoll_wait返回，Reactor 在accept_clients()中接收连接，并把新连接 fd 设为非阻塞后注册进 epoll。 - 读取请求：连接上数据到达后触发可读事件，
handle_client_event()循环 recv 字节到该连接的接收缓冲区。epoll 支持 LT 与 ET 两种触发模式，ET 下必须一次读到 EAGAIN。 - 解析 HTTP：手写的解析器逐字节解析请求行（方法 / 路径）、Header 与 Content-Length，拼出一个完整的请求对象；畸形报文在这里被拦下并返回 400。
- 路由与分派：服务器按路径决定谁来处理：静态页面直接读文件返回；轻量 API 在 Reactor 线程内即时计算；压测、网络探测这类耗时任务则被打包扔进线程池，Reactor 立刻回去接待其他连接。
- 后台执行：worker 线程完成任务（比如打开 TCP 连向一台交换机、跑一组压测），但它绝不直接碰 socket——结果连同连接标识一起写入完成队列，并向
eventfd写一个 1。 - 回到 Reactor：主循环被 eventfd 唤醒，在
handle_completion_event()中取出完成项，由 Reactor 单线程把响应发回给对应的连接，状态变更同样只在这里发生。 - 浏览器呈现：响应到达浏览器，HTML 被渲染；页面 JS 再发起若干 JSON 请求填充各项数据。keep-alive 连接在空闲超时前可以继续复用，不必反复握手。
这条链路就是「Reactor + 线程池 + eventfd」模式的全部要点：单线程处理连接状态，多线程处理阻塞任务，
用一个 8 字节的 eventfd 把结果安全送回主循环。
这个网址的完整地图
左侧导航看似有很多页，实际只分三条主线，全部由同一个二进制直接提供（「跨层监控平台」是独立部署的子站，以新标签页外链打开）：
| 主线 | 页面 | 回答什么问题 |
|---|---|---|
| 工具箱 | 工作台 / 连通性诊断 / 局域网扫描 / 性能测试 / 设备监控 / 网络接口 / 光链路 / 资产与链路 / 设备接入 | 网络通不通、快不快、局域网里有什么、这台机器连了哪些设备 |
| 项目档案 | 架构总览 / 核心特性 / 实施路线 / 核心代码 / 开发者说明 | 它内部怎么实现、跑多快、按什么顺序建成 |
| 实验记录 | 学习档案 | 数据中心网络怎么学、报文长什么样 |
API 端点索引
所有端点由同一个 C++ HTTP 解析器直接处理，无框架。证据列标注数据来源：实时 = 当前机器真实读取，登录 = 需要主机视角会话。
| 方法 | 路径 | 权限 | 作用 | 证据 |
|---|---|---|---|---|
GET | / | 公开 | 返回单文件前端 HTML | 实时 |
GET | /ping | 公开 | 延迟测试（RTT） | 实时 |
GET | /health | 公开 | 服务健康与启动时间 | 实时 |
GET | /api/links | 公开 | 网络接口状态（admin/carrier/speed/duplex/mtu） | 实时 · /sys/class/net |
GET | /api/optics | 公开 | 光模块 EEPROM 与 DDM（仅物理主机） | 实时 · ethtool |
POST | /api/lan/scan | 登录 | 局域网设备发现（ARP + ping 扫描 + OUI） | 实时 · /proc/net/arp |
GET | /api/benchmark | 公开 | epoll 性能基准（5 种模式对比） | 实时 · 回环压测 |
POST | /login | 公开 | 主机视角登录（monitor_password） | 实时 |
POST | /logout | 公开 | 退出登录 | 实时 |
POST | /pair/generate | 登录 | 生成 6 位配对码 | 实时 |
POST | /pair/revoke | 登录 | 撤销配对码 | 实时 |
GET | /monitor | 登录 | 主机视角会话验证 | 实时 |
超时行为：耗时端点（
/api/lan/scan、/api/benchmark）走 deferred task 线程池，
客户端应设置 30–90 秒超时；其它端点均在 Reactor 线程内即时返回（< 10ms）。
接入指南（一）：设备如何接入潮汐
「主机视角」是本平台的设备组织模型：一台主机作为主控台，其他设备通过配对码加入它。
- 创建主机视角：在主机上打开本页，先在顶部登录账户（电话/邮箱），再点击「登录主机视角 → 创建新的主机视角」，已登录账户直接授权创建，无需输入监控密码。成功后得到 24 小时有效的会话 cookie，本设备即成为主控台。
未登录账户仍可用config/server.conf中monitor_password的密码创建（后备路径）。 - 生成配对码：主控台在「主机视角」页发起配对，服务器生成一个 6 位数字配对码，5 分钟内有效、一次性使用。
- 设备加入：新设备打开同一个网址，点击「登录主机视角 → 输入配对码加入」，输入 6 位码。它还会带上自己的设备标识（浏览器本地生成的 device id）与自动识别的名称，调用
/pair/claim完成登记。 - 保持在线：加入后的设备定时向
/agent/beat发送心跳；主控台在/monitor中看到所有在线设备，也可以撤销某台设备的接入。
设计上：创建路径只属于主控台；已登录账户直接授权，未登录账户需监控密码（后备）；普通设备只需要一个 6 位码，不需要知道密码。
接入指南（二）：DC-Lab 实验成果如何接入本网址
DC-Lab 是用 Linux network namespace + FRRouting 搭建的纯软件数据中心网络实验室： Spine-Leaf 拓扑、VXLAN 隧道、EVPN 控制面、多租户 IRB，全部跑在一台机器里。 实验过程中产生的 Markdown 报告、命令记录与 pcap 抓包，按下面的方式组织，「学习档案」页就能直接呈现：
- 写阶段报告：每个阶段产出一份 Markdown，放入
datacenter-network-lab/docs/，说明本阶段解决什么问题、怎么验证。 - 留存报文证据：关键协议的抓包放入
datacenter-network-lab/captures/，命名体现阶段与协议（如p8_evpn.pcap）。 - 汇总知识库：
knowledge/下的build_knowledge_db.py把各阶段的概念、命令、实测断言、报文路径汇总为knowledge.json。 - 页面自动呈现：「学习档案」页 fetch 这份 JSON，渲染阶段卡片；Markdown 报告通过页内阅览器直接排版显示，pcap 可点击下载用 Wireshark 打开。
想接入自己的实验成果，不需要改前端：按同样结构补充 Markdown、pcap 与 knowledge.json 条目即可。
更多学习文稿持续整理中，后续文稿都会以页内 Markdown 阅览的方式加入。
接入指南（三）：AIDC 真实硬件与设备如何接入
AIDC 三页分别对应数据中心现场的三类工作，全部基于真实读取与真实连接，没有模拟数据：
- 硬件清单（资产盘点）：直接读取运行服务主机的
/proc/cpuinfo、/proc/meminfo、/sys/class/net、/proc/net/arp等系统文件，得到 CPU、内存、网卡、MAC、ARP 邻居与默认网关。把服务部署到哪台主机，盘点的就是哪台主机。 - 设备接入（识别网络设备）：输入交换机 / 路由器的管理 IP，服务器对其 22（SSH）与 23（Telnet）端口发起真实 TCP 连接，抓取登录横幅（banner），按特征识别华为 VRP、H3C Comware、Cisco IOS、Juniper 等厂商。无需账号密码，不改动设备配置。
- 链路诊断（分段排障）：按「网卡 → 默认网关 → 公网 DNS」的顺序逐段探测，哪一步断，问题就在哪一段。
- 光链路（热插监控）：通过
/sys/class/net与 ethtool EEPROM 监测接口 UP/DOWN、速率与光模块 DDM 信息。物理网线与光模块的具体接入方式见「光链路排错」页顶部的操作说明。
WSL2 与物理机的区别：本项目运行在 WSL2 中时，看到的网卡是宿主机映射的虚拟 NIC，
无法接触真实 SFP 光模块笼；光模块 present / DDM 数据只有在裸金属 Linux 物理主机上部署时才能读到。
这一区别会如实显示，不会用假数据填充。
在自己的机器上运行
需要 Linux 环境（物理机、虚拟机或 WSL2 均可）、CMake 与 OpenSSL 开发库：
cmake -B build
cmake --build build
./build/tcp_server 8080 --tls
启动后 HTTP 监听 8080；直接运行时可加 --tls 用自签证书在 8443 提供 HTTPS
（浏览器会提示证书不受信任）。云端部署则由前置 Nginx 在 443 上终结 TLS，
证书来自 Let's Encrypt，浏览器无警告。
端口、线程数、监控密码、keep-alive 等配置项集中在 config/server.conf，
文件内有逐项注释，改完重启生效，无需改代码。日志写入 logs/。
源码地图与扩展点
src/：服务器主体（Reactor、HTTP 解析、路由、监控、配对、压测调度均在此）；include/：头文件。tests/：CTest 集成测试，覆盖核心请求流程；scripts/：压测脚本、故障注入、benchmark 工具。docs/：版本验收报告；www/：本网页静态文件；datacenter-network-lab/：实验室环境与成果。- 加一个新 API：在
src/tcp_server.cpp的路由分派处增加路径与处理逻辑（耗时任务走submit_deferred_task）。 - 加一个新页面：在
www/index.html增加一个.panel、在侧边栏加一个.tab、并在viewTitles映射中登记，三处即可。
附录：HTTP API 速查
API 是理解系统的结果，不是使用系统的入口——先读懂上面的全链路，再看这张表。 除标注 POST 外均为 GET，返回 JSON：
- 基础：
/ping·/health·/ip·/headers·/connections - 链路体验：
/speed/download?size=N·/speed/upload·/probe/tcp?host=H&port=P·/probe/http?host=H - 主机与网络：
/netdev·/netstat·/api/links·/api/optics·/api/targets·/api/status·/api/metrics·/api/history - AIDC：
/hwinfo·/probe/device?host=H - 设备与配对（POST 为主）：
/login·/pair/offer·/pair/claim·/pair/revoke·/agent/beat·/monitor - 性能实测：
POST /api/benchmark（需主控台登录，约 30 秒返回五组模式数据）
资产与链路
你的设备（浏览器侧采集） · 云机硬件资产 · 物理链路状态 · 一键链路排障 ☁️ 云机数据你这台设备
由你的浏览器主动采集并上报 · 需你先授权 · 可随时撤回并删除 👤 你的设备主机硬件读取
CPU、内存、内核、网卡与 ARP 邻居
点击按钮读取
物理链路状态
插网线即测 · 网卡 carrier / 速率 / 双工 · /api/links物理链路检测
读取所有网卡的 carrier（是否插线）、协商速率、双工模式
点击按钮读取所有网卡链路状态
| 接口 | 类型 | Carrier | 速率 | 双工 | 状态 | MTU |
|---|---|---|---|---|---|---|
| 点击按钮开始检测 | ||||||
一键链路诊断
网卡 → 网关 → 外网，逐段定位故障自动链路排查
按顺序检查网卡状态、网关连通、外网可达
点击按钮开始
说明：硬件数据来自服务器宿主机真实系统文件——
CPU 型号与核心数来自
/proc/cpuinfo，内存来自 /proc/meminfo，
网卡名称/MAC/状态来自 /sys/class/net，ARP 邻居与默认网关来自
/proc/net/arp 与 /proc/net/route。
物理链路读取 /sys/class/net/<网卡>/carrier（1=链路建立，0=未插线）。
链路诊断按「分段定位，先近后远」思路：① 网卡与路由 → ② 默认网关 → ③ 公网 DNS，三步逐段定位。
设备接入
两条真实接入路径：网络设备管理通道 · 计算节点 Agent；不做模拟接入路径一 · 网络设备管理通道
用网线连通交换机/路由器的管理 IP，抓 SSH(22)/Telnet(23) 横幅识别厂商
输入管理 IP 后开始探测
路径二 · 计算节点 Agent 接入
Agent 通过 --connect-type 指定接入方式；每 5 秒从 Collector 实时同步在线状态
仅用于生成下方启动命令，不会自动启动 Agent
注意：仅仅打开本页面不算接入。计算节点必须真实启动 Agent 并在 Collector（9090）注册成功，
对应接入方式卡片才会亮起绿点并列出节点；在线节点达到 ≥1 后，左侧「跨层监控平台」才可点击进入。
RDMA 高速网络 · InfiniBand / RoCE
GPU 集合通信底座 · 点击检测本机 RDMA 设备（读取 /sys/class/infiniband） ☁️ 云机数据RDMA 设备检测
检测 InfiniBand HCA / RoCE 网卡、端口链路层与速率（真实 sysfs 读取）
点击检测本机是否有 InfiniBand HCA 或 RoCE 网卡
RDMA 是什么：远程直接内存访问——网卡把数据直接写进远端应用的内存，绕过 CPU 与内核协议栈（kernel bypass），零拷贝、微秒级延迟。
InfiniBand 是原生 IB 网络（HCA + IB 交换机），天生无损；
RoCEv2 让 RDMA 跑在 UDP/IP/以太网上，需要无损以太网配套：PFC 优先级流控 + ECN/DCQCN 拥塞控制（RoCEv1 不可路由，已少见）。
AIDC 为什么关心：多机训练的 All-Reduce / All-Gather 走 RDMA，网络抖动会直接表现为 GPU 利用率掉下去。
🖥️ 本机自检（这不是集群节点接入）
只想看这台电脑自己的 CPU / 内存 / 网卡 / GPU 情况，请使用「资产与链路」。 该操作仅读本台主机，不会注册为 AIDC 集群节点，也不会出现在上方接入方式里。
识别原理：路径一由服务器对目标设备的 22（SSH）与 23（Telnet）管理端口发起真实 TCP 连接，
抓取登录横幅（banner）并按特征识别厂商——华为 VRP、H3C Comware、Cisco IOS、Juniper、OpenSSH/Dropbear 等，
无需账号密码，也不改动设备配置。完整 SSH 命令行管理（批量下发配置、采集运行状态）需引入 libssh，属于后续 AIDC 阶段计划。
DC-Lab 数据中心网络 · 学习档案
Spine-Leaf → EVPN 控制面 → 多租户 IRB · 内容实时读取自知识库自主学习成果总览
10 个阶段 · 167 项实测断言全部通过 · 每阶段含概念/命令/实测/报文证据
AIDC 网络工程师知识体系
13 大分支 · 涵盖 DC-Lab 基础 + AIDC 全链路（RDMA / InfiniBand / RoCE / 无损网络 / GPU 互联 / 集合通信 / 集群设计 / 监控调优）· 点击节点查看「必须理解 / 必须观察 / 必须验证」四列表点击左侧知识节点查看详细要求。
学习过程
十个阶段依次在解决什么问题 · 点击任意节点展开下方对应阶段档案学习文稿
Markdown 原文 · 点击在页内直接排版阅览
更多学习文稿持续整理中：后续以 Markdown 提供的学习笔记，会经梳理串通后加入此处，
并配以时间轴与动态示意，保持「读得下去、能跟着做」的阅读体验。
报文证据索引
captures/ 下全部抓包 · 点击下载后用 Wireshark 打开| 文件 | 阶段 / 内容 | 操作 |
|---|---|---|
evpn.pcap | EVPN 路由协议报文 | 下载 pcap |
vxlan.pcap | VXLAN 封装与租户数据 | 下载 pcap |
p8_bgp.pcap | 阶段 8 · BGP 报文 | 下载 pcap |
p8_evpn.pcap | 阶段 8 · EVPN 报文 | 下载 pcap |
p8_ospf.pcap | 阶段 8 · OSPF 报文 | 下载 pcap |
p8_data.pcap | 阶段 8 · 数据面报文 | 下载 pcap |
VXLAN / EVPN 实测分镜
动画是已有软件实验 pcap 的教学索引；只有“证据”链接与原始命令可作为实测依据
验收边界：本分镜使用 WSL2 + Linux namespace + FRRouting 实验拓扑，不代表已在物理交换机生产网验证。控制面路由存在是数据面可转发的前提，不等于单独证明每一条业务流已成功。
阶段档案
展开查看每阶段的概念 / 命令 / 实测观察 / 报文结构AIDC 动画演示专区
RDMA 通信 · RoCEv2 封装 · AllReduce Ring · PFC/ECN 拥塞控制 · 逐帧动画 + SVG 拓扑演示
专区说明：以下动画演示用于理解 AIDC 网络的核心流程——从 GPU 显存到远端内存的完整路径、
RoCEv2 帧的逐层封装、AllReduce Ring 算法的梯度同步过程、以及 PFC/ECN 拥塞控制闭环。
每个流程都有 SVG 动态拓扑图和逐帧讲解，点击步骤切换帧。
光链路 · 硬件热插排错
插入光模块 / 光网线即自动识别 · 数据来自 /sys/class/net 与 ethtool EEPROM
实时监测中
轮询间隔 3s
✅ 本页「光链路」管的范围
主机网卡口 ↔ 对端交换机 / 路由器之间的那一段物理连接：光纤（SFP/QSFP 光模块 + 双芯光纤）或电口（RJ45 双绞线）。
验证的是：模块插没插、光功率正不正常、速率协没协商、VLAN 通不通、到网关这一跳活没活 —— 即「线插进去以后，这一跳是否成立」。
⚠️ 不要与 AIDC 页搞混
AIDC「设备接入」走的是管理通道：用网线连通交换机/路由器的管理 IP，再从上层 SSH/扫描去管理整组数据中心设备。
简单记：本页看「这根光纤/网线本身」，AIDC 看「接上线之后去管理谁」。两处一个向下看物理跳、一个向上做管理面。
如何把链路接进来测试
先明确监测对象：本页监测的是运行潮汐服务的那台主机上的网络接口。
物理 Linux 主机上是真实的 RJ45 / SFP 口；在 WSL2 中运行时看到的是映射的虚拟网卡，
能反映链路 UP/DOWN 与速率，但读不到真实光模块信息。
场景一：插一根电口网线（双绞线）
- 准备：主机的 RJ45 网卡、一根完好的双绞线，对端可以是交换机口、家用路由器或另一台电脑。
- 插入：水晶头对准卡口推入，听到「咔哒」一声即锁定，两端都要插紧。
- 看结果：3 秒内事件日志出现链路 UP；对应接口状态变绿，速率显示协商结果（如 1000 Mb/s）、双工为 full；网卡指示灯同步亮起。
- 没 UP 怎么办：依次检查对端口是否启用、水晶头是否压好、线缆是否插紧。现代网卡支持 Auto-MDIX，直通 / 交叉线一般都能自适应。
- 拔出：按住水晶头弹片再拔；事件日志会记录链路 DOWN。
场景二：把主机接到一台交换机
- 物理拓扑：主机网卡 → 交换机任意业务口（不是管理口也可以，业务口负责承载流量）。插好后先在本页确认物理层 UP、速率与对端口匹配。
- 识别设备：切到 AIDC「设备接入」，输入交换机管理 IP（主机必须能路由到该管理网段），通过 SSH/Telnet 横幅识别厂商型号，无需账号密码。
- 验证连通：切到「链路诊断」执行一键排查，按 网卡 → 网关 → 外网 逐段确认。
物理口 UP 但业务不通，最常见原因是交换机口的 VLAN 配置不匹配（access VLAN 不一致、
该配 trunk 的配成 access 等）。本页能验证物理与 IP 层，VLAN / 端口配置需要登录交换机核对。
场景三：接入集成组网（多设备、多链路）
- 逐台接入：按场景二的方式先识别每一台交换机，确认厂商与管理可达。
- 逐链验证：每插好一条线，先在本页事件日志确认 UP 再插下一条——一次只变动一条链路，出问题时才能准确定位。
- 端到端验证：全部接完后用「链路诊断」逐段检查；跨设备的路由、VXLAN 隧道与 EVPN 属于配置面，可在「学习档案」中对照概念与命令。
- 变更留痕：拔线、换口都会实时写入事件日志，排障时按时间顺序回看即可。
场景四：光模块与光纤（仅物理主机）
- 前提条件：裸金属 Linux 主机、网卡带 SFP / SFP+ 笼、光模块规格与口速率匹配（如 10GbE 口配 SFP+）、网卡驱动支持 EEPROM 读取。
- 插入模块：去掉模块防尘帽，模块卡扣朝外、金手指朝下推入 SFP 笼，按到底直到锁定。
- 接入光纤：拔去光纤头防尘帽，LC 双芯按 TX / RX 对应插入（收发接反则链路不亮），对端同样接好。
- 看结果：页面出现光模块卡片，显示 present、协商速率与 DDM 数字诊断（收 / 发光功率、温度、电压、偏置电流）；事件日志记录模块接入与链路 UP。
- 异常判断：接收光功率过低或为 0 → 对端发光异常、链路衰耗过大或 TX/RX 接反；完全无光 → 光纤未插紧或断纤。
- 拔出顺序：先拔光纤，再掰开模块卡扣取下模块，最后盖回防尘帽。光模块支持热插拔，但应避免频繁拔插。
在当前 WSL2 环境中无法验证光模块分支；把服务部署到带 SFP 笼的物理 Linux 主机后，
以上模块卡与 DDM 数据才会出现。此处不使用任何模拟光模块数据。
1模块在位
2光功率
3速率协商
4VLAN
5MAC 表
6STP
7LACP
8ARP
9直连路由
10动态路由
11MTU
12TCP/TLS
13DNS/HTTP
点击上方场景按钮开始演示；小兔子代表一个数据包，光点表示链路上的数据流，沿 模块→光纤→接入交换→Trunk→网关→路由 逐跳到达服务器 B。
点击一个场景开始；演示到的每一步都会在这里用白话解释「这步在查什么、为什么能 / 不能过」。
🔒
等待真实链路接入
本测试台只对真实物理链路开放。请在本机网卡插入光纤 / 网线并使链路 UP（可看上方面板的实时状态）；
检测到 UP 的物理接口后会自动解锁。这里不提供任何模拟选项，也不做教学演示。
物理接口与光模块
全部链路
名称 / 状态 / 速率 / 双工 / MAC| 接口 | 类型 | 链路 | 速率 | 双工 | MAC |
|---|
事件日志
接入 / 拔出 / 链路建立断开 / 光模块变化等待硬件事件…
登录潮汐账户
同步你的昵称、头像与使用记录
+86
本地账户演示：验证码不会真实发送短信或邮件，点击「获取验证码」后页面直接显示演示码；账户信息仅保存在当前浏览器。
账户设置
头像和用户名会在全站跟随显示
📱 绑定手机未绑定
✉️ 绑定邮箱未绑定
主机管理权限
在这台设备上创建控制台，或输入配对码加入已有的主机视角
「个人账户」用于保存头像 / 昵称等偏好；此处「主机管理权限」用于设备监控 / 局域网扫描 / 性能测试。
加入设备监控
配对后主机可以看到这台设备的网络状态；也可以只用诊断工具
添加我的设备
在你的 Linux 设备上运行 Agent，即可上报真实本地硬件数据（CPU/内存/磁盘/网卡/GPU）到本监控平台。无需配对码，Agent 启动时自动注册并获取 token。
- 下载 Agent 二进制：
tidal-agent-linux-x64
或使用 curl：curl -O http://HOST/download/tidal-agent-linux-x64 - 赋予执行权限：
chmod +x tidal-agent-linux-x64 - 启动 Agent（需 sudo/root 以读取 /proc /sys）：
sudo ./tidal-agent-linux-x64 --host-id my-pc --collector HOST:9090 --interval 5 --connect-type ethernet - 打开「跨层监控平台」查看新节点 · CPU/内存/网络曲线 · GPU（需本机已装 NVIDIA 驱动）
说明：本站「资产与链路」「RDMA 检测」等硬件功能读的是云服务器本机的 /proc /sys，
无法反映你设备的真实硬件状态。要在监控平台看到你设备本地的 CPU/内存/网卡/GPU 真实数据，
必须在你设备上运行此 Agent 上报到 Collector（端口 9090）。Agent 通过 HTTP POST /api/v1/register
自动注册并获取 token，后续 /api/v1/metrics 上报带 Authorization 头鉴权。
设备配对码
在要加入的设备上输入此码 · 5 分钟内有效 · 一次性
- - - - - -
设备打开本页后会自动弹出配对窗口
文档
Esc
↑↓ 选择
Enter 打开
Esc 关闭