Skip to content
Troray edited this page Aug 25, 2026 · 3 revisions

🚀 MyTab 数据备份与同步配置指南 (GitHub / Gitee)

MyTab 提供了基于 Git(GitHub / Gitee) 的轻量级、去中心化数据备份与多端同步方案。您所有的新标签页分组、快捷图标、壁纸配置及个性化设置,均以加密或 JSON 明文的形式安全存储在您个人的专属仓库或代码片段中。


📑 目录


一、Gitee(码云)配置指南

Gitee 服务器位于国内,网络连接稳定且速度极快,推荐国内用户优先使用。

1.1 申请 Gitee Token(两种方式)

方案 A:仓库级私人令牌(更安全·推荐)

特点:权限严格限定在单个备份仓库内,即便 Token 泄漏也不会影响账号下的其他私有项目。

  1. 第一步:手动新建私有仓库

    • 登录 Gitee,右上角点击 「+」「新建仓库」
    • 填写仓库名称(如 MyTab-Backup)。
    • 是否开源务必勾选「私有」(保护隐私)。
    • 初始化仓库留空即可,点击 「创建」

    新建 Gitee 私有仓库

新建 Gitee 私有仓库
  1. 第二步:创建仓库级私人令牌

    • 访问令牌生成页:https://gitee.com/profile/personal_access_tokens/new
    • 私人令牌描述:填写便于识别的名字,如 MyTab-Backup
    • 令牌类型:选择 「仓库级私人令牌」
    • 仓库范围:选择 「选择仓库」 ➔ 勾选刚刚创建的私有仓库(如 xxx/MyTab-Backup)。
    • 令牌过期时间:选择 「永不过期」
    • 权限勾选:勾选 projects(查看、创建、更新指定仓库)

    仓库级令牌配置

仓库级令牌配置
  1. 第三步:复制保存 Token

    • 点击提交,复制生成的 Token 字符串(关闭窗口后将不再明文显示)。

    复制 Gitee 令牌

复制 Gitee 令牌

方案 B:全局私人令牌(支持扩展内一键自动建仓)

特点:无需提前手动在网页建仓,在扩展内点击「验证并连接」即可一键自动创建私有仓库。

  1. 打开 Gitee 令牌生成页:https://gitee.com/profile/personal_access_tokens/new
  2. 配置参数
    • 令牌描述:如 MyTab-Backup
    • 令牌类型:选择 「私人令牌」(可访问账号下授权范围内的全部资源)。
    • 令牌过期时间:选择 「永不过期」
    • 权限勾选
      • projects:查看、创建、更新你的项目(必选,用于自动创建仓库及读写同步文件)。
      • gists:查看、删除、更新你的代码片段(选配,若使用代码片段模式请勾选)。
  3. 点击底部 「提交」 并复制生成的 Token。

全局私人令牌配置

全局私人令牌配置

1.2 在 MyTab 中完成 Gitee 同步绑定

打开 MyTab ➔ 点击右上角 「设置」 图标 ➔ 切换到 「同步」 标签 ➔ 选择 「Git 仓库备份」 ➔ 开启开关并选择 Gitee

方式 1:极简代码片段模式 (Gist)

  • 适合不需要管理仓库文件的极简用户。
  • 切换到 「极简代码片段」 模式。
  • 粘贴您的 Gitee 私人令牌(需拥有 gists 权限)。
  • 点击 「智能连接」,插件将自动为您创建专属私有 Gist 并完成绑定。

Gitee 极简代码片段模式设置

Gitee 极简代码片段模式设置

方式 2:自定义仓库模式 (Repo)

  • 适合希望把备份作为独立 Git 仓库管理的用户。
  • 切换到 「自定义仓库 (高级)」 模式。
  • Personal Access Token (PAT):粘贴申请的 Gitee 令牌。
  • 仓库地址 / 路径
    • 若使用方案 A(已建好仓库):填写完整 URL 或 用户名/仓库名
    • 若使用方案 B(全局令牌):直接留空
  • 点击 「验证并连接」(若留空系统将自动为您创建专属私有仓库)。
  • 目标分支默认为 master,备份文件路径默认为 mytab-backup.json

Gitee 自定义仓库模式设置

Gitee 自定义仓库模式设置

二、GitHub 配置指南

2.1 申请 GitHub Personal Access Token

  1. 进入 Token 创建页面

    • 登录 GitHub ➔ 右上角头像 ➔ SettingsDeveloper settingsPersonal access tokensTokens (classic)Generate new token (classic)(快捷访问:https://github.com/settings/tokens/new)
  2. 配置参数

    • Note:填写用途标识,例如 MyTab Backup
    • Expiration:选择 No expiration(永不过期)。
    • Select scopes(权限勾选)
      • repo必选:勾选 repo,将自动包含私有仓库的全部读写权限)。
      • gist选配:若需要使用 Gist 代码片段模式,请勾选 gist)。

    GitHub Repo 权限勾选

GitHub Repo 权限勾选

GitHub Gist 权限勾选

GitHub Gist 权限勾选
  1. 生成并复制

    • 滚动到页面底部,点击绿色 「Generate token」 按钮。
    • 复制生成的 ghp_... 格式 Token(离开页面后将不可见)。

    点击生成 Token

点击生成 Token

复制 GitHub Token

复制 GitHub Token

2.2 在 MyTab 中完成 GitHub 同步绑定

打开 MyTab ➔ 「设置」「同步」「Git 仓库备份」 ➔ 托管平台选择 GitHub

方式 1:极简代码片段模式 (Gist)

  • 切换到 「极简代码片段」 模式。
  • 粘贴以 ghp_ 开头的 GitHub Token。
  • 点击 「智能连接」,插件会自动创建或关联私有 Gist。

GitHub 极简代码片段设置

GitHub 极简代码片段设置

方式 2:自定义仓库模式 (Repo)

  • 切换到 「自定义仓库 (高级)」 模式。
  • 粘贴 GitHub Token。
  • 仓库地址可留空后点击 「验证并连接」(自动创建私有仓库 MyTab-Data-Backup),也可以填入已有仓库。
  • 目标分支默认为 main,文件路径默认为 mytab-backup.json

GitHub 自定义仓库设置

GitHub 自定义仓库设置

三、数据上传、恢复与自动同步操作

完成上述配置与连接后,即可使用以下功能:

  1. 首次上传备份(本地 ➔ 云端)
    • 点击底部的 「☁ 上传备份 (本地 ➔ 云端)」 按钮,成功后会显示上次同步时间。
  2. 在新设备上拉取恢复(云端 ➔ 本地)
    • 在新设备安装 MyTab 后,按上述步骤填入相同的 Token 与仓库信息,点击 「验证并连接」
    • 点击 「☁ 拉取恢复 (云端 ➔ 本地)」,云端数据将瞬间同步至当前浏览器。
  3. 数据变动时自动同步至云端
    • 勾选 「数据变动时自动同步至云端」 复选框后,当您在日常使用中新增/修改书签、调整分组或更改配置时,MyTab 会自动静默上传最新数据至云端。

四、常见问题与安全提示 (FAQ)

Q1:为什么必须将备份仓库设置为「私有 (Private)」?

A:备份数据中包含您的书签、历史分组、自定义网址及插件各项配置。设为私有仓库能够防止数据被搜索引擎索引或被他人查阅,最大程度保护隐私。

Q2:Gitee 两种令牌模式该如何选择?

A

  • 追求极致安全:推荐 方案 A(仓库级私人令牌)。先在网页建好私有仓库,再创建仅对该仓库生效的 Token。
  • 追求简单快捷:推荐 方案 B(全局私人令牌)。只需申请一个带 projects 权限的 Token,在扩展中直接一键自动建仓。

Q3:点击「验证并连接」提示 401 或 404 错误?

  • 401 Unauthorized:Token 复制不完整、格式错误或已被撤销/过期。请重新生成并核对。
  • 404 Not Found
    1. 若手动填写了仓库,请检查「用户名」与「仓库名」是否拼写完全正确(注意大小写区分)。
    2. 检查创建 Token 时是否正确勾选了 projects (Gitee) 或 repo (GitHub) 读写权限。

Clone this wiki locally