常见问题 FAQ
❓ 使用 snir 时的常见疑问解答。
按诉求快速定位能力：
按主题归类的常见疑问全景：
安装与运行
截图需要 Chrome 吗？
需要本地 Chrome/Chromium，或指向远程 CDP 端点 --wss ws://host:9222/devtools/browser/<id>。见 远程 Chrome。
找不到 Chrome 怎么办？
bash
snir scan example.com --chrome-path /usr/bin/chromium或让 chromedp 自动发现，或用远程 Chrome。
支持 Windows 吗？
二进制主要面向 Linux/macOS/BSD。Windows 可从源码构建，但需自行解决 Chrome 路径问题。
功能
--ports 是端口扫描吗？
不是端口扫描
--ports 把裸 host/IP 展开成 Web 候选 URL（如 host:8080 → http://host:8080、https://host:8080），是 Web 端点展开，不是 TCP/UDP 探测。snir 不做端口发现。
如何只截某个元素？
bash
snir scan example.com --selector "#main"
# 或 XPath
snir scan example.com --xpath "//div[@id='main']"如何截完整长页面？
bash
snir scan example.com --full-page如何模拟手机？
bash
snir scan example.com --device iphone-15
snir scan --list-devices # 查看全部预设如何用代理？
bash
snir scan example.com --proxy http://127.0.0.1:8080
# 或轮换
snir scan file -f urls.txt --proxy-list http://p1:8080 --proxy-list http://p2:8080 --proxy-strategy round-robin见 代理。
如何登录后再截图？
输出
JSONL、CSV、SQLite 选哪个？
| 格式 | 特点 | 适合 |
|---|---|---|
| JSONL | 流式追加，每行一条 | 管线、jq、下游脚本 |
| CSV | 扁平表格 | Excel、BI |
| SQLite | 结构化、建索引、可关联查询 | 长期存储与分析 |
可同时启用
--write-jsonl --write-csv --db 一起开，Result 会广播给所有 Writer，无需多次扫描。
截图保存在哪？
默认 ./screenshots/，用 --screenshot-path 修改。文件名由 SanitizeFilename 清理非法字符。
性能
并发多少合适？
取决于机器与目标。--threads 控制并发；太多会触发目标限流或耗尽内存。建议从 5-10 起步。见 性能调优。
如何复用浏览器？
用共享池（SDK Shared* 函数）或 snir provider 跨进程共享。见 并发与池。
安全
可以扫描任意网站吗？
须在授权范围内扫描第三方资产。默认黑名单屏蔽内网与元数据地址以防 SSRF。见 安全注意。