OScam cómo instalar - Guía completa de instalación

Si buscas una forma deoscam cómo instalar en tu sistema, has llegado al lugar correcto. La instalación de OScam es un proceso que requiere varios pasos, pero con la guía correcta te tomará un máximo de una hora. Este artículo te guía a través de la compilación desde fuentes, configuración y pruebas — todo lo que necesitas saber para ejecutar OScam en Linux.

Antes de comenzar, deberías tener acceso a un servidor o enrutador con sistema Linux (Debian, Ubuntu, OpenWrt, Alpine) y conocimientos básicos de línea de comandos. El proceso es repetible, así que incluso si eres nuevo en esta área, las instrucciones paso a paso funcionarán sin problemas.

Qué es OScam y por qué elegirlo

OScam es un emulador de tarjeta de código abierto, escrito en C, adaptado para trabajar con sistemas de cardsharing. Su principal ventaja es la ligereza — consume pocos recursos de procesador y RAM, lo que lo convierte en la solución ideal para enrutadores, decodificadores satelitales y servidores con potencia computacional limitada.

En el ecosistema de cardsharingoscam cómo instalar en tu propio sistema es una de las primeras preguntas que se hacen los usuarios. OScam soporta protocolos CCcam, Newcamd, Gbox y otros, lo que proporciona gran flexibilidad en la elección de fuentes de acceso al contenido.

OScam versus otro software CAM

OScam se destaca de la competencia por varias características. En primer lugar, es ligero — en un enrutador ARM antiguo ocupa aproximadamente 2-3 MB de memoria RAM. En segundo lugar, el código fuente está disponible para inspeccionar y modificar, lo que da una sensación de control.

Otro software CAM puede ser más consumidor de recursos u difícil de configurar para principiantes. OScam tiene documentación decente y un foro comunitario activo, aunque debes saber dónde buscarlo sin depender de paquetes predefinidos.

Requisitos del sistema y dependencias

OScam funciona en la mayoría de arquitecturas de Linux. Se admiten ARM (32 y 64 bits), x86_64, MIPS y otras. Los requisitos mínimos son:

• Procesador: ARM Cortex-A7 o superior, o equivalente x86
• RAM: 64 MB mínimo, 256 MB recomendado
• Disco: 50 MB de espacio para instalación + espacio para registros (100-200 MB)
• Sistema: Linux con gcc, make, git

Importante: OScam requiere bibliotecas criptográficas (OpenSSL) y opcionalmente bibliotecas PCSC para lectores de tarjetas. Sin estas dependencias, la compilación fallará.

Dónde descargar fuentes de OScam

Las fuentes oficiales de OScam se encuentran en el repositorio git. No descargues OScam de sitios aleatorios — siempre obtén las fuentes de un repositorio confiable que puedas revisar tú mismo.

El repositorio está disponible públicamente y contiene el historial completo de cambios desde la versión 1.0. Antes de descargar, verifica que la versión que descargas no esté modificada de forma no oficial — es mejor clonar directamente de la fuente.

Preparación del entorno para la instalación

Antes de comenzar a compilar OScam, debes preparar el sistema. No llevará mucho tiempo, pero omitir algún paso causará errores de compilación.

Actualización del sistema y administrador de paquetes

En sistemas Debian/Ubuntu:

sudo apt-get update

En OpenWrt:

opkg update

Esta actualización ajusta las listas de paquetes a las versiones más recientes disponibles en los repositorios. A continuación, instala las herramientas de compilación necesarias.

Instalación del compilador y bibliotecas requeridas

Este es un paso crucial. Sin estos paquetes no podrás compilar OScam.

En Debian/Ubuntu (todas las distribuciones basadas en apt):

sudo apt-get install -y build-essential git libssl-dev libpcsclite-dev pkg-config

Si planeas soportar funciones avanzadas (LCD, lectores de tarjetas), añade:

sudo apt-get install -y libusb-dev libudev-dev

En OpenWrt (donde los paquetes son más pequeños):

opkg install build-essential git libssl libpcsclite-dev

Verifica que el compilador GCC se haya instalado correctamente:

gcc --version

Deberías ver la versión de GCC (por ejemplo, gcc version 10.2.1). Si aparece "command not found", algo salió mal — vuelve al paso de instalación de build-essential.

Verificación del espacio disponible en disco

OScam ocupa poco espacio en su forma final, pero el proceso de compilación crea archivos temporales. Recomiendo un mínimo de 200 MB de espacio libre.

df -h /

Si ves menos de 200 MB de espacio libre, limpia paquetes antiguos o registros antes de instalar:

sudo apt-get clean

Preparación del directorio de instalación

Crea un directorio donde se descargará y compilará OScam. Normalmente es /opt u /usr/local/src:

sudo mkdir -p /opt/oscam

Al cambiar la propiedad, no tendrás que usar sudo al clonar el repositorio. Esto ahorra problemas con permisos de archivos.

Descarga, compilación e instalación de OScam

Aquí comienza el trabajo real. Comprender cada paso te ayudará a resolver problemas si aparecen.Oscam cómo instalar correctamente depende de ejecutar estos comandos en el orden exacto.

Clonación del repositorio desde git

Descarga las fuentes más recientes de OScam del repositorio oficial:

cd /opt/oscam

El proceso de clonación descarga todos los archivos fuente (generalmente alrededor de 50 MB). Cuando termine, verifica que el directorio oscam contenga el archivo configure y Makefile:

ls -la | grep -E "configure|Makefile"

Si los archivos existen, estás listo para el siguiente paso. Si no — asegúrate de que git se haya instalado sin errores.

Configuración de opciones de compilación (./configure)

Este es el momento en que decides qué características deben compilarse en OScam. Diferentes banderas ./configure habilitan o deshabilitan el soporte para varias funciones.

Configuración mínima con soporte SSl y protocolos de red:

./configure --prefix=/usr/local --enable-ssl --enable-cccam --enable-newcamd

Configuración completa (con soporte para lectores PCSC y funciones avanzadas):

./configure --prefix=/usr/local \

Las banderas significan:

• --prefix=/usr/local — ubicación de instalación de binarios
• --enable-ssl — soporte para cifrado SSL/TLS
• --enable-cccam — protocolo CCcam
• --enable-newcamd — protocolo Newcamd
• --enable-pcsc — soporte para lectores de tarjetas Smart Card PC/SC
• --enable-dvbapi — interfaz DVB-API para tarjetas de sintonizadores

El script configure primero verificará la disponibilidad de bibliotecas. Si falta libssl-dev, verás un error como "checking for OpenSSL... not found". No ignores estos errores — vuelve a la sección de preparación e instala los paquetes faltantes.

Si la configuración tiene éxito, al final verás un resumen:

OScam version x.xx configured successfully

Compilación con make y make install

La compilación es el proceso que convierte el código fuente (C) en un archivo binario ejecutable. Puede tomar desde decenas de segundos a varios minutos dependiendo de la potencia del procesador.

make -j4

La bandera `-j4` significa compilar en 4 núcleos simultáneamente (si tienes múltiples núcleos, aumenta el número para acelerar). En sistemas más antiguos intenta `-j2` o sin bandera.

Espera hasta que veas el mensaje de finalización de compilación. Normalmente es un mensaje que contiene "oscam" y el tamaño en bytes (por ejemplo, "oscam (27 MB)"). Si aparece un error, léelo — normalmente indica qué paquete falta.

Después de una compilación exitosa, instala el archivo binario:

sudo make install

Este comando copia el archivo oscam a /usr/local/bin/oscam y crea los directorios de configuración necesarios.

Verificación de la correcta instalación

Verifica que OScam se haya instalado correctamente:

/usr/local/bin/oscam --version

Deberías ver el número de versión, el número de compilación (SVN/GIT), la fecha de compilación y una lista de funciones habilitadas. Ejemplo:

OScam 1.20-oe-alliance (svn12345) compiled Jan 1 2024

Si la salida muestra la versión y funciones — todo está bien. Si aparece "command not found" — verifica si la ruta /usr/local/bin está en la variable PATH:

echo $PATH

Deberías ver /usr/local/bin en la lista. Si no está, añádela:

export PATH=$PATH:/usr/local/bin

Configuración de permisos y propiedad de archivos

OScam debe ejecutarse con los permisos apropiados. Si lo ejecutas como usuario regular (no root), debes cambiar la propiedad a un usuario específico:

sudo useradd -m -d /var/lib/oscam -s /usr/sbin/nologin oscam

Crea directorios de configuración con la propiedad correcta:

sudo mkdir -p /etc/oscam /var/log/oscam /var/lib/oscam

Si planeas acceso a lectores de tarjetas PCSC, añade el usuario oscam al grupo scard:

sudo usermod -aG scard oscam

Configuración de los archivos oscam.conf, oscam.server y oscam.user

Ahora llega el momento en que OScam "enseñas" cómo trabajar. La configuración es el corazón de toda la instalación.Oscam cómo instalar es una cosa, pero sin configuración correcta seguirá siendo un archivo binario inútil.

Estructura y ubicación de los archivos de configuración

OScam busca archivos de configuración por defecto en /etc/oscam/. Los archivos principales son:

• oscam.conf — configuración principal (puertos, protocolos, registro)
• oscam.server — definiciones de fuentes (tarjetas, servidores CCcam/Newcamd)
• oscam.user — usuarios y grupos de acceso
• oscam.dvbapi — configuración de la interfaz DVB-API (opcional)

Crea estos archivos si no existen:

sudo touch /etc/oscam/{oscam.conf,oscam.server,oscam.user}

Configuración del escuchador (puerto, protocolo, cifrado)

Un escuchador es la parte de OScam que escucha en un puerto específico y protocolo, esperando conexiones de clientes. La configuración del escuchador en oscam.conf se ve así:

[global]

Explicación de parámetros:

• logfile — ruta del archivo de registro
• debug — nivel de depuración (0-255, donde 0 está deshabilitado)
• port en la sección [newcamd] — puerto de escucha para protocolo Newcamd (por defecto 1234)
• key — clave de descifrado para comunicación Newcamd (16 bytes en hexadecimal)
• users — lista de usuarios con acceso a este escuchador

Para el protocolo CCcam añade la sección:

[cccam]

Parámetros de CCcam:

• version — versión del protocolo CCcam (2.2.1 es un estándar popular)
• nodeid — identificador de nodo de 20 bytes (en hexadecimal)
• reshare — cuántos niveles de reshare permites (2 significa compartir con una segunda persona)

Añadiendo fuentes (readers) - tarjetas, servidores

La sección [reader] en oscam.server define de dónde OScam obtiene datos — ya sea de una tarjeta física o de un servidor remoto.

Ejemplo de lector de tarjeta física (PCSC):

[reader]

Parámetros:

• label — nombre del lector (para registros e informes)
• protocol — tipo de protocolo (pcsc para lectores de tarjetas inteligentes, dvbapi para sintonizadores DVB)
• device — número de dispositivo (0 para el primer lector, 1 para el segundo, etc.)
• group — número de grupo (debe coincidir con el grupo en oscam.user)
• caid — identificadores CAID de la tarjeta (0500 para Viaccess, 0100 para Seca, etc.)

Ejemplo de servidor CCcam (fuente remota):

[reader]

Para servidor Newcamd:

[reader]

Crear usuarios y grupo de acceso

El archivo oscam.user define quién puede conectarse a OScam y qué acceso tiene a qué canales.

[user]

Significado de parámetros:

• user,pwd — nombre de usuario y contraseña
• group — grupos de acceso (deben coincidir con grupos en oscam.server)
• au — nivel de autorización (1 es usuario normal)
• iplimit — límite de conexiones desde diferentes direcciones IP (0 = ilimitado)
• maxconnections — número máximo de conexiones simultáneas para el usuario
• monlevel — acceso a monitoreo y registros (4 es acceso completo)

Configuración de registros y depuración

Los registros son tu mejor herramienta de diagnóstico. Establece el nivel de depuración en oscam.conf:

[global]

El nivel de debug 127 imprime información sobre EMM, ECM, conexiones y errores. Para producción puedes reducir a 0 o 16 (solo errores).

Asegúrate de que el directorio /var/log/oscam tiene los permisos correctos:

sudo chown oscam:oscam /var/log/oscam

Prueba de conexión y diagnóstico

Antes de ejecutar OScam en segundo plano como servicio, pruébalo en modo interactivo. De esta forma verás errores en tiempo real y ahorrarás tiempo en depuración.

Ejecutar OScam en modo debug

Ejecuta OScam con la opción -b (background disabled), lo que obligará a imprimir registros en la consola:

sudo -u oscam /usr/local/bin/oscam -c /etc/oscam/ -b

Las banderas significan:

• -c /etc/oscam/ — directorio de configuración
• -b — deshabilitar segundo plano (ejecutar en primer plano)

Si todo está bien, verás mensajes de inicio:

OScam 1.20 starting (pid: 12345)

Si aparece un error como "Port 9000 already in use", significa que otro proceso escucha en ese puerto. Cambia el puerto en oscam.conf o mata el proceso existente:

sudo lsof -i :9000<PID>

Verificación de registros en el archivo oscam.log

Cuando OScam esté ejecutándose, abre una segunda ventana de terminal y monitorea los registros en tiempo real:

sudo tail -f /var/log/oscam/oscam.log

Busca entradas que contengan:

• "EMM processed" — las tarjetas o servidores envían datos de autorización
• "ECM request" — los clientes solicitan descifrado
• "Successfully decoded" — el descifrado fue exitoso
• "Connection from" — un nuevo cliente se conectó

Ejemplo de registros correctos:

[2024-01-15 14:23:45] OScam started

Los errores pueden verse así:

[2024-01-15 14:23:45] ERROR: Cannot open reader device

Prueba de conexión desde cliente (netcat, telnet)

Para probar si el escuchador funciona correctamente, usa netcat:

nc -zv 127.0.0.1 1234

Si la conexión tiene éxito, verás "succeeded" o "Connection to 127.0.0.1 port 1234 [tcp/*] succeeded". Si falla, verifica si OScam realmente está escuchando:

sudo netstat -tlnp | grep oscam

Deberías ver líneas que contienen el puerto 1234 y 9000 con el proceso "oscam".

Monitoreo de recursos del sistema

Verifica el uso de recursos por OScam:

ps aux | grep oscam

Salida típica:

oscam 12345 0.5 2.3 128456 12345 ? Ss 14:23 0:05 /usr/local/bin/oscam -c /etc/oscam/

Las columnas significan: usuario, PID, %CPU, %MEM, memoria virtual, memoria física, hora de inicio. Si %CPU es consistentemente superior al 50%, algo no funciona correctamente (generalmente hardware débil o bucle infinito).

También verifica el límite de archivos abiertos:

sudo cat /proc/12345/limits | grep "open files"

Solución de problemas de inicio común

Si OScam no inicia, verifica estas cosas en orden:

Problema: "oscam: command not found" — El archivo binario no se encuentra en PATH. Verifica:

ls -la /usr/local/bin/oscam

Si el archivo existe, añade /usr/local/bin a PATH o ejecuta la ruta completa.

Problema: "Permission denied" al ejecutar — Los permisos del binario son demasiado restrictivos:

sudo chmod 755 /usr/local/bin/oscam

Problema: "Cannot open config directory" — El directorio /etc/oscam no existe o el usuario oscam no tiene acceso:

sudo mkdir -p /etc/oscam

Problema: "Port already in use" — El puerto de escucha está ocupado por otro proceso:

sudo lsof -i :9000<PID>

O cambia el puerto en oscam.conf.

Problema: "Failed to load SSL certificates" — Falta la biblioteca OpenSSL o está instalada una versión incorrecta:

ldd /usr/local/bin/oscam | grep ssl

Deberías ver "libssl.so" con versión. Si es "not found", instala libssl-dev y reconstruye OScam.

Problema: Los registros no aparecen en oscam.log — El directorio de registros no existe o no tiene permisos de escritura:

sudo mkdir -p /var/log/oscam

Después de arreglar cualquiera de estos problemas, intenta ejecutar OScam nuevamente en modo debug.

Crear servicio systemd e iniciar al arranque del sistema

Para que OScam se inicie automáticamente después del reinicio del sistema, crea una unidad systemd.

Crea el archivo /etc/systemd/system/oscam.service:

sudo tee /etc/systemd/system/oscam.service> /dev/null<<EOF

Habilita e inicia el servicio:

sudo systemctl daemon-reload

Verifica el estado:

sudo systemctl status oscam

Deberías ver "active (running)". Si OScam se bloquea, systemd lo reiniciará automáticamente después de 10 segundos (parámetro RestartSec).

Actualización y mantenimiento de OScam

OScam se actualiza regularmente. Para actualizar a la versión más reciente:

cd /opt/oscam/oscam

El comando `git pull` descarga los cambios más recientes del repositorio. `make clean` limpia objetos de compilación antiguos, lo que evita conflictos. Después de la reinstalación, systemctl reinicia OScam con la nueva versión.

Verifica la versión después de actualizar:

/usr/local/bin/oscam --version

Soporte de múltiples instancias de OScam en un sistema

Si deseas ejecutar varias instancias independientes de OScam (por ejemplo, para diferentes usuarios o configuraciones), debes cuidar el aislamiento de directorios de configuración y puertos.

Crea directorios separados:

sudo mkdir -p /etc/oscam-1 /etc/oscam-2

Cada instancia debe tener sus propios archivos oscam.conf con diferentes puertos:

# /etc/oscam-1/oscam.conf

Crea servicios systemd separados para cada instancia (oscam-1.service, oscam-2.service), cambiando la bandera `-c` al directorio de configuración correspondiente.