4XLink 4XLink for NAS 빠른 설치
빠른 설치 안내

3단계로 설치

시작 전 확인:

NAS에 Docker가 설치되어 있는지 확인하세요(Synology에서는 Container Manager, QNAP에서는 Container Station).

단계 01

4XLink 다운로드

한 가지 방법으로 이미지를 받으세요.

Docker 다운로드

권장

NAS의 SSH 터미널에서 실행SSH로 NAS에 접속한 뒤 아래 명령을 붙여 넣고 Enter를 누르세요.

docker pull docker.io/4xvr/4xlink-nas:2.0.3

NAS에 맞는 x86-64 / ARM64 버전을 자동 선택합니다.

NAS의 Docker 앱에서 4xvr/4xlink-nas를 검색하고 태그 2.0.3을 선택해 다운로드할 수도 있습니다.

단계 02

컨테이너 만들기

로컬 이미지에서 4xvr/4xlink-nas:2.0.3을 선택해 컨테이너를 만들고 세 항목을 설정하세요.

  1. 1 네트워크를 host로 설정

    네트워크는 host를 선택합니다.

  2. 2 데이터 디렉터리 추가

    NAS 설정 폴더 → /data (읽기/쓰기).

  3. 3 비디오 디렉터리 추가

    NAS 동영상 폴더 → /shared/video (읽기 전용).

Compose를 사용하나요?

외장 드라이브 핫플러그 (선택)

QNAP / UGREEN은 브랜드에 맞는 마운트를 추가하세요: NAS 상위 폴더 → 컨테이너 폴더.

QNAP

/share/external/shared/external

- /share/external:/shared/external:ro,rslave

UGREEN

/mnt/@usb/shared/external

- /mnt/@usb:/shared/external:ro,rslave

화면에서는 읽기 전용 + rslave로 설정하세요. 마운트 전파 옵션이 없으면 Compose를 사용하세요.

Compose: volumes: 아래 USB 마운트를 선택한 항목으로 교체하고 /data와 동영상 마운트는 유지하세요. 컨테이너를 다시 만든 후 4XLink의 자동 추가를 켜세요.

호환성 및 안전한 제거

/mnt/@usb/sdc1은 드라이브 한 개만 가리킵니다. 핫플러그에는 고정된 sdc1이 아닌 상위 폴더 /mnt/@usb가 필요합니다. 변경 후 컨테이너를 다시 생성하세요. 재시작만으로는 적용되지 않습니다.

이 설정은 상위 폴더 아래의 모든 외장 드라이브에 대한 접근을 허용합니다. NAS가 새 드라이브를 마운트하고 마운트 전파가 작동하면 2.0.3은 저장된 자동 추가 설정에 따라 새 드라이브를 추가하고 분리된 드라이브를 목록에서 내립니다. 비활성화나 제외 설정을 강제로 해제하지 않습니다. QNAP 및 UGREEN 테스트 환경에서 검증했으며 지원 여부는 모델과 시스템에 따라 다릅니다.

원본 폴더가 존재하고 NAS가 마운트 전파를 지원해야 합니다. 오류가 나도 특권 모드를 켜거나 시스템 마운트를 변경하지 마세요. Synology에는 직접 적용할 수 없으므로 단일 드라이브 수동 설정을 사용하세요. NAS의 안전하게 꺼내기를 사용하고, 사용 중이면 재생이나 컨테이너를 먼저 중지하세요. 강제로 분리하지 마세요.

오래된 커널에서는 ro가 모든 하위 마운트의 읽기 전용을 보장하지 않습니다. Docker 마운트 문서

저장하고 컨테이너를 시작하세요.

단계 03

4XLink 열기

NAS-IP를 NAS의 로컬 IP 주소로 바꾸세요.

http://NAS-IP:18080

폴더 추가 → /shared/video를 선택하면 동영상을 공유할 수 있습니다.

문제가 있나요?
외장 USB 드라이브를 추가하려면?

USB 드라이브를 개별적으로 추가하려면 실제 경로를 /shared/usb에 마운트하세요. 일반적인 경로는 아래와 같습니다. QNAP·UGREEN 핫플러그 마운트는 2단계: 컨테이너 만들기에 있습니다.

Synology /volumeUSB1/usbshare1-1
OpenWrt /tmp/mountd/disk1_part1

NAS에 표시된 실제 경로를 사용해 컨테이너에 저장소 마운트를 추가하세요:

실제 USB 경로 → /shared/usb 권한은 읽기 전용으로 설정하세요.

마운트를 바꾸면 컨테이너를 다시 생성해야 합니다. 재시작만으로 새 마운트가 적용되지는 않습니다. 이후 4XLink에서 /shared/usb 아래 폴더를 추가하세요. 여러 디스크는 다른 경로를 사용하세요. 안전하게 꺼내기 전에 재생과 해당 디스크를 사용하는 컨테이너를 중지하고, 다시 연결한 뒤 매핑을 확인하세요. Synology 기본 Docker 배포는 자동 핫플러그를 보장하지 않으며 SSH 도우미가 필요하지 않습니다.

폴더가 보이지 않거나 공유 이름이 같은가요?

NAS 폴더를 컨테이너의 /shared/video 또는 /shared/usb에 연결하세요. /docker나 /usbdisk로 연결하면 표시되지 않습니다. 각 연결은 서로 다른 컨테이너 경로를 사용하세요. 같은 공유 이름은 자동으로 구분되며 Synology 썸네일 폴더 @eaDir는 숨겨집니다. 전체 시스템 볼륨이나 앱 설정이 아닌 필요한 미디어 폴더만 선택하세요.

업데이트 방법

설정을 백업하고 기존 컨테이너를 중지하세요. 기존 /data와 미디어 마운트를 유지하고 이미지를 업데이트한 뒤 컨테이너를 다시 생성하세요. 데이터 볼륨을 삭제하거나 데이터 폴더를 바꾸지 마세요. 관리 페이지는 신뢰할 수 있는 LAN에서만 사용하고 인터넷에 직접 공개하지 마세요.