서버 구성

운영자 편은 TASTEREMOTE 서버를 직접 설치하고 운영하는 관리자를 위한 장입니다. 서버를 운영하지 않고 TASTEDEV가 운영하는 서비스를 쓰려면 원격 데스크톱 서비스를 보세요. 서버 설치·구축을 맡기려면 구축 문의를 이용하세요.

구성 요소

구성 요소	하는 일	기본 주소
시그널 서버 (signal)	계정, 디바이스, 접속 중개(REST `/api`, WebSocket `/ws`, `/healthz`). 패키지 설치에서는 호스트 설치 파일 `/downloads/`와 호스트 업데이트 `/updates/`도 내려 줍니다.	127.0.0.1:8080
웹 (web)	브라우저 화면(뷰어, 내 디바이스, 관리)	127.0.0.1:3000
리버스 프록시	HTTPS(80/443)를 받아 signal과 web으로 나눕니다. Caddy, nginx, Apache httpd 가운데 하나를 씁니다.	80, 443
TURN (coturn)	호스트와 뷰어가 직접 이어지지 않을 때 영상을 중계합니다.	3478
호스트	접속을 받는 컴퓨터의 TASTEREMOTE 프로그램	서버의 `wss://<주소>/ws`로 연결

프록시는 /api/*, /ws, /healthz, /downloads/*, /updates/*를 signal로, 나머지를 web으로 보냅니다.

8080과 3000은 바깥에 열지 마세요. TURN은 서버 자신의 공인 IP로도 중계할 수 있으므로, 공인 주소에서는 프록시, coturn, sshd만 듣게 하세요. sudo ss -lntup로 확인할 수 있습니다.

Docker Compose: 저장소의 deploy/ 폴더로 컨테이너 넷(Caddy, signal, web, coturn)을 띄웁니다.
패키지(deb·rpm·MSI): 서버용 패키지를 설치하고 systemd(Windows는 서비스)로 돌립니다. 관리 화면의 서버 설치와 업데이트는 이 방법을 위한 것입니다.

자세한 순서는 서버 설치를 보세요.

구성 요소

구성 요소	하는 일	기본 주소
시그널 서버 (signal)	계정, 디바이스, 접속 중개(REST `/api`, WebSocket `/ws`, `/healthz`). 패키지 설치에서는 호스트 설치 파일 `/downloads/`와 호스트 업데이트 `/updates/`도 내려 줍니다.	127.0.0.1:8080
웹 (web)	브라우저 화면(뷰어, 내 디바이스, 관리)	127.0.0.1:3000
리버스 프록시	HTTPS(80/443)를 받아 signal과 web으로 나눕니다. Caddy, nginx, Apache httpd 가운데 하나를 씁니다.	80, 443
TURN (coturn)	호스트와 뷰어가 직접 이어지지 않을 때 영상을 중계합니다.	3478
호스트	접속을 받는 컴퓨터의 TASTEREMOTE 프로그램	서버의 `wss://<주소>/ws`로 연결

프록시는 /api/*, /ws, /healthz, /downloads/*, /updates/*를 signal로, 나머지를 web으로 보냅니다.

무엇이 무엇과 이야기하나요

브라우저 → 프록시 → web, 같은 주소의 /api → signal

브라우저와 호스트 → wss://<주소>/ws → signal(접속 중개)

브라우저 ↔ 호스트: WebRTC로 직접 연결하고, 안 되면 coturn을 거칩니다.

호스트 → 서버의 /downloads/ 또는 /updates/(자기 업데이트)

signal → SMTP 서버(메일, 선택), 소셜 로그인 제공자(선택), 라이선스 설치 코드 교환 주소(선택)

방화벽

설치 방법 두 가지

Docker Compose: 저장소의 deploy/ 폴더로 컨테이너 넷(Caddy, signal, web, coturn)을 띄웁니다.

패키지(deb·rpm·MSI): 서버용 패키지를 설치하고 systemd(Windows는 서비스)로 돌립니다. 관리 화면의 서버 설치와 업데이트는 이 방법을 위한 것입니다.

자세한 순서는 서버 설치를 보세요.