CookieCloud 使用教程

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

avatar
文章
阅读
粉丝