모아둔 영화가
감상이 되는 곳.

1. PC에서 TMDB 키 발급

   TMDB 계정 설정 → API에서 이용 목적을 사실대로 작성하고 조건에 동의해 신청하세요. 발급 화면의 긴 API Read Access Token을 사용합니다. 짧은 API Key (v3 auth)나 로그인 비밀번호가 아닙니다.

2. DSM의 보호된 폴더에 저장

   패키지 센터에서 Text Editor를 설치합니다. File Station에서 Roux 프로젝트 밖에 /volume1/docker/roux-secrets를 만들고, Text Editor에서 Token 값 한 줄만 tmdb_read_token 파일로 저장하세요. .txt, 따옴표, Bearer 는 붙이지 않습니다.

   관리자 외 일반 사용자·게스트에게 이 폴더를 공유하지 않습니다. 서버 실행 사용자 UID 65532가 읽을 수 있어야 하며 Everyone 전체 권한을 주거나 서버를 root로 실행하지 마세요. 키는 자동 암호화되지 않습니다. 저장 후 편집기를 닫고 클립보드를 비우세요. 키를 앱·홈페이지·YAML·문의·스크린샷에 넣지 않습니다.

3. 새로 설치한다면 설정 하나를 선택

   키가 준비됐다면 ZIP의 docker-compose.tmdb.yml을 선택하세요. 나중에 연결하려면 docker-compose.yml을 선택합니다. 두 파일은 각각 전체 설정이므로 함께 적용하지 않습니다. 선택한 파일의 영상 폴더와 secret 파일 경로를 실제 NAS 경로에 맞추세요. OpenSubtitles 키나 빈 파일은 필요하지 않습니다.

4. 이미 설치했다면 기존 설정에만 추가

   프로젝트를 중지하고 YAML과 data를 백업합니다. 새 YAML 전체로 덮어쓰지 말고 아래 부분을 기존 설정에 합치세요. 기존 ROUX_METADATA_MODE는 direct로 바꾸고 ROUX_PUBLIC_METADATA_URL이 있으면 제거합니다. 이미 있는 secret 항목은 중복 추가하지 않습니다. image·미디어/data 경로·포트·다른 secret은 유지합니다.

   추가 위치 보기 — 전체 YAML이 아닌 부분 예시

   services:
     roux-server:
       environment:
         ROUX_METADATA_MODE: "direct"
       secrets:
         - tmdb_read_token
   secrets:
     tmdb_read_token:
       file: "/volume1/docker/roux-secrets/tmdb_read_token"

   적용·배포로 컨테이너를 다시 생성하세요. 단순 재시작은 바뀐 키 파일이 적용되지 않을 수 있습니다. 정리(Clean)나 데이터 삭제는 하지 않습니다.

5. 설정 감지와 실제 조회를 따로 확인

   서버가 healthy가 되면 앱의 설정 → Synology 설치 및 점검 → 다시 점검을 누르세요. 설정 감지는 키 유효성이나 조회 성공을 뜻하지 않습니다. 라이브러리를 새로고침한 뒤 알려진 작품의 제목·포스터와 재생을 확인하세요. 나중에 키를 연결해도 기존 라이브러리에 작품 정보를 수집합니다.

출시 준비 버전 1.0 빌드 76은 광고 없이 제공합니다. TMDB는 개인 키와 제공자의 이용 조건에 따라 연결합니다. 광고 도입 여부는 별도 이용 조건 확인 후 결정하며, 새 공개 설치·나중에 연결·키 교체의 실제 NAS 검증은 남아 있습니다.

TMDB 시작 안내 · Read Access Token · 이용 조건·출처 표시

1. OpenSubtitles.com 계정과 API 키 준비

   OpenSubtitles.com에 가입해 이메일 인증을 마치고, API consumers에서 용도와 이용 조건을 확인하여 키를 발급하세요. 다운로드에는 API 키와 해당 계정의 사용자 이름·비밀번호가 모두 필요합니다. Roux 소셜 로그인과 별개이며, 예전 .org API 키는 사용하지 않습니다.

   다운로드 한도와 요금은 OpenSubtitles 계정·API 조건을 확인하세요. Roux가 일정한 무료 횟수를 보장하지 않습니다.

2. DSM에만 안전하게 보관

   Text Editor로 프로젝트 밖 /volume1/docker/roux-secrets에 opensubtitles_api_key, opensubtitles_username, opensubtitles_password 파일을 만들고 각각 값 한 줄만 저장하세요. .txt나 따옴표를 붙이지 않으며 비밀번호의 공백은 유지합니다.

   관리자와 서버 실행 UID 65532만 필요한 접근 권한을 갖도록 제한하세요. 키·비밀번호를 앱·홈페이지·YAML·메일·로그에 입력하지 않습니다. 저장소는 자동 암호화되지 않습니다. 백업도 보호하고 입력 후 편집기를 닫고 클립보드를 비우세요.

3. 서버 설정에 연결

   새 설치는 docker-compose.subtitles.yml(자막) 또는 docker-compose.tmdb-subtitles.yml(작품 정보와 자막) 하나만 선택하세요. 필요한 secret 파일을 먼저 준비합니다. 기본 설정은 이 파일들 없이 실행됩니다.

   기존 설치는 업데이트 안내에 따라 서버를 업데이트하고, YAML·data 백업 후 아래 항목만 병합하세요. 기존 영상/data 경로·포트·TMDB 설정은 유지합니다. 같은 secret 블록을 중복 작성하지 않습니다.

   추가 위치 보기 — 전체 설정이 아닌 부분 예시

   services:
     roux-server:
       secrets:
         - opensubtitles_api_key
         - opensubtitles_username
         - opensubtitles_password
   secrets:
     opensubtitles_api_key:
       file: "/volume1/docker/roux-secrets/opensubtitles_api_key"
     opensubtitles_username:
       file: "/volume1/docker/roux-secrets/opensubtitles_username"
     opensubtitles_password:
       file: "/volume1/docker/roux-secrets/opensubtitles_password"

   적용·배포하여 컨테이너를 다시 생성하세요. 초기화 서비스에는 secret을 넣지 않습니다. Clean이나 data 삭제는 필요하지 않습니다.

4. 연결 확인 후 자막 한 개로 확인

   앱의 설정 → Synology 설치 및 점검 → OpenSubtitles 연결 확인에서 계정과 남은 다운로드를 확인합니다. 이 확인은 다운로드 한도를 소비하지 않습니다. 숫자는 확인 시점 기준입니다. 이후 플레이어 자막 메뉴에서 원하는 언어로 검색하고 한 개를 내려받아 적용하세요. 실제 다운로드는 한도를 사용할 수 있습니다. 저장된 자막은 NAS 캐시를 사용합니다.

자동 검증된 사전 배포 기능입니다. 실제 NAS의 계정 인증·다운로드·초대 사용자 확인은 별도 검증이 필요합니다.

1. 먼저 집 안 연결과 공유기를 확인하세요

   같은 Wi-Fi에서 소유자 연결과 영상 재생을 끝내세요. 공유기에서 NAS의 내부 IP를 고정 예약합니다. 공유기의 인터넷(WAN) 주소가 공인 IPv4인지 확인하세요. 사설 주소나 100.64.0.0–100.127.255.255이면 이중 공유기 또는 CGNAT 환경일 수 있습니다. 이 경우 통신사에 공인 IP 가능 여부를 확인하거나 별도로 VPN 연결을 구성해야 합니다. 포트 하나만 열어서는 해결되지 않습니다.

2. Synology DDNS 주소를 만드세요

   DSM 제어판 → 외부 액세스 → DDNS → 추가에서 서비스 제공자를 Synology로 선택하고 사용 가능한 호스트 이름을 등록합니다. 연결 테스트와 상태가 정상인지 확인하세요. 아래 roux-example.synology.me는 예시이므로 모두 내 주소로 바꿉니다. DDNS는 주소를 연결할 뿐 포트를 열지는 않습니다.

3. 같은 주소의 인증서를 준비하세요

   DDNS 등록의 Let’s Encrypt 인증서 옵션 또는 제어판 → 보안 → 인증서 → 추가에서 내 DDNS 주소의 인증서를 발급합니다. 아래 프록시를 만든 뒤 인증서의 설정/구성에서 해당 서비스에 이 인증서를 지정하세요. 기본 인증서 변경은 다른 서비스에도 영향을 줄 수 있습니다.

   인증서는 자동 갱신 상태도 확인합니다. 사용자 지정 도메인의 HTTP 인증에는 TCP 80 연결이 필요할 수 있으므로 Synology 인증서 안내를 따르세요. 재생 연결은 HTTPS 443을 사용하며, 인증서 경고를 무시하고 진행하지 않습니다.

4. Roux로 연결할 리버스 프록시를 만드세요

   제어판 → 로그인 포털 → 고급 → 역방향 프록시(리버스 프록시) → 생성을 엽니다. 이름은 Roux로 지정합니다.

   소스

   프로토콜 HTTPS
   호스트 이름 roux-example.synology.me
   포트 443

   대상

   프로토콜 HTTP
   호스트 이름 127.0.0.1
   포트 8080

   8080은 NAS에 연결한 Roux 포트입니다. 기존 YAML에서 변경했다면 그 포트를 사용하세요. 사용자 지정 요청 헤더에 X-Forwarded-Proto = https를 설정하고 기존 전달 헤더를 유지하세요. Roux가 프록시 접속을 원격 요청으로 판별하는 데 사용합니다. DSM 관리 화면이나 소유자 등록 포트 8081로 연결하지 않습니다.

5. 공유기에서 HTTPS 연결을 전달하세요

   공유기 관리 화면의 포트 포워딩에서 외부 TCP 443 → NAS 내부 IP의 TCP 443을 등록합니다. DSM 방화벽을 사용 중이면 필요한 클라이언트의 443 접근도 허용하세요. 이미 443을 사용한다면 기존 서비스를 덮어쓰지 말고 호스트 이름별 프록시 규칙을 확인합니다.

   포트포워딩 방법 펼치기

   공유기가 집 밖의 HTTPS 요청을 NAS로 보내도록 연결하는 설정입니다. 위 단계에서 인증서와 리버스 프록시를 먼저 준비하세요.

   1. 공유기 관리 화면을 여세요. 집 Wi-Fi에 연결한 iPhone의 설정 → Wi-Fi → 연결된 네트워크의 ⓘ → ‘라우터’ 주소를 Safari에 입력하고 관리자 계정으로 로그인합니다.
   2. 포트포워딩 메뉴를 찾으세요. 공유기에 따라 ‘NAT’, ‘포트 전달’, ‘가상 서버’ 안에 있습니다. 새 규칙을 추가해 아래처럼 입력하세요.

   규칙 이름

   Roux HTTPS

   프로토콜

   TCP

   외부 포트

   443 (시작·끝이 있으면 둘 다 443)

   내부 IP

   내 NAS의 내부 IP
   예: 192.168.1.100 — 예시를 그대로 복사하지 마세요.

   내부 포트

   443 — DSM 리버스 프록시의 소스 포트

   NAS IP는 DSM 제어판 → 네트워크 → 네트워크 인터페이스에서 확인합니다. 공유기의 주소 예약(DHCP 예약)으로 이 IP가 바뀌지 않게 해두세요.

   저장·적용 후 Wi-Fi를 끄고 확인하세요. 5G/LTE에서 https://roux-example.synology.me/health를 열어 status: ok를 확인한 뒤 앱에서 재생해 보세요. 주소는 내 DDNS로 바꿉니다.

   443을 이미 다른 장비가 사용한다면? 기존 규칙을 덮어쓰지 마세요. 별도 포트를 쓰려면 외부·내부 포트와 DSM 프록시의 소스 포트를 모두 9443으로 맞추고, 방화벽도 해당 포트를 허용합니다. 앱 주소와 확인 주소에 :9443을 붙이세요. 예: https://roux-example.synology.me:9443. 프록시 대상인 Roux 8080은 그대로입니다.

   시간 초과가 나면 NAS IP·포트·방화벽을 먼저 확인하세요. 이중 공유기나 CGNAT 환경은 아래 ‘연결이 안 될 때’를 참고하세요. 사용을 중단하려면 추가한 Roux 규칙만 비활성화합니다.

   Roux 8080·8081과 DSM 관리 5000·5001을 직접 외부에 공개하거나 DMZ를 켜지 마세요. 이 안내는 설정 방법만 설명하며 포트를 자동으로 열지 않습니다.

6. 앱에 HTTPS 주소와 권한을 설정하세요

   Roux의 서버 주소 입력란에 https://roux-example.synology.me를 입력해 연결합니다. /health나 /webman, 내부 포트 번호는 앱 주소에 붙이지 않습니다. 참여자는 소유자에게 이 HTTPS 주소와 참여 코드를 받아 요청합니다. 소유자는 참여자에게 허용할 라이브러리와 집 밖 원격 접속 권한을 설정해야 합니다.

7. Wi-Fi를 끄고 5G/LTE로 확인하세요

   Safari에서 https://roux-example.synology.me/health가 인증서 경고 없이 열리는지 확인하고, Roux에서 영상 재생과 앞뒤 탐색을 해보세요. 집 안 Wi-Fi 테스트만으로는 외부 접속 성공을 확인할 수 없습니다. 테스트 뒤 Wi-Fi를 다시 켭니다.

Synology DDNS · Certificate · Reverse proxy · QuickConnect