ShareX Custom Uploader Guide．Self-Hosted Screenshot Links

パワーユーザーが愛する理由の1つ ShareX これは、スクリーンショットを他の誰かのクラウドにロックしません。カスタムアップローダーを使用すると、ShareXはすべてのキャプチャを宛先にプッシュできます 自分 コントロール。あなた自身のサーバー、オブジェクトストレージバケット、またはリンク短縮エンドポイント。そして、共有可能なURLを自動的に返してください。このガイドでは、カスタムアップローダーシステムがどのように機能するか、クリーンなものをセットアップする方法、資格情報を安全に保つ方法について説明します。

カスタムアップローダーが実際にある

ShareXの公式ドキュメントが示すように、カスタムアップローダー機能は主に独自のサービスをホストしている人によって使用されます。実際には、ShareXに何かをキャプチャするときに、小さな定義です。 この URL、使用 このリクエストそしてその結果のリンクを見つけてください レスポンスのこの部分。これら3つを正しくして、ShareXは静かにアップロードして毎回機能するURLをコピーします。

リクエスト。メソッドとボディタイプ

ShareX Custom Uploader は標準HTTPメソッドをサポートしています。 GET、POST、PUT、PATCH、削除。経験則として、ドキュメントから。リクエストがパラメーターのみを実行し、本体がない場合。 GET ファイルとして送信される場合は好まれます。 multipart/form-data、 POST は通常の選択です。

リクエスト本体については、ShareXはいくつかのタイプを提供しているため、エンドポイントが期待するのと一致できます。

• 本体なし パラメータのみ。
• フォームデータ（multipart/form-data） ファイルをアップロードするための典型的な選択肢。
• フォーム URL Encoded（application/x-www-form-urlencoded）。
• JSON（application/json）。
• XML（application/xml）。
• バイナリ 本体としての生ファイル。

サーバーのAPIドキュメントは方法とボディタイプを期待していることを示しています。ShareX定義でそれをミラーリングするだけです。

レスポンスをパース。リンクはどこにありますか？

アップロード後、エンドポイントは応答します。通常JSON、XML、またはプレーンテキスト。最終URLを保持するフィールドをShareXに指示する必要があります。ShareXは4つの方法を提供しています。

• JSON JsonPath構文を使用、例えば。 {json:data.link} を読む data.link JSON応答から。
• XML XPath を使用、例えば {xml:/files/file[1]/url}。
• Regex プレーンテキストレスポンスのパターンマッチング用。
• ヘッダー レスポンスヘッダーで返されたURLを読む。

このステップは人々がしばしば間違える場所です。アップロードは成功しますが、パーサーが間違ったフィールドを指しているため、ShareXがコピーする「URL」は空またはマルフォーマットです。それが起こったとき、サーバーが返す生レスポンスを見て、URL文字列への正確なパスをトレースしてください。

ステップバイステップ。クリーンなセットアップ

1. エンドポイントのAPIドキュメントを読む メソッド、ボディタイプ、ファイルの場合のフィールド名、オース認証ヘッダー、レスポンス内のURLの正確な位置に注意してください。
2. 最初に現在のShareX設定をバックアップしてください。 必要な場合に備えて、既存の宛先構成をエクスポートしてロールバックします。
3. カスタムアップローダーを作成 ShareX（宛先→カスタムアップローダー設定）。リクエストメソッド、宛先URL、ヘッダー、エンドポイントが期待する本体タイプを設定します。
4. レスポンスパーサーを構成する 正しいJsonPath、XPath、正規表現、またはヘッダールールを使用して、ShareXが正しいURLを返します。
5. 害のないキャプチャでテストしてください 投げ捨てイメージ。返されたリンクが実際にファイルを開くことを確認してください。
6. 削除/保持動作を確認する エンドポイントが削除をサポートしている場合は、後でアップロードを削除する方法を知っています。
7. アクティブな宛先として設定します 本当のテストリンクが終わりまで機能するだけ。

構成の共有とリユース。.sxcuファイル

完成したカスタムアップローダーはエクスポートできます .sxcu ファイル。別のユーザーはファイルをダブルクリックしてインポートでき、ShareXは宛先構成を自動的に適用します。これにより、複数のマシン間で、またはチーム内で機能するセットアップを簡単に共有できます。ただし、ここは秘密が流出する正確な場所でもあるため、次のセクションを読んでからどこかに送信してください。

あなたの秘密を保護

カスタムアップローダーにはしばしばAPIキー、トークン、または署名の認証情報が含まれています。 .sxcu ファイルのようなパスワード。

• 構成を共有する前に実際の認証情報をストリップまたは置き換える プレースホルダー付き。A .sxcu 公開できます公開キーをエクスポーズします。
• 永続マスターキーよりもスコープされた取り消し可能なトークンを優先する 永続マスターキーよりも、流出は含まれているため、簡単にローテーションします。
• 常にHTTPSを介してアップロードします クリアで認証情報とファイルが送信されない場合。
• 公開されている可能性があるすべてのものを回転 スクリーンショットとその構成はあなたが期待するよりも旅します。

組み込み宛先があるときは優先します

Amazon S3、Google Cloud Storage、Cloudflare R2の場合は、汎用HTTPリクエストを手作業で構築する代わりに、そのプロバイダー用のShareX組み込みガイドを使用してください。組み込みの宛先はプロバイダー固有の署名とカスタムドメイン設定を処理するため、可動部分が少なく、誤りが少なくなります。汎用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は独立した製品であり、これらのプロジェクトまたは企業に提携していない、承認されていない、またはスポンサーされていません。