서버 설치

서버는 도메인 이름 하나(예: remote.example.com)와 그 이름을 가리키는 DNS A/AAAA 레코드가 있어야 합니다. 1 vCPU, 1 GB 메모리의 작은 서버로도 시작할 수 있습니다.

패키지로 설치 (Linux)

서버용 패키지를 설치합니다. 설정은 /etc/tastedev-remote/, 데이터는 /var/lib/tastedev-remote/에 둡니다.
/etc/tastedev-remote/tasteremote-signal.env를 채웁니다. 꼭 필요한 값은 다음과 같습니다.

값	뜻
`TURN_SECRET`	coturn과 함께 쓰는 비밀 값(16자 이상). `openssl rand -hex 32`로 만듭니다.
`RD_SETUP_TOKEN`	첫 관리자 계정을 만들 때 넣는 설정 토큰(32자 이상). 첫 계정을 만든 뒤에는 지워도 됩니다.
`RD_WEB_ORIGIN`	사용자가 접속하는 주소. 예: `https://remote.example.com`
`TURN_URLS`	예: `turn:remote.example.com:3478?transport=udp,turn:remote.example.com:3478?transport=tcp`

coturn을 설치하고 /etc/turnserver.conf의 static-auth-secret을 TURN_SECRET과 같게 둡니다.

sudo apt install coturn

리버스 프록시를 둡니다. Caddy를 쓰거나, 관리 화면의 서버 설치 마법사로 nginx·Apache 설정을 만듭니다(아래 참고).
서비스를 켭니다.

sudo systemctl enable --now tasteremote-signal tasteremote-web tasteremote-update.timer

사용자가 받을 호스트 설치 파일을 내려받아 둡니다. 파일이 없으면 /downloads/가 503을 돌려주고 다운로드 페이지에 "이 서버에는 아직 설치 파일이 없습니다"가 보입니다. 인터넷이 막힌 서버는 설치 파일을 downloads/ 폴더에 직접 넣으세요.

sudo tasteremote-fetch-hosts

Windows 서버는 설정이 %ProgramData%\tasteremote\config\, 데이터가 %ProgramData%\tasteremote\data에 있고, 서비스로 돕니다.

서버 설치 마법사 (nginx · Apache)

첫 관리자 계정으로 로그인한 뒤 관리 › 서버 설치를 엽니다. 다섯 단계로 설정 파일과 명령을 만들어 주고, 관리자가 SSH에서 붙여 넣어 실행합니다. 페이지가 서버에서 직접 실행하는 것은 없습니다.

웹 서버 고르기: nginx 또는 httpd, OS(deb 또는 rpm)
주소 · 포트: 도메인(IP 주소는 받지 않습니다)
프록시 설정: 설정 파일과 방화벽 명령
HTTPS 인증서: certbot으로 인증서를 받고 자동 갱신합니다.
확인: RD_WEB_ORIGIN, RD_COOKIE_SECURE=1, TRUST_PROXY=1 같은 값과 확인 명령. /healthz가 응답하는지, /ws 연결이 101로 바뀌는지 봅니다(400이나 426이면 프록시가 WebSocket 헤더를 빠뜨린 것입니다).

Docker Compose로 설치

Docker Engine 25 이상과 Compose v2.24 이상이 필요합니다.

저장소의 deploy/ 폴더에서 .env.example을 .env로 복사하고 권한을 줄입니다.

cp .env.example .env && chmod 600 .env

.env에 DOMAIN, ACME_EMAIL, TURN_SECRET, RD_SETUP_TOKEN, TURN_EXTERNAL_IP 등을 채웁니다.
띄웁니다.

docker compose up -d --build

주요 설정 값

값	기본	뜻
`PORT` / `HOST`	8080 / 0.0.0.0	signal이 듣는 포트와 주소. 패키지는 127.0.0.1로 둡니다.
`TRUST_PROXY`	0	앞에 둔 프록시 수. 프록시 하나면 1. 틀리면 모든 사용자가 같은 IP로 보여 함께 제한에 걸립니다.
`RD_DB_PATH`	`./data/signal.db`	데이터베이스(SQLite) 파일
`RD_SERVER_KEY_FILE`	`./data/server.key`	서버 서명 키. 잃으면 모든 호스트를 다시 등록해야 합니다.
`RD_ALLOW_SIGNUP`	꺼짐	첫 계정 뒤 가입 허용. 관리 화면에서 정하면 그 값이 우선합니다.
`RD_COOKIE_SECURE`	운영에서 켜짐	세션 쿠키의 Secure
`TURN_TTL_SEC`	600	TURN 자격 증명 유효 시간(초)
`RD_LICENSE_CLAIM_URL`	TASTEDEV 주소	라이선스 설치 코드 교환 주소. 인터넷이 막힌 서버는 `off`
`RD_HOST_VERSION_CHECK`	`on`	`off`면 서버와 앞 두 자리 판이 다른 호스트에도 접속을 허용합니다.
`LOG_LEVEL`	info	`debug`면 연결 시간을 더 자세히 남깁니다.

메일(SMTP)과 소셜 로그인은 설정 파일이 아니라 관리 화면에서 정합니다.

다음 단계는 처음 설정입니다.

TASTEREMOTE 설명서

서버 설치

패키지로 설치 (Linux)

서버용 패키지를 설치합니다. 설정은 /etc/tastedev-remote/, 데이터는 /var/lib/tastedev-remote/에 둡니다.
/etc/tastedev-remote/tasteremote-signal.env를 채웁니다. 꼭 필요한 값은 다음과 같습니다.

값	뜻
`TURN_SECRET`	coturn과 함께 쓰는 비밀 값(16자 이상). `openssl rand -hex 32`로 만듭니다.
`RD_SETUP_TOKEN`	첫 관리자 계정을 만들 때 넣는 설정 토큰(32자 이상). 첫 계정을 만든 뒤에는 지워도 됩니다.
`RD_WEB_ORIGIN`	사용자가 접속하는 주소. 예: `https://remote.example.com`
`TURN_URLS`	예: `turn:remote.example.com:3478?transport=udp,turn:remote.example.com:3478?transport=tcp`

coturn을 설치하고 /etc/turnserver.conf의 static-auth-secret을 TURN_SECRET과 같게 둡니다.

sudo apt install coturn

리버스 프록시를 둡니다. Caddy를 쓰거나, 관리 화면의 서버 설치 마법사로 nginx·Apache 설정을 만듭니다(아래 참고).
서비스를 켭니다.

sudo systemctl enable --now tasteremote-signal tasteremote-web tasteremote-update.timer

사용자가 받을 호스트 설치 파일을 내려받아 둡니다. 파일이 없으면 /downloads/가 503을 돌려주고 다운로드 페이지에 "이 서버에는 아직 설치 파일이 없습니다"가 보입니다. 인터넷이 막힌 서버는 설치 파일을 downloads/ 폴더에 직접 넣으세요.

sudo tasteremote-fetch-hosts

Windows 서버는 설정이 %ProgramData%\tasteremote\config\, 데이터가 %ProgramData%\tasteremote\data에 있고, 서비스로 돕니다.

서버 설치 마법사 (nginx · Apache)

웹 서버 고르기: nginx 또는 httpd, OS(deb 또는 rpm)
주소 · 포트: 도메인(IP 주소는 받지 않습니다)
프록시 설정: 설정 파일과 방화벽 명령
HTTPS 인증서: certbot으로 인증서를 받고 자동 갱신합니다.
확인: RD_WEB_ORIGIN, RD_COOKIE_SECURE=1, TRUST_PROXY=1 같은 값과 확인 명령. /healthz가 응답하는지, /ws 연결이 101로 바뀌는지 봅니다(400이나 426이면 프록시가 WebSocket 헤더를 빠뜨린 것입니다).

Docker Compose로 설치

Docker Engine 25 이상과 Compose v2.24 이상이 필요합니다.

저장소의 deploy/ 폴더에서 .env.example을 .env로 복사하고 권한을 줄입니다.

cp .env.example .env && chmod 600 .env

.env에 DOMAIN, ACME_EMAIL, TURN_SECRET, RD_SETUP_TOKEN, TURN_EXTERNAL_IP 등을 채웁니다.
띄웁니다.

docker compose up -d --build

주요 설정 값

값	기본	뜻
`PORT` / `HOST`	8080 / 0.0.0.0	signal이 듣는 포트와 주소. 패키지는 127.0.0.1로 둡니다.
`TRUST_PROXY`	0	앞에 둔 프록시 수. 프록시 하나면 1. 틀리면 모든 사용자가 같은 IP로 보여 함께 제한에 걸립니다.
`RD_DB_PATH`	`./data/signal.db`	데이터베이스(SQLite) 파일
`RD_SERVER_KEY_FILE`	`./data/server.key`	서버 서명 키. 잃으면 모든 호스트를 다시 등록해야 합니다.
`RD_ALLOW_SIGNUP`	꺼짐	첫 계정 뒤 가입 허용. 관리 화면에서 정하면 그 값이 우선합니다.
`RD_COOKIE_SECURE`	운영에서 켜짐	세션 쿠키의 Secure
`TURN_TTL_SEC`	600	TURN 자격 증명 유효 시간(초)
`RD_LICENSE_CLAIM_URL`	TASTEDEV 주소	라이선스 설치 코드 교환 주소. 인터넷이 막힌 서버는 `off`
`RD_HOST_VERSION_CHECK`	`on`	`off`면 서버와 앞 두 자리 판이 다른 호스트에도 접속을 허용합니다.
`LOG_LEVEL`	info	`debug`면 연결 시간을 더 자세히 남깁니다.

메일(SMTP)과 소셜 로그인은 설정 파일이 아니라 관리 화면에서 정합니다.

다음 단계는 처음 설정입니다.