Brook 是一款轻量级、跨平台的命令行网络工具，专为管理和追踪代理（proxy）与虚拟专用网络（VPN）隧道配置而设计。它不依赖任何外部服务或 API 密钥，所有数据均本地存储于用户机器上，确保隐私与安全。Brook 的核心理念是提供简洁高效的文本日志管理功能，通过一系列直观的子命令实现对网络配置的添加、查询、导出和删除操作。该工具适用于需要长期记录复杂网络环境配置的开发者、运维人员及网络安全工程师，尤其适合那些偏好命令行工作流并重视数据自主控制的场景。Brook 完全基于 Bash 编写，仅需标准 Unix 工具即可运行，无需 Python、Node.js 等运行时环境，极大降低了部署门槛。 Brook 的数据结构清晰且易于扩展：主配置文件存储在 `~/.local/share/brook/data.log` 中，每条记录包含时间戳和内容描述；同时设有独立的 `history.log` 用于追踪用户操作历史。用户可通过环境变量 `BROOK_DIR` 或遵循 XDG Base Directory 规范自定义数据存储路径。Brook 的设计强调轻量化与可移植性，使其能在 Linux、macOS 甚至 Windows 的 WSL 环境中无缝运行。其输出全部为纯文本格式，便于重定向至文件或直接集成到其他自动化脚本中。无论是临时记录一个代理服务地址，还是构建一套完整的服务器代理清单，Brook 都能以最小开销满足需求。 作为一款由 BytesAgain 原创开发的独立项目，Brook 并非第三方工具的衍生版本，而是针对现代网络运维痛点量身打造的一款实用型 CLI 工具。它填补了传统配置管理工具过于庞大、学习成本高的问题，为日常网络配置管理提供了高效、透明且零负担的解决方案。无论是个人开发者调试多环境连接，还是团队协作维护统一的网络策略文档，Brook 都能成为值得信赖的辅助工具。
核心功能特点
- 轻量级 CLI 工具，无外部依赖，纯 Bash 实现，支持跨平台使用
- 本地优先存储机制，所有配置数据保存在用户本机，保障隐私安全
- 提供 add/list/search/export 等核心子命令，支持按关键词快速检索历史记录
- 自动时间戳标记每条条目，便于追溯配置变更时间和上下文信息
- 支持通过环境变量自定义数据目录，兼容 XDG Base Directory 规范
- 输出为标准文本流，易于重定向到文件或与其他脚本集成
适用场景
Brook 特别适合需要频繁记录和管理多种网络代理与 VPN 连接的运维工程师。例如，在部署分布式系统时，工程师可能需要在不同服务器间切换 SOCKS5 或 HTTP 代理，此时可使用 `brook add “SOCKS5 proxy: 192.168.1.100:1080″` 快速保存每个环境的代理设置，后续通过 `brook search “SOCKS5″` 快速定位。对于远程办公团队而言，WireGuard 隧道配置往往涉及多个端点和允许 IP 范围，Brook 能帮助团队成员统一归档这些关键参数，避免因记忆偏差导致连接失败。 在网络故障排查过程中，Brook 同样发挥重要作用。当遇到防火墙规则调整或路由异常时，技术人员常需临时添加或修改出站端口策略。利用 Brook 记录如 `brook add “Firewall rule: allow port 8443 outbound for API gateway”` 这类操作，不仅能形成可追溯的操作日志，还能在问题复现时快速比对前后差异。此外，面对多地域、多角色的服务器集群，Brook 可作为简易版‘网络资产清单’，将每台服务器的代理端口、绕过域名等信息集中存储，并通过搜索功能快速调取所需配置。 对于希望将网络配置纳入文档体系的团队，Brook 提供了便捷的导出能力。执行 `brook export` 命令即可将所有历史条目输出为结构化文本，直接用于生成 README、Wiki 页面或交接报告。这种机制特别适用于项目交接、审计检查或合规审查场景，确保关键网络信息不会因人员变动而丢失。由于 Brook 不强制要求账户体系或云端同步，它也天然契合注重数据主权的企业内部环境，成为构建私有化运维知识库的理想起点。