服务器排障：端口检测 · 磁盘测速 · 日志开关
现场报「终端起不来」「下载特别慢」时，问题不一定在终端。本页集中介绍三件在服务器侧自查的事：端口有没有被别的程序抢走、承载镜像存储的磁盘到底快不快、以及排障要看的日志是否真的在被记录。三项都是管理员自己就能做完的动作，不需要额外工具。
建议的排查顺序
先做端口检测（几秒钟，能一眼排除「服务根本没起来 / 端口被抢」这类硬故障），再做磁盘测速（判断瓶颈是不是服务器磁盘），最后才去翻日志（翻之前先确认日志开关是开的，否则会白翻）。
一、服务器端口检测
入口：控制台 → 「其他（Others）」→ 「服务器端口检测」。
这个页面检测的是当前管理平台所在的这台服务器上，云桌面平台各项服务所需端口的实际监听情况，覆盖终端启动引导、终端登录、镜像数据通道、引导资源下载、管理控制台、终端状态上报、数据库等。端口被第三方程序占用会直接导致对应功能不可用（例如终端无法启动、控制台打不开），而这类故障从终端侧看往往毫无头绪。
1，进入页面后自动开始检测，无需任何操作，结果直接渲染成表格。
2，需要重新跑一遍时，点左上角「重新检测」。
3，若还想顺带看某个自定义端口的占用情况，在「重新检测」右侧的输入框里填写端口号（多个用逗号分隔，如
8080,9000），回车或再点一次「重新检测」。
结果表的列如下：
| 列 | 说明 |
|---|---|
| 端口 | 被检测的端口号 |
| 协议 | 该端口使用的协议 |
| 用途 | 这个端口是给哪项功能用的（终端引导、镜像数据通道等） |
| 归属服务 | 正常情况下应当由哪个服务监听 |
| 状态 | 正常 / 被占用 / 未监听 |
| 监听进程 | 实际占着这个端口的进程名与 PID |
| 说明 / 处理建议 | 该端口的作用，以及被占用时的处理办法 |
三种状态的含义与处理：
| 状态 | 含义 | 怎么处理 |
|---|---|---|
| 正常 | 平台自身的服务正在监听该端口 | 无需处理 |
| 被占用 | 被第三方程序抢占，附监听进程名与 PID | 按「处理建议」列停用或改掉那个程序的端口，然后重新检测 |
| 未监听 | 该端口对应的服务没有启动 | 到服务器上确认对应服务是否已启动 |
表格上方常驻一行汇总：检测时间、正常 N 个、被占用 N 个、未监听 N 个。一旦出现被占用的端口，页面顶部会额外弹出红色告警条，写明有几个平台端口被别的进程占了，请按表中建议处理后重新检测。
这几行不是故障，别误判
下面这些端口由平台自家的组件承载，检测结果显示为正常，不要当成「被第三方占用」：
- TFTP（69）由平台安装器注册的独立 TFTP 服务承担；
- 磁盘数据通道（7002）由磁盘 IO 服务监听；
- 引导资源 HTTP（7012）与硬件上报（7080）由管理平台自身承载。
另外两点：数据库行按管理平台实际的数据库连接配置取端口，数据库部署在远程主机时本机检测没有意义，该行不会列出；Web 管理控制台行以本次检测请求实际到达的服务端口为准，不靠配置猜测。
检测过程只读取操作系统的端口监听表与进程列表，不改变任何服务行为，可以随时执行；Windows 与 Linux 服务器均支持；与其它管理页面一样需要登录后才能使用。
二、SSD / 硬盘测速
入口：控制台 → 「其他（Others）」→ 「SSD硬盘测速」。
排查「终端下载慢 / 加载卡」时，用它判断瓶颈是不是出在承载镜像存储的服务器磁盘上，不必再依赖经验或外部工具。
1，在「测试磁盘」下拉里选择目标磁盘或目录。页面会自动列出服务器上的各磁盘及其可用 / 总容量，默认选中第一个可写目标（通常是系统临时目录）。
2，选择「测试文件大小」：256 MB（快速）、512 MB（推荐）、1 GB（准确）、2 GB（严格），默认 512 MB。
3，点「开始测速」，等待结果。测速期间该磁盘会有一次集中读写。
结果以四张指标卡片呈现，另有一个「磁盘类型判定」标签：
| 指标 | 说明 |
|---|---|
| 顺序写入（MB/s） | 含 fsync 强制落盘，最贴近真实写入能力 |
| 顺序读取（MB/s） | 受操作系统缓存影响，数值可能偏高 |
| 4K 随机读 IOPS | 区分固态盘与机械盘最直观的指标 |
| 4K 随机读吞吐（MB/s） | 随机读对应的吞吐量 |
| 磁盘类型判定 | 按 4K 随机读 IOPS 粗判为「固态盘」或「机械盘 · 低速盘」 |
这是真实读写，不是估算
- 测速会占用磁盘 I/O，并短时占用与测试文件大小相同的磁盘空间，建议避开教学高峰时段。
- 开始前会校验可用空间并预留两成余量，空间不足会直接拒绝执行。
- 测试文件在完成后随即删除。
- 测试文件大小上限为 4096 MB。
- 该功能需登录后才能调用。
「其他」菜单下还有一项「SSD性能测试」，与「SSD硬盘测速」并列（它原先挂在「桌面」菜单下，现已移入「其他」，页面内容、访问地址与所需权限均未变化，原有书签与直达链接照旧可用）。
三、终端日志的「调试开关」
终端（含无盘启动环境）会把关键运行日志经网络上送到服务器，由引导服务按机器分目录落盘，供排障时集中查看。这项能力现在是调试设施，出厂默认关闭：关闭状态下服务端对终端上送的日志完全不理会——不监听、不解析、不写盘，因此服务器上不会产生任何终端日志文件。
需要排障时：
1，在引导服务的配置文件中打开
debug开关。2，重启引导服务（这个开关只在服务启动时读取一次，不重启等于没改）。
3，让故障现场再复现一次，此时的终端日志才会被收下来，按机器分目录保存，保留 7 天后自动清理。
4，排障结束后把开关关回去——上千台终端持续往服务器发日志、服务器持续接收并写盘，平时没有必要。
两条必须先知道的边界
- 开关打开之前发生的终端日志不会被补收。 故障「第一现场」若发生在开关打开之前，服务器上没有对应日志，只能到终端本地去取（终端本地日志一直是完整保留的）。这也是为什么第 3 步要求「再复现一次」。
- 重启引导服务会打断现场：终端控制通道会断开，正在下载的机器会中断。不要在上课时间做这个动作。
其它需要知道的点：
- 终端侧无需任何升级或改动，上送本就是「发后不管」，服务端不收不影响终端任何功能。
- 引导服务的启动日志会明确打印当前开关状态；开关关闭时还会一并提示如何打开，避免把「开关没开」误判成「终端没上送」。
- 此前显式配置过旧的「终端日志开关」配置键的部署，原配置继续按原语义生效，不受默认值变化影响。
AI 助手也能代做这件事：它可以查询该开关的状态、打开或关闭它（属于会重启引导服务的破坏性操作，必须由你在待确认卡片上点确认，改配置前会自动备份原文件）。此外，它在检索日志时若发现该开关是关的，会主动说明「客户机根本没在往服务器发日志，所以搜不到是正常的，不代表客户机没问题」。详见如何使用 AI 助手。
要求管理端与引导服务在同一台机器
「打开 / 关闭调试开关」这两个动作要求管理端与引导服务装在同一台机器上（标准安装即如此）。不在同一台时，助手会明确说明只能到引导服务那台机器上手工修改，不会误报成功。
四、IO 服务日志大小
入口：控制台 → 数据服务 → 「下载设置（Download Settings）」→ 「高级（Advanced）」→ 「日志大小（Log Size）」，单位 KB，按 IO 服务器配置。
IO 服务日志按大小轮转，这份日志里心跳类记录占绝大多数。上限设得太小的直接后果是：最需要它的时候恰好什么都查不到——想查「某间房为什么排成这个形状」「某台机器的上家是谁」，相关记录早已滚出窗口。
| 配置项 | 出厂默认值 | 说明 |
|---|---|---|
| 日志大小（Log Size） | 1024 KB（1 MB） | 旧版出厂值为 16 KB；可回溯时间由「几分钟」提升到「几十分钟」量级 |
- 存量服务器会自动抬升：升级后凡是仍停在出厂 16 或为空的服务器统一抬到 1024；现场自己调过、大于 16 的值一律不动。抬升后的值随下一次设置下发到 IO 服务，不需要人工逐台改。
- 上限不设死，仍可按现场需要在管理台继续调大。日志落盘含一份备份文件，按 1 MB 计磁盘占用约 2 MB。
两种情况需要你手工确认一次
- 若你的现场是有意把它压到 16 KB 以下省磁盘的，这次会被一并抬上来，需要时请在管理台改回。
- 若只更新了 IO 服务而没有更新引导服务，老服务器仍会按记录里的 16 下发，需要在管理台手工改一次。
五、排障时该看哪一份日志
服务器上不止一份日志，选错了会白翻半天：
| 日志 | 记的是什么 | 什么问题去这里找 |
|---|---|---|
| 管理端日志 | 管理端自己的事 | 控制台页面、管理接口相关的问题 |
| 桌面云主服务日志 | 主服务运行情况 | 平台服务级异常 |
| 磁盘 IO 服务日志 | 排链、传输、缓存 | 下载慢、建链失败、缓存出错——这些管理端日志根本不记 |
| 各客户机日志 | 每台终端自己的运行日志，按机器名 / IP 分在各自子目录 | 「这台机器当时到底怎么了」；需先打开调试开关（见第三节） |
| 云代理日志 | 云端接入相关 | 与云端连接有关的问题 |
IO 服务日志现在「只记结果」
排链这类高频过程行不再逐条打印，而是按房间累计后打一行结论行（当前多少台、几个链头分别是谁、这一轮换了多少次上家等）；一间房长时间不收敛时结论行会标明「仍在变动」。其它高频行按房间 / 按结论限频输出，并在行尾注明这一窗口内折叠了多少次。
因此：凡是靠数日志行数做判断的老习惯需要改口径——过去数「链头出现几行」，现在改为直接读结论行里的链头个数与名单。
AI 助手可以一次性跨这几份日志检索（不指定就是全部一起搜），查某台机器时把机器名或 IP 直接当关键字即可，见如何使用 AI 助手。
六、按现象选工具（速查）
| 现象 | 先做什么 | 在哪 |
|---|---|---|
| 终端起不来、控制台打不开 | 服务器端口检测，看有没有端口被抢或服务没起 | 其他 → 服务器端口检测 |
| 全场下载慢、加载卡 | SSD / 硬盘测速，先排除服务器磁盘瓶颈 | 其他 → SSD硬盘测速 |
| 要查某台终端当时发生了什么 | 先确认调试开关已打开，再让它复现一次 | 引导服务配置文件 debug |
| 查建链、排链、缓存类问题查不到记录 | 把 IO 服务日志大小调大，再复现 | 数据服务 → 下载设置 → 高级 → 日志大小 |