Guía de instalación rápida

Instala en tres pasos

Descarga 4XLink, crea el contenedor y ábrelo en el navegador. No se requieren conocimientos avanzados de Docker.

Antes de empezar:

Asegúrate de que Docker esté instalado en tu NAS (Container Manager en Synology y Container Station en QNAP).

Paso 01

Descargar 4XLink

Elige cualquiera de los métodos. Usa Docker si manejas el terminal o descarga directamente una imagen TAR.

Descarga con Docker

Recomendado

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

Docker descarga automáticamente la versión x86-64 o ARM64 adecuada para tu NAS.

Descargar imagen TAR

Descargar x86-64 Intel / AMD NAS Descargar ARM64 ARM / aarch64 NAS

Si no conoces la arquitectura del NAS, usa el comando Docker de la izquierda.

Paso 02

Crear el contenedor

Crea el contenedor 4XLink mediante la interfaz gráfica o Compose.

Método	Recomendado para	Procedimiento
Interfaz gráfica Para principiantes	Primer uso de Docker con selección paso a paso de los ajustes.	Selecciona 4XLink en Imágenes locales, elige Crear contenedor y aplica los tres ajustes siguientes.
Compose	NAS con función Proyecto, Aplicación o Compose.	Crea un proyecto, pega la configuración y sustituye las rutas del NAS.

compose.yaml Sustituye únicamente las rutas del NAS a la izquierda de los dos puntos. Elimina el último montaje si no usas una unidad USB.

services:
  4xlink-nas:
    image: 4xvr/4xlink-nas:latest
    container_name: 4xlink-nas
    restart: unless-stopped
    network_mode: host

    volumes:
      # Directorio de datos de 4XLink, lectura/escritura
      - /path/to/4xlink-data:/data

      # Directorio de vídeos del NAS, solo lectura
      - /path/to/videos:/shared/video:ro

      # Unidad USB opcional, solo lectura
      - /path/to/usb-drive:/shared/usb:ro

    stop_grace_period: 30s

Las rutas de la derecha /data, /shared/video y /shared/usb son rutas del contenedor. No las cambies. Guarda e inicia el proyecto.

¿Dónde está la imagen? Después de descargar con Docker, selecciona 4xvr/4xlink-nas:latest en Imágenes locales. Si descargaste un TAR, impórtalo primero desde la página Imágenes.

1 Configurar la red como host
Selecciona la red host para que el visor pueda detectar el NAS en la red local.
2 Añadir un directorio de datos
Elige una carpeta del NAS y móntala en /data con permiso de lectura y escritura.
3 Añadir un directorio de vídeos
Elige la carpeta que contiene los vídeos y móntala en /shared/video con permiso de solo lectura.

Mantén las demás opciones predeterminadas y crea e inicia el contenedor.

Paso 03

Abrir 4XLink

Introduce la dirección siguiente en el navegador de un ordenador o teléfono. Sustituye NAS-IP por la dirección local del NAS.

http://NAS-IP:18080

En la página, selecciona Añadir carpeta y elige /shared/video para añadir tus vídeos.

¿Tienes problemas?

La página no se abre:Usa la IP local del NAS, no la dirección del contenedor que comienza por 172..
El visor no encuentra el NAS:Comprueba que el modo de red del contenedor sea host y que el visor y el NAS estén en la misma red local.
Los vídeos no aparecen:Comprueba que la carpeta de vídeos esté montada en /shared/video.

¿Cómo añado una unidad USB externa?

Las unidades USB no se añaden automáticamente al contenedor. Monta por separado la ruta real de la unidad en /shared/usb.Rutas habituales:

Synology /volumeUSB1/usbshare1-1

QNAP /share/external/DEV3301_1

UGREEN /mnt/@usb/sdc1

OpenWrt /tmp/mountd/disk1_part1

Usa la ruta real que muestra tu NAS. Añade un montaje de almacenamiento al contenedor:

Ruta USB real → /shared/usb y configúralo como solo lectura.

Vuelve a crear o reinicia el contenedor. En 4XLink, selecciona Añadir carpeta y abre /shared/usb. Las unidades adicionales se pueden montar como /shared/usb2, /shared/usb3.

¿Cómo se crea con compose.yaml?

Crea un proyecto en la página Proyecto, Aplicación o Compose del NAS y pega la configuración siguiente. Sustituye únicamente las tres rutas NAS a la izquierda de los dos puntos. Elimina la línea USB si no usas una unidad USB.

services:
  4xlink-nas:
    image: 4xvr/4xlink-nas:latest
    container_name: 4xlink-nas
    restart: unless-stopped
    network_mode: host

    volumes:
      # Directorio de datos de 4XLink, lectura/escritura
      - /path/to/4xlink-data:/data

      # Directorio de vídeos del NAS, solo lectura
      - /path/to/videos:/shared/video:ro

      # Unidad USB opcional, solo lectura
      - /path/to/usb-drive:/shared/usb:ro

    stop_grace_period: 30s

Las rutas de la derecha /data, /shared/video y /shared/usb son rutas del contenedor. No las cambies. Deja vacíos el comando de inicio y las variables de entorno.