Cookie 管理
🍪 注入、持久化、导入导出 Cookie。
snir 的 Cookie 能力分两类：注入（会话保持）与证据（采集存档）。
两类能力，别混淆
- 注入：让截图带上登录态（
--cookie*），影响"截到的内容" - 证据：把页面现有 Cookie 采集存档（
--save-cookies），只是"记录" 两者可同时用：注入登录态后，再把登录后的 Cookie 存为证据。
注入 vs 证据
| 目的 | 工具 | Result 字段 |
|---|---|---|
| 会话保持 | --cookie* / WithCookie* | — |
| 证据存档 | --save-cookies / WithCookies() | cookies |
注入方式
| 方式 | CLI | SDK | 适合 |
|---|---|---|---|
| 内联 | --cookie name=value | WithCookieStrings | 少量简单 |
| Header 串 | — | WithCookieHeader | a=1; b=2 |
| 结构化 | — | WithInjectedCookies | 含 domain/path |
| 持久化 | --cookie-file + --cookie-write-back | WithCookieFile + WithCookieWriteBack | 跨任务复用 |
| 导入 Netscape | --cookie-import | WithCookieImport | curl 登录态 |
| 导出 Netscape | --cookie-export | WithCookieExport | 供 curl 用 |
登录后截图流程
CLI 示例
bash
# 内联
snir scan example.com --cookie "session=abc" --cookie "token=xyz"
# 持久化 + 写回
snir scan example.com --cookie-file cookies.json --cookie-write-back
# 导入 curl 登录态
snir scan example.com --cookie-import login.txt
# 导出
snir scan example.com --cookie-export out.txt1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
SDK 示例
go
opts := sdk.NewScreenshotOptions(
sdk.WithCookieFile("cookies.json"),
sdk.WithCookieWriteBack(),
sdk.WithCookies(), // 同时作为证据采集
)1
2
3
4
5
2
3
4
5
CookieJar 与 Netscape
两种 Cookie 存储格式
- CookieJar（JSON）：snir 原生，跨任务复用，
--cookie-file - Netscape（
cookies.txt）：与 curl/wget 互通，--cookie-import/--cookie-export
一个 Cookie 在 snir 体系中的完整生命周期：
与 curl 互通的登录态
先用 curl 登录导出 cookies.txt，再 snir scan --cookie-import login.txt 直接带登录态截图——无需在 snir 里重做登录流程。
见 内部 CookieJar、Netscape Cookie。