ShareXカスタムアップローダーガイド：セルフホストのスクリーンショット共有リンク

ShareXはWindows向けの無料のオープンソースのスクリーンショットツールで、画面キャプチャ、画面録画、ファイル共有、作業効率化ツールを備えています。

2026年10月に確認したShareXのカスタムアップローダーのドキュメントは、画像、テキスト、ファイルをホスティングサービスにアップロードしたり、URLを短縮して共有したりできる仕組みを説明しています。このガイドはそのドキュメントに沿って、カスタムアップローダーの仕組み、きれいに設定する方法、その間に認証情報を安全に保つ方法を説明します。

ShareXのカスタムアップローダーのドキュメントをお読みください。

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

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では、次の方法でURLを取り出せます：

• JSON：JsonPath構文を使います。例：{json:data.link}を指定すると、JSONレスポンス内のdata.linkを読み取れます。
• 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のガイドに従ってください。たとえばShareXのAmazon S3のガイドには、バケット、アクセスキー、任意のカスタムドメインが載っています。汎用HTTPのカスタムアップローダーは、ガイドがないエンドポイントのために使ってください。

Maxisnap Studioなら自分のサーバーにもアップロードできます

Maxisnap Studioは買い切りのアップグレードで、次のカスタムアップロード先を追加します：SFTP、FTP、S3互換、HTTP ―つまり、Windowsのキャプチャを自分で管理するストレージにアップロードできます。Maxisnapのアップロードオプションの構成は、SFTPアップロードとS3 / R2 アップロードのページで確認できます。全体像はこちら：MaxisnapとShareXの概要。

Maxisnapは、ShareXと提携していません。このページは、2026年10月時点で公式サイトが示していた内容に基づいてShareXを説明しています。最新の機能、料金、対応プラットフォームは公式サイトでご確認ください。getsharex.com