NetFlowScout

简体中文

English

简体中文

English

外观

管理 TUI ​

在 Linux 终端或 SSH 内运行，随主程序交付，不增加管理端口。默认只读；控制操作需要 --control、已有 OS 权限和逐项确认。

sh
sudo netflowscout tui --endpoint-dir /etc/netflowscout/endpoints
sudo netflowscout tui --endpoint-config /etc/netflowscout/endpoints/billing.json --control
ssh -t host 'sudo netflowscout tui --endpoint-dir /etc/netflowscout/endpoints'

界面截图 ​

以下为 OrbStack Linux/arm64 中实际运行的中英文 TUI，终端尺寸为 120×36。截图由真实 PTY 输出经终端渲染生成，保留紫色主题；点击图片查看原尺寸。服务、PID、计数与内存均为验收当时的示例值，按 L 可切换界面语言。

概览：分开判断各阶段 ​

TUI 中文概览：采集覆盖、业务观测、输出确认、WAL 和资源占用

按 1 查看采集覆盖、业务记录、输出确认、WAL 与资源占用。进程就绪与输出已确认分别显示，避免把服务运行误认为业务链路成功。

选择应用：搜索后选中 ​

TUI 中文应用选择：搜索 tlsfixture 并显示 PID、systemd 单元和 Go TLS 运行时

按 n 开始连续任务，用 / 搜索、上下键选择、Enter 继续。列表是运行时候选；兼容性、范围匹配及实际挂载仍需后续验证，无需抄写 PID。

创建策略：先填必要条件 ​

TUI 中文 HTTP 策略草稿：策略 ID、服务和请求路径三个字段

HTTP 基础表单仅包含策略 ID、服务和路径，Ctrl+O 展开高级选项，Enter 进入预览，Esc 放弃。图中的 checkout_url 是尚未应用的草稿；下一张事件图来自已有规则，并非这份草稿。

看懂事件：规则与投递确认 ​

TUI 中文事件说明：发生了什么、规则版本、file 与 Dataway 各自的确认状态

事件列表 Enter 显示发生了什么、记录的规则版本及逐输出确认；d 展开技术详情，x 排障，c 定位规则。图中事件来自已生效的 systemd_http 规则。Dataway 已确认表示 HTTP 接受，不代表后端已经可检索。

配置管理：编辑常用字段 ​

TUI 中文配置管理：服务名、探针标识、回环指标端口与业务观测开关

按 8 进入配置页，选择分组后按 e 编辑常用字段，或按 E 编辑完整 JSON。Tab/Shift+Tab 切换字段，Enter 校验并预览差异，Esc 放弃。图中为 identity 分组的有效配置，仅打开表单，没有保存或重启服务。

规则编辑：查看并修改 DSL 草稿 ​

TUI 中文规则编辑器：带行号的 HTTP 错误与固定窗口 DSL 规则

按 3 选择规则文件，按 e 打开编辑器。Ctrl+S 进入应用确认，Ctrl+U 清空草稿，Esc 放弃。图中仅打开已有规则；没有保存或重载，也没有显示请求正文。DSL 字段与规则 ID 在中英文界面中保持一致。

插件管理：核对版本与模块身份 ​

TUI 中文插件列表：安装版本、ABI、模块内存上限和 SHA256 前缀

按 4 查看插件的安装版本、ABI、模块内存上限和 SHA256 前缀；Enter 打开详情，再按 d 查看运行代际。按 : 打开校验、回放、安装与重载、回滚等动作。图中的 64 MiB 是模块内存上限，不是当前 RSS；本次截图没有安装、重载或回滚插件。

页面 ​

按键页面用途
1Overview分开看进程、覆盖、业务、输出确认及问题建议
2Targets服务、进程代际、挂载、最近明文
3Rules文件/运行版本，编辑、试跑、重载、恢复
4Plugins摘要、ABI、代际，验证、安装、重载、回退
5Delivery各端待确认数、重试、FIFO 首条时间、WAL
6Events有界本地事件尾部及告警元数据
7Systemsystemd 单元、启停/重启、doctor/verify
8Config主/端点配置表单、JSON、差异、应用和恢复
9Recordings捕获片段、完整性、查询、回放、导出和保护

键盘 ​

1–9 或 Tab/Shift+Tab 切页，方向键或 j/k 选择，Enter 详情，Esc 返回，/ 筛选，r 刷新，Space 暂停轮询，: 动作菜单，t 最近任务，? 帮助，q / Ctrl+C 退出。PageUp/PageDown 可滚动长结果。

配置页 e 编辑常用字段，E 编辑完整 JSON；表单 Enter 或编辑器 Ctrl+S 进入差异预览，y 确认，n/Esc 返回草稿。界面支持 --lang zh|en 与 L 切换，支持中文内容、NO_COLOR，最低终端 60×14。

更改配置 ​

先校验整套配置/插件/规则及接线，预览差异和重启影响，检测外部编辑后保存 .tui-backup，保留权限及属主并原子替换。激活会协调重启所选管线，失败尝试恢复；结果会明确报告是否恢复成功。

控制链路必须选择全部活动端点配置。重启会产生采集空档。切换 WAL 路径、关闭已有输出端需单独离线迁移，TUI 拒绝直接修改。实际 Dataway token 仍由 EnvironmentFile 注入。

控制审计默认 /var/lib/netflowscout/tui-audit.ndjson，先 fsync 操作意图再更改；无法写审计会拒绝操作。审计不保存正文或凭据。一个会话同时执行一个任务；退出会等待当前清理。

如何读状态 ​

STALE / UNKNOWN 会保留最后快照，不能当作当前健康。零目标表示等待；零业务或尚无输出确认时不能显示为端到端成功。Dataway ACK 只证明 HTTP 接受。完整证据仍用接入验证。

原始证据与策略配置 ​

第 9 页 Recordings 展示按捕获片段分组的留存、完整性和保护状态；第 6 页 Events 可按选中事件查找、离线回放或导出原始证据。导出与保护通过现有控制确认及审计；回放只显示脱敏试跑结果。正在写入的文件不能导出。用法与保留边界见原始数据留存。

Config 新增 recording 表单；端点配置为已有每条 policy 提供优先级、排除、服务、模块、协议、角色及进程匹配表单，单目标提供 match 表单。UID 留空表示不限定。策略数组可新增、复制、删除并预览匹配，复杂连接路由仍使用 JSON 草稿。仅实际修改字段写回，其他策略保持原样。

新增应用选择、检测策略创建、无事件排障、轮转历史筛选及投递追溯见接入与调查工作流。x 排障，结果 f 打开建议页，L 切换中英文。事件详情省略 message 和 fields。

连续任务使用 n：应用列表选择 → 精简策略表单 → 对应事件；C 清除上下文，d 展开技术详情。Ctrl+O 高级选项，Ctrl+T 模板，左右键枚举。只读查询直接执行，更改与合成验证仍确认。事件默认可读说明，可继续定位规则、排障和证据。详见连续流程。