Paddock: собственная песочница для ИИ-агентов

Для чего нужен Paddock: простое объяснение

Paddock выделяет ИИ-агенту отдельный Linux-компьютер на VPS под вашим управлением. Такое окружение называется box: в нём есть файлы проекта, инструменты и рабочий стол Ubuntu XFCE. Агент может выполнять команды, собирать приложение и открывать его для проверки. Окружение можно сохранить для дальнейшей работы или удалить после одной задачи.

Публичный сайт описывает проект для самостоятельного развёртывания. Посещение страницы не предоставляет готовый облачный рабочий стол. Paddock отвечает за среду выполнения, а выбранный агент и модель — за выполнение задания.

Что можно поручить агенту

Внутри box работает Docker через Sysbox. Предустановлены Claude Code, Codex, OpenCode, Pi, Prime и Kimi; авторизацию выбранного провайдера нужно настроить отдельно. Команда paddock prompt отправляет задание агенту. Управление доступно через CLI, веб-панель, HTTP API и SDK для TypeScript и Python.

Для проверки графической программы откройте рабочий стол через paddock desktop, запустите приложение с exec --desktop и сохраните изображение с paddock screenshot. Это позволяет увидеть результат сборки, а не только прочитать отчёт агента.

Установка и первый запуск тестов

Официальная инструкция требует VPS с Ubuntu или Debian, root-доступ, архитектуру amd64 либо arm64, открытые порты 80 и 443 и имя хоста, указывающее на сервер. После установки создайте аккаунт владельца по одноразовой ссылке. Установите локальный CLI и войдите на свой сервер.

Для подготовленного Node-проекта можно создать box, передать файлы и выполнить тесты:

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

Проверьте вывод тестов. Зависимости должны быть установлены заранее или доступны для загрузки при выбранной сетевой политике. Остановка сохраняет снимок файловой системы. Перед удалением временного окружения скачайте нужные результаты через pull. Skill Paddock позволяет поддерживаемым агентам управлять CLI.

Сохранение файлов и возврат к снимку

Box можно остановить, возобновить, разветвить через fork и восстановить из снимка. Именованные диски под /mnt сохраняют данные после удаления box — например, кэш или общие входные файлы.

Снимки сохраняют файловую систему, но не оперативную память, работающие процессы, /var/lib/docker или подключённые диски. Возобновление не продолжает процесс с той же машинной инструкции. Для данных на отдельных дисках нужна отдельная стратегия резервного копирования.

Сеть и границы обработки данных

Доступны allow-all, deny-all и список разрешённых доменов или диапазонов IPv4. По умолчанию используется allow-all. Режим deny-all блокирует новые исходящие соединения; уже установленные могут завершиться. Доступ к облачным метаданным блокируется во всех режимах.

Учтите необходимые API моделей, репозитории и реестры пакетов. Полностью отключённая сеть не позволит автоматически скачивать зависимости или обращаться к удалённой модели. Собственный VPS контролирует выполнение кода, но к данным, отправленным внешним провайдерам, применяются и их условия. Это не обещание абсолютной защиты от любого выхода из песочницы.

Лицензия и эксплуатационные расходы

Проверено 29 октября 2026 года: проект распространяется по лицензии MIT. В изученных официальных материалах нет тарифной таблицы размещённого сервиса Paddock. VPS, хранилище и использование моделей могут оплачиваться отдельно. Число одновременных box зависит от ресурсов сервера.

Решение подходит разработчикам, готовым администрировать Linux, обновления, права доступа и резервные копии.

Частые вопросы

Paddock бесплатный и открытый?

MIT-код доступен без подписки на программное обеспечение в проверенных источниках. Это не включает бесплатный сервер и вызовы внешних моделей.

Можно работать с Windows или macOS?

Да, для CLI описаны оба варианта. Сам сервер требует документированную Linux-инфраструктуру.

Интернет отключён в новой песочнице?

Нет, начальный режим — allow-all. deny-all или список разрешений необходимо выбрать явно.

Официальные ресурсы

• Репозиторий проекта: исходный код и техническая документация.
• Выпуски и загрузки: доступные клиенты и сведения о версиях.