Advanced

Hardware Acceleration

• Dispatcharr actualmente no admite aceleración por hardware de forma directa, pero puedes habilitarla utilizando perfiles de transmisión personalizados con ffmpeg.
• Esto requiere mapear tu hardware al contenedor y configurar un perfil personalizado de ffmpeg para aprovechar la aceleración.

Mapping Hardware

NVIDIAIntelNVIDIA (Unraid)Intel (Unraid)

• Instala el NVIDIA Container toolkit
• Agrega una sección deploy a tu docker-compose.yml

Ejemplo

services:
  dispatcharr:
    # build:
    #   context: .
    #   dockerfile: Dockerfile
    image: ghcr.io/dispatcharr/dispatcharr:latest
    container_name: dispatcharr
    ports:
      - 9191:9191
    volumes:
      - dispatcharr_data:/data
    environment:
      - DISPATCHARR_ENV=aio
      - REDIS_HOST=localhost
      - CELERY_BROKER_URL=redis://localhost:6379/0
    deploy:
      resources:
        reservations:
          devices:
            - driver: nvidia
              count: all
              capabilities: [gpu]
volumes:
  dispatcharr_data:

• Agrega una sección "devices" a tu archivo docker-compose.yml

Ejemplo

services:
  dispatcharr:
    # build:
    #   context: .
    #   dockerfile: Dockerfile
    image: ghcr.io/dispatcharr/dispatcharr:latest
    container_name: dispatcharr
    ports:
      - 9191:9191
    volumes:
      - dispatcharr_data:/data
    environment:
      - DISPATCHARR_ENV=aio
      - REDIS_HOST=localhost
      - CELERY_BROKER_URL=redis://localhost:6379/0
    devices:
      - /dev/dri:/dev/dri

volumes:
  dispatcharr_data:

• Instala el plugin NVIDIA Driver Package desde Community Apps (si aún no lo tienes).
• Edita el contenedor de Dispatcharr en Unraid:
  • Activa Advanced View
  • En Extra Parameters
    • Agrega --runtime=nvidia
  • Haz clic en "Add another Path, Port, Variable, Label or Device"
    • Config Type: Variable
    • Name: NVIDIA_VISIBLE_DEVICES
    • Key: NVIDIA_VISIBLE_DEVICES
    • Value: all
  • Clic Save
  • De nuevo en "Add another Path, Port, Variable, Label or Device"
    • Config Type: Variable
    • Name: NVIDIA_DRIVER_CAPABILITIES
    • Key: NVIDIA_DRIVER_CAPABILITIES
    • Value: all
  • Clic Save

• Edita el contenedor de Dispatcharr en Unraid.
• Desplazate hacia abajo y haz clic en "Add another Path, Port, Variable, Label or Device"
  • Config Type: Device
  • Name: /dev/dri
  • Key: /dev/dri
  • Description: Intel GPU
• Clic Save

Stream Profiles Personalizados

• Abre Dispatcharr.

• Ve a Settings > Add Stream Profile.

  • Nombralo con el nombre que prefieras
  • Command (Comando) ffmpeg
  • Parameters (Parámetros) varían según tu hardware y necesidades de streaming.
    • Revisa ffmpeg docs para más información.
  • Visita nuestro discord para ver parámetros de ffmpeg aportados por la comunidad.
  NVIDIAIntel VAAPIIntel QSV

  Ejemplo

  • Parameters: -user_agent {userAgent} -hwaccel cuda -i {streamUrl} -c:v h264_nvenc -c:a copy -f mpegts pipe:1

  Ejemplo

  • Parameters: -user_agent {userAgent} -hwaccel vaapi -hwaccel_output_format vaapi -hwaccel_device /dev/dri/renderD128 -i {streamUrl} -c:a aac -c:v h264_vaapi -f mpegts pipe:1

  Ejemplo

  • Parameters: -hwaccel qsv -user_agent {userAgent} -i {streamUrl} -c:v h264_qsv -c:a aac -f mpegts pipe:1

Configuración de Prioridad del Proceso

Variables de entorno opcionales para ajustar la prioridad de tareas. Valores más bajos = mayor prioridad. Rango: -20 (máxima) a 19 (mínima). Los valores negativos requieren cap_add: SYS_NICE

• UWSGI_NICE_LEVEL - Prioridad para uWSGI, FFmpeg y streaming. Predeterminado 0; recomendado -5 para alta prioridad.
• CELERY_NICE_LEVEL - Prioridad para Celery, EPG y otras tareas en segundo plano. Predeterminado 5.

Ejemplo

    environment:
      - UWSGI_NICE_LEVEL=-5
      - CELERY_NICE_LEVEL=5

    cap_add:
      - SYS_NICE

Reverse Proxies

Nginx

Ejemplo de configuración HTTPS (solo streams vía HTTPS, WebUI a través de la red local y Wireguard)

Example (click to see)

# Dispatcharr HTTPS DynuDNS
server {
    listen 443 ssl;
    server_name dispatcharr.your.domain.com;  #Adjust for your domain

    ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;

    location ~ ^(/proxy/(vod|ts)/(stream|movie|episode)|/player_api.php|/xmltv.php|/api/channels/logos/.*/cache|/(live|movie|series)/[^/]+/.*) { 
        allow all;  # Allow everyone else
        proxy_pass http://dispatcharrserver:9191;  # Adjust for your server name or IP
        proxy_set_header Host $host:443;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        # CORS settings
        add_header 'Access-Control-Allow-Origin' '*';
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'Origin, Content-Type, Accept';
    }

    location / {
        allow 10.0.0.0/22;  # Allow the local network, adjust for your network
        allow 10.1.0.0/24;  # Allow Wireguard, adjust for your network
        deny all;  # Deny everyone else
        proxy_pass http://dispatcharrserver:9191;  # Adjust for your server name or IP
        # WebSocket headers
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "Upgrade";
        proxy_set_header Host $host:443;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        # CORS settings
        add_header 'Access-Control-Allow-Origin' '*';
        add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';
        add_header 'Access-Control-Allow-Headers' 'Origin, Content-Type, Accept';
    }
}  

Tip

Incluso con un reverse proxy configurado correctamente, la salida M3U estará disponible por defecto a través de internet. Sigue estas buenas prácticas para bloquear el acceso M3U estándar y permitirlo únicamente mediante un usuario y contraseña específicos.

1. Configura tu reverse proxy como se muestra en la documentación
2. En Dispatcharr, ve a > Network Access, y restringe M3U / EPG Endpoints únicamente a tu red local (ejemplo: 192.168.1.0/24)
3. Crea un usuario con XC password en la páginaUsers si aún no lo has hecho
4. Usa el siguiente formato de enlace M3U para compartir con tus usuarios: https://hostname/get.php?username=XCUSERNAME&password=XCPASSWORD
5. Y este formato para EPG: https://hostname/xmltv.php?username=XCUSERNAME&password=XCPASSWORD

Pangolin

• Crea tu recurso tal como lo harías con cualquier otro en Pangolin.
• Si estás alojando Dispatcharr en el mismo VPS (si usas un VPS) que Pangolin, asegúrate de configurarlo como recurso local y usa 172.XX.X.X como la IP, luego introduce el puerto. De lo contrario, configúralo de forma normal.
• Si deseas habilitar el SSO de Pangolin para este recurso por motivos de seguridad, hazlo en la pestaña Authentication de tu nuevo recurso de Dispatcharr.

Para permitir que Dispatcharr se conecte con clientes cuando está protegido detrás del SSO de Pangolin o de otro IdP que hayas agregado, necesitas crear Bypass Rules. Consulta abajo la lista de reglas necesarias. Una vez guardes estas reglas, la WebUI de Dispatcharr estará protegida por tu SSO mientras que las aplicaciones y servicios podrán conectarse mediante XC.

• TLa Action será Bypass Auth fpara todas ellas.
• El Match Type será Path para todas ellas.

Reglas de bypass (haz clic para ver)

• /player_api.php/*
• /get.php/*
• /xmltv.php/*
• /*/*/*.ts
• /proxy/ts/stream/*
• /proxy/vod/episode/*
• /proxy/vod/movie/*
• /api/channels/logos/*/cache/
• /live/*/*
• /movie/*/*
• /series/*/*

(Opcional para acceso mediante HDHR, M3U y/o URL de EPG; no es necesario si utilizas XC. Si utilizas HDHR, M3U o EPG, deberías restringirlo aún más en Settings > Network Access > M3U / EPG Endpoints). De lo contrario, tus enlaces HDHR, M3U y/o EPG serán accesibles públicamente a través de internet.

• /hdhr/*
• /output/m3u/*
• /output/epg/*

• Si deseas configurar GeoBlock para cualquiera o todos los recursos, consulta la documentation oficial de Pangolin para obtener orientación.

• Prueba tu nueva configuración accediendo a Dispatcharr en una ventana incógnito o privada. Ahora deberías ver el panel de inicio de sesión de Pangolin al acceder a la WebUI cuando no estés autenticado, mientras que tus clientes seguirán pudiendo conectarse para permitir el streaming.