Paddock: 내 서버의 AI 에이전트 샌드박스

Paddock은 무엇을 하는 도구인가요?

Paddock은 AI 에이전트에게 별도의 Linux 작업용 컴퓨터를 제공하는 소프트웨어입니다. 직접 관리하는 VPS에 설치한 뒤 box라는 환경을 만듭니다. 그 안에는 프로젝트 파일, 도구와 Ubuntu XFCE 데스크톱이 있어 에이전트가 명령을 실행하고 앱을 빌드한 다음 화면을 열어 결과를 확인할 수 있습니다. 환경을 계속 보관하거나 한 번의 작업 뒤 삭제할 수 있습니다.

공개 웹사이트는 직접 설치할 프로젝트를 소개합니다. 실제 사용 전에는 서버를 구성해야 합니다. Paddock은 실행 환경을 관리하고, 선택한 에이전트와 모델이 요청한 작업을 처리합니다.

코드 실행과 실제 화면 검토

box에서는 Sysbox를 통해 Docker가 실행됩니다. Claude Code, Codex, OpenCode, Pi, Prime, Kimi가 미리 설치되어 있지만 사용할 공급자의 인증은 직접 설정해야 합니다. 도구가 포함되어 있다고 모델 사용량까지 제공되는 것은 아닙니다.

paddock prompt로 작업을 전달하거나 CLI와 웹 대시보드로 환경을 관리할 수 있습니다. paddock desktop으로 데스크톱을 열고 exec --desktop으로 GUI 앱을 시작한 뒤 paddock screenshot으로 화면을 저장합니다. 에이전트가 만든 프로그램을 실제로 열어 확인하는 데 유용합니다. HTTP API와 TypeScript 및 Python SDK로 자체 도구에 연결할 수도 있습니다.

서버 준비와 첫 프로젝트 테스트

공식 설치 안내는 Ubuntu 또는 Debian VPS, root 권한, amd64 또는 arm64, 열린 80·443 포트와 서버를 가리키는 호스트 이름을 요구합니다. 설치 후 표시되는 일회용 설정 링크로 소유자 계정을 만들고, 로컬 컴퓨터에 CLI를 설치해 로그인합니다. Windows와 macOS용 클라이언트 설치도 안내됩니다.

준비된 Node 프로젝트라면 다음 흐름으로 파일을 전송하고 테스트를 실행할 수 있습니다.

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

출력을 읽고 테스트 성공 여부를 확인하세요. 프로젝트에 테스트 스크립트와 의존성이 준비되어 있어야 하며, 패키지를 내려받아야 한다면 필요한 네트워크 접근을 허용해야 합니다. 마지막 명령은 파일 시스템 스냅샷을 만든 후 box를 중지합니다. 임시 환경을 삭제하기 전에는 필요한 결과물을 pull로 가져오세요. Paddock skill은 지원되는 코딩 에이전트가 CLI를 사용하도록 돕습니다.

상태를 보관할 때 알아야 할 경계

box 중지, 재개, fork 및 스냅샷 복원을 지원합니다. /mnt 아래에 연결한 이름 있는 드라이브는 box 삭제 후에도 데이터를 유지하므로 캐시나 재사용할 입력 파일에 활용할 수 있습니다.

스냅샷 문서에 따르면 스냅샷은 파일 시스템을 저장하며 RAM, 실행 중 프로세스, /var/lib/docker와 마운트된 드라이브는 포함하지 않습니다. 재개가 프로세스의 같은 실행 위치를 복구한다는 뜻은 아닙니다. 드라이브 데이터는 별도 백업을 계획해야 합니다.

네트워크 제어와 외부 모델의 데이터 처리

allow-all, deny-all, 도메인 또는 IPv4 범위 허용 목록을 선택할 수 있습니다. 새 box의 기본값은 allow-all입니다. deny-all은 새로운 외부 연결을 막지만 기존 연결은 마무리될 수 있습니다. 클라우드 메타데이터 접근은 모든 모드에서 차단됩니다.

모델 API, 코드 저장소와 패키지 레지스트리 등 작업에 필요한 목적지를 고려하세요. 네트워크를 완전히 막으면 원격 모델 호출과 의존성 다운로드도 수행할 수 없습니다. 직접 호스팅하더라도 외부 공급자에게 보낸 데이터에는 해당 서비스의 조건이 적용됩니다. 모든 샌드박스 탈출을 방지한다는 보장으로 해석해서는 안 됩니다.

오픈소스 라이선스와 실제 운영 비용

2026년 10월 29일 확인 기준, 프로젝트는 MIT 라이선스를 사용합니다. 검토한 공식 자료에는 Paddock 호스팅 구독 요금표가 없습니다. VPS, 저장 공간과 모델 사용은 별도로 비용이 발생할 수 있습니다. 동시 실행 가능한 box 수도 서버 자원에 따라 달라집니다.

Linux 운영, 업데이트, 접근 권한과 백업을 관리할 수 있고 에이전트 환경을 직접 통제하려는 개발자에게 적합합니다.

자주 묻는 질문

Paddock은 무료인가요?

확인한 자료에서 MIT 소프트웨어는 별도 소프트웨어 구독 없이 제공됩니다. 서버와 외부 AI 서비스까지 무료로 제공되는 것은 아닙니다.

Windows 또는 macOS에서 사용할 수 있나요?

두 시스템의 CLI 설치 방법이 있습니다. 서버는 문서에 명시된 Linux 구성이 필요합니다.

새 샌드박스는 기본적으로 인터넷이 차단되나요?

아닙니다. 기본값은 allow-all이므로 deny-all이나 허용 목록을 직접 설정해야 합니다.

공식 자료

• 공식 프로젝트 저장소: 소스와 기술 문서.
• 릴리스와 다운로드: 클라이언트 파일과 버전 정보.