ShareX自定义上传器指南：自托管截图链接
ShareX 是适用于 Windows 的免费开源截图工具，集屏幕截取、屏幕录制、文件分享和效率工具于一体。
ShareX 的自定义上传器文档（阅读于 2026 年 10 月）介绍了一个系统，可让你将图像、文字和文件上传到托管服务，或缩短并分享 URL。本指南依据该文档：自定义上传器如何工作、如何干净地设置一个，以及如何在设置过程中保护你的凭据。
首先关键区别：自定义上传器用于与你自己的或第三方的 HTTP 端点通信。ShareX 还提供 Amazon S3、Google Cloud Storage 和 Cloudflare R2 的指南，因此在手写 HTTP 请求之前，请先查找适用于你的存储的指南。
自定义上传器实际是什么
如ShareX自己的文档所述，自定义上传器功能主要被自托管自己的服务的人使用。实践中，这是一个小定义，告诉ShareX：当我截图东西时，将其发送到这个URL，使用这个请求，并找到结果链接在这部分响应。把这三件事做对，ShareX会悄悄上传并每次截图时复制一个工作URL。
请求：方法和正文类型
ShareX的自定义上传器支持标准HTTP方法—— GET、POST、PUT、PATCH和DELETE。作为文档中的经验法则：如果请求只提供参数，无正文，GET它作为发送文件优先；如果它发送multipart/form-data，POST是常常的选择。
对于请求正文，ShareX提供了几种类型，所以它可以匹配你的端点期望的内容：
- 无正文 ——只有参数。
- 表单数据（multipart/form-data） ——上传文件的典型选择。
- 表单URL编码（application/x-www-form-urlencoded）。
- JSON（application/json）。
- XML（application/xml）。
- 二进制 ——原始文件作为正文。
你的服务器API文档告诉你它期望的方法和正文类型；你只是在ShareX定义中镜像那个。
解析响应：链接在哪？
上传后，你的端点会作出响应——通常是 JSON、XML 或纯文本——你需要告诉 ShareX 哪个字段包含最终的 URL。ShareX 为你提供以下提取方式：
- JSON使用JsonPath语法，例如
{json:data.link}读取data.link从JSON响应。 - XML使用XPath，例如
{xml:/files/file[1]/url}。 - 正则表达式用于模式匹配纯文本响应。
- 头在响应头中读取返回的URL。
如果上传成功，但 ShareX 复制的 URL 是空的或格式错误，可能是解析器指向了错误的字段。请查看你的服务器返回的原始响应，并追踪到 URL 字符串的确切路径。
步骤步骤：清晰设置
- 读你的端点API文档并记下方法、正文类型、文件字段名称、任何认证头，以及响应中URL的确切位置。
- 首先备份你的当前ShareX设置。导出你现有的目标地址配置，所以你知道如何回滚如果改变出现问题。
- 创建自定义上传器在ShareX中（目标地址→自定义上传器设置）。设置请求方法、目标地址URL、头和正文类型以匹配你的端点。
- 配置响应解析器使用正确的JsonPath、XPath、正则表达式或头规则，所以ShareX返回正确的URL。
- 用无害截图测试 ——一个一次性图像——并确认返回的链接实际打开文件。
- 验证删除/保留行为如果你的端点支持删除，所以你知道如何稍后移除上传。
- 将其设置为你的活跃目标地址只有一旦真实测试链接端到端工作。
分享和重复使用配置：.sxcu文件
一个完成的自定义上传器可以被导出为.sxcu文件。另一个用户可以通过双击该文件导入它，ShareX自动应用目标地址配置。这使得在你自己的计算机或与一个团队共享工作设置变得容易——但这也正是秘密泄露的地方，所以在你发送给任何人之前请阅读下一部分。
保护你的秘密
自定义上传器常常包含API密钥、令牌或签名凭据。将.sxcu文件如密码：
- 在分享配置前剥掉或替换真实凭据带占位符。一个
.sxcu你公开发布能暴露一个实时密钥。 - 倾向于范围化、可撤销令牌长期存活主密钥，所以泄露是被容纳的且易于轮换。
- 始终通过HTTPS上传所以凭据和文件不在清晰中发送。
- 轮换任何可能已被暴露的东西 ——截图及其配置比你期望的传播更远。
当存在时更倾向内置目标地址
如果你的存储是 Amazon S3、Google Cloud Storage 或 Cloudflare R2，请按照 ShareX 为该提供商提供的指南操作，而不是手写通用的 HTTP 请求。例如，ShareX 的 Amazon S3 指南涵盖存储桶、访问密钥和可选的自定义域。通用 HTTP 自定义上传器则留给没有指南的端点使用。
Maxisnap Studio 也可以上传到你自己的服务器
Maxisnap Studio，一个一次性升级，添加自定义上传后端—— SFTP、FTP、S3兼容和HTTP ——这样你的 Windows 截图就能上传到你掌控的存储空间。要了解 Maxisnap 的上传选项是如何组织的，请参阅SFTP 上传和S3 / R2 上传页，或阅读更广Maxisnap和ShareX概览。
Maxisnap 与 ShareX 没有关联。对 ShareX 的描述依据其官方网站在 2026 年 10 月的介绍；请查看官方网站，了解当前的功能、定价和平台。getsharex.com