1
1
---
2
- title : ' 使用 Cloudflare R2 + ShareX 搭建个人/团队专属“永久”图床'
2
+ title : 使用 Cloudflare R2 + ShareX 搭建个人/团队专属“永久”图床
3
3
description : " "
4
4
date : " 2025-09-27"
5
5
tags :
6
6
- tag-one
7
+ docId : gj4bn01un0s0841berfvwrn5
7
8
---
8
9
9
10
# 使用 Cloudflare R2 + ShareX 搭建个人/团队专属“永久”图床
15
16
---
16
17
17
18
## 目录
19
+
18
20
1 . [ 第一部分:配置 Cloudflare R2 (云端存储)] ( #第一部分配置-cloudflare-r2-云端存储 )
19
21
2 . [ 第二部分:配置 ShareX (桌面客户端)] ( #第二部分配置-sharex-桌面客户端 )
20
22
3 . [ 第三部分:优化 ShareX 工作流] ( #第三部分优化-sharex-工作流 )
@@ -44,26 +46,26 @@ tags:
44
46
为了让上传的图片能被外部访问,需要开启公共访问。
45
47
46
48
1 . 进入你刚创建的存储桶,点击顶部的 ** Settings (设置)** 选项卡。
47
- ![ 1r0AU3aWkD.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/1r0AU3aWkD.png )
49
+ ![ 1r0AU3aWkD.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/1r0AU3aWkD.png )
48
50
2 . 在 ** 下方Public Development URL** 部分,点击右侧的 ** Enable** 。
49
51
3 . 输入确认信息。
50
- ![ fgc4amk7S7.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/fgc4amk7S7.png )
52
+ ![ fgc4amk7S7.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/fgc4amk7S7.png )
51
53
4 . ** 记下** 这里显示的 ` https://pub-....r2.dev ` 格式的 URL,这是你的公共访问域名。
52
- ![ RmQwxSxpLi.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/RmQwxSxpLi.png )
54
+ ![ RmQwxSxpLi.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/RmQwxSxpLi.png )
53
55
54
56
### 1.3 创建用于上传的 API Token
55
57
56
58
API Token 是让 ShareX 有权限上传文件到 R2 的“钥匙”。
57
59
58
60
1 . 回到 R2 的主页(概览页面),点击右上角的 ** Manage API Tokens (管理 R2 API 令牌)** 。
59
- ![ CTzhiiSl04.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/CTzhiiSl04.png )
61
+ ![ CTzhiiSl04.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/CTzhiiSl04.png )
60
62
1 . 点击 ** Create Account API token (创建 API 令牌)** 。
61
- ![ FBEzXXohz7.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/FBEzXXohz7.png )
62
- 2 . ** Permissions (权限)** : ** 务必选择 ` Object Read & Write ` (对象读和写)** 。这是最关键的一步,只读权限会导致上传失败。
63
- ![ xB4pYQOeEI.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/xB4pYQOeEI.png )
64
- 3 . 点击 ** Create API token** 。
65
- 4 . ** ⚠️ 立即复制并保存!** 页面上会显示 ` Access Key ID ` 和 ` Secret Access Key ` 。** 这两个密钥只会出现这一次** ,请立刻将它们复制并粘贴到一个安全的地方。最下方的Default endpoints链接也需要保存一下。
66
- ![ kg9E8tEozI.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/kg9E8tEozI.png )
63
+ ![ FBEzXXohz7.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/FBEzXXohz7.png )
64
+ 1 . ** Permissions (权限)** : ** 务必选择 ` Object Read & Write ` (对象读和写)** 。这是最关键的一步,只读权限会导致上传失败。
65
+ ![ xB4pYQOeEI.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/xB4pYQOeEI.png )
66
+ 1 . 点击 ** Create API token** 。
67
+ 1 . ** ⚠️ 立即复制并保存!** 页面上会显示 ` Access Key ID ` 和 ` Secret Access Key ` 。** 这两个密钥只会出现这一次** ,请立刻将它们复制并粘贴到一个安全的地方。最下方的Default endpoints链接也需要保存一下。
68
+ ![ kg9E8tEozI.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/kg9E8tEozI.png )
67
69
68
70
---
69
71
@@ -81,31 +83,30 @@ API Token 是让 ShareX 有权限上传文件到 R2 的“钥匙”。
81
83
2 . 在弹出的窗口左侧选择 ` Amazon S3 ` ,在右侧输入你的配置信息。
82
84
3 . 按照下表精确填写你的 R2 信息:
83
85
84
- | ShareX 设置项 | 填写内容 | 说明 |
85
- | ------------------------- | ---------------------------------------------------------------------- | ------------------------------------------------------------------------- |
86
- | ** Access key ID** | 粘贴你保存的 ` Access Key ID ` | |
87
- | ** Secret access key** | 粘贴你保存的 ` Secret Access Key ` | |
88
- | ** Region** | 留空 | |
89
- | ** Endpoints** | 留空 |
90
- | ** Endpoint** | ` https://<你的AccountID>.r2.cloudflarestorage.com ` | 如果你在刚才保存过可以直接复制,切记最后没有` / ` 。 |
91
- | ** Bucket name** | 你的 R2 存储桶名称 (例如 ` your-org-images-2025 ` ) | |
92
- | ** Upload path** | ` img/%y/%mo/%d/ ` | 按 ` img/年/月/日/ ` 格式存放图片,有助于管理。ShareX 的变量格式是 ` % ` 。(也可自定义) |
93
- | ** Use custom domain** | ** 勾选此项** | |
94
- | (自定义域名输入框) | ` https://<你记下的r2.dev公共URL> ` | ** 注意** :这里只填刚才你记下的Public Development URL,不要加后面的 ` $key$ ` 。ShareX 新版本会自动处理。 |
95
-
86
+ | ShareX 设置项 | 填写内容 | 说明 |
87
+ | --------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
88
+ | ** Access key ID** | 粘贴你保存的 ` Access Key ID ` | |
89
+ | ** Secret access key** | 粘贴你保存的 ` Secret Access Key ` | |
90
+ | ** Region** | 留空 | |
91
+ | ** Endpoints** | 留空 |
92
+ | ** Endpoint** | ` https://<你的AccountID>.r2.cloudflarestorage.com ` | 如果你在刚才保存过可以直接复制,切记最后没有` / ` 。 |
93
+ | ** Bucket name** | 你的 R2 存储桶名称 (例如 ` your-org-images-2025 ` ) | |
94
+ | ** Upload path** | ` img/%y/%mo/%d/ ` | 按 ` img/年/月/日/ ` 格式存放图片,有助于管理。ShareX 的变量格式是 ` % ` 。(也可自定义) |
95
+ | ** Use custom domain** | ** 勾选此项** | |
96
+ | (自定义域名输入框) | ` https://<你记下的r2.dev公共URL> ` | ** 注意** :这里只填刚才你记下的Public Development URL,不要加后面的 ` $key$ ` 。ShareX 新版本会自动处理。 |
96
97
97
98
#### 2.2.1 关键的高级 (Advanced) 设置
98
99
99
100
在 S3 配置窗口的最下方,找到 ** Advanced** 区域,进行如下设置:
100
101
101
- * ` Set public-read ACL on file ` : ** 必须取消勾选** 。R2 不支持此功能,勾选会导致 ` 403 Forbidden ` 错误。
102
- * ` Use path style request ` : ** 必须勾选** 。R2 需要这种格式的请求 URL。
102
+ - ` Set public-read ACL on file ` : ** 必须取消勾选** 。R2 不支持此功能,勾选会导致 ` 403 Forbidden ` 错误。
103
+ - ` Use path style request ` : ** 必须勾选** 。R2 需要这种格式的请求 URL。
103
104
104
105
### 2.3 将 S3 设置为默认图片上传器
105
106
106
107
1 . 回到 ShareX 主界面。
107
108
2 . 点击 ` Destinations ` -> ` Image uploader ` -> ` File uploader ` -> 选择 ` Amazon S3 ` 。
108
- ![ Code_nqStY1UhqR.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/Code_nqStY1UhqR.png )
109
+ ![ Code_nqStY1UhqR.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/Code_nqStY1UhqR.png )
109
110
110
111
---
111
112
@@ -115,14 +116,14 @@ API Token 是让 ShareX 有权限上传文件到 R2 的“钥匙”。
115
116
116
117
1 . 在 ShareX 主界面,点击 ` Task settings... ` 。
117
118
2 . 在弹出的窗口左侧选择下方的 ** ` Advanced ` ** 。
118
- ![ ShareX_ZWFVlZZu0W.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/ShareX_ZWFVlZZu0W.png )
119
- 1 . 接着,点击 ` After upload ` 下方的 ` ClipboardContentFormat ` 。
120
- 2 . 将里面的内容替换为markdown格式 `  ` 。
119
+ ![ ShareX_ZWFVlZZu0W.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/ShareX_ZWFVlZZu0W.png )
120
+ 3 . 接着,点击 ` After upload ` 下方的 ` ClipboardContentFormat ` 。
121
+ 4 . 将里面的内容替换为markdown格式 `  ` 。
121
122
122
- ### 3.2 打开自动复制到剪切板
123
+ ### 3.2 打开自动复制到剪切板
123
124
124
125
1 . 在主页面的 ` After upload tasks ` -> 右侧选择 ` Copy URL to clipboard ` 。
125
- ![ ShareX_zf6qftjnu6.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/ShareX_zf6qftjnu6.png )
126
+ ![ ShareX_zf6qftjnu6.png] ( https://pub-85d4dcece16844bf8290aa4b33608ccd.r2.dev/ShareX/2025/09/ShareX_zf6qftjnu6.png )
126
127
127
128
### 3.3 修改热键
128
129
@@ -134,6 +135,7 @@ API Token 是让 ShareX 有权限上传文件到 R2 的“钥匙”。
134
135
135
136
** Q1: 上传时报错 ` (403) Forbidden ` ,怎么办?**
136
137
** A1:** 这是最常见的问题,请检查以下两项 S3 高级设置:
138
+
137
139
1 . 确保 ** ` Set public-read ACL on file ` ** ** 没有** 被勾选。
138
140
2 . 确保 ** ` Use path style request ` ** ** 已经** 被勾选。
139
141
3 . 如果依然报错,请重新生成一个** 权限为 ` Object Read & Write ` 的 API Token** 并更新到 ShareX 中。
0 commit comments