云对象存储暴露扫描器与只读存储 CLI,用于经授权的安全测试、漏洞赏金工作以及你自有的基础设施。
BucketBuster 会针对 Yandex Cloud、VK Cloud、Selectel、SberCloud、Alibaba OSS、Tencent COS、Huawei OBS、Baidu BOS 和 China Mobile Cloud EOS 的公开端点检查候选存储桶名称。它可以识别可公开列出的存储桶、匹配与证书相关的对象名称,并可选地通过 HTTP GET 下载可公开访问的对象。存储命令还支持使用各提供商原生凭据进行认证列表、下载、元数据获取和签名 URL 生成。
需要授权: 仅对你拥有或已获得明确测试许可的资产使用此工具。扫描或下载第三方存储桶中的数据可能违法。你有责任遵守适用的法律、合同、漏洞赏金规则和提供商政策。
scan。git clone <repository-url>
cd bucketbuster
python -m venv .venv
激活虚拟环境:
# Linux/macOS
source .venv/bin/activate
# Windows PowerShell
.\.venv\Scripts\Activate.ps1
安装依赖:
python -m pip install -r requirements.txt
创建一个词表,例如 buckets.txt:
example-company
example-company-backup
example-company-documents
使用默认提供商集合、Yandex Cloud 和 VK Cloud 运行:
python bucketbuster.py scan --wordlist buckets.txt
扫描器会报告 HTTP 200 响应、公开列表、匹配的对象名称,以及看似存在的拒绝访问端点。404 响应会被忽略。
CLI 变更: 现在必须指定命令。原先以 python bucketbuster.py -w ... 开头的调用必须改为 python bucketbuster.py scan -w ...。
| 提供商标志 | 服务 | 包含的端点系列 |
|---|---|---|
yandex | Yandex Cloud | 存储和网站端点 |
vk | VK Cloud | vkcloud-storage.ru 端点 |
selectel | Selectel | S3 和 selstorage.ru 端点 |
sber | SberCloud | OBS 和 s3.cloud.ru 端点 |
aliyun | 阿里云 OSS | 选定的中国区域 |
tencent | 腾讯云 COS | 选定的中国和亚洲区域 |
huawei | 华为云 OBS | 选定的中国区域 |
baidu | 百度云 BOS | 选定的中国和亚洲区域 |
cmecloud | 中国移动云 EOS | 来自所提供 EOS 工具的 30 个区域 |
提供商分组:
--providers russia # yandex, vk, selectel, sber
--providers china # aliyun, tencent, huawei, baidu, cmecloud
--providers all # every supported provider
你也可以提供一个逗号分隔的列表,例如:
python bucketbuster.py scan -w buckets.txt --providers aliyun,tencent
每个提供商使用各自的凭据。一个提供商的密钥绝不会被复用于另一个提供商,且不会使用无关的 AWS 配置文件、实例元数据或 .netrc 条目来对请求进行身份验证。
| 提供商 | 身份验证 API |
|---|---|
yandex、vk、selectel、cmecloud | 通过 boto3 使用 S3 Signature V4 |
aliyun | 通过 oss2 使用原生 OSS V4 |
tencent | 通过 cos-python-sdk-v5 使用原生 COS |
huawei | 通过 esdk-obs-python 使用原生 OBS |
sber | 对 obs.*.hc.sbercloud.ru 使用 OBS;对 s3.cloud.ru 使用 S3 |
baidu | 对区域 BOS 使用原生 BCE/BOS 签名;对 s3.*.bcebos.com 使用 S3 |
使用大写形式的提供商标志设置环境变量:
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_ID
BUCKETBUSTER_<PROVIDER>_ACCESS_KEY_SECRET
BUCKETBUSTER_<PROVIDER>_SESSION_TOKEN
BUCKETBUSTER_<PROVIDER>_ENDPOINT
BUCKETBUSTER_<PROVIDER>_REGION
例如,BUCKETBUSTER_CMECLOUD_ACCESS_KEY_ID 和
BUCKETBUSTER_CMECLOUD_ACCESS_KEY_SECRET。CMECloud 还接受独立工具的
EOS_ACCESS_KEY_ID、EOS_ACCESS_KEY_SECRET、EOS_SESSION_TOKEN、
EOS_ENDPOINT 和 EOS_REGION 变量作为优先级较低的别名。
对于存储命令,显式的 --access-key-id、--access-key-secret 以及可选的
--session-token 会按字段覆盖环境变量值。对于扫描,请使用特定于提供商的标志,例如
--cmecloud-access-key-id 和
--cmecloud-access-key-secret;同样的模式适用于每个提供商。
不完整的密钥对,或没有配对密钥的令牌,都会被拒绝。
优先使用环境变量:命令行中的密钥可能会出现在 shell 历史和 进程列表中。不要在报告或缺陷提交中包含实际凭据。
命令只选择一个 --provider;它们不需要词表,也不需要探测
所有区域。通用选项可以出现在命令之前或之后,就像
提供的 EOS 工具一样:
python bucketbuster.py --provider cmecloud \
--endpoint eos-beijing-1.cmecloud.cn --region beijing-1 list-buckets
python bucketbuster.py list-objects --provider cmecloud \
--endpoint eos.ecso.hecd-1.cmecloud.cn --bucket example-company --key certificates/
python bucketbuster.py list-objects --provider cmecloud \
--bucket example-company --key certificates/ --max-keys 100
python bucketbuster.py list-objects-all --provider cmecloud \
--bucket example-company --prefix documents/
python bucketbuster.py download-bucket --provider cmecloud \
--bucket example-company --prefix documents/ --output-dir ./authorized-downloads
python bucketbuster.py get-object --provider cmecloud \
--bucket example-company --key documents/readme.txt --output ./readme.txt
python bucketbuster.py head-object --provider cmecloud \
--bucket example-company --key documents/readme.txt
python bucketbuster.py presign --provider cmecloud \
--bucket example-company --key documents/readme.txt --expires 600
| 命令 | 行为与选项 |
|---|---|
list-buckets | 列出账户存储桶;需要一对凭证和账户列表权限。未指定 --region 或 --endpoint 时,会尝试该提供商所有已知区域并对结果去重。 |
list-objects | 单页列表;--key 为前缀,配合 --marker、--max-keys 和 --delimiter。 |
list-objects-all | 自动分页;--prefix、--delimiter 和 --max-keys。 |
download-bucket | 跨所有页面下载每个匹配前缀的对象;--prefix、--max-keys、--output-dir/-o(默认:存储桶名称)。 |
get-object | 下载 --key;--output/-o 或当前目录下安全的键相对路径。--stream 仅将对象字节写入 stdout。 |
head-object | 返回 --key 的元数据。 |
presign | 打印签名 GET URL;需要凭证。--expires 默认 3600 秒,范围 1-604800。 |
除 list-buckets 外,所有存储命令都需要 --bucket。在存储桶允许的情况下,读取可以匿名进行;提供的凭证仅在其权限允许时启用访问。正常结果为 JSON;presign 打印 URL,get-object --stream 输出字节。错误写入 stderr 并返回非零退出码。签名 URL 是一种持有者凭证:请妥善保护。
需要时传入 --endpoint(HTTPS API 主机名,不含存储桶/路径)和 --region。网站/自定义域名不是经过身份验证的 API 端点。默认值为 ru-central1(Yandex)、ru-msk(VK)、ru-1(Selectel)、ru-moscow-1(Sber OBS)、cn-hangzhou(OSS)、ap-guangzhou(COS)、cn-north-4(OBS)、bj(BOS)和 beijing-1(EOS)。对于覆盖的端点,请使用提供商实际的签名区域。Sber OBS 和 S3 密钥可能属于不同的后端;它们不可互换。腾讯云存储桶名称必须包含数字 APPID 后缀,例如 example-company-123456789。
--path-style 在支持的情况下选择路径寻址;COS 拒绝该方式。--timeout 默认 30 秒;--delay 默认每次 API 请求 0.12 秒。不会跟随重定向到任意主机。请提供正确的区域/端点,而不是依赖区域重定向。
SDK 签名和命令行为已离线测试。实际服务验收,包括导入的 EOS 区域清单和旧版 Sber 端点,仍需针对您授权的提供商账户进行验证。
| 选项 | 默认值 | 描述 |
|---|---|---|
-w、--wordlist PATH | 必需 | 包含候选存储桶名称的文件,每行一个。空行和以 # 开头的注释会被忽略。 |
--providers VALUE | yandex,vk | 逗号分隔的提供商标志,或 all、russia 或 china。 |
--dns | 禁用 | 执行被动 DNS 检查并跳过无法解析的主机名。 |
--resolvers | 系统解析器 | 配合 --dns,改为查询这些解析器:逗号分隔的 IP(8.8.8.8,9.9.9.9)或每行一个 IP 的文件。 |
-t、--threads N | 12 | 并发存储桶工作线程数。 |
--delay SECONDS | 0.12 | HTTP 请求之间的延迟。 |
--timeout SECONDS | 30 | 请求超时。 |
--<provider>-region VALUE | 提供商端点 | 将该提供商限制到某个区域。 |
--<provider>-endpoint HOST | 提供商端点 | 将该提供商限制到显式的 HTTPS API 端点。 |
在没有 EOS 区域/端点覆盖的情况下,scan --providers cmecloud 会在导入的 30 个区域清单中探测两种寻址方式。这会使每个候选最多产生 60 次端点尝试。默认提供商集合仍为 Yandex/VK。
| 选项 | 描述 |
|---|---|
--download-ext LIST | 逗号分隔的扩展名,例如 .cer,.crt。省略时会自动添加前导点。需要 --download。 |
--download-name LIST | 逗号分隔、不区分大小写的名称/路径子串或简单 * 通配符。需要 --download。精确名称也会在发现的不可列出存储桶上尝试。 |
下载过滤器使用 OR 逻辑。在没有自定义过滤器的情况下,扫描下载会选择与证书相关的文件。--download-all 会忽略这些过滤器。这些标志不会过滤扫描报告;不支持 --match-* 选项。
| 选项 | 描述 |
|---|---|
-o、--output PATH | 写入 JSON 报告。结果在扫描期间流式输出。 |
--csv PATH | 写入 CSV 报告。结果在扫描期间流式输出。 |
| 选项 | 默认值 | 描述 |
|---|---|---|
--download | 禁用 | 使用未认证的 HTTP GET 请求从公开列表中下载匹配的对象。 |
--download-all | 禁用 | 与 --download 一起使用时,尝试每个已解析公开列表中的每个对象,并忽略匹配过滤器。 |
--download-dir PATH | ./downloads | 下载对象的根目录。 |
--allow-private-keys | 禁用 | 允许下载 .pfx、.p12、.key、.p8 和 .pem 对象。仅在明确授权时使用。 |
--download-all 需要 --download。每个对象的下载限制为 25 MiB,空响应或非 200 响应不会被保存。除非明确提供 --allow-private-keys,否则私钥容器会被阻止。
使用被动 DNS 检查扫描俄罗斯/独联体提供商:
python bucketbuster.py scan -w buckets.txt --providers russia --dns
扫描所有受支持的提供程序,并写入两种报告格式:
python bucketbuster.py scan \
--wordlist buckets.txt \
--providers all \
--dns \
--output findings.json \
--csv findings.csv
按扩展名下载证书文件:
python bucketbuster.py scan -w buckets.txt --download --download-ext .cer,.crt,.der
使用子字符串和简单通配符匹配名称和路径:
python bucketbuster.py scan \
-w buckets.txt \
--download --download-name 'cryptopro,*keystore*,backups/*.sql'
仅下载与所选扩展名匹配的对象:
python bucketbuster.py scan \
-w buckets.txt \
--providers aliyun,tencent \
--download-ext .cer,.crt,.p7b \
--download \
--download-dir ./authorized-downloads