cat-ip-49

cat-ip-49 是一个可通过 uv tool 安装的高并发 IP 扫描 CLI，支持 ICMP 与 TCP 两种扫描模式。

当前仓库为发布精简形态：仅保留运行所需代码与用户文档，不包含测试目录。

---

安装

方式一：本地源码安装

uv tool install .

方式二：升级已安装本地版本

uv tool uninstall cat-ip-49
uv tool install .

---

快速开始

ICMP 扫描

cat-ip-49 icmp 192.168.1.0/24
cat-ip-49 icmp 127.0.0.1

TCP 扫描

cat-ip-49 tcp 192.168.1.0/24 22,80,443,8000-8100
cat-ip-49 tcp 127.0.0.1 22,80

---

命令格式

cat-ip-49 [--concurrency N] [--timeout SEC] <icmp|tcp> ...

全局参数

• --concurrency：并发数，默认 min(1024, cpu*128)，必须 >= 1
• --timeout：超时时间（秒），默认 0.3，必须 > 0

子命令参数

• icmp <target>
• tcp <target> <ports>

---

目标参数（target）

支持两种输入：

• 单 IP：127.0.0.1
• CIDR：192.168.1.0/24

程序会自动展开 CIDR 范围内可用主机地址。

---

端口表达式（ports）

TCP 模式支持“单值 + 列表 + 范围 + 混合”：

• 单端口：80
• 列表：22,80,443
• 范围：8000-8100
• 混合：22,80,443,8000-8100

程序会自动去重并排序。

---

输出说明

ICMP 模式输出

输出为“摘要 + 结果表格（仅展示 alive 目标）”。

示例：

目标IP数: 3
IP              Status
192.168.1.2     alive
192.168.1.10    alive
扫描结果：命中 2 个IP（仅展示有响应目标）

TCP 模式输出

输出为“摘要 + 结果表格（仅展示存在开放端口的目标）”。

示例：

目标IP数: 3
端口总数: 3
端口列表: 22,80,443
IP              Open Ports           Count
192.168.1.10    22,80                  2/3
192.168.1.23    443                    1/3
扫描结果：命中 2 个IP（仅展示有开放端口的目标）

零命中时仅输出摘要与最终统计，不显示空表头。

---

非 root 与兼容性说明

• TCP 模式可在非 root 环境直接运行。
• ICMP 模式优先尝试 raw ICMP；若权限不足会自动回退到系统 ping。
• 若系统不存在 ping，ICMP 模式会返回错误码 3。

---

退出码

• 0：执行成功
• 2：参数错误（target / ports / concurrency / timeout）
• 3：ICMP 回退所需 ping 不可用

---

常见问题

1) 为什么没有显示任何 IP 行？

可能是零命中。程序会保留摘要并输出命中数量。

2) ICMP 为什么有时偏慢？

在无 raw 权限时会回退系统 ping，速度取决于系统 ping 与网络状态。

3) 如何提高扫描速度？

可适当提高 --concurrency，并根据网络情况调小 --timeout。