ShareX自定义上传器指南：自托管截图链接
电源用户喜欢的原因之一 ShareX 是它不将你的截图锁定到别人的云中。使用自定义上传器，ShareX可以将每个截图推送到一个目标地址 你 控制——你自己的服务器、对象存储桶或链接缩短端点——并自动将一个可分享的URL返回给你。本指南解释了自定义上传器系统如何工作、如何干净地设置一个，以及如何在你这样做时保护你的凭据。
首先关键区别： ShareX的 通用HTTP自定义上传器 是为了与你自己或第三方HTTP端点对话。对于主要对象存储，ShareX也附带 内置目标地址指南 ——包含Amazon S3、Google Cloud Storage和Cloudflare R2——通常比手工编写HTTP请求更简单。当存在时选择内置路径；当不存在时使用通用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请求。内置目标地址为你处理提供商特定的签名和自定义域设置，这是较少的活动部分和较少的犯错地方。为没有内置选项的端点保留通用HTTP自定义上传器。
如果你宁愿不手工配置请求
自定义上传器之所以强大，正是因为它是完全可配置的——那种灵活性就是重点，对于自托管者来说是理想的。如果你喜欢拥有你的存储但宁愿指点并选择一个后端而不是编写HTTP请求和响应解析器，一个更有引导的设置可以节省时间。 Maxisnap Studio，一个一次性升级，添加自定义上传后端—— SFTP、FTP、S3兼容和HTTP — 这样您的 Windows 截图可以上传到您控制的存储空间，只需经过更简单的配置流程。这与 ShareX 的完全开放请求构建器有不同的权衡，针对希望拥有所有权但不需要请求级别细节的用户。您可以在以下位置看到 Maxisnap 的上传选项是如何结构化的 SFTP 上传 和 S3 / R2 上传 页，或阅读更广 Maxisnap和ShareX概览。
ShareX是其各自所有者的商标；Amazon S3、Google Cloud Storage和Cloudflare R2是其各自所有者的商标。ShareX功能详情在2026年8月17日对照ShareX的官方文档进行了检查，可能会改变。Maxisnap是一个独立产品，不与这些项目或公司有关联、未获得其背书，也未获得其赞助。