Paddock: sandbox tự lưu trữ cho AI agent

Paddock dùng để làm gì? Giải thích dễ hiểu

Paddock cấp cho AI agent một máy tính Linux riêng trên VPS do bạn quản lý. Mỗi môi trường, gọi là box, có tệp dự án, công cụ và desktop Ubuntu XFCE. Agent có thể chạy lệnh, biên dịch ứng dụng rồi mở giao diện để kiểm tra kết quả. Bạn có thể giữ box cho công việc tiếp theo hoặc xóa sau một tác vụ.

Website giới thiệu phần mềm cần tự triển khai. Muốn có desktop sử dụng được, bạn phải cài máy chủ trước. Paddock quản lý môi trường thực thi; agent và mô hình được chọn xử lý yêu cầu.

Chạy mã và kiểm tra ứng dụng trên desktop

Box hỗ trợ Docker thông qua Sysbox. Claude Code, Codex, OpenCode, Pi, Prime và Kimi được cài sẵn, nhưng bạn vẫn cần cấu hình xác thực nhà cung cấp. Công cụ có sẵn không đồng nghĩa với hạn mức mô hình miễn phí.

Gửi tác vụ bằng paddock prompt hoặc dùng CLI và bảng điều khiển web. Để xem ứng dụng đồ họa, mở paddock desktop, chạy chương trình qua exec --desktop và lưu ảnh bằng paddock screenshot. API HTTP cùng SDK TypeScript/Python giúp tích hợp quản lý box vào công cụ riêng.

Cài đặt và chạy thử dự án

Hướng dẫn chính thức yêu cầu VPS Ubuntu hoặc Debian, quyền root, amd64 hoặc arm64, cổng 80/443 mở và tên máy chủ trỏ về VPS. Sau khi cài, mở liên kết thiết lập một lần để tạo tài khoản chủ sở hữu. Tiếp theo, cài CLI trên máy cá nhân và đăng nhập máy chủ. Có hướng dẫn cho Windows, macOS và Linux.

Với dự án Node đã chuẩn bị, quy trình sau sao chép tệp và chạy kiểm thử:

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

Đọc đầu ra để xác nhận kết quả. Dự án cần có tập lệnh kiểm thử và thư viện phụ thuộc; nếu phải tải thêm gói, chính sách mạng cần cho phép nguồn phù hợp. Lệnh cuối lưu snapshot hệ thống tệp rồi dừng box. Dùng pull để lấy sản phẩm cần giữ trước khi xóa môi trường tạm. Paddock skill cho phép agent được hỗ trợ thao tác CLI.

Giới hạn mạng và dữ liệu gửi ra ngoài

Bạn có thể chọn allow-all, deny-all hoặc danh sách miền/dải IPv4 được phép. Box mới mặc định dùng allow-all. Deny-all chặn kết nối đi ra mới; kết nối đang có có thể hoàn tất. Truy cập metadata đám mây bị chặn trong mọi chế độ.

Cần tính đến API mô hình, kho mã và nguồn gói mà tác vụ sử dụng. Tắt mạng hoàn toàn cũng ngăn tải thư viện và gọi mô hình từ xa. Tự lưu trữ kiểm soát máy chủ thực thi, nhưng dữ liệu gửi đến dịch vụ bên ngoài vẫn chịu chính sách của họ. Không nên hiểu các tính năng này là bảo đảm chống mọi trường hợp thoát sandbox.

Giữ tệp và khôi phục đúng loại trạng thái

Box có thể dừng, tiếp tục, fork và khôi phục snapshot. Ổ đĩa có tên dưới /mnt giữ dữ liệu sau khi xóa box, hữu ích cho bộ nhớ đệm hoặc đầu vào tái sử dụng.

Tài liệu snapshot nêu rõ RAM, tiến trình đang chạy, /var/lib/docker và ổ đĩa được gắn không nằm trong snapshot. Chỉ trạng thái hệ thống tệp được lưu; cần sao lưu dữ liệu ổ đĩa riêng. Tiếp tục box không có nghĩa là tiến trình chạy tiếp từ đúng lệnh cũ.

Mã nguồn mở và chi phí vận hành

Kiểm tra ngày 29/10/2026: dự án dùng giấy phép MIT. Tài liệu chính thức đã xem không có bảng gói thuê dịch vụ Paddock được quản lý. VPS, lưu trữ và sử dụng mô hình có thể phát sinh phí riêng. Số box đồng thời phụ thuộc tài nguyên máy chủ.

Phù hợp với lập trình viên muốn quản lý môi trường agent và có khả năng vận hành Linux, cập nhật, phân quyền và sao lưu.

Câu hỏi thường gặp

Paddock có miễn phí không?

Phần mềm MIT được cung cấp không cần thuê bao phần mềm trong nguồn đã kiểm tra. Máy chủ và dịch vụ AI bên ngoài không được miễn phí kèm theo.

Có thể dùng từ Windows hoặc macOS không?

Có hướng dẫn cài CLI cho cả hai. Máy chủ vẫn cần hạ tầng Linux được mô tả trong tài liệu.

Sandbox mới có bị ngắt internet sẵn không?

Không. Mặc định là allow-all; bạn cần chủ động chọn deny-all hoặc danh sách cho phép.

Tài nguyên chính thức

• Kho mã dự án: mã nguồn và tài liệu kỹ thuật.
• Bản phát hành và tải xuống: tệp CLI và thông tin phiên bản.