RemoteViewer WebRTC 사용 설명서
계정과 코드로 이어지는 원격 접속 가이드
v0.1.35 · 2026
1. 소개 · 준비물
RemoteViewer WebRTC는 인터넷 어디서나 다른 PC의 화면을 보고 마우스·키보드로 제어하는 원격 접속 프로그램입니다. 연결은 게이트웨이 서버를 통해 WebRTC로 이루어지며, 상황에 따라 일회용 코드 또는 내 계정에 등록한 기기로 접속합니다.
| 항목 | 내용 |
| 지원 OS | Windows 10/11 · Linux (x64) |
| 연결 방식 | 게이트웨이 시그널링 + WebRTC(P2P) · 필요 시 TURN 릴레이 자동 사용 |
| 두 가지 역할 | 호스트(보여주는 PC) · 뷰어(접속하는 PC). 한 프로그램이 둘 다 됩니다. |
| 계정 | 내 기기·무인 접속에는 게이트웨이 계정이 필요합니다. 코드 연결·도움 요청은 로그인 없이 가능합니다. |
핵심 개념잠깐 도움을 주고받을 때는 코드로 연결하고, 내가 관리하는 PC에 언제든 접속하려면 그 PC를 내 계정에 무인 등록해 둡니다.
2. 설치 · 첫 실행
Windows
1
설치 파일(RemoteViewerWebRTC-Setup-0.1.35.exe)을 실행하고 안내에 따라 설치합니다. 설치가 끝나면 바탕화면·시작 메뉴에 RemoteViewer 아이콘이 생깁니다.
2
처음 실행하면 사용권 계약(EULA)에 동의해야 사용을 시작할 수 있습니다.
3
Windows 방화벽 허용 창이 뜨면 허용을 누릅니다(사설/공용 네트워크).
서명되지 않은 설치 파일현재 설치 파일에는 코드 서명이 없어 SmartScreen 경고가 뜰 수 있습니다. 추가 정보 → 실행을 눌러 진행하세요(정식 인증서는 추후 적용 예정).
관리자 권한원격에서 UAC 창까지 제어하려면 설정 탭 → 관리자 권한으로 재시작을 사용하세요.
Linux (x64)
1
배포 파일(RemoteViewer-linux-x64-0.1.35.tar.gz)을 풀고 폴더 안에서 ./install.sh를 실행합니다. 앱은 /opt/remoteviewer에 설치되고, 메뉴 항목·자동 업데이트·필요한 런타임 라이브러리가 함께 설정됩니다.
2
설치 스크립트가 로그아웃 상태에서도 접속할 수 있는 로그인-화면 호스트까지 자동으로 구성합니다(콘솔 화면 + 새 세션 두 방식). 별도 명령은 필요 없습니다.
3
RemoteViewer를 실행해 계정으로 로그인하고, 이 PC를 무인 등록(‘내 기기’ 탭 → 이 PC 무인 등록)합니다. 등록하는 순간, 앞서 설정된 로그인-화면 호스트가 몇 초 안에 스스로 켜집니다.
전체 데스크톱(XFCE) 준비‘새 세션(내 계정으로 새 데스크톱)’에서 XFCE 같은 전체 데스크톱을 쓰려면 대상 PC에 설치해 두세요: sudo apt install xfce4. 설치돼 있으면 접속 시 데스크톱 종류를 고를 수 있습니다.
접속 방식 옵트아웃헤드리스/키오스크처럼 로그인-화면 접속이 필요 없으면 RV_LOGIN_HOST=0 ./install.sh로 설치하고, 콘솔 보기만 원하면 RV_LOGIN_HOST=console ./install.sh를 사용합니다.
3. 계정 만들기 · 로그인
내 기기에 접속하거나 이 PC를 무인 호스트로 등록하려면 먼저 계정이 필요합니다. 왼쪽 계정 탭을 엽니다.
계정 탭 — 이메일·비밀번호·조직으로 가입하거나 로그인
1
이메일·비밀번호을 입력합니다. 처음이라면 조직 이름 (회원가입 시)도 함께 적고 회원가입 버튼을 누릅니다.
2
계정이 있으면 로그인 버튼으로 바로 로그인합니다.
게이트웨이 주소앱에는 기본 게이트웨이 주소가 미리 설정되어 있어 대부분 그대로 두면 됩니다. 옆의 변경 버튼은 향후 확장을 위한 것으로 지금은 비활성 상태입니다.
4. 연결 방법 한눈에
상황에 맞는 연결 방법을 고르세요. 로그인이 필요한 방법과 그렇지 않은 방법이 있습니다.
| 방법 | 탭 | 로그인 | 쓰임 |
| 코드로 연결 | 연결 | 불필요 | 상대가 알려준 코드로 즉석 접속 |
| 이 화면 공유 | 연결 | 불필요 | 내 화면을 보여주려 코드를 발급 |
| 도움 요청 / 지원 시작 | 연결 | 불필요 | 원격 지원(내가 도움받기 / 남을 돕기) |
| 내 기기 연결 | 내 기기 | 필요 | 내 계정에 등록한 무인 PC에 언제든 접속 |
5. 빠른 연결 (코드 · 화면 공유)
왼쪽 연결 탭에서 코드 기반으로 즉시 연결할 수 있습니다 — 로그인은 필요 없습니다.
연결 탭 — ①화면 공유(코드 발급) ②코드로 연결
① 내 화면을 보여주기 — 이 화면 공유
1
이 화면 공유 버튼을 누르면 연결 코드가 만들어집니다. 코드 복사로 복사해 상대에게 알려줍니다.
2
상대가 그 코드로 접속하면 내 화면이 공유됩니다. 창을 닫으면 공유가 끝납니다.
② 상대 화면에 접속 — 코드로 연결
1
코드로 연결 버튼을 누르고 상대가 알려준 코드를 입력합니다.
2
연결되면 상대 PC의 화면이 새 창으로 열립니다(다음 장 참고).
원격 지원도움 요청은 도움을 받는 쪽이 씁니다 — 지원 담당자에게 받은 코드를 입력하면 로그인 없이 내 화면이 담당자에게 공유됩니다. 담당자는 지원 시작으로 코드를 발급합니다(프리미엄).
6. 내 기기 · 무인 접속
내가 관리하는 PC를 내 계정에 무인 등록해 두면, 그 PC 앞에 사람이 없어도 언제든 접속할 수 있습니다. 먼저 계정 탭에서 로그인해야 합니다.
내 기기 탭 — ①상태 표시 ②깨우기 ③선택 기기 연결
접속받을 PC를 등록
1
접속을 받을 PC에서 내 기기 탭 → 이 PC 무인 등록…를 누릅니다. 기기 이름을 정하면 이 PC가 내 계정 목록에 무인 호스트로 등록됩니다.
2
등록된 PC는 이 앱이 실행 중인 동안 목록에 🟢 온라인으로 표시됩니다. 접속 비밀번호를 걸어 두면 이름 옆에 🔑이 붙습니다.
다른 곳에서 그 PC에 접속
1
접속을 할 기기에서 같은 계정으로 로그인한 뒤 내 기기 탭을 엽니다. 등록한 기기들이 목록에 나타납니다.
2
목록에서 PC를 고르고 선택 기기 연결를 누릅니다. 비밀번호가 걸린 기기는 비밀번호를 물어봅니다.
무인 에이전트(고급)창을 띄우지 않고 백그라운드로만 무인 대기시키려면 에이전트 모드로 실행합니다(--rtc-agent). 서버·키오스크 PC에 유용합니다.
7. 원격 깨우기 (WOL)
꺼져 있거나 절전 중인 PC는 접속 전에 먼저 깨워야 합니다. RemoteViewer는 같은 네트워크의 다른 온라인 기기를 통해 대상 PC에 매직 패킷을 보내 깨웁니다(Wake-on-LAN).
1
내 기기 탭 → WOL 설정 마법사를 실행합니다. 마법사가 대상 PC의 메인보드/BIOS·전원 설정, MAC 주소 등을 단계별로 안내합니다(필요한 항목은 관리자 권한으로 자동 설정할 수 있습니다).
2
설정이 끝나면 무인 연결할 내 기기 목록에서 잠자는 PC를 고르고 🔌 깨우기를 누릅니다. 잠시 후 그 PC가 켜지면 🟢로 바뀌고, 이어서 연결할 수 있습니다.
전제 조건같은 랜(LAN)에 깨워 줄 온라인 기기가 하나 이상 있어야 하고, 대상 PC의 BIOS와 네트워크 어댑터에서 Wake-on-LAN이 켜져 있어야 합니다. 마법사가 이 조건을 점검해 줍니다.
8. 원격 제어 창
연결되면 상대 PC의 바탕화면이 새 창으로 열립니다. 이 창 안에서 마우스와 키보드를 그대로 쓰면 원격 PC가 조작됩니다.
| 기능 | 사용법 |
| 마우스·키보드 제어 | 창 안에서 평소처럼 클릭·입력하면 원격 PC가 그대로 움직입니다. |
| 모니터 선택 | 상대가 모니터 여러 대면 창 메뉴에서 볼 모니터를 고릅니다. |
| 연결 품질 표시 | 창 위쪽에 fps·지연(ms)·대역폭이 표시되어 상태를 알 수 있습니다. |
| 화질(표준/고화질) | 상단 화질 메뉴에서 속도 우선·표준·고화질(원본 해상도)을 고릅니다. 자동 모드(기본)에서는 네트워크가 빠르면 스스로 고화질로 올리고 느려지면 낮춥니다 — 설정 → 원격 화면에서 자동/수동을 바꿀 수 있습니다. |
| 소리 듣기 | 🔊 소리로 원격 PC의 소리를 듣습니다. 재생 중인 소리가 없으면 조용합니다. |
| 카메라 보기 | 원격 PC에 카메라가 있으면 📷 카메라로 그 영상을 화면 위 작은 창으로 봅니다. |
| 채팅 | 💬 채팅으로 상대와 문자 메시지를 주고받습니다. |
| 세션 녹화 | ⏺ 녹화로 지금 보는 화면을 MP4 파일로 저장합니다(개인정보 유의). |
| 파일 전송·클립보드 | 데이터 채널로 파일을 주고받고 텍스트를 공유합니다(다음 장). |
| 다중 보기 | 여러 화면을 한 창에 동시에 띄웁니다(프리미엄). |
리눅스 접속리눅스 PC에 접속하면 먼저 접속 방식(콘솔 / 새 세션)을 고르는 창이 뜹니다 — 11장을 참고하세요.
9. 파일 전송 · 공유 폴더
호스트(화면을 보여주는 PC)에는 뷰어가 접근할 수 있는 공유 폴더가 있습니다. 호스트는 이 폴더에 파일을 넣어 두면 되고, 뷰어는 파일 창에서 이를 내려받습니다.
1
호스트에서 화면 공유를 시작하면 나타나는 창의 📂 공유 폴더 열기 버튼을 누르면 그 폴더가 탐색기로 열립니다. 공유할 파일을 여기에 복사해 두세요.
2
뷰어는 원격 제어 창의 파일 기능에서 이 공유 폴더를 탐색해 파일을 받기할 수 있습니다.
3
반대로 뷰어가 호스트로 파일을 보내면 호스트의 받은 폴더에 저장됩니다.
폴더 위치공유 폴더는 사용자 폴더 아래 RemoteViewer\shared에 만들어집니다. 📂 공유 폴더 열기를 쓰면 위치를 외우지 않아도 됩니다.
10. 웹 뷰어로 접속
PC에 앱을 설치하지 않고 웹 브라우저만으로도 접속할 수 있습니다. 회사에서 안내한 게이트웨이 웹 주소를 브라우저에서 엽니다.
웹 뷰어 — 코드로 연결하거나 🔑 로그인 후 내 기기에 접속
1
코드가 있으면 코드 칸에 입력해 바로 연결합니다(로그인 불필요).
2
무인 등록한 내 기기에 접속하려면 오른쪽 위 🔑 로그인을 눌러 계정으로 로그인합니다.
3
로그인하면 기기 목록이 나타납니다. 🟢 온라인 기기를 고르면 브라우저 안에서 바로 화면이 열립니다. 비밀번호가 걸린 기기는 비밀번호를 물어봅니다.
에이전트가 실행 중이어야 합니다대상 PC에서 RemoteViewer(또는 무인 에이전트)가 실행되어 🟢 온라인이어야 목록에 나타납니다.
11. 리눅스: 콘솔 · 세션 모드
리눅스 PC에 접속하면 다른 OS에는 없는 두 가지 접속 방식을 고를 수 있습니다. 리눅스 호스트를 ./install.sh로 설치·무인 등록하면 접속 시 아래 선택 창이 먼저 뜹니다.
| 방식 | 보이는 화면 | 쓰임 |
| 이 PC 화면 보기 (콘솔) | 지금 모니터에 켜져 있는 화면. 로그아웃 상태면 로그인 화면이 보이고, 원격에서 직접 로그인할 수 있습니다. | 한 대를 그대로 원격 조작 |
| 새 세션 (내 계정으로 새 데스크톱) | 이 PC의 OS 계정으로 로그인해 나만의 새 데스크톱이 열립니다. 남과 겹치지 않습니다. | 여러 사람이 각자 동시에 작업 |
① 콘솔 화면으로 접속
1
선택 창에서 ‘이 PC 화면 그대로 보기’를 고릅니다. 대부분 이걸 선택하면 됩니다.
2
모니터에 표시 중인 화면이 그대로 열립니다. 로그아웃 상태였다면 로그인 화면이 보이며, 계정으로 로그인하면 데스크톱으로 이어집니다(연결은 자동으로 따라갑니다).
② 새 세션(내 데스크톱)으로 접속
1
선택 창에서 ‘내 계정으로 새 데스크톱 열기’를 고르면 OS 로그인 창이 뜹니다. 이 PC의 리눅스 계정 사용자 이름·비밀번호를 입력합니다(게이트웨이 계정이 아닙니다). XFCE 등이 설치돼 있으면 데스크톱 종류도 고를 수 있습니다.
2
로그인하면 ‘세션 준비 중…’ 안내가 잠깐 표시됩니다 — 원격 PC가 데스크톱을 새로 띄우는 몇 초 동안이니 그대로 기다립니다. 첫 화면이 나오면 안내가 사라집니다.
3
나만의 데스크톱이 열립니다. 파일 관리자·터미널·설치된 앱을 그대로 쓸 수 있고, 다른 사용자의 세션과 완전히 분리됩니다.
전체 데스크톱이 없을 때XFCE 등 전체 데스크톱이 없으면 기본 경량 세션(창 관리자 + 터미널 + 파일 관리자)이 열립니다. 더 완전한 환경은 sudo apt install xfce4 후 다시 접속하세요.
무인 등록이 먼저콘솔·세션 접속은 대상 리눅스 PC가 무인 등록되어 로그인-화면 호스트가 켜져 있어야 동작합니다. ./install.sh가 이를 자동 구성하므로, 최초 무인 등록 한 번이면 됩니다.
12. 설정 · 보안 · 라이선스
설정 탭에서 선택한 기기의 보안 옵션과 앱 동작을 조정합니다. 먼저 내 기기 탭에서 기기를 선택한 뒤, 여기서 그 기기의 옵션을 바꿉니다.
기기 관리
| 항목 | 설명 |
| 보안 레벨 | 그 기기에 허용할 접속 방식을 제한합니다. |
| 허용 뷰어 | 지정한 계정만 그 기기에 접속할 수 있게 합니다(화이트리스트). |
| 접속 비밀번호 | 무인 기기에 접속할 때 요구할 비밀번호를 설정·해제합니다. |
원격 화면 · 실행 · 초기화
| 화질 자동 조절 | 자동(기본)이면 네트워크가 빠를 때 화질을 ‘고화질’까지 올리고 느려지면 낮춥니다. 수동이면 뷰어 상단에서 고른 화질을 그대로 유지합니다. |
| 부팅 시 자동 시작 | Windows 시작 시 RemoteViewer를 자동 실행합니다(무인 호스트에 유용). |
| 관리자 권한으로 재시작 | 원격에서 UAC 창까지 제어하려면 관리자 권한으로 다시 실행합니다. |
| 설정 초기화 | 저장된 로그인·기기 등록·앱 설정을 모두 지우고 로그아웃합니다. |
무인 접속 주의무인 등록한 PC는 사람이 없어도 접속을 받습니다. 반드시 접속 비밀번호나 허용 뷰어를 함께 설정하고, 필요할 때만 켜세요.
라이선스 · 정보
설치 후 최초 가입일로부터 100일간 전체 기능을 무료로 쓸 수 있습니다. 이후 일부 프리미엄 기능(다중 보기·지원 시작 등)은 라이선스 등록이 필요합니다.
1
정보 탭 → 라이선스 키 등록…에 발급받은 키를 붙여넣습니다.
2
정보 탭에는 이 밖에도 사용 설명서, 사용권 계약, 업데이트 확인, 오류 보고(선택)가 모여 있습니다.
13. 문제 해결 FAQ
| 증상 | 해결 |
| 회원가입/로그인이 ‘거부’됨 | 계정 탭의 게이트웨이 주소가 기본값 그대로인지 확인하세요. 사내망에서만 열리는 주소라면 해당 네트워크에 연결돼 있어야 합니다. |
| 내 기기 목록이 비어 있음 | 대상 PC에서 RemoteViewer(또는 에이전트)가 실행 중이고 같은 계정으로 로그인·무인 등록돼 🟢인지 확인하세요. 새로고침을 눌러 새로고침합니다. |
| ‘비밀번호가 틀렸습니다’ | 그 기기의 접속 비밀번호를 다시 확인하세요(대소문자 구분). 설정은 설정 탭 → 기기 관리에서 바꿉니다. |
| 깨우기(WOL)가 안 됨 | 같은 랜에 깨워 줄 온라인 기기가 있는지, 대상 PC의 BIOS·네트워크 어댑터에서 WOL이 켜져 있는지 확인하세요. WOL 설정 마법사가 점검을 도와줍니다. |
| 화면이 느리거나 끊김 | 연결되면 상태줄에 경로가 표시됩니다 — 직접(P2P/LAN)이면 가장 빠르고, 중계(TURN)는 인터넷 중계를 거쳐 다소 느릴 수 있습니다(직접 연결이 막힌 네트워크). 유선/안정적 회선에서 다시 시도해 보세요. |
| 연결이 갑자기 끊김 | 대부분 자동으로 다시 연결됩니다 — WiFi 전환이나 짧은 끊김은 몇 초 안에 스스로 복구합니다. 오래 지속되면 창을 닫고 다시 접속하고, 계속 실패하면 방화벽에서 앱을 허용했는지 확인하세요. |
| 연결이 안 될 때 원인 확인 | 화면이 멈추면 뜨는 안내 창의 [진단 정보 열기]를 누르면 이번 연결의 경로·손실·디코더·오류가 담긴 진단 로그(rv-session-diag.log)가 열립니다. 화면 내용이나 비밀번호는 담기지 않으므로 지원에 그대로 보내면 됩니다. |
도움말프로그램 안 정보 탭 → 사용 설명서에서 이 문서를 다시 열 수 있습니다.