Panduan Pengunggah Khusus ShareX: Tautan Tangkapan Layar Self-Hosted

ShareX adalah alat screenshot gratis dan open source untuk Windows yang menggabungkan tangkapan layar, perekaman layar, berbagi file, dan alat produktivitas.

Dokumentasi custom uploader ShareX, yang dibaca pada Oktober 2026, menjelaskan sebuah sistem yang memungkinkan Anda mengunggah gambar, teks, dan file ke layanan hosting atau memperpendek dan membagikan URL. Panduan ini mengikuti dokumentasi tersebut: cara kerja custom uploader, cara menyiapkannya dengan rapi, dan cara menjaga kredensial Anda tetap aman saat melakukannya.

Baca dokumentasi custom uploader ShareX.

Apa itu uploader kustom sebenarnya

Seperti yang dikatakan dokumentasi ShareX sendiri, fitur pembuat unggah khusus terutama digunakan oleh orang yang menjalankan layanan mereka sendiri. Dalam praktik itu adalah definisi kecil yang memberi tahu ShareX: ketika saya menangkap sesuatu, kirimkan ke URL ini, menggunakan permintaan ini, dan cari tautan yang dihasilkan di bagian respons ini. Dapatkan tiga hal itu benar dan ShareX secara diam-diam mengunggah dan menyalin URL kerja setiap kali Anda menggambar.

Permintaan: metode dan jenis isi

ShareX mendukung metode HTTP standar — GET, POST, PUT, PATCH, dan DELETE. Sebagai aturan praktis dari dokumen: jika permintaan hanya membawa parameter dan tidak ada badan, GET lebih disukai; jika mengirim file sebagai multipart/form-data, POST adalah pilihan biasanya.

Untuk badan permintaan, ShareX menawarkan beberapa tipe sehingga dapat mencocokkan apa pun yang diharapkan titik akhir Anda:

• Tidak ada isi — parameter saja.
• Data formulir (multipart/form-data) — pilihan tipikal untuk mengunggah file.
• Form URL encoded (application/x-www-form-urlencoded).
• JSON (application/json).
• XML (application/xml).
• Biner — file mentah sebagai isi.

Dokumentasi API server Anda memberi tahu Anda metode dan tipe badan mana yang diharapkan; Anda hanya mencerminkan itu dalam definisi ShareX.

Menguraikan respons: di mana tautannya?

Setelah unggahan, endpoint Anda merespons — biasanya dengan JSON, XML, atau teks biasa — dan Anda perlu memberi tahu ShareX field mana yang menyimpan URL akhir. ShareX memberi Anda cara-cara berikut untuk mengekstraknya:

• JSON menggunakan sintaks JsonPath, misalnya {json:data.link} untuk membaca data.link dari respons JSON.
• XML menggunakan XPath, misalnya {xml:/files/file[1]/url}.
• Regex untuk pencocokan pola respons teks biasa.
• Header untuk membaca URL yang dikembalikan dalam header respons.

Jika unggahan berhasil tetapi URL yang disalin ShareX kosong atau salah format, parser mungkin menunjuk ke field yang salah. Lihat respons mentah yang dikembalikan server Anda dan lacak jalur persisnya ke string URL.

Langkah demi langkah: penyetelan bersih

1. Baca dokumentasi API titik akhir Anda dan catat metodenya, tipe badannya, nama bidang untuk file, header auth apa pun, dan lokasi tepat URL dalam respons.
2. Cadangkan pengaturan ShareX Anda saat ini terlebih dahulu. Ekspor konfigurasi destinasi yang ada sehingga Anda dapat kembali jika perubahan tidak berperilaku.
3. Buat uploader kustom di ShareX (Destinations → pengaturan pembuat unggah khusus). Atur metode permintaan, URL destinasi, header, dan tipe badan agar sesuai dengan API titik akhir Anda.
4. Konfigurasikan parser respons menggunakan aturan JsonPath, XPath, regex, atau header yang tepat sehingga ShareX mengembalikan URL yang benar.
5. Uji dengan tangkapan yang tidak berbahaya — gambar yang dibuang — dan konfirmasi tautan yang dikembalikan benar-benar membuka file.
6. Verifikasi perilaku hapus/retensi jika titik akhir Anda mendukung penghapusan, jadi Anda tahu cara menghapus unggahan nanti.
7. Tetapkan sebagai tujuan aktif Anda hanya setelah tautan pengujian nyata berfungsi dari awal hingga akhir.

Berbagi dan menggunakan kembali konfigurasi: file .sxcu

Pembuat unggah khusus yang selesai dapat diekspor sebagai .sxcu berkas. Pengguna lain dapat mengimpornya dengan mengklik dua kali file, dan ShareX menerapkan konfigurasi destinasi secara otomatis. Itu membuatnya mudah untuk berbagi pengaturan yang berfungsi di seluruh mesin Anda sendiri atau dengan tim — tetapi itu juga persis di mana rahasia bocor, jadi baca bagian berikutnya sebelum Anda mengirim satu ke siapa pun.

Lindungi rahasia Anda

Pembuat unggah khusus sering berisi kunci API, token, atau kredensial yang ditandatangani. Perlakukan .sxcu file seperti kata sandi:

• Sebelum berbagi konfigurasi, lepas atau ganti kredensial nyata dengan placeholder. A .sxcu Anda posting secara publik dapat mengekspos kunci aktif.
• Lebih suka token yang terscopeScopedrevocable atas kunci master yang berumur panjang, jadi kebocoran terkandung dan mudah diputar.
• Selalu unggah melalui HTTPS sehingga kredensial dan file tidak dikirim dalam jelas.
• Putar apa pun yang mungkin telah diekspos — tangkapan layar dan konfignya bepergian lebih jauh dari yang Anda harapkan.

Lebih suka tujuan bawaan ketika ada satu

Jika penyimpanan Anda adalah Amazon S3, Google Cloud Storage, atau Cloudflare R2, ikuti panduan ShareX untuk penyedia itu daripada membangun permintaan HTTP generik dengan tangan. Panduan Amazon S3 ShareX, misalnya, mencakup bucket, access key, dan domain kustom opsional. Gunakan custom uploader HTTP generik untuk endpoint yang tidak memiliki panduan.

Maxisnap Studio juga dapat mengunggah ke server Anda sendiri

Maxisnap Studio, upgrade satu kali, menambahkan backend unggahan kustom — SFTP, FTP, kompatibel S3, dan HTTP — sehingga tangkapan Windows Anda diunggah ke penyimpanan yang Anda kendalikan. Anda dapat melihat bagaimana opsi unggah Maxisnap disusun di Unggah SFTP dan Upload S3 / R2 halaman, atau baca yang lebih luas Gambaran umum Maxisnap dan ShareX.

Maxisnap tidak berafiliasi dengan ShareX. Halaman ini menjelaskan ShareX sebagaimana situs resminya menyajikannya pada Oktober 2026; periksa situs resminya untuk fitur, harga, dan platform terkini. getsharex.com