Self-host thực sự mua được gì (và tốn gì)

Converter công khai tối ưu cho những lần dùng một lần ẩn danh. Self-host PDF123 thay đổi hợp đồng: tệp tải lên rơi xuống máy do bạn vận hành, và mọi công cụ trong danh mục gọi được qua HTTP, không chỉ form trình duyệt.

Bạn mua được gì

Tính cục bộ của dữ liệu là thứ đầu tiên. Tệp rơi vào pdfx-server của bạn, không phải một kho tạm bạn không chạy. Thứ hai là bề mặt lập trình trên chính máy đó: REST dưới /api/v1/…, OpenAPI tại /v1/openapi.json, MCP tại /mcp, và pdfx --cloud nhắm vào base URL của bạn.

Docker Compose chạy backend Rust và portal Next.js cùng nhau để người lẫn script dùng chung một danh mục. Không có bộ cài desktop trong đường đó; dùng offline là Compose và CLI (Self-host). Phát triển cục bộ dùng task pdfx:dev bên cạnh portal; Compose dùng task docker:build / task docker:up (API :8080, portal :3000).

Một agent hay tác vụ CI cầm key của bạn gọi đúng những thao tác như trên site công khai. Merge, Compress, OCR, convert và phần còn lại giữ nguyên đường dẫn lẫn tham số. Chính sự giống nhau đó là sản phẩm, không phải khẩu hiệu.

Quảng cáo nuôi site công khai không thuộc bản self-host. Bạn cũng bỏ được câu chuyện hạn mức ẩn danh của bản hosted: việc tính dung lượng thành của bạn, kể cả những đỉnh CPU khi OCR hay ghép tệp lớn. OCR trên máy bạn vẫn trả Markdown (text/markdown); chuyển server không đổi hợp đồng thao tác.

Nó tốn những gì

Bạn sở hữu uptime, nâng cấp image, đĩa cho tệp tạm, TLS và xoay key. Compose khởi động nhanh; giữ nó khỏe mạnh là việc thường trực. Đặt SECURITY_CUSTOMGLOBALAPIKEY khi muốn một cổng API key cố định trên instance. Các tính năng tùy chọn (ví dụ URL→PDF qua SYSTEM_ENABLEURLTOPDF=true) là những cờ bạn chủ động bật, không phải mặc định xuất hiện chỉ vì site công khai có.

Self-host không thêm canvas “Edit PDF” chỉ bằng cách gạt cờ. Bề mặt vẫn là công cụ dạng form cộng API. Nếu cần chỉnh sửa trên canvas, bạn vẫn cần một sản phẩm khác; chuyển server không tạo ra giao diện đó.

Hạn mức và cách đo đếm phụ thuộc vào cách bạn cấu hình máy. Đừng giả định các tiêu đề và trần của site công khai chuyển nguyên sang; hãy đọc những tiêu đề mà instance của bạn trả về khi quan tâm đến ngân sách. Các thao tác nặng phụ thuộc (mô hình OCR, converter tùy chọn) thất bại với mã problem có cấu trúc missing_dependency / unavailable nếu binary hoặc gói mô hình chưa được cài trên image.

Liên hệ với site công khai

Dùng PDF123 hosted cho những lần thử không cần cài đặt. Công cụ trong danh mục và các lệnh gọi /api/v1/ ẩn danh ở đó không cần tài khoản; phản hồi công bố X-RateLimit-* và response 429 kèm Retry-After (giới hạn tần suất ẩn danh).

Hãy self-host khi quy định lưu giữ, mạng tách biệt hoặc tự động hóa riêng buộc phải vậy. /llms.txt giúp agent khám phá công cụ trên bất kỳ base URL nào bạn chạy; Google Search không coi đó là tín hiệu xếp hạng. MCP và OpenAPI vẫn sẵn có bên cạnh portal trên cùng base đó.

Khi nào chưa nên self-host

Nếu chiều nay bạn chỉ cần một lần ghép tệp, form hosted là đủ. Nếu ngày mai và mỗi ngày sau bạn cần byte riêng tư, hãy bắt đầu từ Compose ngay, thay vì gắn một bộ cài desktop vào thói quen dùng SaaS. Câu chuyện offline mà chúng tôi hỗ trợ được ghi tại Self-host, không phải trên một trang store.

Bắt đầu từ Self-host. Key và OpenAPI nằm ở Nhà phát triển. Để so sánh ngắn gọn hơn với các converter chỉ chạy trên trình duyệt, xem Vì sao nên self-host bộ công cụ PDF. Vì sao Compose là đường riêng tư thay vì một tệp .exe, xem Vì sao chúng tôi bỏ qua ứng dụng desktop.