Migración desde xaccel-codec
Actualizado el 04 oct. 2026Pasa tus canales, fuentes, salidas, ajustes de transcodificación y adaptadores DVB de xaccel-codec a Castreon directamente desde el panel, en pocos minutos. xaccel sigue funcionando todo el tiempo y no se escribe nada hasta que confirmas.
Disponible a partir de Castreon 1.0.3. Compatible: xaccel-codec 5.x (probado con 5.5.17).
Cómo funciona
- Subes la copia automática que xaccel ya guarda en su servidor.
- Castreon la lee y te muestra un informe: qué se va a crear, qué no se puede conservar y por qué. Todavía no cambia nada.
- Confirmas. Los canales se crean detenidos, para que las fuentes no se capten dos veces mientras xaccel sigue funcionando.
- Compruebas los canales, los inicias y cambias tus balanceadores de carga. Las direcciones antiguas de los streams de xaccel siguen funcionando en Castreon.
La copia solo se lee. Castreon no se conecta a xaccel, no lo detiene ni cambia nada en él.
Antes de empezar
- Castreon está instalado y activado en el servidor al que migras: consulta Instalación y activación.
- Tu plan cubre el número de canales que quieres tener en marcha a la vez.
- Fuentes DVB: las tarjetas DVB deben estar en el servidor de Castreon. Si Castreon funciona en el mismo servidor que xaccel, una tarjeta solo puede usarla un programa a la vez: detén xaccel (o los canales que usan esa tarjeta) antes de iniciar los canales DVB en Castreon.
- Si también recibes con Astra (Cesbo), sube su configuración en el mismo análisis: consulta Migración desde Astra (Cesbo).
1. Descarga la copia de seguridad de xaccel
xaccel guarda copias automáticas en /opt/xaccel-codec/backup/. En el servidor de xaccel, lístalas, la más reciente primero:
ls -lt /opt/xaccel-codec/backup/
Los archivos se llaman xaccel-codec-<versión>-<fecha>-<id>.gz. Copia la más reciente a tu ordenador, por ejemplo:
scp root@SERVIDOR-XACCEL:/opt/xaccel-codec/backup/xaccel-codec-5.5.17-20261004182209-3e042dc4.gz .
Usa el archivo más reciente: los cambios hechos en xaccel después de la fecha del nombre del archivo no están en él.
Trata la copia con cuidado. Contiene las cuentas y contraseñas de xaccel. Castreon no las lee, pero el archivo las contiene: guárdalo en un ordenador de confianza y bórralo cuando termine la migración.
2. Analizar
- En el panel de Castreon, abre Ajustes → Migración (xaccel, Astra).
- En Copia de xaccel-codec, elige el archivo
.gz. - Haz clic en Analizar.
Se aceptan también copias de varios gigabytes (por ejemplo, con datos EPG). El análisis es válido durante 30 minutos; después, vuelve a subir el archivo.
3. Lee el informe
Arriba, cuatro cifras resumen la importación:
| Cifra | Significado |
|---|---|
| Canales | los canales que se crearán y cuántos funcionan sin transcodificación (passthrough) |
| Perfiles nuevos | los perfiles de transcodificación que se crearán; los canales con ajustes idénticos comparten un perfil |
| Salidas | salidas HLS, HTTP-TS y push (UDP, SRT, RTMP) |
| Otros | adaptadores DVB nuevos, grupos y direcciones IP permitidas; los adaptadores que ya existen se reutilizan |
La tabla muestra cada canal:
- Canal — nombre, nombre en la dirección (slug) y grupo;
- Fuente — la fuente principal, por ejemplo
DVB · Cable 610 · SID 40805oHTTP; - Perfil — el perfil de transcodificación, o passthrough;
- Salidas — HLS, HTTP-TS, UDP…;
- Dirección antigua — la dirección de xaccel que seguirá funcionando, por ejemplo
/stream/15/30015.m3u8; - A tener en cuenta — lo que no se pudo conservar en este canal.
Debajo de la tabla:
- Perfiles y Adaptadores DVB — qué se va a crear; ya existe, se usa ese significa que no se crea nada nuevo;
- Ajustes que no se conservan — ajustes sin equivalente, con el número de canales afectados;
- Lo que no se migra — datos que se dejan fuera a propósito (ver más abajo).
Direcciones permitidas
Si xaccel tenía una lista de IP permitidas, el informe ofrece Añadir las N direcciones permitidas de xaccel. La lista se aplica inmediatamente a todos los canales: los reproductores y balanceadores que no están en ella son rechazados (HTTP 403). Márcala solo si la lista está completa, incluidas las direcciones de tus balanceadores. Puedes cambiarla en cualquier momento en Ajustes → Acceso a los flujos: consulta Reinicios programados y restricciones de IP.
4. Importar
Haz clic en Importar N canales (detenidos). Primero se crean los grupos, los adaptadores DVB y los perfiles; si uno de ellos falla, no se conserva nada. Después los canales se crean uno a uno: un canal que no se puede crear (por ejemplo, uno sin ninguna fuente utilizable) aparece en No se pudieron importar, y el resto se importa.
5. Comprobar e iniciar
- Abre Canales. Los canales importados están detenidos; sus notas contienen el número de stream de xaccel.
- Abre algunos canales y comprueba las fuentes, el perfil y las salidas. Una fuente DVB muestra el adaptador y el servicio (SID).
- Para DVB, abre Adaptadores DVB y comprueba que cada adaptador esté enganchado a la señal: consulta Adaptadores DVB, sintonizadores y escaneo.
- Inicia los canales, unos pocos a la vez, y compáralos con xaccel.
6. El cambio
Las direcciones antiguas de xaccel funcionan en Castreon en el puerto del panel (33400 por defecto):
| xaccel | Castreon |
|---|---|
http://XACCEL:33200/stream/15/30015.m3u8 |
http://CASTREON:33400/stream/15/30015.m3u8 (la lista HLS del canal) |
http://XACCEL:33200/stream/15/axn.ts |
http://CASTREON:33400/stream/15/axn.ts (el flujo HTTP-TS del canal) |
En tus balanceadores solo cambias el host y el puerto. Se aplican las mismas reglas de acceso que a las direcciones normales de Castreon: consulta Entrega.
Cuando todo funcione en Castreon, detén xaccel.
Qué se migra
| xaccel | Castreon |
|---|---|
| Nombre del canal, URL del logo, ID EPG, modo bajo demanda | lo mismo en el canal de Castreon; el slug se crea a partir del nombre |
| Fuentes (HTTP/HTTPS, UDP/RTP, SRT, RIST, RTMP, RTSP), en orden de failover | fuentes del canal, con user agent, cabeceras y referer |
Fuentes DVB (dvb://… y servicios escaneados) |
fuente DVB vinculada al adaptador importado, con el SID del servicio |
| Mapeo de vídeo, audio y subtítulos, rate emulation | lo mismo en cada fuente |
| Codificadores de vídeo y audio (NVENC, QSV, VAAPI, CPU; H.264, HEVC, AV1, VP9; AAC, Opus, AC-3, E-AC-3, MP3), bitrate, tamaño, preset, GOP, desentrelazado, texto superpuesto | un perfil de transcodificación: consulta Perfiles de transcodificación |
| Vídeo y audio copiados, sin superposiciones | passthrough (sin perfil) |
| Subtítulos incrustados, copiados o WebVTT | el modo de subtítulos del canal |
| Reinicios programados | los reinicios programados del canal |
| Categorías | grupos de canales |
| Salidas HLS, HTTP, UDP/RTP, SRT, RTMP | HLS (con duración del segmento y longitud de la lista de reproducción), HTTP-TS, salidas push |
| Sintonización DVB-C, DVB-T y DVB-T2 | adaptadores DVB |
| Lista de IP permitidas | direcciones permitidas (opcional) |
Qué no se migra
- las cuentas, usuarios y paquetes de reventa de xaccel;
- la licencia de xaccel y los datos del servidor;
- VOD (películas y series) y datos EPG — el ID EPG de cada canal se conserva;
- el balanceo y los proxys de xaccel;
- los ajustes de acceso condicional;
- las fuentes cuya dirección contiene claves — el canal recibe una nota; añádelas a mano;
- los adaptadores de satélite (DVB-S/S2) — aparecen en el informe; por ahora Castreon solo admite recepción por cable y terrestre;
- los logos subidos a xaccel como archivos (vuelve a subirlos en el perfil), el volumen de audio modificado, la eliminación del logo (delogo), el timeshift;
- el reinicio diario global de xaccel — Castreon no lo necesita; puedes añadir un reinicio programado por canal.
Repetir la importación
La importación se puede repetir sin riesgo, con la misma copia o con una más reciente:
- los canales ya importados se reconocen por su número de stream de xaccel y no se duplican;
- los perfiles y adaptadores DVB ya importados se reutilizan;
- para importar de nuevo un canal, elimínalo primero en Castreon y luego ejecuta la importación.
Las direcciones antiguas están ligadas al número de stream de xaccel. Si juntas varios servidores xaccel en un solo Castreon, los canales con el mismo número de stream en servidores distintos se tratan como el mismo canal. Migra esos servidores a servidores Castreon separados, o abre un ticket y te ayudamos.
Si algo falla
- «El archivo no parece una copia de xaccel-codec» — usa un archivo de
/opt/xaccel-codec/backup/(xaccel-codec-<versión>-….gz), no una exportación de la base de datos hecha de otra forma. - «El análisis ha caducado» — pasaron más de 30 minutos entre el análisis y la importación; vuelve a subir el archivo.
- Los reproductores reciben HTTP 403 tras la importación — se importó la lista de direcciones permitidas y no están en ella; corrígela en Ajustes → Acceso a los flujos.
- Un canal no arranca por la licencia — tu plan permite menos canales en marcha; detén otros canales o pasa a un plan superior.
- Un canal DVB no arranca — comprueba en Adaptadores DVB que el adaptador esté activado y enganchado, y que ningún otro programa (xaccel, Astra) use la tarjeta.
- Un canal aparece en «No se pudieron importar» — lee el motivo que aparece al lado; normalmente el canal no tenía ninguna fuente que Castreon pueda usar. Créalo a mano.
Si el problema continúa, abre un ticket y adjunta el informe (basta una captura de pantalla): consulta Cómo abrir un buen ticket.