VPS 호스팅 가이드

로컬 머신에서만 작업하다 보면 컴퓨터를 끄는 순간 프로세스가 중단되어 불편할 때가 많죠. 외부에서 작업 결과물에 접속하고 싶어도 방화벽이나 네트워크 설정 때문에 가로막히는 경험, 개발자라면 누구나 한 번쯤 겪어보셨을 거예요. 항상 켜져 있으면서도 어디서나 안전하게 접근할 수 있는 서버 환경이 필요한 이유입니다.

필요한 것

• VPS 프로바이더 계정 (Railway, Fly.io, AWS 등)
• 터미널 접속을 위한 SSH 클라이언트
• 데이터 보존을 위한 백업 전략

빠른 시작

5분 안에 클라우드 환경을 구축하는 핵심 단계입니다.

1. 프로바이더 선택하기: 브라우저에서 클릭 한 번으로 설정을 끝내고 싶다면 Railway나 Northflank를 추천해요. 비용을 아끼고 싶다면 Oracle Cloud의 Always Free 티어나 AWS EC2 프리티어를 고려해보세요.
2. Gateway 실행: 선택한 VPS에서 Gateway를 실행하세요. 이 서버가 여러분의 상태(state)와 워크스페이스를 관리하는 소스 오브 트루스(Source of Truth)가 됩니다.
3. 보안 연결 설정: 보안을 위해 Gateway를 loopback에 두고 SSH 터널이나 Tailscale Serve를 통해 접속하는 것이 가장 안전합니다.
4. 로컬 노드 연결: 화면 공유나 카메라, system.run 기능이 필요하다면 로컬 장치(Mac, iOS, Android 등)에서 노드를 실행해 클라우드에 있는 Gateway와 페어링하세요.

문제 해결

• 접속 권한 오류: Gateway를 lan이나 tailnet에 바인딩했다면 반드시 gateway.auth.token 또는 gateway.auth.password를 설정해야 접근할 수 있습니다.
• 리소스 할당 실패: Oracle Cloud 같은 무료 티어는 지역에 따라 용량(capacity)이 부족하여 인스턴스 생성이 실패할 수 있습니다. 이럴 때는 다른 리전을 선택하거나 나중에 다시 시도해야 합니다.

설정 과정에서 막히는 부분이 있다면 AI Setup Assistant에게 바로 물어보세요.

다음 단계

• Gateway remote: 원격 접속 상세 설정
• Platforms: 지원 플랫폼 전체 보기
• Nodes: 노드 개념 이해하기
• Nodes CLI: CLI로 노드 관리하기