Joplin 笔记同步腾讯云 COS 完整教程

一、准备工作（在腾讯云控制台操作）

1. 创建存储桶

• 登录腾讯云控制台，进入对象存储（COS） -> 存储桶列表。
• 点击创建存储桶，按以下建议填写：
  • 名称：自定义，如 joplin-notes（需全网唯一）。
  • 所属地域：选离你最近的，如 广州、上海、北京。
  • 访问权限：私有读写（重要！保障数据安全）。
• 其他选项保持默认，点击确定。

2. 创建子账号密钥（安全第一，不要用主账号）

• 进入访问管理 -> 用户 -> 用户列表，点击新建用户 -> 自定义创建。
• 填写用户名（如 joplin_sync），访问方式勾选 “编程访问”。
• 设置权限步骤：直接点击“下一步”，暂时不勾选任何策略。
• 创建成功后，务必保存弹窗中的信息：
  • SecretId （相当于用户名）
  • SecretKey （相当于密码，只显示一次！）

3. 授权子账号访问存储桶

• 回到刚才创建的存储桶，点击权限管理 -> 存储桶访问权限。
• 在“用户权限”栏，点击添加用户。
  • 用户ID：搜索并选择刚创建的子账号（如 joplin_sync）。
  • 权限：勾选 数据读取 和 数据写入。
• 点击保存。

二、配置 Joplin 同步

1. 打开 Joplin，进入 工具 -> 选项 (Windows/Linux) 或 偏好设置 (macOS)。
2. 选择 同步 标签页。
3. 按照下表填写（最关键的一步）：

4. 点击 检查同步配置 按钮，等待提示“配置检查通过”。
5. 点击 应用 保存设置。

三、开始同步

• 点击 Joplin 主界面工具栏上的 同步 按钮。
• 等待同步完成，你的笔记就会上传到腾讯云 COS。

四、云端文件结构说明（了解即可）

同步成功后，在你的腾讯云存储桶里会看到：

五、费用详解（比你想象的更便宜）

计费项拆解

月度账单估算（以2台设备为例）

• 存储费：0.06元
• 请求费：~0元
• 流量费：两台设备首次下载共约1GB → 0.5元
• 总计：约 0.56元/月

新用户福利：腾讯云通常赠送6个月 50GB 的标准存储额度，足够免费试用很长时间。

六、关键原理与常见问题

Q1：日常切换、阅读笔记会下载文件吗？

不会。 日常操作都在本地硬盘进行，只有点击“同步”按钮时才会与云端通信，且通常是只上传改动，不会重复下载。

Q2：什么情况会产生下载流量？

只有一种情况： 在新设备（新电脑/新手机）上首次配置 Joplin 并点击同步，会完整下载一次云端的所有笔记和附件。

Q3：每次同步都是全量上传吗？

不是。 Joplin 执行增量同步。只会：

• 上传：新增或修改的 .md 笔记文件、新增的附件（如图片）。
• 下载：极小的 .sync 状态文件（几KB）用于检查冲突。

Q4：如何降低流量费用？

• 尽量只在需要的设备上配置同步。
• 新设备首次同步时，建议使用家用宽带Wi-Fi，避免使用手机流量。

七、故障排查