Bohdan Triapitsyn
7ea974d89b
- new Connect a Device page: one-time QR pairing, transport choices, device management - new Private Relay page: E2EE guarantees, demand-driven lifecycle, relay vs tunnel - rewrite mobile page around the native iOS/Android apps (TestFlight + APK) - update remote-instances, security, tunnels, and remote-access troubleshooting to point at the new pairing flow - translate everything across all 8 locales and update the sidebar
57 lines
3.8 KiB
Plaintext
57 lines
3.8 KiB
Plaintext
---
|
|
title: 기기 연결
|
|
description: 일회용 QR 코드로 휴대폰, 데스크톱, 다른 브라우저를 OpenChamber 서버와 페어링하세요.
|
|
---
|
|
|
|
# 기기 연결
|
|
|
|
일회용 QR 코드를 스캔해 다른 기기(모바일 앱, 데스크톱 앱, 다른 컴퓨터의 브라우저)를 OpenChamber 서버와 페어링하세요. 기기를 연결하는 권장 방법이며, 열어야 할 포트도 입력할 주소도 없습니다.
|
|
|
|
## 기기 페어링하기
|
|
|
|
1. OpenChamber가 실행 중인 컴퓨터에서 **Settings → Remote Instances → 이 서버에 연결**을 열고 **기기 추가**를 누릅니다.
|
|
2. 나중에 알아볼 수 있도록 기기 이름(예: *My iPhone*)을 지정합니다.
|
|
3. 기기를 어디에서 사용할지 선택합니다.
|
|
- **이 컴퓨터 전용** — 같은 컴퓨터에서 실행되는 앱용
|
|
- **집 네트워크 전용** — Wi-Fi로 직접 연결하며, 이 네트워크 밖에서는 작동하지 않습니다
|
|
- **어디서나** — 집에서도 밖에서도 작동합니다. 밖에서는 설정이 필요 없는 종단 간 암호화 터널인 [Private Relay](/ko/private-relay/)를 통해 연결됩니다
|
|
4. **QR 코드 만들기**를 누릅니다.
|
|
5. 다른 기기에서 코드를 스캔합니다.
|
|
- **모바일 앱** — 연결 화면(또는 인스턴스 목록)에서 **QR 코드 스캔**을 탭합니다
|
|
- **데스크톱 앱** — 대신 연결 링크를 복사해 **Settings → Remote Instances → 다른 OpenChamber 서버 → 링크 가져오기**에 붙여넣습니다
|
|
|
|
기기가 연결되는 즉시 대화 상자가 자동으로 닫히고, 기기가 실시간 상태와 함께 목록에 나타납니다. 이것으로 페어링 완료입니다.
|
|
|
|
## 페어링이 안전한 이유
|
|
|
|
- **QR 코드는 일회용입니다.** 기기가 코드를 사용하는 순간 더 이상 작동하지 않으며, 사용되지 않으면 저절로 만료됩니다.
|
|
- **기기마다 고유한 토큰을 받습니다.** 코드를 스캔해도 UI 비밀번호는 절대 노출되지 않으며, 한 기기의 토큰으로 다른 기기를 사칭할 수 없습니다.
|
|
- **제어권은 항상 사용자에게 있습니다.** 페어링된 모든 기기는 이름, 플랫폼, 연결 상태와 함께 목록에 표시되며, 언제든 어떤 기기든 해지할 수 있습니다.
|
|
- **집 밖 트래픽은 종단 간 암호화됩니다.** **어디서나**를 선택하면 네트워크 밖의 트래픽은 [Private Relay](/ko/private-relay/)를 통해 전달되며, 릴레이는 지나가는 내용을 읽을 수 없습니다.
|
|
|
|
## 페어링된 기기 관리하기
|
|
|
|
**Settings → Remote Instances → 이 서버에 연결**에는 이 서버에 접근할 수 있는 모든 기기가 표시됩니다. 온라인이면 초록색 점이, 로컬 네트워크와 릴레이 중 어느 경로로 연결되어 있는지도 함께 표시됩니다.
|
|
|
|
- **해지**는 기기 접근을 즉시 차단합니다. 마음이 바뀌면 새 QR 코드로 다시 페어링하세요.
|
|
- **해지된 항목 지우기**로 목록을 정리할 수 있습니다.
|
|
|
|
같은 기기가 나중에 다시 로그인해도 항목은 하나로 유지되므로 중복이 쌓이지 않습니다.
|
|
|
|
## 명령줄에서 연결하기
|
|
|
|
서버가 headless(UI가 열려 있지 않음)로 실행 중이면 그 컴퓨터의 터미널에서 연결 링크를 만드세요:
|
|
|
|
```bash
|
|
openchamber connect-url --port 3000 --qr
|
|
```
|
|
|
|
출력된 링크와 QR 코드는 설정 대화 상자에서 만든 것과 똑같이 작동합니다.
|
|
|
|
## 관련 항목
|
|
|
|
- [Private Relay](/ko/private-relay/) — "어디서나" 연결의 작동 방식과 릴레이가 볼 수 있는 것과 없는 것
|
|
- [모바일 앱](/ko/mobile/) — iOS 또는 Android 앱 설치
|
|
- [원격 인스턴스](/ko/remote-instances/) — SSH나 링크로 데스크톱 앱을 서버에 연결
|
|
- [원격 접속](/ko/troubleshooting/remote-access/) — 기기가 연결되지 않을 때
|