当前位置：首页 > news >正文

技术深度解析：Get-cookies.txt-LOCALLY - 本地化Cookie导出解决方案

news 2026/4/28 16:57:46

技术深度解析：Get-cookies.txt-LOCALLY - 本地化Cookie导出解决方案

【免费下载链接】Get-cookies.txt-LOCALLYGet cookies.txt, NEVER send information outside.项目地址: https://gitcode.com/gh_mirrors/ge/Get-cookies.txt-LOCALLY

Get-cookies.txt-LOCALLY是一款专注于本地化Cookie数据导出的浏览器扩展工具，采用零数据传输架构确保用户隐私安全。该工具支持Netscape和JSON两种标准格式导出，兼容wget、curl、Python3的MozillaCookieJar等主流工具链，为开发者和安全研究人员提供可靠的Cookie管理能力。

项目亮点

模块化架构设计

项目采用ES模块化设计，核心功能分布在三个独立模块中：

cookie_format.mjs- 负责Cookie格式转换，实现JSON到Netscape格式的映射算法
get_all_cookies.mjs- 处理跨浏览器Cookie获取逻辑，支持Chrome和Firefox的差异处理
save_to_file.mjs- 实现本地文件保存机制，确保数据不离开用户设备

安全隐私保障机制

扩展遵循权限最小化原则，仅申请必要的API访问权限：

activeTab- 获取当前活动标签页URL
cookies- 读取Cookie数据（仅读权限）
downloads- 本地文件导出功能
notifications- 更新通知机制

隐私保护通过本地处理架构实现，所有数据转换和文件生成均在用户浏览器沙盒内完成，完全避免网络传输风险。

跨浏览器兼容性

项目通过manifest.json和manifest-firefox.json双配置文件策略，解决Chrome和Firefox平台差异。核心模块通过条件判断处理浏览器特定API，确保功能一致性。

实战应用

API调试与自动化测试 ⚙️

开发者在API测试场景中，可直接使用导出的Cookie文件进行身份验证：

# 使用Netscape格式Cookie文件进行curl请求 curl -b exported_cookies.txt -X GET https://api.example.com/v1/user # 使用wget进行资源下载 wget --load-cookies cookies.txt https://example.com/protected-resource

Python爬虫集成 🕷️

Python开发者可通过MozillaCookieJar直接加载导出的Cookie文件：

from http.cookiejar import MozillaCookieJar import requests # 加载Netscape格式Cookie文件 cookiejar = MozillaCookieJar('cookies.txt') cookiejar.load(ignore_discard=True, ignore_expires=True) # 创建带Cookie的会话 session = requests.Session() session.cookies = cookiejar # 执行需要认证的请求 response = session.get('https://target-site.com/api/data')

浏览器状态迁移 🔄

用户在不同浏览器或设备间迁移时，可通过以下流程恢复登录状态：

在源浏览器导出当前网站的Cookie文件
将文件传输到目标设备
使用目标浏览器的开发者工具或扩展导入Cookie
恢复完整的会话状态

配置调优

性能优化策略 📊

Cookie筛选机制- 扩展自动过滤过期Cookie，减少无效数据导出
批量处理优化- 针对大量Cookie的导出场景进行内存优化
格式转换缓存- 重复导出相同数据时使用缓存机制提升性能

开发环境配置

项目采用现代JavaScript工具链：

# 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/ge/Get-cookies.txt-LOCALLY # 安装依赖 npm install # Firefox版本构建 npm run build:firefox # 加载扩展到浏览器 # Chrome: 打开chrome://extensions/，启用开发者模式，加载src目录 # Firefox: 使用web-ext工具或通过about:debugging加载

类型定义支持

项目提供完整的TypeScript类型定义文件src/@types/index.d.ts，为开发者提供完整的类型提示和IDE支持。

Get-cookies.txt-LOCALLY扩展界面展示Cookie数据表格和导出选项，支持Netscape和JSON格式导出

生态集成

命令行工具集成

导出的Cookie文件可直接与主流命令行工具集成：

# 与curl集成进行API测试 curl -b cookies.txt -H "Content-Type: application/json" \ -X POST https://api.example.com/endpoint \ -d '{"action": "test"}' # 与wget集成进行批量下载 wget --load-cookies cookies.txt \ --recursive --level=1 \ https://example.com/protected-area/

自动化测试框架

在自动化测试场景中，可通过编程方式生成和使用Cookie文件：

# Selenium测试中使用导出的Cookie from selenium import webdriver from http.cookiejar import MozillaCookieJar # 加载Cookie文件 cookiejar = MozillaCookieJar('test_cookies.txt') cookiejar.load() # 创建浏览器实例并设置Cookie driver = webdriver.Chrome() driver.get("https://example.com") for cookie in cookiejar: driver.add_cookie({ 'name': cookie.name, 'value': cookie.value, 'domain': cookie.domain }) # 刷新页面应用Cookie driver.refresh()

CI/CD管道集成

在持续集成环境中，可通过脚本自动化Cookie管理：

# GitHub Actions工作流示例 name: API Testing with Cookies jobs: test: runs-on: ubuntu-latest steps: - name: Export cookies run: | # 导出测试环境Cookie # 这里使用扩展导出的Cookie文件 cp test_cookies.txt ./cookies.txt - name: Run API tests run: | python -m pytest tests/api_tests.py \ --cookie-file=cookies.txt

技术实现原理

Cookie格式转换算法

核心转换模块采用高效的映射算法，将Chrome的JSON格式Cookie转换为Netscape标准格式：

// JSON到Netscape格式映射函数 const jsonToNetscapeMapper = (cookies) => { return cookies.map( ({ domain, expirationDate, path, secure, name, value }) => { const includeSubDomain = !!domain?.startsWith('.'); const expiry = expirationDate?.toFixed() ?? '0'; const arr = [domain, includeSubDomain, path, secure, expiry, name, value]; return arr.map((v) => typeof v === 'boolean' ? v.toString().toUpperCase() : v, ); }, ); };

跨浏览器兼容处理

扩展通过条件判断处理不同浏览器的API差异：

// 获取当前Cookie存储ID的兼容性处理 const getCurrentCookieStoreId = async () => { // Firefox支持tab.cookieStoreId属性 const [tab] = await chrome.tabs.query({ active: true, currentWindow: true }); if (tab.cookieStoreId) return tab.cookieStoreId; // Chrome通过cookies.getAllCookieStores获取 const stores = await chrome.cookies.getAllCookieStores(); return stores.find((store) => store.tabIds.includes(tab.id))?.id; };

文件导出机制

文件保存模块采用浏览器原生的downloads API，确保数据不经过任何中间服务器：

// 安全的本地文件保存实现 const saveToFile = (filename, content, mimeType) => { const blob = new Blob([content], { type: mimeType }); const url = URL.createObjectURL(blob); chrome.downloads.download({ url: url, filename: filename, saveAs: true }); };