Apa yang benar-benar Anda dapatkan dari self-hosting (dan biayanya)

Konverter publik dioptimalkan untuk pemakaian anonim sesekali. Self-hosting PDF123 mengubah kontraknya: berkas yang diunggah mendarat di mesin yang Anda operasikan sendiri, dan setiap alat di katalog bisa dijangkau lewat HTTP, bukan hanya lewat formulir browser.

Apa yang Anda dapatkan

Lokalitas data adalah keuntungan pertama. Berkas masuk ke pdfx-server Anda, bukan ke penyimpanan sementara yang tidak Anda kelola. Keuntungan kedua adalah permukaan pengembang di mesin yang sama: REST di bawah /api/v1/…, OpenAPI di /v1/openapi.json, MCP di /mcp, dan pdfx --cloud yang diarahkan ke base URL Anda.

Docker Compose menjalankan backend Rust dan portal Next.js sekaligus, sehingga manusia dan skrip berbagi satu katalog. Tidak ada pemasang desktop di jalur itu; pemakaian offline berarti Compose dan CLI (Self-host). Pekerjaan lokal native memakai task pdfx:dev di samping portal, sedangkan Compose memakai task docker:build / task docker:up (API di :8080, portal di :3000).

Agen atau tugas CI yang memegang key Anda memanggil operasi yang sama dengan situs publik. Merge, Compress, OCR, convert, dan sisanya mempertahankan jalur serta parameter yang sama. Kesamaan itu adalah produknya, bukan sekadar slogan.

Iklan yang membiayai situs publik bukan bagian dari penerapan self-host. Anda juga melewati urusan kuota anonim versi hosted: perencanaan kapasitas menjadi tanggung jawab Anda, termasuk lonjakan CPU selama OCR atau penggabungan besar. OCR tetap mengembalikan Markdown (text/markdown) di mesin Anda; memindahkan server tidak mengubah kontrak operasinya.

Apa biayanya

Anda menanggung sendiri uptime, pembaruan image, ruang disk untuk berkas sementara, TLS, dan rotasi key. Compose memang cepat dinyalakan, tetapi menjaganya tetap sehat adalah pekerjaan berkelanjutan. Setel SECURITY_CUSTOMGLOBALAPIKEY bila Anda menginginkan gerbang API key yang tetap di instance Anda. Fitur opsional (misalnya URL→PDF lewat SYSTEM_ENABLEURLTOPDF=true) adalah flag yang Anda aktifkan dengan sengaja, bukan default yang muncul hanya karena situs publik memilikinya.

Self-host tidak menambahkan kanvas "Edit PDF" visual hanya dengan membalik satu flag. Permukaan yang tersedia tetap alat berbasis formulir plus API. Bila Anda membutuhkan penyuntingan kanvas, Anda tetap memerlukan produk lain; memindahkan server tidak menciptakan antarmuka itu.

Batas laju dan perilaku pencatatan mengikuti cara Anda mengonfigurasi mesinnya. Jangan menganggap header dan batas yang dinyatakan situs publik berpindah tanpa perubahan; bacalah header yang dikembalikan instance Anda ketika anggaran menjadi penting. Operasi yang berat dependensi (model OCR, konverter opsional) gagal dengan kode problem terstruktur missing_dependency atau unavailable bila biner atau paket modelnya tidak terpasang di image Anda.

Kaitannya dengan situs publik

Gunakan PDF123 hosted untuk uji coba tanpa persiapan. Alat katalog dan panggilan /api/v1/ anonim tidak memerlukan akun di sana; responsnya menyertakan X-RateLimit-*, dan respons 429 menyertakan Retry-After (pembatasan laju untuk pemanggil anonim).

Jalankan self-host ketika aturan retensi, jaringan terisolasi, atau otomasi privat menuntutnya. /llms.txt membantu agen menemukan alat pada base URL mana pun yang Anda jalankan; Google Search tidak memperlakukannya sebagai sinyal peringkat. MCP dan OpenAPI tetap tersedia di samping portal pada base yang sama.

Kapan belum perlu self-host

Jika Anda hanya membutuhkan satu kali merge sore ini, formulir hosted sudah cukup. Jika Anda membutuhkan byte yang privat besok dan setiap hari setelahnya, mulailah dari Compose sekarang, bukan menempelkan pemasang desktop pada kebiasaan SaaS. Jalur offline yang kami dukung didokumentasikan di Self-host, bukan di halaman toko aplikasi.

Mulailah dari Self-host. Key dan OpenAPI tersedia di Developers. Untuk perbandingan singkat dengan konverter yang hanya berjalan di browser, lihat Mengapa self-host toolkit PDF. Untuk alasan Compose menjadi jalur privat alih-alih .exe, lihat Mengapa kami melewati aplikasi desktop.