Apa Sebenarnya yang Anda Dapat daripada Self-Host (dan Apa Kosnya)
Self-host PDF123 menyimpan muat naik pada pdfx-server anda dan menyediakan katalog REST, MCP, serta CLI yang sama. Anda menukar kemudahan SaaS dengan kos operasi.
Penukar awam mengoptimumkan kerja sekali tanpa nama. Self-host PDF123 mengubah kontraknya: muat naik mendarat pada mesin yang anda kendalikan, dan setiap alat katalog boleh dicapai melalui HTTP, bukan sekadar melalui borang pelayar.
Apa yang anda peroleh
Kedudukan data setempat ialah perkara pertama yang anda peroleh. Fail masuk ke pdfx-server anda, bukan ke storan sementara yang tidak anda kendalikan. Perkara kedua ialah permukaan pembangun pada kotak yang sama: REST di bawah /api/v1/…, OpenAPI di /v1/openapi.json, MCP di /mcp, dan pdfx --cloud yang diarahkan ke URL asas anda.
Docker Compose menjalankan backend Rust dan portal Next.js serentak supaya manusia dan skrip berkongsi satu katalog. Tiada pemasang desktop dalam laluan itu; penggunaan luar talian ialah Compose dan CLI (Self-host). Kerja setempat asli menggunakan task pdfx:dev bersebelahan portal; Compose menggunakan task docker:build / task docker:up (API :8080, portal :3000).
Ejen atau tugasan CI yang mempunyai kunci anda memanggil operasi yang sama seperti tapak awam. Gabungkan PDF, Mampatkan PDF, OCR, convert, dan selebihnya mengekalkan laluan serta parameter yang sama. Kesamaan itulah produknya, bukan slogan.
Iklan yang membiayai tapak awam bukan sebahagian daripada pemasangan self-host. Anda juga terlepas daripada isu kuota tanpa nama yang dihoskan: perancangan kapasiti menjadi tanggungjawab anda, termasuk lonjakan CPU semasa OCR atau gabungan besar. OCR masih memulangkan Markdown (text/markdown) pada kotak anda; memindahkan pelayan tidak mengubah kontrak operasi.
Apa kosnya
Anda bertanggungjawab ke atas masa operasi, naik taraf imej, cakera untuk fail sementara, TLS, dan putaran kunci. Compose pantas dimulakan, tetapi menjaganya kekal sihat ialah kerja berterusan. Tetapkan SECURITY_CUSTOMGLOBALAPIKEY apabila anda mahukan kawalan kunci API yang tetap pada instans anda. Ciri pilihan (contohnya URL→PDF melalui SYSTEM_ENABLEURLTOPDF=true) ialah bendera yang anda dayakan dengan sengaja, bukan lalai yang muncul semata-mata kerana tapak awam memilikinya.
Self-host tidak menambah kanvas "Edit PDF" visual hanya dengan menukar satu bendera. Permukaannya kekal sebagai alat borang beserta API. Jika anda memerlukan penyuntingan kanvas, anda masih memerlukan produk yang berbeza; memindahkan pelayan tidak mencipta antara muka itu.
Had kadar dan tingkah laku pemeteran bergantung pada cara anda mengkonfigurasi kotak itu. Jangan andaikan pengepala dan had yang dinyatakan oleh tapak awam berpindah tanpa perubahan; bacalah pengepala yang dipulangkan oleh instans anda apabila anda mementingkan bajet. Operasi yang berat kebergantungannya (model OCR, penukar pilihan) gagal dengan kod masalah berstruktur missing_dependency / unavailable jika binari atau pek model itu tidak dipasang pada imej anda.
Kaitannya dengan tapak awam
Gunakan PDF123 yang dihoskan untuk percubaan tanpa persediaan. Alat katalog dan panggilan /api/v1/ tanpa nama tidak memerlukan akaun di sana; respons menyatakan X-RateLimit-* dan respons 429 menyertakan Retry-After (had kadar tanpa nama).
Self-host apabila peraturan pengekalan, rangkaian terasing, atau automasi peribadi memerlukannya. /llms.txt membantu ejen menemui alat pada mana-mana URL asas yang anda jalankan; Google Search tidak menganggapnya sebagai isyarat kedudukan. MCP dan OpenAPI kekal tersedia bersebelahan portal pada asas yang sama.
Bila belum perlu self-host
Jika anda hanya memerlukan satu gabungan petang ini, borang yang dihoskan sudah memadai. Jika anda memerlukan bait data yang peribadi esok dan setiap hari selepas itu, mulakan dengan Compose sekarang, daripada memasang pemasang desktop sebagai tabiat SaaS. Jalan cerita luar talian yang kami sokong didokumentasikan di Self-host, bukan penyenaraian kedai.
Mulakan dengan Self-host. Kunci dan OpenAPI ada di Pembangun. Untuk perbandingan yang lebih ringkas dengan penukar pelayar sahaja, lihat Mengapa self-host kit alat PDF. Untuk sebab Compose menjadi laluan peribadi dan bukannya fail .exe, lihat Mengapa kami melangkau aplikasi desktop.