CookieCloud 使用教程

16,727 阅读5分钟

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使用教程