Real-Fruit-Snacks/tcpdump-filter-builder
GitHub: Real-Fruit-Snacks/tcpdump-filter-builder
一个纯静态的浏览器端工具,帮助用户通过图形化选项快速生成 tcpdump 抓包命令及 BPF 过滤器表达式。
Stars: 0 | Forks: 0
在线站点 ·
功能 ·
运行 ·
键盘快捷键 ·
自行部署 ·
架构
根据协议、主机、端口和方向组装 tcpdump 抓包命令及其 BPF 过滤器——附带标志参考和复制按钮。采用
[Terminal Workbench 设计系统](https://github.com/Real-Fruit-Snacks/terminal-workbench-design-system)进行样式设计:
沉稳的石墨灰表面、克制的 ANSI 强调色、等宽字体标签。
**无需网络。无需依赖。无需构建步骤。** 一切都在你的浏览器中运行,你输入的任何内容
都不会离开该页面。从 U 盘打开 `index.html` 即可正常使用。
## 功能
- 通过直观的选项组装 tcpdump 抓包命令及其 BPF 过滤器。
- 一键示例过滤器(HTTPS、DNS、主机、TCP SYN、ICMP、写入 pcap)。
- 选择主机、端口、协议、方向和抓包设置。
- 即复制可用的命令。
- **双主题,六种强调色** —— 默认为暗色主题,可根据偏好设置或切换为亮色;输入框、滚动条和聚焦环均遵循当前主题。
- **小幽灵** —— 家族站点的宠物,移植自 [worldclock](https://github.com/Real-Fruit-Snacks/worldclock)。它会漂浮、打盹,还会躲避光标。点击它可改变颜色。
- **设计上的绝对隐私** —— 无网络请求,无分析工具,无外部字体。一切均在你的浏览器中运行;你输入的任何内容都不会离开该页面。
## 运行
打开 `index.html`。就这样——无论通过 `file://`、U 盘还是任何静态文件服务器,它都能正常运行。
如果需要本地服务器:
```
python -m http.server 8000
```
然后访问 http://localhost:8000。
## 键盘快捷键
在应用中随时按 `?` 即可调出此列表。
| 按键 | 操作 |
|---|---|
| `/` | 聚焦到第一个输入框 |
| `s` | 设置 |
| `t` | 切换主题 |
| `?` | 调出此帮助 |
| `esc` | 关闭 / 取消聚焦 |
## 自行部署
本仓库包含了部署所需的一切——仅包含静态文件,无需构建。
**GitHub Pages:** fork 或推送此仓库,然后进行 Settings → Pages → Deploy from branch → `main` / `/ (root)` 设置。
包含的 `.nojekyll` 文件是必须的(它可以防止 Jekyll 破坏文件结构)。
**GitLab Pages:** 包含的 [`.gitlab-ci.yml`](.gitlab-ci.yml) 会在每次推送到默认分支时发布站点——无需任何配置。也适用于自托管/物理隔离的 GitLab;该任务仅涉及文件复制。
**其他平台:** 将 `index.html`、`css/` 和 `js/` 复制到任意 Web 根目录下即可。
**离线 / 物理隔离:** 从 [最新发布版本](https://github.com/Real-Fruit-Snacks/tcpdump-filter-builder/releases/latest) 下载 zip 压缩包
—— 其中包含了上述所有内容;部署或运行均无需网络。
## 架构
| 文件 | 职责 |
|---|---|
| `js/tool.js` | 工具逻辑与 UI |
| `js/settings.js` | 偏好设置存储(唯一的 `localStorage` 拥有者)、设置面板、主题/强调色、键盘快捷键、帮助 |
| `js/content.js` | 代码示例的点击复制按钮 |
| `js/pet.js` | 小幽灵 |
原生脚本,共享一个 `TW` 命名空间,两个 window 事件(`tw:prefs`、`tw:pet`)——无框架,无模块,非常适合直接查看源码。
## 致谢
- 设计 Token:[terminal-workbench-design-system](https://github.com/Real-Fruit-Snacks/terminal-workbench-design-system) (MIT)
- 宠物小幽灵:移植自 [worldclock](https://github.com/Real-Fruit-Snacks/worldclock) (MIT)
## 许可证
[MIT](LICENSE)
标签:BPF过滤器, 前端工具, 命令行生成器, 多模态安全, 数据可视化, 纯前端, 网络抓包, 自定义脚本, 防御绕过