sqlmap 1.10.10 配置参数详解

目标：把 sqlmap 的参数体系讲透——从 -h/-hh 帮助体系、-c 配置文件加载机制，到 16 个参数分组的逐项详解与默认值，最后沉淀一份可实测验证的"扫描预案"配置模板。全部命令与回显均在 Ubuntu 22.04.4 + sqlmap 1.10.10（pip 版）实测通过（2026-10-24）。

一、环境信息

本章记录实测环境与素材来源，读者在同类环境可直接复现。

• 操作系统：Ubuntu 22.04.4 LTS
• 工具版本：sqlmap 1.10.10（pip 安装，sqlmap --version 输出 1.10.10#pip，安装过程见《Ubuntu 22.04 安装 sqlmap 1.10.10 指南》）
• Python：3.10.12 / pip 22.0.2
• 靶场：自建 Python + SQLite 注入靶场，仅监听 127.0.0.1:8145，含 /user?id=1 注入点（UNION 注入已验证），供 -c 配置文件加载实测
• 参数素材：sqlmap -h（90 行）与 sqlmap -hh（330 行）完整输出采集于 2026-10-24；默认值取自包内 lib/core/defaults.py；配置模板取自包内 sqlmap.conf

⚠️ 安全声明：sqlmap 是攻击性安全工具，本文所有实验均针对自建授权靶场（127.0.0.1 本地监听）。未获得书面授权对他人系统使用 sqlmap 属违法行为。

二、前置条件

1. 已按《Ubuntu 22.04 安装 sqlmap 1.10.10 指南》完成安装，which sqlmap 返回 /usr/local/bin/sqlmap。
2. 如需复现本文 -c 配置文件实测，准备一个本地注入靶场（Python 标准库 http.server + sqlite3 即可搭建，监听 127.0.0.1，提供 /user?id=1 注入点）。
3. 配置文件路径认知：pip 安装后包内模板位于 /usr/local/lib/python3.10/dist-packages/sqlmap/sqlmap.conf（ls 实测存在），源码安装则位于解压目录根。

三、参数查看与修改方式

sqlmap 有 4 种参数查阅/固化途径：-h、-hh、-c 配置文件、--save 落盘。先看 -h 与 -hh 的差别（实测）：

sqlmap -h

        ___
       __H__
 ___ ___[,]_____ ___ ___  {1.10.10#pip}
|_ -| . [)]     | .'| . |
|___|_  [.]_|_|_|__,|  _|
      |_|V...       |_|   https://sqlmap.org

Usage: python3 sqlmap [options]

Options:
  -h, --help            Show basic help message and exit
  -hh                   Show advanced help message and exit
  --version             Show program's version number and exit
  -v VERBOSE            Verbosity level: 0-6 (default 1)
...

sqlmap -h | grep -c ""
sqlmap -hh | grep -c ""

90
330

结论：-h 只显示常用参数（90 行），-hh 显示全量参数（330 行，16 分组）。日常排查从 -h 入手，深度调参查 -hh。

3.1 配置文件加载（-c）

-c CONFIGFILE 从 INI 格式文件加载参数。关键规则：配置文件中的键名与 CLI 开关同名不同形——CLI 的 --tables 在 conf 里叫 getTables，--timeout 就叫 timeout。实测一段错误键名（[Enumeration] tables = True）的表现：

[08:52:36] [INFO] parsing configuration file 'shop-scan.conf'
...
[08:52:37] [INFO] testing connection to the target URL
[08:52:38] [INFO] testing if the target URL is stable
...
[08:52:45] [INFO] fetched data logged to text files under '/root/.local/share/sqlmap/output/127.0.0.1'

目标与检测均执行了，但枚举没有任何输出——错误键名被静默忽略，不报错。把键名改为官方 conf 中的正确写法 getTables = True 再跑：

[08:54:16] [INFO] fetching tables for database: 'SQLite_masterdb'
Database: SQLite_masterdb
[2 tables]
+--------------------+
| shop_items         |
| users              |
+--------------------+

[08:54:24] [INFO] fetched data logged to text files under '/root/.local/share/sqlmap/output/127.0.0.1'

users、shop_items 两张表成功枚举。这是 sqlmap 配置文件最大的坑：键名写错不报错、直接静默跳过。正确的键名清单见包内 sqlmap.conf（每个键都有注释说明）。

3.2 配置文件与命令行的合并关系（实测）

-c 与命令行参数是叠加合并而非二选一：conf 提供基线（如 getTables = True），命令行再追加新动作（如 --current-db），两类都会执行。实测（conf 含 url + getTables，命令行加 --current-db）：

sqlmap -c shop-scan.conf --batch --current-db

[08:58:09] [WARNING] on SQLite it is not possible to get name of the current database (use only '--tables')
[08:58:09] [INFO] fetching tables for database: 'SQLite_masterdb'
Database: SQLite_masterdb
[2 tables]
+--------------------+
| shop_items         |
| users              |
+--------------------+

conf 里的 getTables 与命令行的 --current-db 都生效了（SQLite 不支持当前库名枚举的提示为预期行为）。

3.3 修改参数的 4 条路径小结

四、参数总览（16 分组）

-hh 将全量参数组织为 16 个分组（实测分组标题，2026-10-24）：

💡 技术拓展：-hh 的分组顺序即 sqlmap 的运行流水线（定目标 → 构请求 → 圈注入面 → 检测 → 定技术 → 枚举取数 → 接管）。调参时顺着这条线找参数，比按字母序检索快得多。

五、核心参数分类详解

以下每个参数的默认值均为实测（-hh 输出与包内 lib/core/defaults.py 交叉核对，2026-10-24）。

5.1 Target：目标参数

5.2 Request：HTTP 请求参数

💡 说明：--delay/--safe-url 是对目标限速/IDS 的友好保护项；对自建单线程靶场，连续密集请求容易触发 connection timed out 重试（实测在 --dbs 枚举时出现过），提高 --timeout 或降低并发可缓解。

5.3 Optimization：优化参数

5.4 Injection：注入面圈定

5.5 Detection：检测灵敏度

⚠️ 注意：--risk 3 的 OR 型布尔注入会向目标写入条件数据（如把整表值置同），只对授权测试的靶机使用。

5.6 Techniques：注入技术

5.7 Enumeration：数据枚举

💡 说明：SQLite 是嵌入式单文件库，没有"服务器多库"概念，所以 --dbs/--current-db 这类多库枚举天然不适用——sqlmap 会明确提示改用 --tables。这是方言差异，不是故障。

5.8 General：通用行为

5.9 Miscellaneous 与 Non-SQL injection

--dependencies 实测（节选，用于直连特定 DBMS 前的依赖自检）：

[08:58:47] [WARNING] sqlmap requires 'python-psycopg2' third-party library in order to directly connect to the DBMS 'PostgreSQL'. Download from 'https://github.com/psycopg/psycopg2'
[08:58:47] [WARNING] sqlmap requires 'python-oracledb' third-party library in order to directly connect to the DBMS 'Oracle'. Download from 'https://oracle.github.io/python-oracledb/'
[08:58:47] [WARNING] sqlmap requires 'python-pymssql' third-party library in order to directly connect to the DBMS 'Microsoft SQL Server'. Download from 'https://github.com/pymssql/pymssql'
[08:58:47] [WARNING] sqlmap requires 'python-impacket' third-party library for out-of-band takeover feature. Download from 'https://github.com/coresecurity/impacket'

注意：这些 WARNING 只影响"直连数据库"与"带外接管"特性；走 HTTP 注入路径不需要任何第三方库。

六、扫描预案配置模板

sqlmap 没有"生产环境"概念（CLI 工具、无常驻服务），但可以把高频参数组合固化成 INI "预案文件"，用 -c 复用。以下模板基于包内 sqlmap.conf 的真实键名整理（默认值与第 5 节一致），保存为 plan.conf：

# ---- 目标 ----
[Target]
# 单目标：url = http://127.0.0.1:8145/user?id=1
# 批量目标：bulkFile = /root/targets.txt
# 请求文件：requestFile = /root/req.txt

# ---- 请求 ----
[Request]
timeout = 30
retries = 3
delay = 0
randomAgent = False

# ---- 检测 ----
[Detection]
level = 1
risk = 1

# ---- 技术 ----
[Techniques]
technique = BEUSTQ
timeSec = 5

# ---- 枚举 ----
[Enumeration]
getBanner = True
getTables = True
getColumns = False
dumpTable = False

# ---- 通用 ----
[General]
batch = True
flushSession = False
dumpFormat = CSV

逐项说明（键名 ↔ CLI 开关对照，均按包内 sqlmap.conf 实测核对）：

加载方式与实测验证（模板放入 shop-scan.conf，getTables = True 开启）：

sqlmap -c shop-scan.conf --batch --flush-session

[08:54:16] [INFO] fetching tables for database: 'SQLite_masterdb'
Database: SQLite_masterdb
[2 tables]
+--------------------+
| shop_items         |
| users              |
+--------------------+

适用场景：目标授权书要求"先摸表结构、暂不拖库"时，dumpTable=False、getColumns=True；确认后把 dumpTable 改 True 复扫。模板文件可按目标分文件管理（如 plan-tcp80.conf、plan-tcp8443.conf），配合第 3.2 节的叠加特性，临时动作走命令行、固定动作进预案。

七、常见问题

Q1：conf 里写了开关但不生效，也不报错？

九成是键名写错（如把 --tables 写成 tables）。正确键名必须以包内 sqlmap.conf 为准：枚举类是 getTables/getColumns/dumpTable/getBanner，通用类是 batch/flushSession。写错静默忽略，本文第 3.1 节有完整实录。

Q2：-c 配置文件和命令行同时给参数，谁赢？

两者叠加合并：conf 提供基线，命令行追加新动作，都执行（第 3.2 节实测）。想让某次运行覆盖预案，把要改的项写进命令行，conf 里的同键项保持不变即可（命令行开关最终仍以显式传入为准）。

Q3：单线程靶机枚举时频繁 connection timed out 重试？

自建 http.server 单线程处理请求，连续密集枚举会排队超时。sqlmap 按 --retries 3 自动重试并最终完成（实测 --dbs 时出现过一次超时重试，结果仍完整）。缓解：降低 --threads（默认 1 本就最保守）、提高 --timeout。

Q4：--risk 3 会不会破坏靶机数据？

会。risk 3 的 OR 型布尔注入会改写目标表数据，conf 注释原文写明"boolean-based blind SQL injection tests with AND are considered risk 1, with OR are considered risk 3"。授权靶场可玩，真实业务一律 risk ≤ 1。

Q5：如何确认某个 tamper 脚本存在与用途？

sqlmap --list-tampers

实测输出共 84 个脚本条目（如 apostrophemask.py、between.py 等），每条带一行用途说明；脚本本体在包内 tamper/ 目录（85 个 .py 文件，含 __init__.py）。

八、参考链接

• 包内模板：/usr/local/lib/python3.10/dist-packages/sqlmap/sqlmap.conf（1.10.10，2026-10-24 实测读取）
• 默认值定义：包内 lib/core/defaults.py
• 官方参数手册：sqlmap -hh 全量输出（330 行）与用户手册 https://github.com/sqlmapproject/sqlmap/wiki/Usage
• 站内系列：《sqlmap 1.10.10 介绍与选型指南》《Ubuntu 22.04 安装 sqlmap 1.10.10 指南》《sqlmap 1.10.10 常用 CLI 命令与工具详解》