컨텐츠로 건너뛰기
OpenChamber

기기 연결

일회용 QR 코드를 스캔해 다른 기기(모바일 앱, 데스크톱 앱, 다른 컴퓨터의 브라우저)를 OpenChamber 서버와 페어링하세요. 기기를 연결하는 권장 방법이며, 열어야 할 포트도 입력할 주소도 없습니다.

기기 페어링하기

  1. OpenChamber가 실행 중인 컴퓨터에서 Settings → Remote Instances → 이 서버에 연결을 열고 기기 추가를 누릅니다.
  2. 나중에 알아볼 수 있도록 기기 이름(예: My iPhone)을 지정합니다.
  3. 기기를 어디에서 사용할지 선택합니다.
    • 이 컴퓨터 전용 — 같은 컴퓨터에서 실행되는 앱용
    • 집 네트워크 전용 — Wi-Fi로 직접 연결하며, 이 네트워크 밖에서는 작동하지 않습니다
    • 어디서나 — 집에서도 밖에서도 작동합니다. 밖에서는 설정이 필요 없는 종단 간 암호화 터널인 Private Relay를 통해 연결됩니다
  4. QR 코드 만들기를 누릅니다.
  5. 다른 기기에서 코드를 스캔합니다.
    • 모바일 앱 — 연결 화면(또는 인스턴스 목록)에서 QR 코드 스캔을 탭합니다
    • 데스크톱 앱 — 대신 연결 링크를 복사해 Settings → Remote Instances → 다른 OpenChamber 서버 → 링크 가져오기에 붙여넣습니다

기기가 연결되는 즉시 대화 상자가 자동으로 닫히고, 기기가 실시간 상태와 함께 목록에 나타납니다. 이것으로 페어링 완료입니다.

페어링이 안전한 이유

  • QR 코드는 일회용입니다. 기기가 코드를 사용하는 순간 더 이상 작동하지 않으며, 사용되지 않으면 저절로 만료됩니다.
  • 기기마다 고유한 토큰을 받습니다. 코드를 스캔해도 UI 비밀번호는 절대 노출되지 않으며, 한 기기의 토큰으로 다른 기기를 사칭할 수 없습니다.
  • 제어권은 항상 사용자에게 있습니다. 페어링된 모든 기기는 이름, 플랫폼, 연결 상태와 함께 목록에 표시되며, 언제든 어떤 기기든 해지할 수 있습니다.
  • 집 밖 트래픽은 종단 간 암호화됩니다. 어디서나를 선택하면 네트워크 밖의 트래픽은 Private Relay를 통해 전달되며, 릴레이는 지나가는 내용을 읽을 수 없습니다.

페어링된 기기 관리하기

Settings → Remote Instances → 이 서버에 연결에는 이 서버에 접근할 수 있는 모든 기기가 표시됩니다. 온라인이면 초록색 점이, 로컬 네트워크와 릴레이 중 어느 경로로 연결되어 있는지도 함께 표시됩니다.

  • 해지는 기기 접근을 즉시 차단합니다. 마음이 바뀌면 새 QR 코드로 다시 페어링하세요.
  • 해지된 항목 지우기로 목록을 정리할 수 있습니다.

같은 기기가 나중에 다시 로그인해도 항목은 하나로 유지되므로 중복이 쌓이지 않습니다.

명령줄에서 연결하기

서버가 headless(UI가 열려 있지 않음)로 실행 중이면 그 컴퓨터의 터미널에서 연결 링크를 만드세요.

같은 네트워크의 기기라면:

Terminal window
openchamber connect-url --port 3000 --qr

어디서든 연결해야 하는 기기라면(대화 상자에서 어디서나를 선택하는 것과 동일):

Terminal window
openchamber connect-url --relay --qr

--relay 링크에는 대화 상자와 마찬가지로 두 경로가 모두 들어 있습니다. 기기가 서버에 도달할 수 있으면 로컬 네트워크로 직접 연결하고, 밖에 있으면 Private Relay로 대체합니다. 릴레이는 스스로 시작됩니다. 실행 중인 인스턴스는 1분 안에 링크를 인식하고, 멈춰 있는 인스턴스는 다음 실행 시 인식합니다.

직접 경로는 서버가 실제로 네트워크에서 수신 대기할 때만 작동합니다. 기본적으로 OpenChamber는 그 컴퓨터 자체에서만 수신 대기하므로, Wi-Fi에서 접근할 수 있게 하려면 --lan으로 시작하세요. 링크의 직접 경로를 다른 기기에서 사용할 수 없는 경우 명령이 경고([LAN_UNREACHABLE])를 표시합니다. 이때도 --relay 링크는 여전히 작동하며, 항상 릴레이를 통해 연결될 뿐입니다.

출력된 링크와 QR 코드는 설정 대화 상자에서 만든 것과 똑같이 작동합니다. 일회용이고, 만료되며, 해지할 수 있습니다.

관련 항목