Panduan Pembuat Unggah Khusus ShareX: Tautan Tangkapan Layar Self-Hosted

Salah satu alasan pengguna canggih mencintai ShareX adalah bahwa itu tidak mengunci tangkapan layar Anda ke cloud seseorang. Dengan pembuat unggah khusus, ShareX dapat mendorong setiap tangkapan ke destinasi Anda kontrol — server Anda sendiri, bucket penyimpanan objek, atau titik akhir pemendek tautan — dan serahkan tautan yang dapat dibagikan secara otomatis. Panduan ini menjelaskan cara kerja sistem pembuat unggah khusus, cara menyiapkannya dengan bersih, dan cara menjaga kredensial Anda aman saat Anda melakukannya.

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, titik akhir Anda merespons — biasanya dengan JSON, XML, atau teks biasa — dan Anda perlu memberi tahu ShareX field mana yang menyimpan URL akhir. ShareX memberi Anda empat cara 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.

Ini adalah langkah yang paling sering dilakukan orang dengan salah: unggahan berhasil, tetapi "URL" yang ShareX salin kosong atau salah format karena pengurai menunjuk ke field yang salah. Ketika itu terjadi, lihat respons mentah yang server Anda kembalikan dan lacak jalur yang tepat 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, gunakan panduan bawaan ShareX yang didedikasikan untuk penyedia itu daripada membangun permintaan HTTP generik dengan tangan. Destinasi bawaan menangani penandatanganan khusus penyedia dan pengaturan domain kustom untuk Anda, yang merupakan lebih sedikit bagian yang bergerak dan lebih sedikit tempat untuk membuat kesalahan. Cadangkan pembuat unggah HTTP khusus untuk titik akhir yang tidak memiliki opsi bawaan.

Jika Anda lebih suka tidak mengonfigurasi permintaan dengan tangan

Pembuat unggah khusus sangat kuat tepat karena sepenuhnya dapat dikonfigurasi — kelenturan itulah intinya, dan untuk self-hoster itu ideal. Jika Anda menyukai kepemilikan penyimpanan tetapi lebih suka titik-dan-pilih backend daripada mengarang permintaan HTTP dan pengurai respons, pengaturan yang lebih terpandu dapat menghemat waktu. Maxisnap Studio, upgrade satu kali, menambahkan backend unggahan kustom — SFTP, FTP, kompatibel S3, dan HTTP — jadi tangkapan Windows Anda naik ke penyimpanan yang Anda kontrol dengan alur konfigurasi yang lebih sederhana. Ini adalah pertukaran yang berbeda dari pembuat permintaan yang sepenuhnya terbuka ShareX, ditujukan kepada orang yang menginginkan kepemilikan tanpa detail tingkat permintaan. Anda dapat melihat bagaimana opsi unggah Maxisnap terstruktur di Unggah SFTP dan Upload S3 / R2 halaman, atau baca yang lebih luas Gambaran umum Maxisnap dan ShareX.

ShareX adalah merek dagang pemiliknya masing-masing; Amazon S3, Google Cloud Storage, dan Cloudflare R2 adalah merek dagang pemilik masing-masing. Detail fitur ShareX diperiksa terhadap dokumentasi resmi ShareX pada 17 Agustus 2026 dan dapat berubah. Maxisnap adalah produk independen dan tidak terkait dengan, didukung oleh, atau disponsori oleh proyek atau perusahaan apa pun.