Configurazione OScam spiegata: reader, user e cosa fa ogni riga

Pubblicato agosto 2026

I file di configurazione di OScam sembrano intimidatori finché non scopri che solo due contano davvero. Cos'è un reader, cos'è un user e perché il numero di gruppo è quasi sempre il problema.

OScam ha fama di essere complicato, e non se lo merita davvero. Include diversi file di configurazione, ma su un ricevitore normale ne contano solo due: oscam.server, che dice da dove arriva la decodifica, e oscam.user, che dice chi può richiederla. Tutto il resto sono impostazioni globali che non tocchi mai o funzioni che non stai usando.

I due file, una frase ciascuno

Un reader in oscam.server è una connessione in uscita, la tua box che raggiunge un server. Un user in oscam.user è un permesso in entrata, la tua box che autorizza qualcuno a chiedere la decodifica. Su un singolo ricevitore sei entrambe le estremità: un reader verso il tuo fornitore, un user che rappresenta la tua stessa box.

È il modello mentale che sfugge a molti. Si modifica il reader, si legge CONNECTED nel log e non si capisce perché non decodifichi nulla. Il reader è solo metà della configurazione.

Il blocco reader

Apri il file. Il percorso dipende dall’immagine, quindi prova entrambi:

nano /usr/local/etc/oscam.server
# alcune immagini usano:
# nano /etc/tuxbox/config/oscam.server

Un reader che punta a una linea cccam.io ha questo aspetto:

[reader]
label                         = cccam_io
protocol                      = cccam
device                        = server1.cccam.io,12000
user                          = <nomeutente>
password                      = <password>
group                         = 1
audisabled                    = 1

I campi che vale la pena capire: protocol è come parla, device contiene hostname e porta insieme separati da una virgola invece che da uno spazio, e group è un numero che scegli tu. Il nostro generatore di reader OScam lo compila dalle tue credenziali se preferisci non scrivere a mano.

Il blocco user

Ora oscam.user, dove la maggior parte delle configurazioni sbaglia davvero:

[account]
user                          = local
pwd                           = local
group                         = 1

Il group qui deve corrispondere al group del reader. Quel singolo numero è il collegamento tra i due file. Se differiscono, OScam si connette al server, elenca i CAID, sembra perfettamente sano nel log e continua a non decodificare nulla, perché non considera quel reader disponibile per quell’utente.

Ricarica, poi guarda l’interfaccia web

OScam non ha bisogno di un riavvio della box. Ricaricalo al volo:

oscam -d 4096
# oppure riavvia il servizio softcam:
# /etc/init.d/softcam restart

Poi apri http://<ip-del-ricevitore>:8888. Questa è la parte che vale la pena imparare, perché l’interfaccia web ti dice la verità più in fretta di qualsiasi log. Il reader deve mostrare CONNECTED ed elencare i CAID. Sintonizza un canale criptato e guarda il tempo ECM: sotto i 500 ms è sano, e un valore che sale nelle ore di punta indica il server, non la tua box.

Quando aggiungere un secondo reader

Ogni linea che emettiamo include due hostname, quindi aggiungi il secondo come reader a sé, con le stesse credenziali e lo stesso gruppo. OScam ne userà uno e passerà all’altro quando un host è occupato, ed è questo che tiene su l’immagine durante un disservizio invece di farla congelare. Vale per qualsiasi fornitore: se ti hanno dato un solo hostname, non hai alcun failover, ed è uno degli aspetti da verificare prima di comprare.

Provalo sulla tua box

La configurazione qui sopra è tutto il lavoro, e la prima volta richiede circa dieci minuti. Se preferisci seguirla con una linea vera invece che con dei segnaposto, la nostra prova gratuita di 3 giorni ti dà credenziali che funzionano sia con CCcam sia con OScam, e la guida rapida OScam ripete gli stessi passaggi con i nostri hostname reali.