Paddock: AI ajanları için kendi sunucunuzda sandbox

Paddock ne işe yarar? Basit bir açıklama

Paddock, AI ajanına sizin yönettiğiniz bir VPS üzerinde ayrı bir Linux bilgisayar verir. Box adı verilen bu ortamda dosyalar, araçlar ve Ubuntu XFCE masaüstü bulunur. Ajan komut çalıştırabilir, uygulama geliştirebilir ve sonucu görmek için uygulamayı açabilir. Ortamı sonraki çalışmalar için saklayabilir veya tek görev sonunda kaldırabilirsiniz.

Halka açık site, kendi sunucunuza kuracağınız projeyi tanıtır. Sayfayı açmak hazır bir bulut masaüstü oluşturmaz. Paddock çalışma ortamını sağlar; görevi seçtiğiniz ajan ve model gerçekleştirir.

Linux sunucusunu ve istemciyi hazırlama

Resmî kurulum belgesi, root erişimi olan Ubuntu veya Debian VPS, amd64 ya da arm64 mimarisi, açık 80/443 portları ve sunucuya yönelen bir alan adı ister. Kurulumun verdiği tek kullanımlık bağlantıyla sahip hesabını oluşturun. Ardından bilgisayarınıza CLI kurup sunucunuzda oturum açın. Windows, macOS ve Linux istemci yolları belgelenmiştir.

Hazır bir Node projesini kopyalayıp test etmek için belgelerdeki akışı uygulayabilirsiniz:

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

Test çıktısını inceleyin. Bağımlılıklar hazır olmalı veya uygun ağ izinleriyle yüklenmelidir. Son komut dosya sistemi snapshot’ı aldıktan sonra box’ı durdurur. Geçici ortamı silmeden önce gerekli sonuçları pull ile indirin. Paddock skill kurulumu, desteklenen kodlama ajanlarına CLI kullanımını öğretir.

Ajan çalışmasını masaüstünde ve API ile yönetme

Docker, Sysbox üzerinden box içinde çalışır. Claude Code, Codex, OpenCode, Pi, Prime ve Kimi önceden kuruludur; seçilen sağlayıcının kimlik doğrulamasını ayrıca ayarlarsınız. paddock prompt ile görev gönderebilir, web panelinden ortamı izleyebilirsiniz.

Grafik uygulama için paddock desktop ile oturumu açın, exec --desktop ile programı başlatın ve paddock screenshot ile görüntüyü kaydedin. Böylece üretilen kodun gerçek arayüzünü kontrol edebilirsiniz. HTTP API, TypeScript ve Python SDK’ları kendi otomasyonunuza box yönetimi eklemek için kullanılabilir.

Ağ erişimini açıkça sınırlandırma

allow-all, deny-all veya alan adı/IPv4 izin listesi seçilebilir. Yeni box’ların varsayılanı allow-all’dur. deny-all yeni dış bağlantıları engeller; mevcut bağlantılar tamamlanabilir. Bulut metadata erişimi her modda engellenir.

Model API’si, paket kayıtları ve kaynak depoları için gerekli erişimleri planlayın. Ağ tamamen kapalıysa uzak model çağrısı veya paket indirme kendiliğinden çalışmaz. Kendi VPS’inizi kullanmanız, dış sağlayıcılara gönderilen verilerin onların koşullarından bağımsız olduğu anlamına gelmez. Mutlak sandbox güvenliği garantisi çıkarılmamalıdır.

Snapshot ve kalıcı disklerin farkı

Box’ları durdurabilir, sürdürebilir, fork oluşturabilir veya önceki snapshot’a döndürebilirsiniz. /mnt altında bağlanan adlandırılmış diskler box silindikten sonra veriyi korur.

Snapshot belgelerine göre RAM, çalışan süreçler, /var/lib/docker ve bağlı diskler snapshot kapsamına girmez. Yalnızca dosya sistemi durumu saklanır; disk yedeklemesini ayrıca planlayın.

Açık kaynak lisansı ve kullanım maliyeti

29 Ekim 2026 kontrolünde proje MIT lisanslıdır. İncelenen resmî kaynaklarda barındırılan Paddock abonelik tablosu bulunmamaktadır. VPS, depolama ve kullanılan model servisleri ayrı maliyet yaratabilir. Aynı anda çalışacak box sayısı sunucu kaynaklarına bağlıdır.

Linux yönetimini, güncellemeleri ve yedeklemeyi üstlenebilen geliştiriciler için uygundur.

Sık sorulan sorular

Paddock ücretsiz mi?

MIT yazılımı incelenen kaynaklarda yazılım aboneliği olmadan sunulur. Sunucu ve haricî AI hizmetlerinin maliyeti buna dahil değildir.

Windows veya macOS üzerinden kullanabilir miyim?

Evet, bu sistemler için CLI kurulumu belgelenmiştir. Sunucu yine belirtilen Linux altyapısını gerektirir.

Yeni sandbox internete kapalı mı başlar?

Hayır. allow-all varsayılandır; deny-all veya izin listesi sizin yapılandırmanız gerekir.

Resmî kaynaklar

• Proje deposu: kaynak kodu ve teknik belgeler.
• Sürümler ve indirmeler: istemci dosyaları ve sürüm bilgileri.