pranshuparmar/witr - 快速上手

由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名

项目介绍快速开始学习路径项目截图 2 贡献者 34 增长趋势 Commit 历史代码统计生态关系项目时间线项目竞品上榜历史

witr 5分钟快速开始

witr 是一个强大的进程溯源工具，通过一条命令就能告诉你某个进程、端口、容器或文件为什么正在运行，并可视化地展示其启动链。

环境要求

支持的操作系统

macOS Windows Linux

运行环境

Go 1.21+

所需工具

curl

用于下载安装脚本或二进制文件

必需

bash

用于执行安装脚本（Linux/macOS/FreeBSD）

必需

操作步骤

安装 witr

使用官方提供的快速安装脚本，一键安装最新版 witr 二进制文件。

在 macOS、Linux 或 FreeBSD 系统上执行此命令。

curl -fsSL https://raw.githubusercontent.com/pranshuparmar/witr/main/install.sh | bash

如果遇到权限问题，请尝试在命令前加上 `sudo`。

验证安装

检查 witr 命令是否已正确安装并可执行。

查看安装的 witr 版本号。

witr --version

如果提示命令未找到，请检查 PATH 环境变量是否包含 /usr/local/bin。

快速体验：查询一个进程

运行 witr 并查询一个常见进程（如 `bash` 或 `sh`）的启动链。

查询名为 'bash' 的进程，显示其启动链和原因。

witr bash

可以尝试查询 `sshd`, `docker`, `node` 等系统常见进程。

探索交互式模式 (TUI)

不带任何参数运行 witr，启动交互式终端界面，实时查看和探索系统进程。

启动 witr 的交互式终端用户界面。

witr

在 TUI 中，按 'q' 退出。使用 '?' 查看帮助。

验证成功

通过执行基本命令和启动 TUI，确认 witr 已正确安装并能正常工作。

执行 `witr --version` 能显示版本号

执行 `witr bash` 能输出一个清晰的启动链

执行 `witr` 能成功启动交互式终端界面

快速提示

基本用法

想快速了解某个服务的启动原因？试试 `witr <服务名>`，例如 `witr sshd`。

交互模式

witr 的 TUI 界面支持鼠标操作，可以点击列头排序，点击行查看详情。

高级查询

如果只想看特定 PID 的进程信息，使用 `witr --pid <PID>`。

常见问题

安装脚本执行失败，提示权限不足。

尝试在命令前添加 `sudo` 来提升权限：`sudo curl -fsSL ... | bash`。

执行 `witr` 命令时提示 'command not found'。

检查安装路径（默认为 /usr/local/bin）是否在你的 PATH 环境变量中。可以运行 `export PATH=$PATH:/usr/local/bin` 临时添加，或将其写入你的 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc）中。

TUI 界面显示异常或颜色错乱。

尝试将你的终端模拟器设置为支持 256 色或真彩色的模式。大多数现代终端默认支持。

下一步

查看帮助文档

运行 `witr --help` 或 `man witr` 查看所有可用的命令和选项。

探索更多用法

尝试用 witr 查询端口占用：`witr --port 80`，或查询特定容器：`witr --container <容器名>`。

集成到监控脚本

利用 witr 的 JSON 输出模式（`--json`）将进程溯源信息集成到你的自动化监控或事件响应脚本中。