Files
Obsidian/MyArticles/Browser Cookie3 详解:功能特性与使用指南.md
T
coco 8b94d76799 a
2026-07-21 13:57:15 +08:00

176 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# browser_cookie3 详解
`browser_cookie3` 是一个 Python 库,能够从主流网页浏览器中加载 cookie 到 `cookiejar` 对象,让你无需手动登录就能通过 Python 访问浏览器中已登录的网页内容。
## 核心特性
### 1. 支持的浏览器
涵盖多平台主流浏览器,具体支持情况:
|浏览器|Linux|MacOS|Windows|
|---|---|---|---|
|Chrome|✅|✅|✅|
|Firefox|✅|✅|✅|
|LibreWolf|✅|✅|✅|
|Opera|✅|✅|✅|
|Opera GX|-|✅|✅|
|Edge|✅|✅|✅|
|Chromium|✅|✅|✅|
|Brave|✅|✅|✅|
|Vivaldi|✅|✅|✅|
|Safari|-|✅|-|
|W3m|✅|-|-|
|Lynx|✅|-|-|
### 2. Cookie 存储机制
- 多数浏览器(Chrome/Firefox 等)将 Cookie 存储在用户主目录的 SQLite 数据库中;
- 部分浏览器(如 W3m/Lynx)存储在制表符分隔的 TXT 文件中。
## 安装
通过 pip 安装最新版本(当前为 0.20.1):
```Bash
pip install browser-cookie3
```
## 使用方法
### 1. Python 代码中使用
#### 加载指定浏览器的 Cookie
以 Chrome 为例,结合 `requests` 访问网页:
```Python
import browser_cookie3
import requests
# 加载 Chrome 浏览器的 Cookie
cj = browser_cookie3.chrome()
# 访问需要登录的网页
r = requests.get("https://bitbucket.org", cookies=cj)
print(r.content.decode('utf-8')) # 输出已登录状态的网页内容
```
#### 加载所有浏览器的 Cookie
无需指定浏览器,自动加载所有支持浏览器的 Cookie:
```Python
import browser_cookie3
import requests
cj = browser_cookie3.load()
r = requests.get("https://bitbucket.org", cookies=cj)
print(r.content.decode('utf-8'))
```
#### 过滤指定域名的 Cookie
仅加载目标域名的 Cookie,减少冗余:
```Python
import browser_cookie3
import requests
# 仅加载 www.bitbucket.com 的 Chrome Cookie
cj = browser_cookie3.chrome(domain_name='www.bitbucket.com')
r = requests.get("https://bitbucket.org", cookies=cj)
print(r.content.decode('utf-8'))
```
### 2. 命令行使用
执行 `browser-cookie --help` 查看所有参数,常用示例:
#### 查看指定浏览器+域名的 Cookie 值
```Bash
# 查看 Firefox 中 stackoverflow.com 的 acct 字段 Cookie
browser-cookie --firefox stackoverflow.com acct
```
#### 输出 Cookie 的 JSON 详情
```Bash
# 以 JSON 格式输出 Chrome 中 stackoverflow.com 的 acct 字段 Cookie
browser-cookie --json --chrome stackoverflow.com acct
```
#### 检查 Cookie 是否存在
```Bash
# 检查不存在的域名/Cookie,返回对应状态
browser-cookie nonexistent-domain.com nonexistent-cookie && echo "Cookie found" || echo "No cookie found"
```
## 开发与贡献
### 1. 计划中的不兼容变更(1.0 版本)
- 优化 Cookie 文件检查顺序(如 Firefox 优先使用 `profiles.ini` 中定义的默认路径)。
### 2. 贡献方向
目前已支持多平台主流浏览器,欢迎贡献:
- 新增其他浏览器的支持;
- 补充现有浏览器在未覆盖平台的适配;
- 修复 Cookie 解析/加载的已知问题。
## 许可证
该项目基于 **GNU LESSER GENERAL PUBLIC LICENSE v3** 开源,允许自由复制、分发和修改(需遵循许可证条款)。
## 依赖说明
安装时自动依赖以下库:
- `lz4`:数据压缩/解压缩;
- `pycryptodomex`:Cookie 解密(如 Chrome 的加密 Cookie);
- `dbus-python/jeepney`:Linux 下访问系统密钥库(依 Python 版本适配);
- `shadowcopy`:Windows 下支持影子拷贝获取 Cookie;
- 命令行入口依赖:`entry_points` 注册 `browser-cookie` 命令。
## 常见问题
### 1. 测试新鲜 Cookie 文件(排除用户环境问题)
以 Chrome/Chromium 为例(Linux/Mac):
```Bash
# 启动临时 Chrome 实例,生成全新 Cookie 文件
google-chrome-stable --user-data-dir=browser_cookie3
# 关闭浏览器后,Cookie 文件位于 browser_cookie3/Default/Cookies
```
访问如 `https://www.theverge.com/`(接受 GDPR 提示)生成测试用 Cookie,避免上传主目录的敏感 Cookie 文件。
### 2. 版本更新记录
关键版本变更:
- v0.20.0:新增 CLI、支持 Lynx/W3m/Arc 浏览器、Windows 影子拷贝、修复 ResourceWarning;
- v0.14.0:新增 HTTPOnly 标记、修复 Firefox/Chromium Cookie 过期时间;
- v0.11.4:支持 Chromium v80、优化 Cookie 文件缺失报错。
如果遇到问题,可在 [GitHub 仓库](https://github.com/borisbabic/browser_cookie3) 提交 Issue(需注明浏览器版本、操作系统)。