원격 인스턴스

데스크톱 앱은 SSH를 통해 업무 서버, 클라우드 인스턴스, 홈랩 등 다른 컴퓨터에서 실행 중인 OpenChamber에 연결하여, 마치 로컬인 것처럼 그 UI를 화면에 가져올 수 있습니다. Settings → Remote Instances에서 설정합니다.

원격 인스턴스는 데스크톱 전용 기능입니다. 웹이나 VS Code에서는 대신 OpenCode Server의 환경 변수로 원격 서버에 연결하세요.

원격 인스턴스 추가하기

Settings → Remote Instances를 열고 하나를 추가합니다.
평소에 그 컴퓨터에 접근할 때 사용하는 SSH 명령과 별칭을 지정합니다.
OpenChamber가 거기서 실행되는 방식을 선택합니다.
- managed — OpenChamber가 원격 컴퓨터에 직접 설치하고 시작합니다
- external — 이미 실행 중인 것에 연결합니다
연결합니다.

OpenChamber가 연결 확인, 원격 설정, 서버 시작, 포트 포워딩 단계를 안내하며 각 단계의 진행 상황을 보여줍니다. ready에 도달하면 원격 UI가 로컬에 로드됩니다.

자격 증명

SSH 및 UI 비밀번호를 저장할지, 매번 입력할지 결정합니다. 연결이 끊기면 OpenChamber가 어느 단계가 실패했는지 알려주므로 고칠 수 있습니다. Remote access를 참고하세요.

연결 링크

원격 머신에서 OpenChamber가 이미 실행 중이라면 데스크톱 앱을 연결하는 가장 쉬운 방법은 페어링 링크입니다. 원격 서버의 UI에서 Settings → Remote Instances → 이 서버에 연결 → 기기 추가를 열어 링크를 만들고, 데스크톱의 Settings → Remote Instances → 다른 OpenChamber 서버 → 링크 가져오기에서 가져오세요. 전체 흐름은 기기 연결을 참고하세요.

어디서나로 만든 링크에는 직접 주소와 Private Relay 경로가 모두 들어 있습니다. 데스크톱이 서버에 도달할 수 있으면(같은 네트워크) 직접 연결하고, 밖에 있으면 종단 간 암호화 릴레이로 대체합니다. 저장된 각 서버 옆의 상태에 어느 경로가 사용 중인지 표시됩니다.

원격 머신의 터미널에서도 링크를 만들 수 있습니다:

openchamber connect-url --port 3000 --server http://your-host:3000 --qr

해당 포트에 서버가 없으면 connect-url이 먼저 서버를 시작합니다. Headless 서버에는 --api-only, 시작 시 LAN에 바인딩하려면 --lan, 브라우저 접근 보호에는 --ui-password, 저장된 연결 이름에는 --name을 사용하세요. 로컬 네트워크 밖에서도 작동하는 링크가 필요하면 --relay를 추가하세요. 기기는 도달 가능할 때 직접 연결을 우선하고, 밖에서는 Private Relay로 대체합니다. 인스턴스가 릴레이를 알아서 올립니다.

생성된 링크에는 일회용 페어링 시크릿이 들어 있습니다. 한 번 가져오면 기기는 브라우저 UI 비밀번호와 별개인 고유 client token을 갖게 되며, 발급한 서버에서 해지하기 전까지 서버 재시작 후에도 유지됩니다.

원격 인스턴스