CookieCloud 使用教程
大家好,感谢关注 CookieCloud ,这里是使用教程
什么是CookieCloud
CookieCloud 是一个 Cookie 同步工具,它可以通过浏览器插件提取 Cookie ,本地加密后上传到可以自行搭建的云端。或者从云端下载加密后的 Cookie ,解密后覆盖到浏览器。当然,你也可以编写脚本下载解密并传入无头浏览器或者爬虫,来进行自动化
什么是CookieCloud
为了降低复杂度,减少同步冲突, CookieCloud 采用单向同步的方式工作。也就是说,一个浏览器要么处于上传状态,要么处于下载覆盖状态。
CookieCloud的安全性
因为 Cookie 数据非常敏感,因此 CookieCloud 采用强制端对端加密。也就是说无论加密和解密都是发生在你的电脑上,服务器端接触到的只有加密后的数据。
CookieCloud的安装、配置和使用
- 安装浏览器插件
- 搭建和选择服务器端
下边我们来看看如何安装、配置 CookieCloud 。大的步骤分两步:安装浏览器插件和搭建和选择服务器端。
CookieCloud插件的安装
- 安装浏览器插件
- 搭建和选择服务器端
CookieCloud 的浏览器插件理论上支持所有 Chrome 内核的浏览器,包括 Edge 。你可以通过两种方式安装插件:商店安装和手动安装。
Edge商店安装插件
直接在商店搜索 CookieCloud 点击即可安装,目前我们只上架了 Edge , Chrome 商店还在审核。
插件版本说明
由于审核的关系,商店还是 0.1.5 版本,在部分 http 协议的网站上不能获取到 Cookie ,如果你发现有 Cookie 不同步的问题,可以试试手动安装 0.1.7 以后的版本。
手动安装
你可以在我们 Github 仓库首页右侧的 Release 中找到 zip 格式的安装包。 Chrome 和 Edge 均下载 chrome-mv3-prod.zip 即可。关于如何在浏览器中加载未打包插件,可自行搜索,这里就不再说明
工作模式
安装完后,点击浏览器插件图标会弹出设置界面。首先要选择的是工作模式,一个浏览器只能工作在上传或者下载覆盖状态。一般来讲,我们会把最常使用的浏览器设为上传模式,其他都设置为下载覆盖模式。
服务器地址
你可以在我们 GitHub 仓库首页找到社区贡献的第三方服务器端,也可以自行搭建。搭建教程我们放到后边讲。有一个需要注意的地方,早期版本的服务器端在 Cookie 过大时会报错,如果你在测试时遇到了,可以尝试添加「同步域名关键字」限制上传的 cookie 。
用户KEY
由于一台服务器需要支持多个用户进行同步,因此需要通过用户 KEY 来进行区分。重复的用户 KEY 会导致同步数据覆盖,因此插件会自动生成一个足够长的随机 KEY 。当你配置下载覆盖模式时,需要使用同样的用户 KEY 。
密码
密码用于端对端加密,由于服务器端完全不知道密码,因此无法找回。不过我们的场景下只是备份 Cookie ,忘记后可以设置新的密码覆盖原有云端数据就行了。同样的,当你配置下载覆盖模式时,需要使用同样的用户 KEY 。
同步域名关键词
默认情况下,会上传所有的 Cookie ,但这会带来额外的流量消耗。因此我们提供了同步域名关键词,如果你填写了关键词,只有当 Cookie 的域名包含关键词时,才会上传对应的 Cookie 。有一个需要注意的地方是,部分网站的登入可能采用了其他二级域名,因此可能需要填写更短的顶级域名才能同步登入状态。
Cookie保活
即使是常用浏览器,某些网站我们长期不打开它的 Cookie 也会过期,这样即使同步了 Cookie 也是过期的。因此,我们添加了 Cookie 保活功能,填到这里的网址会每 60 分钟在后台打开一次。
Cookie保活
http://ftqq.com|5
你也可以在 URL 后加上竖线和分钟数,指定自己想要的间隔时间
覆盖模式的配置
配置好了上传的浏览器,就可以配置下载覆盖的浏览器了。当然你需要再安装一遍插件。覆盖模式下不需要同步域名关键字和保活配置,其他项和上传浏览器的配置一样,服务器地址、用户 KEY 和密码则需要完全一致。
服务器端的自行搭建
- Docker
- Node
服务器端提供两种部署方案,一种是 Docker ,一种是 Node 。推荐使用 Docker ,尤其对于不懂技术的用户。
Docker 部署
docker run -p=8088:8088 easychen/cookiecloud:latest
Docker 部署首先需要 Docker 环境,请自行搜索安装。镜像启动参数非常简单,除了镜像名称,只需要配置端口。你可以直接运行屏幕上的命令启动服务。
Docker 部署 - 后台
docker run -d -p=8088:8088 easychen/cookiecloud:latest
测试无误后,可以后台启动,在 run 命令中添加 -d 参数即可。用浏览器打开 http://ip: 端口看到 Hello World 则说明服务器端成功启动。
Docker 部署 - 接口指定目录
docker run -e API_ROOT=/cookie -p=8088:8088 easychen/cookiecloud:latest
设置 API_ROOT 环境变量,可以指定目录访问接口
Node 部署
git clone https://github.com/easychen/CookieCloud.git --depth=1
&& cd CookieCloud/api && yarn install && node app.js
Node 部署需要服务器支持 Node 和 Git 并可访问 GitHub 仓库,运行屏幕上的命令可直接启动。
调试和日志查看
如果你想知道运行过程中的细节,可以进入浏览器插件列表,点击 service worker ,会弹出一个面板,可查看运行日志。
GitHub仓库
github.com/easychen/Co…
视频教程中用到的命令,可以在我们 GitHub 仓库找到文字版。
互动交流
最后,如果你在使用中遇到了问题或者想关注新版发布,可以订阅我们的电报频道,里边也有我们电报交流群的链接。
File: CookieCloud使用教程