VPS 호스팅

이 허브는 지원되는 VPS/호스팅 가이드 링크를 모아두고, 클라우드 배포의 전반적인 동작 방식을 설명합니다.

공급자 선택

클라우드 설정의 동작 방식

  • Gateway는 VPS에서 실행되며 상태와 워크스페이스를 관리합니다.
  • 노트북/휴대폰에서 Control UI 또는 Tailscale/SSH를 통해 접속합니다.
  • VPS를 기준 데이터 소스(source of truth)로 취급하고 상태와 워크스페이스를 백업하세요.
  • 보안 기본값: Gateway를 루프백에 유지하고 SSH 터널이나 Tailscale Serve로 접속합니다. lan/tailnet에 바인드하는 경우 gateway.auth.token 또는 gateway.auth.password를 설정하세요.

원격 접속: Gateway remote 플랫폼 허브: Platforms

VPS에서 공유 회사 에이전트 운영

하나의 신뢰 경계 내 사용자(예: 한 팀)가 업무 전용으로 에이전트를 사용하는 경우 유효한 구성입니다.

  • 전용 런타임(VPS/VM/컨테이너 + 전용 OS 사용자/계정)에서 운영하세요.
  • 해당 런타임에 개인 Apple/Google 계정이나 개인 브라우저/비밀번호 관리자 프로필로 로그인하지 마세요.
  • 사용자 간 신뢰가 없으면 Gateway/호스트/OS 사용자를 분리하세요.

보안 모델 상세: 보안

VPS에서 노드 사용

Gateway를 클라우드에 유지하면서 로컬 기기(Mac/iOS/Android/헤드리스)에 노드를 페어링할 수 있습니다. 노드는 로컬 화면/카메라/캔버스와 system.run 기능을 제공하고, Gateway는 클라우드에 머물릅니다.

문서: 노드, 노드 CLI

소형 VM 및 ARM 호스트의 시작 튜닝

저사양 VM(또는 ARM 호스트)에서 CLI 명령이 느리게 느껴지면 Node의 모듈 컴파일 캐시를 활성화하세요.

grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
  • NODE_COMPILE_CACHE는 반복 실행 시 시작 시간을 단축합니다.
  • OPENCLAW_NO_RESPAWN=1은 자체 재실행 경로의 추가 시작 오버헤드를 방지합니다.
  • 첫 실행 시 캐시가 워밍업되며, 이후 실행은 더 빠릅니다.
  • Raspberry Pi 관련 사항은 Raspberry Pi를 참고하세요.

systemd 튜닝 체크리스트 (선택)

systemd를 사용하는 VM 호스트에서 고려할 사항:

  • 안정적인 시작 경로를 위한 서비스 환경 변수 추가:
    • OPENCLAW_NO_RESPAWN=1
    • NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
  • 재시작 동작을 명시적으로 설정:
    • Restart=always
    • RestartSec=2
    • TimeoutStartSec=90
  • 랜덤 I/O 콜드 스타트 패널티를 줄이기 위해 상태/캐시 경로에 SSD 디스크를 권장합니다.

예시:

sudo systemctl edit openclaw
[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

Restart= 정책으로 자동 복구를 자동화하는 방법: systemd can automate service recovery.

arrow_back
이전
Uninstall
다음
Kubernetes
arrow_forward