집이나 사무실에서 굴리는 개인 홈서버나 남는 우분투 인스턴스에 개발 환경과 AI 도구를 올리다 보면 누구나 비슷한 병목을 겪게 됩니다. Portainer로 도커 컨테이너를 수십 개 띄우고, Tailscale 붙이고, 웹 기반 VS Code(code-server) 깔고, 거기에 Claude Code나 Codex 같은 코딩 에이전트를 돌리려다 보면 포트 번호가 꼬이고 권한 충돌이 나기 일쑤였습니다.

서버 관리에 들어가는 시간이 정작 코드를 짜는 시간보다 길어지던 차에 깃허브 트렌드에서 눈에 띈 프로젝트가 바로 agentverse-os/AgentVerse-OS였습니다.

우분투 단 한 대의 서버에 명령어 하나로 배포하면, 브라우저 안에 창(Window)과 작업표시줄이 있는 웹 데스크톱을 띄워주고, 그 안에서 격리된 VS Code, Claude Code 워크스페이스와 944개의 오픈소스 앱 스토어를 제공하는 오픈소스 개인용 클라우드 OS입니다.

flowchart LR subgraph Client ["내 디바이스 (Tailscale 망)"] Browser["웹 브라우저 (노트북 / 태블릿 / 폰)"] end subgraph Server ["단일 우분투 서버 (Ubuntu + ZFS)"] Edge["Caddy 역방향 프록시 (HTTPS / MagicDNS 자동 발급)"] Core["Rust cloudd 코어 엔진 (API / 백업 / 권한 제어)"] subgraph Workspace ["격리된 워크스페이스 (Incus + Coder)"] VSCode["VS Code Web"] Agents["Claude Code / Codex CLI"] DockerInner["내부 Docker 엔진"] end subgraph AppStore ["통합 앱 스토어 (944개 셀프호스팅 앱)"] Apps["Gitea · n8n · LiteLLM · Nextcloud"] end end Browser -- "암호화 통신 (포트포워딩 불필요)" --> Edge Edge --> Core Core --> Workspace Core --> AppStore

AgentVerse-OS의 핵심 아키텍처와 특징

기존의 Coolify, CasaOS, Umbrel 같은 홈서버 OS들이 단순한 도커 웹 GUI 역할에 그쳤다면, AgentVerse-OS는 철저하게 개발자와 AI 코딩 에이전트의 작업 공간에 초점을 맞췄습니다.

1. 외부 노출 제로(Zero-Exposure)와 Tailscale 네이티브 통합

이 시스템은 공용 IP나 공유기 포트포워딩을 전혀 요구하지 않습니다. 설치 과정에서 Tailscale 인증 링크(QR 코드)를 통해 사설 메시 네트워크(Tailnet)에만 노드로 등록됩니다.

외부 인터넷과의 접점을 원천 차단하고, Caddy가 Tailscale의 사설 인증서를 받아 브라우저 접속을 안전하게 TLS 암호화 처리합니다. 카페나 외부에서도 Tailscale만 켜져 있다면 태블릿이나 노트북 웹 브라우저로 서버 데스크탑에 바로 접속할 수 있습니다.

실무 프로덕션 환경에서 주의할 점: Tailscale 사설망에만 의존하는 구조이므로, 사내 폐쇄망이나 Tailscale 프로토콜이 차단된 방화벽 환경에서는 별도의 DERP 릴레이 서버를 자체 구축하지 않는 한 접속이 완전히 단절될 수 있습니다.

2. Incus 기반의 완벽한 워크스페이스 격리

일반적인 도커 기반 웹 IDE는 호스트의 도커 소켓(/var/run/docker.sock)을 공유하는 경우가 많아 보안상 취약점이 컸습니다.

AgentVerse-OS는 리눅스 컨테이너 기술인 Incus와 Coder를 하부 엔진으로 사용합니다. 프로젝트마다 완전히 격리된 컨테이너가 생성되며, 그 안에서 독립된 Docker daemon이 돌아가므로 Claude Code나 AI 에이전트가 실수로 파괴적인 쉘 명령어나 무한 루프 스크립트를 실행하더라도 호스트 서버 시스템은 안전하게 보호됩니다.

실무 프로덕션 환경에서 주의할 점: 컨테이너 내부에서 다시 도커를 띄우는 중첩 가상화(Docker in Docker) 방식을 사용하므로, 디스크 I/O 오버헤드가 발생하며 호스트 서버의 메모리가 최소 8GB 이상 확보되지 않으면 OOM Killer에 의해 작업 중인 IDE 프로세스가 강제 종료될 수 있습니다.

3. 944개 앱을 통합한 원클릭 스토어

Runtipi, Coolify, Umbrel 등 유명 셀프호스팅 플랫폼의 앱 매니페스트를 하나로 모아 944개의 오픈소스 소프트웨어를 카드 형태로 제공합니다.

n8n, Gitea, Nextcloud, LiteLLM(로컬 LLM 게이트웨이) 등을 클릭 한 번으로 배포할 수 있으며, 앱 간의 권한과 네트워크 연결(storage.s3, llm 게이트웨이 등)을 복잡한 포트 매핑 없이 추상화된 어드레스(http://storage.s3.gate)로 연결해 줍니다.

실무 프로덕션 환경에서 주의할 점: 오픈소스 카탈로그를 취합해 제공하는 특성상 업스트림 이미지의 보안 패치 주기가 제각각일 수 있으므로, 금융 데이터나 민감한 개인정보를 다루는 운영 DB로는 사용하지 말고 내부 개발/테스트용 스테이징 환경으로 한정하는 것이 안전합니다.

설치 요구사항 및 1분 설치 흐름

설치는 우분투 22.04 LTS 이상의 깨끗한 서버 환경과 8GB 이상의 RAM을 권장합니다.

공식 릴리즈 패키지를 내려받아 부트스트랩 스크립트를 실행하면 ZFS 풀 구성부터 Tailscale 등록까지 단계별로 진행됩니다.

# 릴리즈 패키지 다운로드 및 압축 해제
curl -LO https://github.com/agentverse-os/AgentVerse-OS/releases/download/v0.2.0/agentverse-os-0.2.0-x86_64.tar.gz
mkdir agentverse-os && tar xzf agentverse-os-0.2.0-x86_64.tar.gz -C agentverse-os && cd agentverse-os

# ZFS 디스크를 지정하여 설치 스크립트 실행
sudo DISKS="/dev/disk/by-id/your-disk-id" bootstrap/install.sh

설치가 완료되면 화면에 출력되는 https://<서버이름>.<테일넷>.ts.net/ 주소로 브라우저에서 접속한 뒤, 온보딩 마법사를 통해 첫 번째 AI 워크스페이스를 즉시 생성할 수 있습니다.

백업의 경우 ZFS의 카피-온-라이트(Copy-on-Write) 스냅샷 기능을 기반으로 restic 백업을 연동하여, 앱 설정이 꼬였을 때 클릭 두 번으로 특정 시점의 스냅샷으로 롤백할 수 있습니다.

실무 프로덕션 환경에서 주의할 점: ZFS 파일시스템을 사용하도록 설계되어 있어 기존 디스크의 파티션이 포맷될 수 있으므로, 기존 데이터가 있는 운영 서버에 그대로 덮어씌우지 말고 반드시 전용 파티션이나 별도 데이터 디스크를 지정해야 합니다.

정리하며

남는 미니 PC나 단일 클라우드 인스턴스에 나만의 독립적인 AI 코딩 환경을 구축하고 싶었던 엔지니어에게 AgentVerse-OS는 훌륭한 선택지입니다.

Rust 기반의 경량 코어(cloudd)와 Svelte 5로 제작된 반응성 높은 웹 UI 덕분에 시스템 리소스 점유율도 매우 낮습니다. 특히 포트포워딩과 SSL 인증서 발급 삽질 없이 Tailscale로 보안을 한 번에 끝낼 수 있다는 점이 가장 큰 매력입니다.