10. 보안 안내
가이드 목차 · 이전: 문제 해결 · 다음: English summary
서버는 로그인과 원격 연결을 중계합니다. 서버와 서버 운영자를 신뢰할 수 있는 환경에서 사용하세요.
처음 쓸 때 기억할 다섯 가지
- 인터넷에서는
https://주소를 사용하세요. - 처음 설치한 관리자 아이디와 비밀번호를 둘 다 바꾸세요.
- Host를 승인할 때 두 화면의 확인 코드를 비교하세요.
- 복사·USB 공유는 필요한 사용자와 컴퓨터에만 허용하세요.
- 비밀번호·설정 코드·토큰·백업 파일을 공개하지 마세요.
토큰은 프로그램이 비밀번호처럼 사용하는 비밀값입니다. 문의할 때는 오류 문구만 남기고, 비밀값이 들어 있는 부분을 가리세요.
HTTPS와 HTTP
인터넷에서 접속할 때는 유효한 인증서가 있는 HTTPS 주소를 사용하세요. 주소의 이름과 인증서가 일치해야 합니다.
HTTP는 로그인과 WebSocket 통신을 암호화하지 않습니다. 비밀번호, 화면과 키 입력이 네트워크에서 노출될 수 있습니다. HTTP는 믿을 수 있는 내부망에서만 사용하고 인터넷으로 포트 전달하지 마세요.
앱의 HTTP 확인 창에 동의해도 암호화가 생기지는 않습니다. 서버 주소·포트와 운영자의 설정이 맞는지 확인하세요.
종단 간 암호화는 아닙니다
화면과 입력은 브로커·릴레이 서버를 거칩니다. HTTPS는 클라이언트와 서버, Host와 서버 사이의 각 연결을 보호합니다. 클라이언트와 Host만 내용을 해독하는 종단 간 암호화(E2E) 기능은 제공하지 않습니다.
서버 운영자가 통신 내용에 접근할 수 없는 구조라고 생각하면 안 됩니다. UDP 미디어의 암호화도 종단 간 암호화를 뜻하지 않습니다.
설치 직후 첫 설정
- 설치 후 바로 관리자 웹을 여세요.
admin/admin으로 로그인하세요.- 서버 로그의 1회용 설정 코드를 입력하세요.
- 관리자 아이디를 새 값으로 바꾸세요.
- 다른 서비스와 겹치지 않는 새 비밀번호를 정하세요.
- Proxmox 연결과 접속 주소 설정을 완료하세요.
Docker에서 설정 코드는 다음 명령으로 확인합니다.
sudo docker compose logs broker | grep initial_setup
설정 코드는 서버 로그에만 나오며, 첫 설정을 마치는 데 필요합니다. 코드나 코드가 포함된 로그를 다른 사람에게 보내지 마세요. 설정 전에 서버를 다시 시작했다면 최신 로그의 코드를 사용하세요.
현재 서버 로그인에는 2단계 인증이 없습니다. 강한 비밀번호를 사용하고 관리자 계정을 공동으로 쓰지 마세요.
Host 승인과 사용자 권한
- Host 설정과 관리자 웹에 나온 확인 코드를 비교하세요.
- 요청한 Windows와 코드가 일치할 때만 승인하세요.
- 같은 VM의 중복 요청이 있으면 요청 대상을 먼저 확인하세요.
- 사용자에게 필요한 VM과 로컬 PC만 배정하세요.
- 필요한 클립보드·장치 공유 권한만 켜세요.
클립보드와 장치 공유 권한은 사용자 × 배정된 대상별로 적용하며 기본은 꺼짐입니다. Host 업데이트 권한과 전원 조작 권한은 서로 다릅니다. VM을 배정받았다고 모든 전원 동작과 장치 공유가 허용되지는 않습니다.
같은 VM의 같은 Windows 계정을 함께 쓰면 그 계정의 파일과 프로그램을 공유합니다. ToTBVDI 계정만 나눈다고 Windows 안의 작업 공간이 분리되지는 않습니다.
업데이트 파일의 확인
| 대상 | 확인하는 것 |
|---|---|
| 공식 Windows 클라이언트·Host 업데이트 | 파일 크기, SHA-256과 프로젝트 자체 Ed25519 배포 서명 |
| 서버 업데이트 안내 | 고정된 공개키로 서명된 릴리스 정보 확인 |
| Android 업데이트 | 파일 크기·SHA-256과 기존 앱에 맞는 패키지 서명 확인 |
파일이나 서명 확인에 실패하면 설치를 멈추고 관리자에게 문의하세요. 클라이언트는 로그인에 사용한 서버의 배포 목록에서 업데이트를 받습니다. 신뢰하는 서버 주소를 사용하세요.
프로젝트 서명과 Windows 코드 서명의 차이
Ed25519 배포 서명은 ToTBVDI가 고정한 공개키로 공식 배포 파일을 확인하는 방법입니다. Windows가 설치 파일의 게시자를 표시하는 Authenticode 코드 서명과는 별개입니다. 배포 서명이 맞아도 SmartScreen 경고가 사라지거나 Windows가 게시자를 신뢰한다는 뜻은 아닙니다.
Docker의 서명된 업데이트 안내도 컨테이너 이미지 태그 자체를 서명한 것은 아닙니다. 운영자는 공식 배포 경로와 관리자 웹이 안내하는 버전을 확인해야 합니다.
비밀번호·백업·로그
Windows 클라이언트는 비밀번호 기억을 선택한 경우에만 현재 Windows 사용자의 자격 증명 관리자에 비밀번호를 저장합니다. 공용 PC에서는 이 선택을 해제하세요.
서버 데이터 볼륨과 백업에는 계정 정보, VM 배정과 서버의 비밀키가 들어 있습니다.
관리자만 접근할 수 있는 곳에 보관하세요.
.env, 백업, 로그와 화면을 공개 저장소나 공개 이슈에 올리지 마세요.
보안 문제 알리기
취약점의 재현 방법이나 비밀값을 공개 이슈에 적지 마세요. 신고 범위와 처리 기준은 보안 정책을 먼저 확인하세요.
공식 GitHub 저장소에서 비공개 신고 기능이 켜져 있으면 다음 순서로 신고할 수 있습니다.
- 저장소의 Security → Advisories를 여세요.
- Report a vulnerability를 누르세요.
- 영향을 받는 구성요소와 버전을 적으세요.
- 필요한 권한, 재현 순서와 예상 영향을 적으세요.
- 실제 주소·비밀번호·토큰을 가린 뒤 제출하세요.
버튼이 보이지 않으면 저장소의 최신 보안 정책을 확인하세요. 안내가 없으면 공개 이슈에는 취약점 내용 없이 비공개 신고 창구의 활성화만 요청하세요. 이 프로젝트는 별도의 신고 메일을 안내하지 않습니다.
버튼은 저장소에서 기능을 켠 경우에만 표시됩니다(GitHub 공식 안내). 보안 수정은 최신 공개 버전을 대상으로 하며, 정해진 응답 시간은 보장하지 않습니다.