Mengapa Self-Host Kit Alat PDF Berbanding Penukar Web Percuma Lain

Penukar PDF yang berasaskan pelayar sahaja mengoptimumkan muat naik, klik, muat turun. Iklan sering membiayai halaman itu, dan biasanya tiada permukaan pembangun yang stabil selain borangnya. Bentuk produk itu betul untuk kerja manusia sekali sekala. Ia bentuk yang salah apabila anda memerlukan automasi, dasar pengekalan, atau fail yang mesti kekal dalam rangkaian anda.

Apa yang dioptimumkan oleh penukar pelayar

Penukar awam menjual kemudahan: buka tab, lepaskan fail, dapatkan hasil, keluar. Antara muka pengguna itulah produknya. Skrip sama ada mengikis HTML atau menghantar permintaan ke laluan tidak didokumentasikan yang berubah tanpa notis. Pengekalan bergantung pada sesiapa yang mengendalikan storan sementara. Untuk satu gabungan dua PDF peribadi, pertukaran itu berbaloi.

Sebaik sahaja anda memerlukan kerja yang sama daripada CI, ejen, atau rangkaian terasing, bahagian yang hilang muncul serentak: pengesahan, OpenAPI, cubaan semula yang idempoten, dan katalog yang tidak menyimpang secara senyap daripada borang yang anda klik minggu lalu.

Apa yang anda dapat dengan menjalankan katalog ini sendiri

Tapak yang dihoskan dan instans self-host berkongsi operasi yang sama. Mampatkan PDF dan Gabungkan PDF ialah operasi yang sama sama ada permintaan datang daripada portal atau daripada POST /api/v1/…. Self-host menambah kawalan di sekeliling katalog yang dikongsi itu:

• REST + OpenAPI di /v1/openapi.json: setiap alat katalog ialah laluan yang stabil, bukan sekadar borang.
• MCP di /mcp: ejen menemui dan memanggil operasi yang sama tanpa perlu mencipta pengikis sendiri.
• CLI (pdfx): pdf-core setempat, atau --cloud terhadap kunci API pada URL asas anda.
• Tiada klien desktop: Docker Compose ialah jalan cerita luar talian; pemalam dan pemasang Windows sengaja diletakkan di luar skop.
• Iklan kekal di luar stack anda: AdSense di tapak awam bukan sebahagian daripada pemasangan self-host. Muat naik tidak pernah meninggalkan mesin yang anda jalankan.

Compose menghidupkan pdfx-server Rust dan portal Next.js serentak supaya manusia dan skrip berkongsi satu katalog. Pembangunan asli (task pdfx:dev berserta portal) menggunakan laluan operasi yang sama. Butirannya ada di Self-host.

OCR pada mana-mana pemasangan masih memulangkan Markdown (text/markdown) daripada /api/v1/misc/ocr-pdf, bukan PDF boleh cari yang dilapisi semula. Memindahkan pelayan mengubah tempat bait data mendarat; ia tidak mencipta kontrak operasi yang berbeza.

Apa yang sengaja tidak kami tiru

Kanvas "Edit PDF" dalam talian, perbandingan visual, Create PDF kosong, dan antara muka Sign untuk pengguna memerlukan kerja produk yang berbeza. Kami sebaliknya mengekalkan matriks alat berasaskan borang dan API. Self-host tidak membuka pokok antara muka kedua; ia memindahkan pokok yang sama ke belakang tembok api anda.

Melangkau permukaan pengguna itu memang disengajakan. Penyunting kanvas akan menjadi pangkalan kod kedua dengan kelewatan cirinya sendiri berbanding OpenAPI. Sekatan yang penting untuk penggunaan peribadi ialah "bait data kekal di sini", bukan "ada fail .exe". Untuk sebab tiada cabang desktop, lihat Mengapa Kami Melangkau Aplikasi Desktop.

Bila yang dihoskan memadai, dan bila tidak

Gunakan tapak awam apabila anda mahukan persediaan sifar dan kerja sekali tanpa nama. Alat katalog dan panggilan /api/v1/ tanpa nama tidak memerlukan akaun; respons yang dihoskan menyertakan pengepala had kadar, dan had itu wujud supaya permukaan percuma tidak menjadi ladang pemprosesan kelompok orang lain (had kadar tanpa nama).

Self-host apabila peraturan pengekalan, rangkaian peribadi, atau automasi peribadi memerlukannya. Anda kemudian bertanggungjawab ke atas masa operasi, naik taraf imej, cakera untuk fail sementara, TLS, dan putaran kunci (SECURITY_CUSTOMGLOBALAPIKEY untuk kawalan akses tetap pada kotak anda). Operasinya kekal sama; tempat bait data mendarat itulah yang berubah.

Cubalah

Mulakan dengan Self-host dan Pembangun. Untuk permukaan API berorientasikan ejen pada mana-mana URL asas, baca Dibina untuk ejen AI, bukan hanya pelayar. Untuk perbandingan kos dan manfaat yang lebih panjang, lihat Apa yang sebenarnya anda peroleh daripada self-host.