sherlock
一个用户名，482 个站点

{
  "GitHub": {
    "url": "https://github.com/{}",
    "urlMain": "https://github.com",
    "username_claimed": "blue",
    "username_unclaimed": "thisuserdoesnotexist1234567890",
    "errorType": "status_code"
  },
  "某国内平台": {
    "url": "https://example.com/u/{}",
    "errorType": "message",
    "errorMsg": "用户不存在",
    "regexCheck": "^[A-Za-z0-9_-]{3,20}$"
  }
}

# 1. 装 pipx（已装可跳过）
python3 -m pip install --user pipx
python3 -m pipx ensurepath

# 2. 装 sherlock
pipx install sherlock-project

# 3. 验证（必须看到版本号）
sherlock --version

pip install sherlock-project
# 若提示 command not found，说明 Scripts 目录不在 PATH，改用模块方式跑：
python3 -m sherlock_project --version

# 拉镜像
docker pull sherlock/sherlock

# 跑一次：把结果写回当前目录（-v 挂载是必须的，否则报告留在容器里随它一起消失）
docker run --rm -v "$PWD/sherlock-results:/out" sherlock/sherlock \
  --folderoutput /out yourname

git clone https://github.com/sherlock-project/sherlock.git
cd sherlock
python3 -m pip install -r requirements.txt
python3 -m sherlock_project yourname

# 想加自己的站？直接编辑这个文件，不用碰 Python：
# sherlock_project/resources/data.json

# 拿官方自检样本跑，理论上只有 1 个站会命中
sherlock --site GitHub blue

# 期望输出（大意）：
# [*] Checking username blue on:
# [+] GitHub: https://github.com/blue

sherlock yourname --print-found --timeout 15

sherlock jiangtian wuchenge nange old_id1 old_id2 \
  --folderoutput ./osint-2026 --csv --print-found --timeout 15

sherlock yourname --site GitHub --site Reddit --print-all

sherlock yourname --xlsx --csv --print-found -o ./报告

# 先确认代理端口活着（Clash 默认 7890，其他客户端看设置）
curl -x socks5h://127.0.0.1:7890 -I https://github.com --max-time 8

# 通了再跑
sherlock yourname --proxy socks5://127.0.0.1:7890 --print-found --timeout 20

# macOS：brew install tor && brew services start tor
# Linux：apt install tor && systemctl start tor

sherlock yourname --tor --print-found --timeout 30

# 每个请求换链路（极慢，只在对单站密集查询时用）
sherlock yourname --site GitHub --unique-tor

# 一正：肯定存在的名字（GitHub 官方叫 blue）
sherlock blue --site GitHub --print-all

# 一反：肯定不存在的乱码
sherlock zzq9x8v7u6t5s4r3q2p1 --site GitHub --print-all

# 一正一反都对，这个站的判定才可信；错一个，它的命中全部打问号

────────────────── 装 ──────────────────
pipx install sherlock-project
python3 -m pip install sherlock-project        # 备选
docker run --rm -v "$PWD/out:/out" sherlock/sherlock --folderoutput /out NAME

────────────────── 验 ──────────────────
sherlock --version
sherlock blue --site GitHub --print-all        # 应命中 1 个

────────────────── 跑 ──────────────────
sherlock NAME --print-found --timeout 15
sherlock NAME1 NAME2 NAME3 --folderoutput ./out --csv
sherlock NAME --site GitHub --site Reddit --print-all
sherlock NAME --xlsx --csv -o ./report
sherlock NAME --proxy socks5://127.0.0.1:7890 --print-found
sherlock NAME --tor --print-found              # 慢

────────────────── 读 ──────────────────
[+]  存在        [-]  不存在        [?]  没问到（≠ 没有）

────────────────── 铁律 ──────────────────
1. ID 相同 ≠ 同一人，必须交叉验证
2. 只查自己、授权对象、公开身份的机构
3. 不写身份结论，只写证据链
4. 查完删除中间产物