FootprintAI/Containarium

Containarium – AI 에이전트를 위한 오픈소스 런타임

정의 – 각 AI 에이전트에게 SSH로 접근 가능한 자체 격리 Linux 컨테이너(LXC 또는 Kubernetes)를 제공하는 셀프 호스팅 플랫폼입니다. 컨테이너 내부에는 경량 MCP(메시지 제어 프로토콜) 서버(agent-box)가 실행되어 에이전트가 shell_exec, read_file, write_file 등과 같은 안전하고 제한된 명령을 실행할 수 있습니다. 호스트 측에도 MCP 서버가 실행되어 컨테이너를 생성, 나열, 삭제, 노출합니다. 모든 통신은 JWT 인증되며, "센티널" VM을 앞세워 TLS를 종료하고 SSH/HTTPS를 올바른 백엔드 박스로 라우팅할 수 있습니다.

중요성 – AI 에이전트(Claude, Cursor, Gemini, 사용자 정의 MCP 클라이언트)는 개발자 노트북이나 공유 Kubernetes 클러스터를 오염시키지 않고 코드 컴파일, 의존성 설치, 테스트 실행, 웹 앱 제공을 할 수 있는 장소가 필요합니다. Containarium은 다음을 제공합니다:

• 지속성 – 컨테이너는 에이전트 실행 간에 유지됩니다.
• 강력한 격리 – 각 테넌트는 자체 네트워크 네임스페이스를 가지며, kube-apiserver 토큰이 없고, eBPF 이그레스 정책이 있습니다.
• 실제 Linux 환경 – 완전한 systemd, GPU 패스스루, ZFS 스냅샷 등.
• 셀프 호스팅 – SaaS 전용 샌드박스와 달리 저렴한 Ubuntu VM, 온프레미스 하드웨어 또는 모든 클라우드에서 실행할 수 있습니다.

핵심 구성 요소

구성 요소	역할
agent-box(컨테이너 내 MCP 서버)	컨테이너 내에서 안전한 파일 시스템 및 셸 작업을 실행합니다.
플랫폼 MCP 서버	컨테이너를 관리합니다(생성, 시작, 중지, 포트 노출, 메트릭).
containarium CLI	플랫폼 MCP와 통신하고 SSH 구성을 생성하는 사용자 지향 도구.
Sentinel(sshpiper + Caddy)	SSH 및 HTTPS를 올바른 백엔드 컨테이너로 라우팅하고 공개 호스트 이름과 TLS 종료를 제공하는 상시 VM.
보안 계층	JWT 인증, 선택적 이미지 다이제스트 검증, KMS를 통한 봉투 암호화 비밀, eBPF 이그레스 정책.

일반적인 워크플로우

1. 설치 Ubuntu VM에 데몬을 설치합니다(curl … | sudo bash).
2. 박스 생성: containarium quickstart alice – LXC 컨테이너를 만들고, SSH 키를 생성하고, ~/.containarium/ssh_config를 작성하고, 박스를 에이전트의 MCP 구성에 연결합니다.
3. SSH로 연결: ssh alice hostname.
4. 박스 안에 에이전트 설치: containarium code install alice(예: agent-box 및 Claude Code 배치).
5. 코드 실행: containarium code run alice --prompt "add a health endpoint" – 에이전트가 컨테이너 내에서 실행되고, 로그가 스트리밍되며, 나중에 다시 연결할 수 있습니다.
6. 서비스 노출: containarium expose-port alice --container-port 8080 --domain blog.example.com – 센티널의 Caddy가 트래픽을 컨테이너로 라우팅합니다.

사용 대상 –

• 자체 인프라에서 자율 코딩 에이전트를 실행하려는 팀.
• GPU 지원, 지속적이며 엄격한 격리가 필요한 샌드박스가 필요한 회사.
• SSH로 어디서나 접근 가능하고 공개 웹 앱을 제공할 수 있는 재현 가능한 환경을 원하는 개발자.

시작 방법 – README의 빠른 시작 섹션을 따르세요: 새 Ubuntu 24.04 VM에서 설치 프로그램을 실행하고, containarium quickstart <name>을 실행하고, SSH 구성을 동기화하고, 에이전트를 설치하세요. 저장소에는 다중 풀 배포, 보안 강화, 통합(예: pi 개발 환경)에 대한 문서도 있습니다.

라이선스 및 커뮤니티 – Apache 2.0, Go 1.25 코드베이스, 공개 MCP 서버 배지, 라이브 데모 사이트.