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 像密碼一樣的檔案：
- 在分享配置之前，剝離或替換真實認證 用預留位置。A
.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 是一個獨立產品，與任何這些專案或公司無關、未獲得認可或贊助。