Paddock: sandbox agen AI yang dihosting sendiri

Untuk apa Paddock? Penjelasan sederhana

Paddock menyediakan komputer Linux terpisah untuk agen AI di VPS yang Anda kelola. Setiap lingkungan disebut box dan berisi berkas proyek, alat kerja, serta desktop Ubuntu XFCE. Agen dapat menjalankan perintah, membangun aplikasi, lalu membuka tampilannya untuk memeriksa hasil. Lingkungan dapat disimpan untuk pekerjaan berikutnya atau dihapus setelah satu tugas.

Situs publiknya memperkenalkan proyek yang perlu Anda pasang sendiri. Untuk memperoleh desktop yang dapat digunakan, server harus disiapkan terlebih dahulu. Paddock mengelola lingkungan eksekusi; agen dan model pilihan Anda mengerjakan instruksi.

Menyiapkan lingkungan dan menguji proyek

Panduan pemasangan resmi memerlukan VPS Ubuntu atau Debian, akses root, arsitektur amd64 atau arm64, port 80 dan 443 terbuka, serta nama host yang mengarah ke server. Setelah pemasangan, gunakan tautan pengaturan sekali pakai untuk membuat akun pemilik. Pasang CLI di komputer Anda, kemudian masuk ke server sendiri.

Untuk proyek Node yang sudah disiapkan, alur berikut menyalin berkas dan menjalankan pengujian:

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

Periksa keluaran untuk memastikan hasil tes. Dependensi dan skrip pengujian harus tersedia; pemasangan paket membutuhkan akses jaringan yang sesuai. Perintah terakhir menyimpan snapshot sistem berkas lalu menghentikan box. Ambil hasil penting melalui pull sebelum menghapus lingkungan sementara. Paddock skill memungkinkan agen yang didukung mengoperasikan CLI.

Dari agen pemrograman ke aplikasi yang terlihat

Docker berjalan di dalam box melalui Sysbox. Claude Code, Codex, OpenCode, Pi, Prime, dan Kimi sudah terpasang, tetapi autentikasi penyedia yang dipilih tetap perlu diatur. Alat yang terpasang tidak berarti kuota model ikut tersedia gratis.

Kirim tugas melalui paddock prompt atau kelola pekerjaan dari CLI dan dasbor web. Buka sesi dengan paddock desktop, jalankan aplikasi grafis menggunakan exec --desktop, lalu simpan gambar lewat paddock screenshot. Ini membantu Anda memeriksa antarmuka aplikasi yang benar-benar dijalankan. API HTTP dan SDK TypeScript/Python menyediakan jalur integrasi ke perangkat lunak sendiri.

Mengatur akses jaringan dan batas privasi

Pilih allow-all, deny-all, atau daftar domain/rentang IPv4 yang diizinkan. Box baru menggunakan allow-all secara bawaan. Deny-all mencegah koneksi keluar baru; koneksi yang sudah terbuka dapat selesai. Akses metadata cloud diblokir pada semua mode.

Pertimbangkan API model, repositori kode, dan registri paket yang diperlukan. Lingkungan tanpa jaringan tidak dapat otomatis mengambil dependensi atau menghubungi model jarak jauh. Hosting sendiri mengendalikan server eksekusi, tetapi data yang dikirim ke penyedia eksternal tetap mengikuti ketentuan mereka. Fitur ini tidak menjamin perlindungan mutlak dari setiap kemungkinan keluar dari sandbox.

Menyimpan berkas dan memahami snapshot

Box dapat dihentikan, dilanjutkan, dibuat fork, dan dipulihkan dari snapshot. Drive bernama di bawah /mnt tetap menyimpan data setelah box dihapus, misalnya untuk cache atau masukan yang digunakan kembali.

Menurut dokumentasi snapshot, snapshot hanya menyimpan sistem berkas. RAM, proses aktif, /var/lib/docker, dan drive yang dipasang tidak termasuk. Melanjutkan box bukan berarti proses kembali ke instruksi yang sama; rencanakan pencadangan drive secara terpisah.

Lisensi terbuka dan biaya operasional

Diverifikasi pada 29 Oktober 2026: proyek menggunakan lisensi MIT. Materi resmi yang diperiksa tidak menampilkan paket langganan Paddock terkelola. VPS, penyimpanan, dan penggunaan model dapat menimbulkan biaya masing-masing. Jumlah box bersamaan bergantung pada sumber daya server.

Paddock cocok bagi pengembang yang ingin mengendalikan lingkungan agen serta mampu menangani administrasi Linux, pembaruan, akses, dan cadangan.

Pertanyaan umum

Apakah Paddock gratis dan open source?

Perangkat lunak MIT tersedia tanpa langganan perangkat lunak pada sumber yang diperiksa. Hosting dan layanan AI eksternal tidak otomatis gratis.

Dapatkah saya menggunakannya dari Windows atau macOS?

Ya, pemasangan CLI untuk keduanya didokumentasikan. Server tetap memerlukan infrastruktur Linux yang ditentukan.

Apakah sandbox baru otomatis tanpa internet?

Tidak. Pengaturan awalnya allow-all. Anda perlu memilih deny-all atau daftar izin secara sengaja.

Sumber resmi

• Repositori proyek: kode sumber dan referensi teknis.
• Rilis dan unduhan: berkas klien dan informasi versi.