Quick Reference

Neko는 Docker 안에서 브라우저나 Linux 데스크톱을 실행하고, 화면·소리를 전송하면서 원격 입력을 전달하는 직접 호스팅 가상 브라우저입니다.

실행 위치: Docker를 실행하는 로컬 PC, VM 또는 서버
공유 단위: Docker 호스트에서 실행 중인 하나의 브라우저·데스크톱 세션
접속 방식: 별도 앱 없이 웹 브라우저로 접속
협업 방식: 여러 참가자가 같은 화면을 보고 제어권을 주고받음
주요 용도: 공동 브라우징 / 원격 지원·수업 / 함께 시청 / 지속형 브라우저
선택: 발표자의 개인 화면이 아닌 별도 호스트의 세션을 함께 사용해야 할 때

일반 화면 공유는 주로 발표자의 로컬 화면을 전송하지만, Neko는 별도 호스트 안의 브라우저나 앱을 참가자 모두가 같은 상태로 사용합니다. 쿠키와 세션 데이터는 참가자의 브라우저로 옮기지 않고 Neko 쪽 프로필에 두므로, 공동 제어와 여러 기기 사이의 세션 유지가 필요한 경우에 특히 잘 맞습니다.

운영 전 확인

기본 Docker 구성은 웹 접속용 포트와 WebRTC용 UDP 포트 범위를 함께 엽니다. NEKO_WEBRTC_EPR의 범위는 Docker에 공개한 UDP 포트와 일치해야 하며, 외부에서 접속할 때는 NAT와 방화벽 설정도 맞아야 합니다. 웹 화면은 열리는데 영상이나 입력이 연결되지 않는다면 이 경로부터 확인합니다.

공식 설치 예제의 사용자·관리자 비밀번호는 그대로 운영에 사용하지 않습니다. 외부에 공개할 때는 HTTPS, 강한 인증 정보와 제어 권한을 설정합니다. 참가자는 공유 화면의 로그인 상태와 민감한 정보를 볼 수 있으므로 룸 구성원도 제한해야 합니다.

지속형 브라우저를 쓴다면 쿠키·다운로드·프로필이 컨테이너 재생성 뒤에도 필요한지 먼저 정하고, 필요할 때만 저장소를 마운트합니다. 여러 룸은 관련 프로젝트인 Neko Rooms로 만들고 관리할 수 있지만, 룸 생성 자체가 인증 정보와 저장 데이터를 자동으로 안전하게 격리한다는 뜻은 아닙니다. 참가자가 실제로 조작해야 할 때만 제어권을 엽니다.