如何用CookieCloud实现跨设备Cookie同步？完整指南让你的浏览器数据无缝流转✨
项目地址: https://gitcode.com/gh_mirrors/co/CookieCloud CookieCloud是一款轻量级的自托管Cookie同步工具，能帮你将浏览器Cookie和LocalStorage安全同步到手机或云端，支持端到端加密和自定义同步间隔。通过自建服务器掌控数据隐私，告别多设备登录的繁琐！
🚀 为什么选择CookieCloud？三大核心优势
1️⃣ 数据安全可控
采用AES加密算法保护数据传输，所有Cookie和LocalStorage仅存储在你的私人服务器中。加密密钥由用户UUID和密码生成，确保即使服务器被访问也无法获取内容。
2️⃣ 跨设备无缝体验
无论是工作电脑、家用PC还是移动设备，只需简单配置即可共享登录状态。特别适合需要在多终端保持网站登录状态的用户，如开发者、内容创作者和重度互联网使用者。
3️⃣ 开源免费+高度可定制
项目完全开源，核心加密逻辑位于extension/function.js。支持自定义同步频率、筛选特定网站Cookie，还能通过examples/fixediv/中的多语言解密示例扩展功能。
📸 CookieCloud界面展示
CookieCloud插件主界面，可直观管理同步状态和加密设置
通过浏览器开发者工具查看同步日志，轻松调试问题
🔧 快速部署指南：三种方式任选
方法一：Docker一键部署（推荐）
适合新手的最简单方案，支持Linux/amd64、Linux/arm64等架构：
docker run -p=8088:8088 easychen/cookiecloud:latest
默认端口8088，数据存储在容器内部。如需持久化数据，可使用Docker Compose：
version: '3'
services:
cookiecloud:
image: easychen/cookiecloud:latest
container_name: cookiecloud-app
restart: always
volumes:
- ./data:/data/api/data
ports:
- 8088:8088
方法二：Node.js手动部署
适合已安装Node环境的开发者：
git clone https://gitcode.com/gh_mirrors/co/CookieCloud
cd CookieCloud/api
yarn install
node app.js
服务默认监听8088端口，支持通过API_ROOT环境变量自定义路径。
方法三：第三方公共服务（测试用）
- http://45.138.70.177:8088
- http://nastool.cn:8088
⚠️ 注意：公共服务仅用于临时测试，重要数据请务必自建服务器！
🌐 浏览器插件安装与配置
支持的浏览器
- 官方支持：Chrome、Edge
- 社区支持：Firefox（需手动编译：
cd extension && pnpm build --target=firefox-mv2）
安装步骤
配置同步服务
- 点击插件图标打开设置面板
- 输入服务器地址（如
http://localhost:8088） - 设置UUID和密码（用于生成加密密钥）
- 选择同步频率（支持即时、5分钟、1小时等选项）
💻 高级应用：自动化场景示例
无头浏览器集成
通过CookieCloud同步的Cookie可用于自动化测试或爬虫，examples/playwright/tests/example.spec.js展示了Playwright集成方案：
test('使用CookieCloud访问网站', async ({ browser }) => {
// 从云端获取并解密Cookie
const cookies = await cloud_cookie(COOKIE_CLOUD_HOST, COOKIE_CLOUD_UUID, COOKIE_CLOUD_PASSWORD);
// 注入Cookie到浏览器上下文
const context = await browser.newContext();
await context.addCookies(cookies);
const page = await context.newPage();
await page.goto('https://目标网站.com');
// 已自动登录，可执行后续操作
});
多语言解密实现
项目提供多种语言的解密示例，包括：
- Python：examples/fixediv/python/decrypt.py
- Java：examples/fixediv/java/src/main/java/com/cookiecloud/decrypt/DecryptMain.java
- Go：examples/fixediv/go/decrypt.go
❓ 常见问题解答
同步是双向的吗？
目前仅支持单向同步（一个浏览器上传，其他浏览器下载），多设备同时编辑可能导致数据冲突。
支持LocalStorage同步吗？
是的！v0.1.5+版本已支持同域名下的LocalStorage同步，数据格式为{ cookie_data, local_storage_data }。
如何查看同步日志？
在浏览器扩展管理页面找到CookieCloud，点击"服务工作线程"即可打开日志面板，查看加密、上传、下载等操作记录。
🛠️ 技术原理简析
加密流程
- 密钥生成：
md5(uuid+password)取前16位作为AES密钥 - 数据加密：
AES.encrypt(JSON.stringify({cookie_data, local_storage_data}), key) - 传输存储：加密后的字符串通过API上传至服务器
核心代码结构
- 前端加密：extension/function.js
- 后端API：api/app.js
- 多语言解密示例：examples/fixediv/
📝 注意事项
- 数据备份：定期导出加密数据，防止服务器故障导致数据丢失
- 密码安全：UUID和密码是解密关键，请妥善保管
- 浏览器兼容性：Firefox与Chrome的Cookie格式存在差异，不可混用
- 版本更新：v0.3.0+使用wxt框架重构，需注意配置迁移
通过CookieCloud，你可以打造专属的跨设备数据同步方案，既保障隐私安全，又提升工作效率。立即部署体验，让浏览器数据在你的设备间无缝流转吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
