sqlmap-x —— 三模式(GUI / TUI / CLI)sqlmap 启动器
在不改动 sqlmap 本体的前提下,为 sqlmap 提供三种操作界面:
| 模式 | 命令 | 说明 |
|---|---|---|
| CLI | sqlmap-cli |
原样透传给原生 sqlmap,行为与 sqlmap … 完全一致 |
| TUI | sqlmap-tui |
Textual 终端界面:分组选项 + 流式日志 + 运行/停止/存档 |
| GUI | sqlmap-gui |
tkinter 桌面界面:选项 Notebook + 流式日志 + 运行/停止/存档 |
sqlmap 是开源渗透测试工具,本启动器仅为其编写界面层,未增删任何检测/利用 能力,仅面向已授权的安全测试与研究场景。请仅用于你拥有权限或已获授权 的目标。
设计
CLI ─┐
TUI ─┼─▶ core/ ─▶ 子进程驱动 vendor/sqlmap/sqlmap.py(零修改)
GUI ─┘ ├─ catalog 解析 `sqlmap -hh` → 选项目录(随 sqlmap 版本自动失效重建)
├─ runner 选项→argv、Popen 流式输出、取消杀进程树、退出码
├─ profiles 任务配置档 JSON(三模式共享/复用)
└─ output 运行日志 → 结构化摘要(DBMS / 注入点 / technique / payload)
- 集成方式:子进程 CLI 包装。
vendor/sqlmap/里的 sqlmap 原封不动,启动器只做 命令行组装与输出流转发,因此功能与官方 CLI 100% 一致。 - CLI 透传:
sqlmap-cli -u … --dbs等价于sqlmap -u … --dbs,退出码原样返回。 - 选项目录:自动解析当前 vendored sqlmap 的
-hh,分组/类型/默认值/帮助随之同步; 升级 sqlmap 后目录按版本号自动重建,无需手工维护。
安装
# 从 PyPI 安装(推荐;会自动拉取 sqlmap 本体)
pip install sqlmapx
或从源码安装(Windows 可直接跑 install.bat):
git clone --depth 1 https://github.com/sqlmapproject/sqlmap.git vendor/sqlmap
python -m pip install -e . # 安装 textual 依赖与三个可执行入口
sqlmap 自动发现顺序:环境变量 SQLMAP_HOME → pip 安装的 sqlmap 包 → 包内 vendor/sqlmap。无网络时把 sqlmap 放到 vendor/sqlmap/ 即可。
使用
sqlmap-cli -u "http://target/?id=1" --dbs # 原生透传
sqlmap-tui # 终端界面(极简主屏)
sqlmap-gui # 桌面窗口(极简主屏)
python -m sqlmapx --mode tui # 模块方式,等价
极简操控(TUI / GUI)
主屏只放三样:目标输入 → 一键任务 → 常用参数,点一下 = 跑通一条典型路径:
- 一键任务:探测注入 / 列数据库 / 列表 / 读数据 / 拿 OS 壳 / 拿 SQL 壳 / 枚举用户 / 读哈希 / 读权限 / 读文件 / 执行命令 / OOB-XXE / 指纹·WAF 识别。
- 常用参数:batch / verbosity / level / risk / technique / tamper / proxy / threads / delay / dbms / cookie / POST 数据,直接勾选或填值。
- 全选项:GUI 点"专家选项"展开、TUI 按
[m]展开 16 分组 240+ 项专家表单, 满足高级需求。
预设只是 sqlmap 原生选项的组合,不新增任何能力;目标与库表等占位(-D/-T
等)由界面提示补全后随命令带出。任务配置可 Save/Load 复用(存于 profiles/)。
目录
vendor/sqlmap/ 原版 sqlmap(勿改)
sqlmapx/ 启动器源码(core / cli / tui / gui)
profiles/ 任务配置档、扫描输出、选项目录缓存
install.bat 一键安装
requirements.txt textual(GUI 用标准库 tkinter,无额外依赖)
升级 sqlmap
重新 git pull/重新 clone vendor/sqlmap 即可;选项目录会在下次启动按新版本自动重建。
授权与免责声明
本项目仅用于已授权目标的安全测试、教学与研究。使用者须自行确认对目标拥有合法 权限,遵守当地法律法规。项目对因不当使用造成的任何损失不负责。
Release files for sqlmapx 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sqlmapx-0.1.0.tar.gz | 27.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sqlmapx-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 56.1 kB
Release files / sqlmapx-0.1.0.tar.gz
| Download URL | sqlmapx-0.1.0.tar.gz |
|---|---|
| Size | 27.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
684991431f75286640aa2c4cd619ac86f4c4a02ceddbcd57433cc2e26e392016
|
|
BLAKE2b-256 checksum How to use checksums |
1d01bb763a6e81720b73b084da0503057cfea8622c09e8df3c786d398f1ba524
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / sqlmapx-0.1.0-py3-none-any.whl
| Download URL | sqlmapx-0.1.0-py3-none-any.whl |
|---|---|
| Size | 28.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5add4d51e3b0c0fd8f2cb29dfde64a6f4459fff75430aa89edf98dbe6c92593d
|
|
BLAKE2b-256 checksum How to use checksums |
0a6556eab25532b23456acc82202e4d6ba13f0d0df0d629695a194873bd9c3c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log