答案是需检查密钥、权限与区域参数:先确认七牛云存储空间为公开、accesskey/secretkey准确无误、region编号(如z0)与外链域名https化且已备案,再核对sharex中bucket、domain、path等字段严格一致,测试上传并启用截图自动工作流。

如果您使用 ShareX 进行截图后希望自动上传至七牛云图床,但图片无法成功上传或返回错误链接,则可能是由于密钥配置错误、存储空间权限设置不当或区域参数不匹配所致。以下是解决此问题的步骤:
一、获取七牛云必要参数
在 ShareX 中配置七牛云图床前,需先从七牛云控制台准确获取五项核心参数:存储空间名称(Bucket)、AccessKey、SecretKey、存储区域编号及外链域名。这些参数必须与 ShareX 配置项严格一致,任何一项错误都将导致上传失败。
1、登录七牛云官网,进入「对象存储 Kodo」→「空间管理」,确认已创建公开空间,并记录下该空间名称(如 my-sharex-images);
2、点击右上角头像,进入「密钥管理」,复制 AccessKey 和 SecretKey,务必确保 SecretKey 仅本地保存,切勿泄露;
3、在空间详情页的「基本设置」中找到「访问域名」,选择已启用的 HTTPS 域名(如 https://cdn.example.com),禁用 HTTP 测试域名(xxx.bkt.clouddn.com),因其30天后失效;
4、在「空间设置」→「区域」栏确认所选区域编号(如华东为 z0,华北为 z1,华南为 z2),该编号将直接用于 ShareX 的 Region 字段,不可填写“华东”或“z0-1”等错误格式。
二、ShareX 图床配置(内置七牛云支持)
ShareX 自带原生七牛云图床类型,无需额外插件,但需手动填写全部字段。配置时若出现 ENOTFOUND 或 401 错误,大概率源于区域编号或权限设置偏差。
1、打开 ShareX,点击「任务设置」→「图像上传」→「图床」→「添加图床」;
2、在图床类型下拉菜单中选择「Qiniu Cloud」;
3、依次填入以下内容:
Bucket:填写存储空间名称(全小写、无空格);
AccessKey:粘贴 AccessKey;
SecretKey:粘贴 SecretKey;
Region:仅填写区域编号(如 z0、z1、z2);
Domain:填写完整的 HTTPS 外链域名(含 https:// 前缀);
Path:可选填自定义路径(如 sharex/),留空则默认根目录;
4、点击「测试」按钮,上传一张本地图片验证;若提示“Upload successful”,且返回链接能正常打开图片,则配置完成。
三、ShareX 图床配置(自定义 API 方式)
当 ShareX 内置七牛云选项不可用(如旧版本或区域未覆盖),可改用「Custom uploader」通过七牛云 REST API 实现上传。该方式绕过 SDK 依赖,兼容性更强,且支持自定义上传策略。
1、在「图床」设置中选择「Custom uploader」;
2、URL 地址填写:https://upload-z0.qiniup.com(根据实际区域替换 z0 为 z1/z2);
3、请求方法选择 POST;
4、在「Body」中选择「Form data」,添加以下键值对:
key:留空(由 ShareX 自动生成);
token:需通过服务端或客户端生成上传凭证,此处不可硬编码,须配置动态 token 获取逻辑;
file:选择「File」类型并绑定为 $inputfile;
5、在「Headers」中添加:
Content-Type:multipart/form-data;
Authorization:Bearer {token}(需配合 token 动态注入);
6、保存后执行测试上传,若返回 400 错误,请检查 token 是否过期或 scope 字段与 Bucket 名不一致。
四、解决常见上传失败问题
ShareX 上传失败常表现为无响应、报错 401、返回空链接或图片显示 404。这些问题多由权限、域名或时间戳校验引发,需逐项排查。
1、若截图上传后返回链接但图片打不开,立即检查存储空间访问控制是否为「公开」;私有空间会导致所有外链返回 403,必须改为公开;
2、若 ShareX 提示「Authentication failed」,核对 AccessKey 与 SecretKey 是否复制完整,SecretKey 中若含换行或空格会导致签名计算失败;
3、若上传后链接为 http://xxx.bkt.clouddn.com/xxx.jpg 且已过期,说明仍在使用七牛云默认测试域名;必须绑定已备案的自定义域名并完成 CNAME 解析,否则30天后全部失效;
4、若上传耗时超30秒后失败,检查 ShareX 网络代理设置是否与系统代理冲突,建议关闭 ShareX 的「Use system proxy」选项,改用直连。
五、启用截图后自动上传与剪贴板集成
完成图床配置后,需激活 ShareX 的工作流以实现截图即传。此步骤决定实际使用体验是否流畅,尤其影响剪贴板图片的自动处理能力。
1、点击「任务设置」→「工作流」→「截图后」,勾选「上传到图床」;
2、在「图像上传」→「上传后」中,勾选「复制图片链接到剪贴板」;
3、若需支持拖拽/粘贴图片上传,进入「高级」→「剪贴板监视器」,启用「监视图像剪贴板」并设置触发动作;
4、保存所有设置,按快捷键截图,观察右下角通知:若显示“Uploaded to Qiniu”且剪贴板已含 Markdown 格式链接,则全流程打通。











