需配置自定义文本上传器实现ShareX上传至Pastebin类服务:一、用.sxcu文件导入适配API的Pastebin服务;二、通过CustomUploader.js脚本处理复杂认证或加密逻辑;三、借助curl等CLI工具桥接上传并回传URL。

如果您希望将文本内容(如代码片段、日志、配置信息)通过 ShareX 快速上传至 Pastebin 类服务并获取分享链接,则需配置自定义文本上传器。ShareX 本身不内置 Pastebin 支持,但可通过自定义上传器(.sxcu 文件)或 CustomUploader.js 脚本实现。以下是多种可行的配置方法:
一、使用 .sxcu 文件导入 Pastebin 兼容服务
该方法适用于提供标准 Pastebin API 或类 Pastebin 接口的服务(如 PrivateBin、dpaste、Hastebin 等),无需编写脚本,仅依赖 ShareX 内置的 HTTP 上传器能力。
1、访问目标 Pastebin 类服务的 API 文档,确认其支持 POST 表单上传、返回 JSON 格式 URL,且请求体为 application/x-www-form-urlencoded 或 text/plain。
2、构造符合 ShareX 规范的 JSON 配置内容,例如适配 dpaste.org 的配置示例:
{"Version":"14.0.0","Name":"dpaste","DestinationType":"TextUploader","RequestMethod":"POST","RequestURL":"https://dpaste.org/api/","Body":"FormURLEncoded","Arguments":{"content":"$input$","syntax":"text","expiry_days":"7"},"URL":"$json:url$","ErrorMessage":"$json:error$"}
3、打开 ShareX → 右键系统托盘图标 → 目标 → 自定义上传器设置 → 点击“导入” → 选择“从剪贴板导入”,粘贴上述 JSON 内容。
4、保存后,在 ShareX 主界面 → 任务设置 → 文本上传 → 选择“dpaste”作为默认文本上传器。
二、通过 CustomUploader.js 实现动态文本上传逻辑
当目标服务要求签名头、OAuth 认证、分段上传或响应解析逻辑复杂时,.sxcu 文件无法满足需求,此时需启用 ShareX 的自定义 JavaScript 上传器功能,直接调用 src/CustomUploader.js。
1、确保 ShareX 已启用高级脚本功能:进入 ShareX 设置 → 高级 → 勾选 “启用自定义上传器脚本”。
2、在 ShareX 安装目录或用户文档目录(如 C:\Users\用户名\Documents\ShareX)下,创建文件夹 Scripts,并将修改后的 CustomUploader.js 放入其中。
3、编辑 CustomUploader.js,在 exports.upload 函数中添加 Pastebin 类服务适配逻辑,例如针对 PrivateBin 的 AES 加密上传流程,需调用 CryptoJS 并注入 X-Requested-With 头。
4、在 ShareX 自定义上传器设置中,新建上传器 → 类型选“自定义上传器脚本” → 脚本路径指向该 CustomUploader.js 文件 → 在参数字段填入服务地址、密码(若需)等必要变量。
三、利用命令行 + 外部工具桥接文本上传
该方法绕过 ShareX 原生上传模块,通过调用外部 CLI 工具(如 curl、httpie)完成上传,并将结果 URL 写入剪贴板,再由 ShareX 捕获输出。适用于高度定制化或私有 Pastebin 部署场景。
1、安装 curl 或 httpie 到系统 PATH,并验证可执行性(在 CMD 中运行 curl --version)。
2、准备一个批处理脚本 upload-paste.bat,内容为:
@echo off
set /p input=
echo %input% | curl -s -X POST -H "Content-Type: text/plain" --data-binary @- https://your-privatebin.example.com/documents | python -c "import sys, json; print(json.load(sys.stdin)['key'])" > temp_url.txt
set /p url=
3、在 ShareX 中创建新任务 → 添加动作 → “运行命令行” → 命令设为 upload-paste.bat,参数留空;再添加后续动作“从剪贴板获取文本”并“显示通知”。
4、将该任务绑定热键,截图后选中文本区域 → 右键“复制文本” → 按热键触发,最终 URL 将自动复制到剪贴板。
四、基于 Zipline 后端生成 ShareX 兼容文本上传配置
Zipline 支持文本上传模式,并内置 ShareX 配置生成器,可一键导出含身份认证与加密参数的 .sxcu 文件,适用于自建 Zipline 实例并启用文本上传功能的用户。
1、登录您的 Zipline 管理后台 → 进入“设置” → “ShareX 配置生成器”。
2、勾选 “启用文本上传”,设置默认过期时间、密码保护开关及语法高亮类型。
3、点击“生成配置”,下载生成的 .sxcu 文件(文件名含 zipline-text-uploader.sxcu)。
4、将该 .sxcu 文件放入 ShareX 的 Uploaders 文件夹(路径为 C:\Users\用户名\Documents\ShareX\Uploaders),重启 ShareX。
5、在 ShareX 文本上传目标列表中即可看到“Zipline Text”选项,上传时自动携带 x-zipline-password 等安全头部。
五、调试与验证文本上传行为
ShareX 提供详细日志记录机制,用于定位文本上传失败原因,尤其在使用非标准 API 或自定义脚本时至关重要。
1、启动 ShareX 时附加命令行参数 -LogToFile,使所有上传操作写入日志文件(默认位于 %APPDATA%\ShareX\Logs)。
2、执行一次文本上传任务后,打开最新 log 文件,搜索关键词 "TextUploader" 和 "Response:",确认请求 URL、状态码及响应体是否符合预期。
3、若返回 400 或 403 错误,检查 Arguments 中的 $input$ 是否被正确替换,以及服务端是否拒绝未携带 Referer 或 Origin 头的请求。
4、在 ShareX 设置 → 高级 → 日志级别设为“详细”,可捕获更底层的网络请求头与 SSL 握手信息。











