시작 전 확인
최신 Chrome, Edge, Safari, Firefox를 HTTPS로 사용하세요. WebRTC, WebCrypto, IndexedDB가 필요하며 앱 내 브라우저는 기능이 제한될 수 있습니다. 개발할 때 일반 LAN의 HTTP 주소는 localhost 보안 예외와 같지 않습니다. 권한과 조직 정책도 확인해야 합니다.
실제 사용 순서
브라우저만으로 로컬 경로를 증명하지 못할 때 LAN 내부 노드가 기기에 묶인 단기 토큰을 발급할 수 있습니다. 확인된 연결에서 STUN을 사용할 수는 있지만 TURN 중계는 계속 거부합니다. 노드는 원격 전달, 영구 저장, 모든 제한망에서의 연결을 보장하는 기능이 아닙니다.
엄격한 LAN 검증
공인 IP가 같다는 사실만으로 같은 LAN이 증명되지는 않습니다. 노드의 확인이 없는 자동 검증은 로컬 호스트 후보를 통한 직접 연결을 요구합니다. 설정한 LAN 노드는 기기에 연결된 별도의 네트워크 소속 증명을 제공할 수 있습니다.
함께 확인할 질문
어떤 브라우저와 기기를 지원하나요?
Windows, macOS, Linux, Android, iOS, iPadOS의 최신 Chrome, Edge, Safari, Firefox를 지원합니다. 브라우저는 WebRTC, WebCrypto, IndexedDB를 지원해야 하며, 페이지는 HTTPS로 열어야 합니다.
기기가 같은 LAN에 있는지 어떻게 판단하나요?
자동 모드에서 같은 공인 IP는 기기를 후보로 만들 뿐입니다. Share는 사설·링크 로컬·mDNS 호스트 후보로 WebRTC 경로를 확인하며 STUN이나 TURN을 사용하지 않고 연결 중에도 재확인합니다. 별도의 선택 방식으로 관리자 LAN 노드가 서명된 단기 토큰으로 기기를 확인할 수 있습니다. 이렇게 확인된 기기에는 설정된 STUN과 비중계 후보를 허용하지만 TURN 중계는 항상 거부합니다.
LAN 검증 노드란 무엇인가요?
네트워크 안에서 항상 켜져 있는 컴퓨터에서 실행하는 선택형 작은 프로그램입니다. 각 브라우저가 노드의 사설 주소에 한 번 접속하면, 해당 기기에 묶인 단기 서명 토큰을 받습니다. 같은 노드의 토큰을 가진 기기들은 브라우저만으로 로컬 경로를 증명할 수 없을 때도 함께 묶입니다.
페이지를 열면, 설정은 끝.
OKYA Share는 표준 브라우저 기술만 사용하므로 설치하거나 설정할 것이 없습니다.
- 같은 네트워크에 연결: 기기를 같은 Wi-Fi나 유선 LAN에 연결하고 최신 브라우저에서 share.okya.app을 엽니다.
- 기기끼리 서로 검증: 시그널링이 후보를 소개합니다. 자동 모드는 로컬 호스트 후보 경로를 검증하고, 설정한 LAN 노드가 확인한 기기는 별도의 검증 방식을 사용합니다.
- 자유롭게 공유: 검증이 끝나면 파일, 메시지, 화면이 기기 사이를 직접 오갑니다. 탭을 닫으면 공유가 끝납니다.
연결과 개인정보
메시지와 파일은 항상 암호화(DTLS)되는 WebRTC DataChannel로 전송됩니다. TURN 중계는 설계상 비활성화되어 있어 내용이 서버를 거쳐 전달될 수 없습니다.
자동 로컬 경로 검증에 실패하면 Share는 추측하지 않고 안내합니다. 관리자 선택형 LAN 노드가 기기를 별도로 확인하면 설정된 STUN을 쓸 수 있지만 TURN 중계는 사용하지 않습니다. 네트워크 정책 때문에 연결이 계속 차단될 수도 있습니다.