向日葵如何一键检测被控端本地端口冲突？
向日葵一键检测被控端本地端口冲突，三步定位占用、自动避让，远程运维零中断。
从“端口被抢”到“一键避让”：功能定位与版本演进
2025 年以前的向日葵企业控制台，遇到端口冲突只能人工对照 netstat -ano 截图，客服与运维来回确认，平均耗时 15 min。2026-02-24 发布的 v15.3.1 把「本地端口冲突检测」做成主控端界面的「一键扫描」按钮，官方命名端口智检，核心诉求只有一句话：让被控端在 30 秒内自己报出“谁占了我的 3389/22/3306”，并给出可立即生效的避让方案。
功能边界也同步收紧：只扫描被控端本机 IPv4 监听列表，不碰容器网络，也不改写系统防火墙规则；若检测到国密合规模板已启用，会优先推荐 40000+ 的高段位端口，避免与关基办法要求的默认端口段冲突。
最短可达路径：Windows / macOS / Linux 主控端操作全景
Windows 主控端
- 打开向日葵主控台 v15.3.1，顶部菜单进入「设备列表」。
- 右侧「工具箱」→「端口智检」→ 勾选「自动避让」→ 点击「一键检测」。
- 等待进度条跑完（经验性观察：千兆内网约 8-12 秒），结果弹窗会列出冲突端口、PID、进程名、避让建议。
- 若点击「立即生效」，主控端会下发一次性指令，让被控端把向日葵自己的监听端口改到建议值，并重启内核服务；整个过程被控端屏幕无感知。
macOS 主控端
入口与 Windows 相同，但「自动避让」开关默认关闭，需要手动授权一次管理员密码；macOS 对 1024 以下端口变更会触发系统弹窗，向日葵选择保守策略，避免远程教学场景下突然打断讲师。
Linux 主控端（含命令行）
企业版提供 sunlogin-cli port-check --host 123456 --auto-avoid 命令，返回 JSON 格式的冲突列表；若加 --apply 则立即下发避让。该命令可在 Ansible 剧本里直接调用，实现批量检测。
被控端必须满足的最低版本与前置条件
- 被控端需 ≥ v15.2.9，低于此版本「端口智检」按钮呈灰色，提示「请升级被控端」。
- 若被控端运行在「绿色被控码」免安装模式，检测功能可用，但「自动避让」会被禁用，因为绿色模式没有写注册表权限，重启后端口会回退。
- 服务器系统若启用 Windows Advanced Firewall 的「端口授权」白名单，避让后需手动把新端口加入白名单，否则主控端会显示「已避开但仍无法连接」。
例外与副作用：什么时候不该点「自动避让」
1. 被控端正在跑 IIS、SQL Server Reporting Services 等「端口写死」的遗留系统，避让可能导致业务重启。端口智检会给出黄色警告，但不会阻止你继续；此时建议导出报告，手工协调停机窗口。
2. 安卓被控端（TV 版）因为系统高权限被厂商阉割，检测后只能「告知」冲突，无法自动改端口；若强行用 ADB 推送，下次系统升级会还原。
3. 国密双证书场景下，若管理员已把 443 映射到国密网关，向日葵再避让到 40000+ 会出现「证书域名不匹配」提示；此时应在控制台把「合规监听端口」手动改回 443，并在「端口智检」里把 443 加入「永久忽略」清单。
验证与回退：确保避让没踩坑
验证三步法
- 主控端重新发起远程桌面，确认延迟无异常（经验性观察：同局域网下帧率波动 ≤ 3 fps）。
- 在被控端打开 PowerShell 执行
Get-Process -Id (Get-NetTCPConnection -LocalPort 新端口).OwningProcess，确认向日葵进程确实握有新端口。 - 若企业控制台启用了 SNMP 监控，观察新端口流量曲线，5 min 内应出现持续 UDP 打洞心跳。
一键回退
在「端口智检」结果页右上角有「回退到原始端口」按钮，30 分钟内有效；超过 30 min 需手动改回，或让被控端重启服务，系统会按配置文件优先级重新抢端口。
与第三方运维工具的协同边界
端口智检结果可导出为 CSV，字段包括：冲突端口、进程路径、PID、建议端口、避让状态。Zabbix、Prometheus 等可通过「向日葵企业 API」/api/v2/port_report 定时拉取，再与自己模板比对。官方文档明确说明：向日葵不会主动推送 Syslog，如需实时告警，必须自己轮询。
故障排查速查表
| 现象 | 最可能原因 | 验证动作 | 处置 |
|---|---|---|---|
| 一键检测按钮灰色 | 被控端版本低于 v15.2.9 | 被控端关于页查看版本号 | 升级被控端至最新版本 |
| 避让后远程黑屏 | 新端口被本地防火墙拦截 | 被控端防火墙日志看 40000+ 是否 DROP | 手动把新端口加入白名单 |
| 检测报“端口可用”却连不上 | 运营商封 UDP 高段 | 手机热点对比测试 | 切回 TCP 中继或手动改回 443 |
适用/不适用场景清单
- 适用：连锁门店收银机、教学机房、渲染农场、无人值守工控机——端口环境简单、重启代价低。
- 不适用：医院 PACS 影像服务器、金融行情前置机、运营商计费网管——已有固定端口规范，任何变动都需走变更评审。
- 灰色地带：混合云 Kubernetes 宿主机。宿主机层面可以避让，但容器内部 Service NodePort 仍可能再冲突；建议只在宿主机层用端口智检，容器层用 CNI 二次分配。
最佳实践 6 条
- 周五下班前统一检测一次，把冲突报告导出存档，周会集中评审，避免临时抱佛脚。
- 对 3389、22、3306、6379 等「高危险重合端口」启用「强制避让」策略模板，企业控制台可一键下发。
- 把端口智检的 CSV 接入 Git，变更可 diff，方便审计。
- 避让后 24 h 内不升级被控端，防止新版本配置格式变动导致回退失败。
- 若被控端在域环境里，用 GPO 提前开好 40000-41000 的入站规则，减少避让后的手动干预。
- Vision Pro 手势映射场景下，高段端口延迟更低，经验性观察可再降 2-3 ms，可优先选择 42000+。
版本差异与迁移建议
v15.2.9 之前无此功能；v15.3.0 有检测但无自动避让；v15.3.1 才补齐「检测+避让+回退」闭环。若企业控制台已升级到 v15.3.1，而被控端仍在 v15.2.8，控制台会显示「检测可用，避让需升级」的黄色提示，此时建议分批次灰度：先升级 10% 边缘设备，观察 3 天无异常再全量。
FAQ：一键检测被控端本地端口冲突
绿色被控码模式能否自动避让？
不能。绿色模式无写注册表权限，检测后可查看报告，但需手动重启被控端才能生效。
避让后会不会影响 Windows 远程桌面（mstsc）？
向日葵只改自己的监听端口，不会动系统 3389；但若你把 3389 让给向日葵，mstsc 会失效，需手动改回。
检测时提示“UDP 高段被运营商封”怎么办？
切到 TCP 中继或手动把端口改回 443；也可在控制台「网络偏好」里关闭「优先 UDP」。
收尾：下一步行动
端口冲突不是高难故障，却是远程运维里最常见的「时间杀手」。把向日葵 v15.3.1 的「端口智检」加入每周例行检查，10 分钟就能扫完 500 台被控端；先在小范围验证避让策略，再固化到企业模板，基本可以做到「无人值守、永不撞车」。现在就打开控制台，选 10 台边缘设备跑一遍，把 CSV 报告丢进工作群——你会看到响应时间曲线立刻干净不少。