vianic/kali-cyberpunk-setup
GitHub: vianic/kali-cyberpunk-setup
一套 Kali Linux 的安装后配置工具，通过自动化脚本将系统转变为统一赛博朋克主题且预装渗透测试工具的即用型工作站。
Stars: 1 | Forks: 0
# Kali Cyberpunk 配置
**版本 1.0.0** · [更新日志](CHANGELOG.md) · [许可证](`）并重新生成。
这就是保证你始终能汇聚到最新捆绑工具列表的机制。你手动添加的任何工具都将保存在 `.bak` 文件中，以便在 schema 升级后手动重新添加。
### 配置格式
管道符分隔，七个字段，`-` 表示“不适用”：
```
name|type|check_cmd|apt_pkg|git_url|install_cmd|description
```
| 字段 | 含义 |
|-------|---------|
| `name` | 菜单名称；也是 repo/binary 工具的 `/opt/tools/` 目录 |
| `type` | 以下安装类型之一 |
| `check_cmd` | 用于检测现有安装的二进制文件（如果没有则为 `-`） |
| `apt_pkg` | apt 包名（仅由 `type=apt` 使用） |
| `git_url` | git 仓库 URL、go module 路径或原始文件 URL，具体取决于类型 |
| `install_cmd` | 安装步骤（`pip install ...`、`make`、脚本等） |
| `description` | 菜单中显示的简短单行描述 |
示例：
```
certipy|git+pip|certipy-ad|-|https://github.com/ly4k/Certipy.git|pip install -e .|ADCS enumeration & abuse (ESC1-ESC16)
```
### 安装类型
| 类型 | 行为 |
|------|----------|
| `apt` | `sudo apt-get install ` |
| `pip` | 通过 **pipx**（如果使用 uv backend/`--python` pin，则为 **uv tool**）进行隔离 CLI 安装；绝不触碰系统解释器 |
| `git+pip` | 克隆到 `/opt/tools/`，创建 `.venv`，在其中运行 `install_cmd` |
| `git+bash` | 仅克隆，可选直接运行 `install_cmd`（无 venv） |
| `go` | `go install `（如果不在 PATH 中，自动探测 `/usr/local/go` 处的 Go） |
| `winbin` | 克隆源码**并**获取最新的 GitHub release 二进制文件——用于打算在 Windows 目标上运行的工具，而不是在 Kali 上 |
| `rawfile` | 直接下载单个脚本（带有用于其依赖项的可选 venv） |
| `special` | 按名称分发的定制安装器（例如 Sysinternals suite、Eisvogel 报告模板） |
### 添加你自己的工具
选择 **“+ Add a new tool to this menu”** 并回答提示。你的条目将追加到 `tools.conf`。请注意，schema 升级将重新生成默认列表；你的添加项会保留在带时间戳的 `.bak` 文件中，以便你可以重新添加它们。
### Burp Suite 下载器
**“Download Burp Suite”** 会查询 PortSwigger 自己的发布源，选择与你的**版本**（Community/Professional）和架构匹配的 Stable 构建，并**强制执行**完整性检查：除非其 SHA-256 与 `portswigger.net` 上发布的校验和匹配，否则它会删除下载文件并中止。成功后，它会将安装程序放入 `~/Downloads`。特意设计为**仅下载**——它从不安装或运行任何东西。
### 安装状态检测
如果满足以下任何条件，工具将显示为 `[installed]`：
1. 其 `check_cmd` 二进制文件在 `PATH` 中；
2. `/opt/tools/` 存在且非空；
3. 存在以该工具命名的 `pipx`/`uv` 工具 venv（捕获那些二进制名称不同的 CLI 工具，例如 `corscanner` → `cors`）；
4. 存在已知的 special-installer 产物（例如 Eisvogel 模板、Sysinternals 目录）。
### 内置工具
默认列表附带跨类别的 **89 个工具**，包括 Active Directory / Windows 枚举与滥用、ADCS、Kerberos、强制认证、隧道和文件传输、web 应用程序测试以及报告。按安装类型：
| 类型 | 数量 |
|------|-------|
| `git+pip` | 26 |
| `git+bash` | 13 |
| `apt` | 13 |
| `winbin` | 12 |
| `pip` | 11 |
| `go` | 8 |
| `rawfile` | 4 |
| `special` | 2 |
## 关于 `uv` 的说明
`uv` 是一个单一的快速二进制文件（来自 Astral），可替代 `pip`、`venv`、`virtualenv` 和 `pipx`，还可以管理 Python 版本：
- `uv tool install ` — 相当于 `pipx`（PATH 上的隔离 CLI 应用）。
- `uv venv` / `uv pip install` — 快得多的 venv + pip。
- `uv python install 3.12` — 获取并管理独立的 Python 构建。
安装在两处使用了它：
- 作为整个选项的快速可选 backend（`2) uv` 提示选项）。
- 对于任何锁定特定 Python 版本的工具**自动**使用。例如，`spraycharles` 锁定了 `numpy<2.0`，它没有 Python 3.13 wheel；在 Kali 的 3.13 上，这将强制进行注定失败源码构建。安装器将其锁定到 Python 3.12，并通过 `uv` 进行路由，`uv` 会根据需要下载独立的 3.12 解释器，从而使用预构建的 numpy wheel。`uv` 会在第一次需要时自动安装。
## 自定义
- **文件夹图标颜色：** 编辑 `kali-ui-setup.sh` 中的 `FOLDER_COLOR="teal"`（运行 `papirus-folders -l` 列出可用颜色）。
- **面板图标大小：** `kali-ui-setup.sh` 中的 `PANEL_ICON_SIZE` / `PANEL_ROW_SIZE`。
- **安装根目录：** `tool-installer.sh` 中的 `TOOLS_DIR="/opt/tools"`。
- **配置位置：** `~/.config/kali-tools/tools.conf`。
- **快捷键：** 映射在 `kali-ui-setup.sh` 的快捷键部分被故意固定；可在那里进行编辑。
## 故障排除
| 症状 | 原因 / 修复 |
|---------|-------------|
| 菜单仅显示少数工具 | 磁盘上有旧的 `tools.conf`。安装器现在会在 schema 升级时自动重新生成；你也可以删除 `~/.config/kali-tools/tools.conf` 并重新运行。 |
| 在 `pip` 安装时出现 `externally-managed-environment` | PEP 668。`pip` 类型现在通过 `pipx`/`uv` 安装，绝不使用系统解释器。 |
| 对于 `go` 类型的工具出现 `Go toolchain not found` | Go 不在此 shell 的 PATH 中。安装器探测 `/usr/local/go`；如果 Go 确实不存在，请重新运行 `kali-ui-setup.sh` 或 `sudo apt install golang-go`。 |
| `Could not open requirements file: requirements.txt` | 某些仓库不提供此文件。`git+pip` 处理程序现在会回退到 `pip install .`（如果存在打包元数据）、备用的 `requirements*.txt`，或仅克隆。 |
| 工具克隆提示输入 GitHub 用户名/密码 | 通常是 URL 错误/私有。`GIT_TERMINAL_PROMPT=0` 会使此类克隆快速失败而不是挂起。 |
| `spraycharles` 构建 `numpy` 失败 | Python 3.13 没有 `numpy<2.0` wheel；它会自动通过 `uv` 锁定到 3.12。 |
| pipx/uv 工具显示为未安装 | 已修复——检测现在会检查 pipx/uv 工具 venv 和 special-installer 产物，而不仅仅是 PATH。 |
| 重新着色的文件夹仍然看起来是蓝色的 | 文件管理器缓存了旧图标。运行 `thunar -q` 并重新打开，或者注销/登录。 |
### 日志
各工具的安装日志写入私有的、按用户的目录（`$XDG_RUNTIME_DIR/kali-tools-/`，模式 0700，回退到 `$TMPDIR`/`/tmp`），而不是所有人可读的 `/tmp/*.log`，因此其他本地用户无法读取你的用户名或你安装的工具。Burp 下载、uv 和 pipx 设置步骤将其日志写入同一个私有目录。
## 免责声明
本项目仅供**教育目的和授权安全测试使用**。不得将其用于任何非法或恶意活动，或修改以用于此类活动。**仅**对你拥有的系统或你有明确书面许可测试的系统使用安装的工具；你需自行负责遵守所有适用法律、法规和交战规则。
本软件按“原样”提供，不提供任何形式的担保。作者对任何滥用或因其使用而产生的任何损害概不负责。其下载的第三方工具是其各自作者的作品和责任。
## 许可证
本项目中的代码（两个脚本和此 README）在 **MIT License** 下发布——参见 [`LICENSE`](LICENSE)。此许可证仅涵盖本仓库中的代码。它**不**适用于脚本下载的第三方工具、主题或字体，其中每一项仍保留其自己单独的许可证。
标签：Blue Team, Cutter, Shell脚本, 桌面环境, 环境配置, 系统美化, 逆向工具