OpenMuse를 VPS에 직접 호스팅할 수 있을까? LightNode에서 실행 가능한 구성

LightNode
작성자 LightNode ·

클라우드 서버에서 실행 중인 셀프 호스팅 브라우저 에이전트 일러스트

개념 일러스트, OpenMuse 또는 LightNode 인터페이스 스크린샷이 아닙니다.

노트북을 닫은 상태에서도 AI 어시스턴트가 사이트를 탐색하고 파일을 작업하며 태스크를 계속 실행하길 원할 수 있습니다. VPS는 애플리케이션과 브라우저 워커를 계속 실행할 수 있습니다. 하지만 '셀프 호스팅'이라는 용어는 여러 다른 구성을 의미할 수 있으며, OpenMuse는 세부 사항이 중요한 이유를 잘 보여주는 사례입니다.

이 글은 CopilotKit/OpenMuse를 다룹니다. 다른 프로젝트들도 OpenMuse라는 이름을 공유하고 있으므로, 배포 지침을 혼동해서는 안 됩니다. CopilotKit의 프로젝트는 MIT 라이선스를 따르며 현재 알파 단계로 표시되어 있습니다. 이는 개인용 에이전트 애플리케이션이며, Meta Muse의 공식 오픈소스 릴리스나 LightNode에 사전 설치된 이미지가 아닙니다.

VPS에서 실제로 실행되는 것은 무엇인가요?

OpenMuse는 ChromeOS나 그래픽 데스크톱을 필요로 하지 않습니다. 그 아키텍처는 웹 또는 모바일 인터페이스, 대화 및 백그라운드 태스크용 API, 그리고 별도의 브라우저 워커를 포함합니다. 태스크 처리도 별도의 워커로 실행할 수 있습니다. 브라우저 워커는 Playwright와 Chromium을 사용하며 브라우저 세션을 유지합니다. 애플리케이션은 사용자가 브라우저를 보고 세션을 인수할 수 있게 합니다. 선택적 Linux 작업 공간은 명령 및 파일 작업을 위해 Docker 컨테이너 내에서 실행되며, 완전한 원격 데스크톱 가상 머신은 아닙니다.

LightNode Linux VPS는 애플리케이션, 태스크 워커, 브라우저 워커 및 로컬 데이터를 호스팅할 수 있습니다. 이러한 프로세스들은 백그라운드 작업이 계속되려면 서버가 계속 실행 중이어야 합니다. 프로젝트는 기본적으로 .openmuse/ 아래에 내장 데이터베이스, 파일 및 서명 키를 저장하는 반면, 브라우저 프로필은 별도의 지속성 저장소를 가집니다. Git 체크아웃만이 아닌, 두 데이터 세트와 브라우저 워커의 볼륨을 백업하세요. 업스트림 README는 이러한 경로와 프로세스 역할을 설명합니다.

VPS 상의 OpenMuse 서비스 및 Chromium, CopilotKit Intelligence 및 모델 제공자는 별도로 구성됨을 보여주는 다이어그램

VPS는 OpenMuse 애플리케이션과 브라우저 워커를 호스팅합니다. 다른 서비스들은 각자의 구성이 필요합니다.

LightNode에서 합리적인 첫 배포 구성

LightNode Linux VPS의 Ubuntu 인스턴스로 시작하세요. 업스트림 퀵 스타트는 Node.js 24 LTS, pnpm 11.19.0, 그리고 CopilotKit Intelligence 프로젝트 키를 요구합니다. 오직 본인만 접근할 수 있는 환경에서 공식 예제를 실행하세요. 실제 모델과 브라우저 워커를 추가하기 전에 웹 인터페이스, API 및 세션이 시작되는지 확인하세요. 데모는 가상 데이터를 사용하며, 고객에게 직접 노출할 프로덕션 설정이 아닙니다.

업스트림 가이드의 초기 명령어는 다음과 같습니다:

git clone https://github.com/CopilotKit/OpenMuse.git openmuse
cd openmuse
pnpm install --frozen-lockfile
cp .env.example .env
npx copilotkit@latest login
npx copilotkit@latest project select

프로젝트 키를 획득한 후, 서버 측 .env 파일에 CPK_INTELLIGENCE_API_KEY로 넣으세요. 로컬 예제를 위해 pnpm dev와 pnpm dev:web을 실행하도록 README를 따르세요. 해당 명령어들을 VPS에서 실행한다면, SSH 터널을 통해 로컬 포트를 확인하세요. 개발 서버를 공개 인터넷에 직접 노출하지 마세요. 공개 배포에는 빌드된 웹 및 API 서비스, 본인의 도메인, 그리고 HTTPS도 필요합니다.

실제 브라우저 작업을 위해서는 모델 제공자와 자체 비밀 키를 가진 Chromium 브라우저 워커를 구성해야 합니다. 업스트림 Docker Compose 파일은 브라우저 워커만 다루며, 전체 애플리케이션의 원-커맨드 프로덕션 배포가 아닙니다. 기본적으로 워커 포트는 동일 서버에 위치한 API가 호출할 수 있도록 서버의 로컬 주소에 바인딩됩니다. 워커 포트나 그 비밀 키를 사이트 방문자에게 노출하지 마세요.

장기 사용을 위해서는 HTTPS로 웹 및 API 엔드포인트를 보호하고, 관리 접근을 제한하며, 환경 설정과 브라우저 데이터를 백업하고, 재시작 후 태스크와 세션이 복구되는지 테스트하세요. 프로젝트의 보안 지침은 원격 배포 시 HTTPS와 제한된 네트워크를 권장합니다. 모든 브라우저 작업 부하에 맞는 단일 업스트림 VPS 최소 사양은 없습니다: 열린 탭, 동시 태스크, 그리고 선택적 Linux 컨테이너 모두 메모리와 CPU 사용량에 영향을 미칩니다. 실제 작업을 기준으로 서버 사양을 결정하세요.

'셀프 호스팅'이 의미하는 것과 의미하지 않는 것

모든 OpenMuse 배포는 대화 지속성과 재개를 위해 CopilotKit Intelligence를 사용하도록 CPK_INTELLIGENCE_API_KEY가 필요합니다. 실제 에이전트 작업에는 모델 제공자나 모델 게이트웨이도 필요합니다. OpenMuse 애플리케이션과 브라우저를 본인의 VPS에서 실행한다고 해서 대화 인프라와 모델 추론이 자동으로 그 VPS에서 실행되는 것은 아닙니다. 프로젝트의 Rich Threads 문서는 Intelligence를 OpenMuse의 MIT 라이선스 코드 외부에 별도로 구성되는 서비스로 설명합니다.

CopilotKit는 셀프 호스팅 Intelligence 옵션을 문서화하고 있지만, 적절한 셀프 호스팅 또는 엔터프라이즈 플랜이 필요합니다. 지원되는 경로는 Kubernetes나 AWS ECS, 그리고 데이터베이스 및 Redis와 같은 지원 시스템을 포함합니다. VPS에서 OpenMuse를 평가하는 개인이나 소규모 팀에게는 공식적으로 지원되는 프로젝트-키 설정이 더 직접적인 시작점입니다. 조달 규정이 대화와 추론이 완전히 본인 인프라에 남아야 한다면, 해당 주장을 하기 전에 전체 아키텍처, 라이선스 및 모델 배포를 확인하세요.

이 설정은 누구를 위한 것인가요?

에이전트 워크플로우를 변경하고, 모델을 선택하며, 브라우저 프로필을 통제하고 싶은 개발자는 하나의 VPS로 시작할 수 있습니다. 소규모 팀은 코드, 브라우저 데이터, 비밀 키를 분리하기 위해 별도의 프로젝트에 별도의 인스턴스를 사용할 수 있습니다. OpenMuse는 현재 배포당 하나의 소유자만 지원합니다. 공유 접근 키는 다중 사용자 계정 시스템이 아니므로, 하나의 인스턴스를 관련 없는 고객들을 위한 즉시 사용 가능한 플랫폼으로 취급해서는 안 됩니다.

단순히 Chrome과 데스크톱 애플리케이션을 원격으로 열어야 하는 요구사항이라면, Ubuntu Desktop (XFCE) VPS가 더 적합합니다. OpenMuse는 에이전트가 작업을 수행하는 동안 애플리케이션, 모델 연결, 비밀 키, 백업을 운영할 의사가 있는 사람들을 위한 것입니다. 또한 Meta가 Muse에 대해 설명한 전용-VM 보안 모델 전체를 제공하지도 않습니다.

자주 묻는 질문

OpenMuse는 클라우드 데스크톱인가요?

아니요. 에이전트가 Chromium 브라우저를 사용하고 표시할 수 있게 하며, 선택적 Linux 컨테이너 작업 공간을 제공할 수 있습니다. 완전한 그래픽 데스크톱은 프로젝트 로드맵에 남아 있습니다. RDP를 통해 Ubuntu 데스크톱에 로그인해야 하는 사람은 데스크톱 VPS 설정을 대신 사용하세요.

LightNode가 원-클릭 애플리케이션 이미지로 제공할 수 있을까요?

웹 서비스, API, 워커 및 지속성 저장소는 엔지니어링과 검증 후 배포 템플릿으로 패키징될 수 있습니다. 현재 업스트림 Compose 파일은 브라우저 워커만 다루며, 사용자는 여전히 CopilotKit Intelligence 자격 증명과 모델 구성이 필요합니다. 설치, 재시작, 백업 복구, 리소스 사용이 VPS에서 검증되기 전까지는 기존의 원-클릭 LightNode 이미지로 제시되어서는 안 됩니다.

VPS 가격에 AI 모델과 CopilotKit Intelligence가 포함되나요?

아니요. VPS 청구는 LightNode에서 실행하는 컴퓨트와 스토리지를 포함합니다. 모델 접근과 CopilotKit Intelligence는 각자의 구성과 가격 책정이 있습니다. VPS 크기를 선택할 때 브라우저 프로세스, 저장된 세션, 백업을 위한 여유 공간을 확보하세요.

본인의 에이전트 워크플로우를 테스트하려면 LightNode Linux VPS에 Ubuntu 인스턴스를 생성하고, OpenMuse README를 따라 작업한 후, 실제 계정과 장기 실행 태스크를 연결할지 결정하세요. 사람이 운영하는 데스크톱을 위해서는 클라우드 Chrome 데스크톱 가이드로 시작하세요.