OScam come installare - Guida completa all'installazione

Se stai cercando un modo peroscam come installare sul tuo sistema, sei nel posto giusto. L'installazione di OScam è un processo che richiede alcuni passaggi, ma con la giusta guida ti porterà via al massimo un'ora. Questo articolo ti guida attraverso la compilazione dai sorgenti, la configurazione e il test — tutto quello che devi sapere per eseguire OScam su Linux.

Prima di iniziare, dovresti avere accesso a un server o router con sistema Linux (Debian, Ubuntu, OpenWrt, Alpine) e conoscenze di base della riga di comando. Il processo è ripetibile, quindi anche se sei nuovo in questo campo, le istruzioni passo dopo passo funzioneranno senza problemi.

Che cos'è OScam e perché sceglierlo

OScam è un emulatore di schede open-source, scritto in C, successivamente adattato per funzionare con sistemi di cardsharing. Il suo principale vantaggio è la leggerezza — consuma poche risorse della CPU e della RAM, rendendolo la soluzione ideale per router, box satellitari e server con potenza di calcolo limitata.

Nell'ecosistema del cardsharingoscam come installare sul proprio sistema è una delle prime domande che si pongono gli utenti. OScam supporta i protocolli CCcam, Newcamd, Gbox e altri, offrendo grande flessibilità nella scelta delle fonti di accesso ai contenuti.

OScam rispetto ad altri software CAM

OScam si distingue dalla concorrenza per alcune caratteristiche. In primo luogo, è leggero — su un vecchio router ARM occupa circa 2-3 MB di memoria. In secondo luogo, il codice sorgente è disponibile per l'ispezione e la modifica, il che ti dà il controllo.

Altro software CAM può essere più ingombrante o difficile da configurare per i principianti. OScam ha una documentazione decente e un forum comunitario attivo, anche se devi sapere dove cercarlo senza affidarti a pacchetti preconfezionati.

Requisiti di sistema e dipendenze

OScam funziona sulla maggior parte delle architetture Linux. Supportate sono ARM (32 e 64-bit), x86_64, MIPS e altre. I requisiti minimi sono:

• Processore: ARM Cortex-A7 o più veloce, o equivalente x86
• RAM: 64 MB minimo, 256 MB consigliati
• Disco: 50 MB per l'installazione + spazio per i log (100-200 MB)
• Sistema: Linux con gcc, make, git

Importante: OScam richiede librerie crittografiche (OpenSSL) e opzionalmente librerie PCSC per i lettori di schede. Senza queste dipendenze la compilazione fallirà.

Dove scaricare i sorgenti di OScam

Le fonti ufficiali di OScam si trovano nel repository git. Non scaricare OScam da siti casuali — aggancia sempre i sorgenti da un repository affidabile che puoi ispezionare tu stesso.

Il repository è disponibile pubblicamente e contiene la cronologia completa dei cambiamenti dalla versione 1.0. Prima di scaricare, verifica che la versione che stai scaricando non sia modificata in modo non ufficiale — è meglio clonare direttamente dalla fonte.

Preparazione dell'ambiente per l'installazione

Prima di iniziare a compilare OScam, devi preparare il sistema. Non ci vorrà molto tempo, ma saltare uno qualsiasi di questi passaggi causerà errori di compilazione.

Aggiornamento del sistema e del gestore pacchetti

Su sistemi Debian/Ubuntu:

sudo apt-get update

Su OpenWrt:

opkg update

Questo aggiornamento adatta gli elenchi dei pacchetti alle versioni più recenti disponibili nei repository. Successivamente, installa gli strumenti di compilazione necessari.

Installazione del compilatore e delle librerie richieste

Questo è il passaggio critico. Senza questi pacchetti non potrai compilare OScam.

Su Debian/Ubuntu (tutte le distribuzioni basate su apt):

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

Se intendi supportare funzionalità avanzate (LCD, lettori di schede), aggiungi:

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

Su OpenWrt (dove i pacchetti sono più piccoli):

opkg install build-essential git libssl libpcsclite-dev

Verifica che il compilatore GCC si sia installato correttamente:

gcc --version

Dovresti vedere la versione di GCC (ad es. gcc version 10.2.1). Se appare "command not found", qualcosa è andato male — torna al passaggio di installazione di build-essential.

Verifica dello spazio disponibile su disco

OScam occupa poco spazio nella forma finale, ma il processo di compilazione crea file temporanei. Consiglio un minimo di 200 MB di spazio libero.

df -h /

Se vedi meno di 200 MB di spazio libero, ripulisci i vecchi pacchetti o i log prima dell'installazione:

sudo apt-get clean

Preparazione della directory di installazione

Crea una directory in cui scaricare e compilare OScam. Di solito è /opt o /usr/local/src:

sudo mkdir -p /opt/oscam

Cambiando la proprietà non dovrai usare sudo durante la clonazione del repository. Questo elimina i problemi di permessi dei file.

Download, compilazione e installazione di OScam

Qui inizia il lavoro vero. Capire ogni passaggio ti aiuterà a risolvere i problemi se si presentano.Oscam come installare correttamente dipende dall'esecuzione corretta di questi comandi nell'ordine esatto.

Clonazione del repository da git

Scarica i sorgenti più recenti di OScam dal repository ufficiale:

cd /opt/oscam

Il processo di clonazione scarica tutti i file sorgente (solitamente circa 50 MB). Al termine, verifica che la directory oscam contenga il file configure e Makefile:

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

Se i file esistono, sei pronto per il passaggio successivo. Se no — assicurati che git si sia installato senza errori.

Configurazione delle opzioni di compilazione (./configure)

Questo è il momento in cui decidi quali funzionalità devono essere compilate in OScam. Diversi flag ./configure abilitano o disabilitano il supporto per diverse funzionalità.

Configurazione minima con supporto SSL e protocolli di rete:

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

Configurazione completa (con supporto per lettori PCSC e funzionalità avanzate):

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

I flag significano:

• --prefix=/usr/local — posizione di installazione dei binari
• --enable-ssl — supporto per la crittografia SSL/TLS
• --enable-cccam — protocollo CCcam
• --enable-newcamd — protocollo Newcamd
• --enable-pcsc — supporto per lettori di schede Smart Card PC/SC
• --enable-dvbapi — interfaccia DVB-API per schede sintonizzatore

Lo script configure controllerà prima la disponibilità delle librerie. Se manca libssl-dev, vedrai un errore come "checking for OpenSSL... not found". Non ignorare questi errori — torna alla sezione di preparazione e installa i pacchetti mancanti.

Se la configurazione ha successo, vedrai un riepilogo alla fine:

OScam version x.xx configured successfully

Compilazione con make e make install

La compilazione è il processo che trasforma il codice sorgente (C) in un file binario eseguibile. Può richiedere da decine di secondi a pochi minuti a seconda della potenza del processore.

make -j4

Il flag `-j4` significa compilare su 4 core contemporaneamente (se hai più core, aumenta il numero per accelerare). Su sistemi più vecchi prova `-j2` o senza flag.

Attendi finché non vedi il messaggio di compilazione completata. Di solito è un messaggio contenente "oscam" e la dimensione in byte (ad es. "oscam (27 MB)"). Se appare un errore, leggilo — solitamente indica quale pacchetto manca.

Dopo la compilazione riuscita, installa il file binario:

sudo make install

Questo comando copia il file oscam a /usr/local/bin/oscam e crea le directory di configurazione necessarie.

Verifica della correttezza dell'installazione

Verifica che OScam si sia installato correttamente:

/usr/local/bin/oscam --version

Dovresti vedere il numero di versione, il numero di build (SVN/GIT), la data di compilazione e l'elenco delle funzionalità abilitate. Esempio:

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

Se l'output mostra versione e funzionalità — tutto è a posto. Se appare "command not found" — verifica che il percorso /usr/local/bin sia nella variabile PATH:

echo $PATH

Dovresti vedere /usr/local/bin nell'elenco. Se non c'è, aggiungilo:

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

Impostazione dei permessi e della proprietà dei file

OScam deve funzionare con i permessi appropriati. Se lo esegui come utente normale (non root), devi cambiare la proprietà a un utente specifico:

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

Crea le directory di configurazione con la proprietà corretta:

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

Se intendi accedere a un lettore di schede PCSC, aggiungi l'utente oscam al gruppo scard:

sudo usermod -aG scard oscam

Configurazione dei file oscam.conf, oscam.server e oscam.user

Ora è il momento di "insegnare" a OScam come lavorare. La configurazione è il cuore di tutta l'installazione.Oscam come installare è una cosa, ma senza la giusta configurazione rimarrà un file binario inutile.

Struttura e posizione dei file di configurazione

OScam cerca per impostazione predefinita i file di configurazione in /etc/oscam/. I file principali sono:

• oscam.conf — configurazione principale (porte, protocolli, registrazione)
• oscam.server — definizioni di fonti (schede, server CCcam/Newcamd)
• oscam.user — utenti e gruppi di accesso
• oscam.dvbapi — configurazione dell'interfaccia DVB-API (opzionale)

Crea questi file, se non esistono:

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

Configurazione del listener (porta, protocollo, crittografia)

Un listener è la parte di OScam che ascolta su una porta e un protocollo specifici, in attesa di connessioni dai client. La configurazione del listener in oscam.conf si presenta così:

[global]

Spiegazione dei parametri:

• logfile — percorso del file di registro
• debug — livello di debug (0-255, dove 0 è disabilitato)
• port nella sezione [newcamd] — porta di ascolto per il protocollo Newcamd (predefinito 1234)
• key — chiave di decrittazione per la comunicazione Newcamd (16 byte in esadecimale)
• users — elenco di utenti con accesso a questo listener

Per il protocollo CCcam aggiungi una sezione:

[cccam]

Parametri di CCcam:

• version — versione del protocollo CCcam (2.2.1 è uno standard popolare)
• nodeid — identificatore di nodo a 20 byte (in esadecimale)
• reshare — quanti livelli di reshare consenti (2 significa condividere con un'altra persona)

Aggiunta di fonti (reader) - schede, server

La sezione [reader] in oscam.server definisce da dove OScam deve ottenere i dati — da una scheda fisica o da un server remoto.

Esempio di lettore di scheda fisica (PCSC):

[reader]

Parametri:

• label — nome del lettore (per i log e i rapporti)
• protocol — tipo di protocollo (pcsc per i lettori di Smart Card, dvbapi per i sintonizzatori DVB)
• device — numero del dispositivo (0 per il primo lettore, 1 per il secondo, ecc.)
• group — numero di gruppo (deve corrispondere al gruppo in oscam.user)
• caid — identificatori CAID della scheda (0500 per Viaccess, 0100 per Seca, ecc.)

Esempio di server CCcam (fonte remota):

[reader]

Per un server Newcamd:

[reader]

Creazione di utenti e gruppo di accesso

Il file oscam.user definisce chi può connettersi a OScam e a quale accesso ha diritto per quali canali.

[user]

Significato dei parametri:

• user,pwd — login e password
• group — gruppi di accesso (devono corrispondere ai gruppi in oscam.server)
• au — livello di autorizzazione (1 è un utente normale)
• iplimit — limite di connessioni da diversi indirizzi IP (0 = illimitato)
• maxconnections — numero massimo di connessioni simultanee per l'utente
• monlevel — accesso al monitoraggio e ai log (4 è accesso completo)

Configurazione dei log e del debug

I log sono il vostro miglior strumento diagnostico. Imposta il livello di debug in oscam.conf:

[global]

Il livello di debug 127 stampa informazioni su EMM, ECM, connessioni e errori. Per la produzione puoi ridurlo a 0 o 16 (solo errori).

Assicurati che la directory /var/log/oscam abbia i permessi corretti:

sudo chown oscam:oscam /var/log/oscam

Test della connessione e diagnostica

Prima di eseguire OScam in background come servizio, testalo in modalità interattiva. In questo modo vedrai gli errori in tempo reale e risparmierai tempo nel debugging.

Esecuzione di OScam in modalità debug

Esegui OScam con l'opzione -b (background disabilitato), che forza la stampa dei log sulla console:

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

I flag significano:

• -c /etc/oscam/ — directory di configurazione
• -b — disabilita lo sfondo (esecuzione in primo piano)

Se tutto è a posto, vedrai i messaggi di avvio:

OScam 1.20 starting (pid: 12345)

Se appare un errore come "Port 9000 already in use", significa che un altro processo sta ascoltando su quella porta. Cambia la porta in oscam.conf o termina il processo esistente:

sudo lsof -i :9000<PID>

Verifica dei log nel file oscam.log

Quando OScam è in esecuzione, apri una seconda finestra del terminale e monitora i log in tempo reale:

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

Cerca le voci contenenti:

• "EMM processed" — schede o server inviano dati di autorizzazione
• "ECM request" — i client chiedono la decrittazione
• "Successfully decoded" — la decrittazione è andata a buon fine
• "Connection from" — un nuovo client si è connesso

Esempio di log corretti:

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

Gli errori possono apparire così:

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

Test di connessione dal client (netcat, telnet)

Per verificare se il listener sta ascoltando correttamente, usa netcat:

nc -zv 127.0.0.1 1234

Se la connessione ha successo, vedrai "succeeded" o "Connection to 127.0.0.1 port 1234 [tcp/*] succeeded". Se non ha successo, verifica se OScam sta effettivamente ascoltando:

sudo netstat -tlnp | grep oscam

Dovresti vedere le righe contenenti la porta 1234 e 9000 con il processo "oscam".

Monitoraggio delle risorse di sistema

Verifica l'utilizzo delle risorse da parte di OScam:

ps aux | grep oscam

Output tipico:

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

Le colonne significano: utente, PID, %CPU, %MEM, memoria virtuale, memoria fisica, ora di avvio. Se %CPU è costantemente superiore al 50%, qualcosa non funziona correttamente (di solito hardware scarso o loop infinito).

Verifica anche il limite del numero di file aperti:

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

Risoluzione dei problemi di avvio comuni

Se OScam non si avvia, controlla queste cose in ordine:

Problema: "oscam: command not found" — Il file binario non si trova in PATH. Verifica:

ls -la /usr/local/bin/oscam

Se il file esiste, aggiungi /usr/local/bin a PATH o esegui il percorso completo.

Problema: "Permission denied" durante l'esecuzione — I permessi del binario sono troppo restrittivi:

sudo chmod 755 /usr/local/bin/oscam

Problema: "Cannot open config directory" — La directory /etc/oscam non esiste o l'utente oscam non ha accesso:

sudo mkdir -p /etc/oscam

Problema: "Port already in use" — La porta di ascolto è occupata da un altro processo:

sudo lsof -i :9000<PID>

Oppure cambia la porta in oscam.conf.

Problema: "Failed to load SSL certificates" — Manca la libreria OpenSSL o è installata la versione sbagliata:

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

Dovresti vedere "libssl.so" con una versione. Se è "not found", installa libssl-dev e ricompila OScam.

Problema: I log non vengono visualizzati in oscam.log — La directory dei log non esiste o non ha permessi di scrittura:

sudo mkdir -p /var/log/oscam

Dopo aver risolto uno di questi problemi, prova a eseguire OScam di nuovo in modalità debug.

Creazione di un servizio systemd e avvio all'avvio del sistema

Affinché OScam si avvii automaticamente dopo il riavvio del sistema, crea un'unità systemd.

Crea il file /etc/systemd/system/oscam.service:

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

Abilita e avvia il servizio:

sudo systemctl daemon-reload

Verifica lo stato:

sudo systemctl status oscam

Dovresti vedere "active (running)". Se OScam si arresta in modo anomalo, systemd lo riavvierà automaticamente dopo 10 secondi (parametro RestartSec).

Aggiornamento e manutenzione di OScam

OScam viene aggiornato regolarmente. Per aggiornare alla versione più recente:

cd /opt/oscam/oscam

Il comando `git pull` scarica gli ultimi cambiamenti dal repository. `make clean` cancella i vecchi oggetti di compilazione, prevenendo i conflitti. Dopo la reinstallazione, systemctl riavvia OScam con la nuova versione.

Verifica la versione dopo l'aggiornamento:

/usr/local/bin/oscam --version

Supporto di più istanze di OScam su un singolo sistema

Se desideri eseguire più istanze indipendenti di OScam (ad es. per utenti diversi o configurazioni), devi prenderti cura dell'isolamento delle directory di configurazione e delle porte.

Crea directory separate:

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

Ogni istanza deve avere i propri file oscam.conf con porte diverse:

# /etc/oscam-1/oscam.conf

Crea servizi systemd separati per ogni istanza (oscam-1.service, oscam-2.service), cambiando il flag `-c` nella directory di configurazione appropriata.