ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Joplin 如何配置 S3 同步目标并通过 check config 验证?

Joplin 如何配置 S3 同步目标并通过 check config 验证? Joplin 如何配置 S3 同步目标并通过 check config 验证【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin本文面向希望把 Joplin 笔记数据同步到 S3 兼容对象存储如 AWS S3、Backblaze B2、Cloudflare R2、DigitalOcean Spaces、Linode、Scaleway、UpCloud、Tebi的用户。从 Joplin 2.x.x 开始同步目标中提供 S3 (Beta) 选项桌面版和移动版都支持。本文说明如何准备 Bucket、在配置界面填写 S3 参数并用 check config 判断配置是否正确。配置前创建 Bucket 并获取访问密钥在 Joplin 里填参数之前先在所选的 S3 兼容服务商处完成两件事创建一个 Bucket并拿到该账户的程序化访问密钥Access Key / Secret Key。以 AWS 为例到 IAM Security Credentials 页面创建新的 key 与 secret其他服务商按其官方文档操作。按文档建议在创建 Bucket 时关闭Bucket Versioning、启用Block all public access、并开启Default encryptionAmazon S3 key (SSE-S3)。部分服务商不暴露这些选项可能会造成同步问题如果你遇到了文档建议反馈给维护者以更新文档。如果需要同步到私有权限的 Bucket以 AWS 为例文档给出了添加 Bucket Policy 的方式在 AWS S3 Web Console 的Permissions标签页先临时关闭Block all public access才能编辑策略。下面是文档给出的策略示例原文标注为 something along the lines of即大致结构其中joplin-bucket需替换为你的 Bucket 名称{ Version: 2012-10-17, Statement: [ { Sid: VisualEditor0, Effect: Allow, Action: [ s3:ListBucket, s3:GetBucketLocation, s3:GetObject, s3:DeleteObject, s3:DeleteObjectVersion, s3:PutObject ], Resource: [ arn:aws:s3:::joplin-bucket, arn:aws:s3:::joplin-bucket/* ] } ] }该策略允许列出 Bucket、获取对象、写入和删除对象是 Joplin 完成同步所需的操作集合。打开配置界面并选择 S3 (Beta)打开配置界面配置界面说明Windows 和 Linux菜单Tools Options或按Ctrl,。macOS菜单Joplin Preferences或按Cmd,。移动应用点左上角汉堡图标 ≡选择Configuration。在同步目标synchronisation target中选择S3 (Beta)。填写 S3 参数选择 S3 (Beta) 后需要填写以下字段字段说明S3 BucketBucket 名称例如joplin-bucketS3 URL完整端点 URL。AWS 的格式为https://s3.regionName.amazonaws.com/其余服务商见下文各厂商参考S3 Access Key S3 Secret Key账户的程序化访问密钥S3 Region部分服务商要求填写 Bucket 所在区域如eu-west1不需要的服务商可留空Force Path Style启用后会以旧式 S3 Path 风格访问服务商具体开或关取决于你的服务商两个方向都可以试已测试服务商的参数参考文档列出了已测试确认可用的服务商配置所有服务商都需要 Bucket、Access Key、Secret Key。...形式的片段需替换为你自己的值服务商URLRegionForce Path StyleAWShttps://s3.region.amazonaws.com/填入你的 region完整端点列表见 AWS 官方 S3 端点文档requireduncheckedBackblazehttps://s3.region.backblazeb2.comBackblaze B2 提供的端点 URLrequired从提供的端点 URL 复制例如us-east-001uncheckedCloudflare R2https://ACCOUNT_ID.r2.cloudflarestorage.com在 Cloudflare 控制台 API 页面的 Use R2 with APIs 处可看到正确 URLautouncheckedDigitalOceanhttps://region.digitaloceanspaces.comregion 在建桶时选定可用区域见 DigitalOcean 官方文档required但实际区域由 URL 决定文档建议填us-east-1uncheckedLinodehttps://region.linodeobjects.comregion 在 Linode 提供的 URL 中该 URL 也是去掉桶名后的 Linode URL必填但可填任意值不能留空uncheckedScalewayhttps://s3.region.scw.cloudregion 与桶的 region 相同可复制桶 endpoint 后去掉桶名required例如fr-paruncheckedUpCloudhttps://account.region.upcloudobjects.com服务商提供多个 URL符合此格式的那个可用requireduncheckedTebihttps://s3.tebi.ioTebi 提供的端点 URLrequireduncheckedCloudflare R2 有一个特殊步骤需要到Manage API tokens Create Account API Token生成一个带Object Read Write权限的 API Token然后把得到的Access Key ID和Secret Access Key分别填入 Joplin 的 S3 Access Key 与 S3 Secret Key。用 check config 验证配置参数填完后使用 S3 (Beta) 目标中的check config来验证。判断标准以 S3 同步文档 为准如果 check config 返回success!那么对该服务商而言 S3 同步应当可以工作。配置界面确认后应用运行期间会在后台自动同步也可以在界面上点 Synchronise 手动触发一次同步。如果没有返回 success先调整设置重试或者保存配置、重启应用、再尝试一次同步——文档指出同步过程可能会给出更明确的错误信息有助于定位问题。文档没有给出 success 之外的更细判定表排查手段就是调参 → check config和保存 → 重启 → 试同步看错误信息这两条路径。其中 Force Path Style 是最常见的可调节项文档明确说取决于服务商可能需要开、关各试一次。可选在终端里手动触发同步如果安装了 Joplin 的 terminal client可以不经过图形界面在终端执行joplin sync来同步同步总览。文档给出的 cron 示例为每 30 分钟同步一次其中/path/to/joplin需要替换为你本机 joplin 可执行文件的实际路径*/30 * * * * /path/to/joplin sync限制说明S3 同步目标目前在 Joplin 中仍标注为Beta。只有文档列出的服务商被测试并确认可用其他 S3 兼容服务商不在已验证范围内。部分服务商不暴露 Bucket Versioning、Block all public access、默认加密等选项文档提示这可能造成同步问题遇到时文档建议反馈以便更新文档。check config 失败时文档没有给出逐条错误对照排查手段限于调整设置或重启应用后尝试同步以获得更明确的报错。相关文档S3 同步、配置界面、同步总览。【免费下载链接】joplinJoplin - the privacy-focused note taking app with sync capabilities for Windows, macOS, Linux, Android and iOS.项目地址: https://gitcode.com/GitHub_Trending/jo/joplin创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表