griffinmx
2400c16ea9
Reviewed source snapshot: 70a56fe37dd527e68823bddceb0c10d2f64f32dc Default compact display and repository layout from the prior accepted local baseline are included.
65 lines
5.3 KiB
Markdown
65 lines
5.3 KiB
Markdown
# 使用与常见问题 / Usage & FAQ
|
||
|
||
下例先设置 `VM="$HOME/.local/share/vpsmaster/1.0.0b1/bin/vpsmaster"`；自定义安装请使用安装器打印的路径。逐项参数以 `"$VM" <command> --help` 为准。
|
||
|
||
| 命令 | 用途 |
|
||
| --- | --- |
|
||
| `check --lang zh` | 本机体检；仅显式 `--detect-public-ip` 才查询公网出口 |
|
||
| `suite --offline --lang en` | 不发起外部探测的综合检测 |
|
||
| `quality` | DNS、TCP/TLS、网络质量观察 |
|
||
| `trace --target 1.1.1.1 --method udp --max-hops 30` | 默认30跳，最多64跳的逐跳探测 |
|
||
| `trace --target 1.1.1.1 --method tcp --tcp-port 443 --geo` | 可选系统 traceroute；位置是推测，最多查询12个公网跳点 |
|
||
| `bgp --target 1.1.1.1` | RIPE RIS 的前缀、ASN 与有限路径样本 |
|
||
| `ipquality` / `media` | IP 多来源信息 / 公开网页可达性 |
|
||
| `cn-nodes` | 实验性中国候选节点的基础探测 |
|
||
| `return-route --method udp --max-hops 30` | VPS 到固定中国目标方向，不等于中国到 VPS 去程 |
|
||
|
||
## 输出和报告
|
||
|
||
```bash
|
||
"$VM" check --lang zh --theme framed --color always
|
||
"$VM" suite --json-output report.json
|
||
"$VM" report --input report.json --output report.md
|
||
"$VM" recover --journal report.json.events.jsonl --output recovered.json
|
||
```
|
||
|
||
主题支持 `default / iprisk / framed`，中英文可选；窄终端推荐 framed。Linux 纯文字控制台默认英文，中文需要字体支持。保存时不覆盖已有文件，默认脱敏；`--show-ip` 只影响终端。中断尝试保存已完成结果，恢复以完整日志事件为准；断电/SIGKILL 不保证尚未落盘的数据。
|
||
|
||
退出码：`0` 完成；`1` 有发现、结果不完整或存储失败；`2` 参数/安装错误；`130` 中断。模块执行结束不代表全部检测成功。未知、缺依赖或权限不足不会写成安全或解锁。
|
||
|
||
`suite` 默认省略值仅为“未知／跳过”的空条目及离线未执行模块的标题；使用 `--show-unavailable` 显示这些条目。实际失败和重要限制仍显示，JSON 和恢复日志始终保留完整状态。
|
||
|
||
## 可选测速（会消耗流量）
|
||
|
||
```bash
|
||
"$VM" bandwidth --allow-bandwidth --rounds 3 --sample-mib 4
|
||
"$VM" bandwidth --china --allow-bandwidth --rounds 3 --sample-mib 1
|
||
```
|
||
|
||
默认不开启。下载为节点→本机，上传为本机→节点；中国候选主要提供下载。大陆三网仍实验性，不保证覆盖与可用性；香港移动不替代大陆移动。小样本不证明端口上限，节点拥堵会影响结果。`attempted` 统计计划样本槽（含失败后跳过），不是实际请求次数。
|
||
|
||
## 常见问题
|
||
|
||
- **为什么没有安装到 PATH？** 安装器不改 shell 配置；使用打印的完整启动器路径。
|
||
- **为什么不能再次安装？** 保护已有文件；使用新的 `--prefix`。
|
||
- **为什么 ICMP/TCP 跳过？** 需要系统已有 `traceroute` 和相应权限；不会自动提权/安装。
|
||
- **中间跳点超时是否丢包？** 不一定。设备可能只过滤探测响应；不能据单跳延迟判断真实转发拥堵。
|
||
- **为什么媒体是 unknown？** DNS、TLS、HTTP、反爬、账号和地区因素不能总是自动区分；网页成功不等于播放成功。
|
||
- **报告能直接公开吗？** 仍需人工检查。第三方 API 会看到来源 IP，数据保存和分享受[服务条款](DATA_SERVICES.md)约束。
|
||
- **这些 CPU/内存是独享吗？** 只反映来宾可见资源及可见配额，不能证明宿主硬件独享。
|
||
|
||
[安装指南](INSTALL.md) · [已知限制](../release/KNOWN_LIMITATIONS.md)
|
||
|
||
|
||
## all：面向初学者的一键入口
|
||
|
||
`all` 与 `suite` 共用参数、调度、worker、逐模块日志和报告；`suite` 保持原有执行范围。`all` 默认额外选择 BGP 与 ICMP/TCP（系统缺 traceroute 或权限时保留原因，不自动安装或 sudo）。`--skip-route` 同时跳过三种路由。`--offline` 不发起外部探测，所有联网模块明确跳过。
|
||
|
||
进度显示已完成模块数量，不虚构百分比。执行成功只表示模块运行结束，不能证明网络目标成功、安全、解锁或播放。`--show-unavailable` 可显示更多无数据条目；默认简洁展示仍保留每模块跳过/失败原因。
|
||
|
||
`--total-timeout 30..900` 设置总秒数，默认300、full600；`--module-timeout 5..120` 默认60。Linux CLI 主线程使用可恢复的作用域计时器取消阻塞操作；已有活动计时器、不支持计时器的平台或非主线程不能保证该边界时，明确标记不支持。到总预算后剩余模块记为跳过，总结果不完整。单模块超时记未知并尝试继续，其已落盘数据保留。计时预算不保证故障存储设备写入或外部服务端传输的严格实时时限。
|
||
|
||
默认串行、固定来源、有限响应和请求超时；UDP 最多64跳×3轮、位置查询上限12个公网地址。普通模式默认30跳；ICMP/TCP 不对无响应跳点作转发丢包结论。`--full` 启用 PTR/单目标TCP25与有界中国方向追踪，没有完整三网线路保证。
|
||
|
||
带宽须同时使用 `--full --allow-bandwidth`。按来源数×轮数×每方向样本×2进行保守测试载荷预算，最大64 MiB，超限在开始前拒绝；协议开销不计入载荷上限。大陆测速另需 `--china-speed`，可能需要降低 `--sample-mib` 以满足总预算。不会自动执行 CPU/磁盘基准。脱敏、独占保存、Ctrl+C恢复与旧命令一致。
|