OSCam oscam.server Configuration File Explained for Beginners (2026)

If you've gotten OScam compiled and running, the web interface loads fine on port 8888, and then you open oscam.server and just stare at it — you're not alone. This is the oscam oscam.server configuration file explained for beginners, written for the exact moment you're in right now: readers showing OFF or CONNECTED-but-not-decoding, a block you copied from a forum thread that "should" work, and no idea which lines actually matter versus which ones OScam is quietly ignoring.

Ich habe diese Datei mehrmals von Grund auf neu erstellt, von einem Raspberry Pi, der einen Quellcode-Build ausführt, bis hin zu Enigma2-Boxen mit ihren seltsamen symlinkten Konfigurationsordnern. Die gute Nachricht: Sobald Sie verstehen, wofür jede Zeile tatsächlich gedacht ist, hört oscam.server auf, magisch zu sein. Dieser Leitfaden geht die Datei Zeile für Zeile durch, zeigt drei vollständig funktionierende Leserblöcke und — das ist der Teil, den die meisten Leitfäden überspringen — lehrt Sie, wie Sie die Statusspalte des Lesers lesen, damit Sie Ihre eigene Einrichtung diagnostizieren können, anstatt zu raten.

Was oscam.server tatsächlich tut (und was nicht)

Das größte Missverständnis, das ich bei neuen OScam-Nutzern sehe, ist, oscam.server als "die Konfigurationsdatei" zu behandeln. Das ist es nicht. OScam verteilt seine Konfiguration auf drei Dateien, und jede hat eine spezifische Aufgabe. Sie durcheinanderzubringen ist der Grund, warum die Hälfte der Setup-Leitfäden da draußen die Leute verwirrt — sie sagen Ihnen, Sie sollen eine Portnummer zu oscam.server hinzufügen, und es sitzt einfach da und tut nichts, weil Ports dort nicht leben.

Wo die Datei gespeichert ist

Bei einem Quellcode-Build ist es normalerweise /usr/local/etc/oscam.server. Bei Enigma2/Dreambox-Empfängern ist es typischerweise /etc/tuxbox/config/oscam.server, obwohl einige Images es unter /var/keys/ verstecken. Raten Sie nicht — überprüfen Sie die Statusseite der OScam-Weboberfläche, die das ConfigDir anzeigt, das OScam tatsächlich verwendet. Wenn Sie OScam mit dem -c-Flag gestartet haben (zum Beispiel oscam -c /etc/oscam/), überschreibt dieser Pfad alles andere, einschließlich jeder Datei, die sich am Standardstandort befindet.

Die Ein-Satz-Regel

oscam.server definiert Quellen der Entschlüsselung. oscam.user definiert Verbraucher der Entschlüsselung. Wenn Sie sich an nichts anderes aus diesem Artikel erinnern, denken Sie daran. Jedes Mal, wenn Sie versucht sind, etwas zu oscam.server hinzuzufügen, das sich nach "wer kann meinen Server nutzen" anhört, stoppen Sie — das ist der Job von oscam.user.

Wie ein Leserblock etwas Reales abbildet

Jeder [reader]-Block in oscam.server entspricht genau einer Sache: einer physischen Smartcard, die in einem USB-Leser sitzt, einem Netzwerkpeer, von dem Sie Schlüssel abrufen, oder einem lokalen Emulator wie CCcam-emu oder Newcamd-emu. Es ist eine 1:1-Abbildung. Wenn Sie zwei physische Karten haben, benötigen Sie zwei Leserblöcke. Wenn Sie eine CCcam-Zeile haben, ist das ein Block.

Die Datei lesen, die OScam tatsächlich geladen hat

Hier ist der Teil, der die Leute ständig verwirrt: OScam analysiert oscam.server beim Start und erneut, wenn Sie im Web-UI auf Neustart klicken — nicht, wenn Sie eine Textdatei über SSH speichern. Wenn es einen Syntaxfehler in einem Block gibt oder ein doppeltes Label, zeigt OScam kein Dialogfeld an oder schreibt einen lauten Fehler. Es lässt einfach diesen Block stillschweigend fallen. Der Leser wird einfach nicht existieren. Gehen Sie immer zu Konfiguration > Leser in der Web-UI nach einem Neustart und bestätigen Sie, dass der von Ihnen eingegebene Lesername tatsächlich aufgeführt ist. Wenn er fehlt, wurde der Block nie analysiert — Punkt, verschwenden Sie keine Zeit mit der Fehlersuche im Netzwerk für einen Leser, den OScam nie geladen hat.

Anatomie eines Leserblocks: Jede Zeile, was sie tut, wann man sie weglassen kann

Das ist der Teil, den jeder tatsächlich braucht, also lassen Sie uns von nichts aufbauen. Hier ist ein minimal funktionierender newcamd-Leserblock — sechs Zeilen, nichts Aufwendiges:

[reader]

Das reicht wirklich aus, um einen newcamd-Leser zu verbinden. Jetzt hier ist ein vollständigerer Block mit den Parametern, über die die Leute tatsächlich in Foren streiten:

[reader]

Jetzt lassen Sie uns durchgehen, was jede Zeile tatsächlich tut, und — noch wichtiger — wann es sicher ist, sie wegzulassen.

label

Der interne Name für diesen Leser. Er erscheint in der Web-UI, in Ihren Protokollen, und es ist das, worauf oscam.user indirekt über Gruppennummern verweist. Er muss im gesamten Datei einzigartig sein — doppelte Labels führen dazu, dass ein Block stillschweigend überschrieben oder fallen gelassen wird, und das Symptom ist ein Leser, der einfach im Reiter "Leser" fehlt, ohne Erklärung. Halten Sie ihn kurz, vermeiden Sie Leerzeichen, wenn Sie können, und wählen Sie etwas, das Sie in sechs Monaten wiedererkennen.

protocol

Sagt OScam, um welche Art von Quelle es sich handelt: cccam, camd35, cs378x, newcamd, intern (für lokale Emulation) oder mouse / smartreader für eine physische Karte in einem USB-Leser. Diese Zeile ist obligatorisch und muss mit dem übereinstimmen, was tatsächlich am anderen Ende ist — ein cccam-Server wird auf keinen newcamd-Handshake antworten, egal wie korrekt der Rest Ihres Blocks ist.

device

Diese eine Zeile bedeutet zwei völlig unterschiedliche Dinge, abhängig vom Protokoll. Für eine physische Karte ist es ein serieller Pfad wie /dev/ttyUSB0 oder /dev/sci0. Für jedes Netzwerkprotokoll (newcamd, cccam, camd35, cs378x) ist es host,port — zum Beispiel server.example.net,12000. Diese durcheinanderzubringen ist ein klassischer Copy-Paste-Fehler: einen seriellen Gerätepfad in einen Netzwerkleserblock einzufügen oder umgekehrt, führt nur dazu, dass der Leser in einer Verbindungs-Schleife feststeckt.

user / password

Anmeldeinformationen für den Zugriff auf die entfernte Quelle. Diese stammen von dem, der diese Quelle betreibt — sie sind nicht Ihr OScam-Web-UI-Login, und sie sind auch nicht die Anmeldeinformationen in Ihrer oscam.user-Datei. Drei separate Satz von Anmeldeinformationen, drei separate Zwecke. Diese zu verwechseln ist äußerst häufig und führt zu einer sofortigen Anmeldeablehnung.

group

Dies ist die am häufigsten missverstandene Zeile in der gesamten Datei, und sie ist die direkte Verbindung zwischen oscam.server und oscam.user. group ist eine durch Kommas getrennte Liste von Ganzzahlen — group = 1 oder group = 1,3,7. Ein Leser in Gruppe 1 wird nur Clients bedienen, deren Gruppenzeile in oscam.user ebenfalls 1 enthält. Wenn Ihr Leser group=2 ist und Ihr Testclient group=1 ist, kann der Leser vollständig VERBUNDEN und gesund sein, und Ihr Client erhält genau null ECMs von ihm, für immer. Diese Diskrepanz ist die häufigste Ursache für "Leser ist verbunden, aber nichts dekodiert", und sie wird selten anderswo richtig erklärt.

caid, ident, chid, boxid

Betrachten Sie diese als Whitelist-Filter. Lassen Sie sie leer und OScam fragt den Leser nach den CAIDs, die der Leser selbst meldet. Füllen Sie caid = 1802 aus und Sie sagen OScam "fragen Sie diesen Leser nur nach CAID 1802" — alles andere wird ignoriert, selbst wenn der Leser es technisch hat. Dies ist nützlich, um unnötigen ECM-Verkehr zu reduzieren und das Lastenausgleichssystem sinnvoll zu halten, aber ein falsch geschriebenes CAID-Wert erzeugt einen Leser, der sich gut verbindet und einfach nie eine einzige ECM-Anfrage erhält, was genau wie ein Netzwerkproblem aussieht, aber keines ist. ident schränkt weiter auf spezifische Anbieter-IDs innerhalb eines CAID ein, chid auf spezifische Kanal-IDs, und boxid verbindet einen Netzwerkleser mit einer spezifischen Box-ID, die einige Anbieter benötigen. Lassen Sie all dies leer, wenn Sie zuerst einen Leser zum Laufen bringen, und schränken Sie sie dann ein, sobald er als funktional bestätigt ist.

cccversion, cccmaxhops, ccckeepalive, cccwantemu

Diese gelten nur für protocol=cccam und OScam ignoriert sie vollständig für jedes andere Protokoll. cccversion legt die CCcam-Protokollversionszeichenfolge fest, die Ihr Leser ankündigt (2.3.0 ist üblich). cccmaxhops begrenzt, wie viele Links entfernt eine Karte sein kann und trotzdem zählt — mehr dazu im unten stehenden Beispiel. ccckeepalive hält die TCP-Sitzung mit periodischen Pings am Leben, damit sie nicht stillschweigend abläuft. cccwantemu sagt dem Peer, ob Sie bereit sind, emulierte (nicht-Karten-) Quellen über diesen Link zu akzeptieren.

inactivitytimeout, reconnecttimeout, lb_weight, fallback, disablecrccws

Die Abstimmungszeilen. inactivitytimeout (Sekunden) trennt und verbindet einen Leser erneut, der still geworden ist — nützlich für fehlerhafte Netzwerkquellen. reconnecttimeout steuert die Verzögerung, bevor eine fehlgeschlagene Verbindung erneut versucht wird; erhöhen Sie dies, wenn das Netzwerk Ihrer Box eine Weile braucht, um nach dem Booten online zu kommen. lb_weight beeinflusst, wie OScams Lastenausgleich diesen Leser im Vergleich zu anderen, die denselben CAID bedienen, priorisiert — höheres Gewicht bedeutet, dass er häufiger ausgewählt wird, vorausgesetzt, Ihr Lastenausgleich ist in oscam.conf aktiviert. fallback = 1 markiert einen Leser als letzte Möglichkeit, der nur verwendet wird, wenn Ihre primären Leser nicht antworten können. disablecrccws unterdrückt eine spezifische CRC-basierte Kartentausch-Erkennung, die einige Setups nicht benötigen.

Parameter, die nur für physische Karten gelten

mhz und cardmhz legen die Taktrate fest, die OScam verwendet, um mit einer physischen Smartcard zu kommunizieren — typische Werte sind 357/357 oder 600/357, abhängig von der Karte und der Leserhardware. detect steuert, wie OScam das Einsetzen/Entfernen von Karten bei einigen Leserhardware erkennt. readnano ist für spezifische Kartentypen, die eine zusätzliche ATR-Verarbeitung benötigen. Keiner dieser Parameter hat Auswirkungen auf ein Netzwerkprotokoll. Ich sehe immer noch in Foren gepostete cccam- und newcamd-Blöcke mit mhz=368 — es ist harmlos, aber es ist totes Gewicht, und es sagt Ihnen, dass die Person, die den Beitrag verfasst hat, nicht vollständig verstanden hat, was sie gepostet hat.

Drei Leserblöcke, vollständig bearbeitet

Die Theorie ist gut, aber Sie sind hierher gekommen, um einen funktionierenden Block zu schreiben. Hier sind drei, die die Setups abdecken, die die Leute tatsächlich verwenden.

Eine lokale Smartcard in einem USB-Leser

Zuerst finden Sie den tatsächlichen Gerätepfad — raten Sie nicht. Führen Siedmesg | grep tty direkt nach dem Anschließen des Lesers aus oder überprüfen Siels /dev/serial/by-id/ auf einen beständigen Namen, der Neustarts übersteht (die USB-Aufzählungsreihenfolge kann /dev/ttyUSB0 nach einem Neustart auf /dev/ttyUSB1 verschieben, was einen fest codierten Pfad stillschweigend unterbricht).

[reader]

Einige Phoenix-Stil-Leser verwenden stattdessen /dev/sci0, und ältere serielle Leser erscheinen als /dev/ttyS0. Wenn die Karte erkannt wird, Sie aber intermittierende NEEDINIT erhalten, liegt das sehr oft am mhz/cardmhz-Paar, nicht an einem Netzwerk- oder Konfigurationsproblem — versuchen Sie 600/357, bevor Sie annehmen, dass die Karte oder der Leser fehlerhaft ist.

Ein Netzwerkleser über newcamd

[reader]

Die Schlüsselzeile ist ein 14-Byte-DES-Schlüssel, der Ihnen von demjenigen gegeben wird, der die Quelle betreibt — es ist nichts, was Sie sich ausdenken. Beachten Sie, dass caid hier ausdrücklich festgelegt ist, anstatt leer gelassen zu werden; das ist keine optionale Konvention, sondern weil das newcamd-Protokoll im Allgemeinen einen CAID pro Port überträgt, erwartet die Quelle, dass Sie deklarieren, für welchen Sie sich verbinden.

Ein Netzwerkleser über cccam

[reader]

cccmaxhops = 2 bedeutet, dass Sie Karten bis zu zwei Links entfernt akzeptieren: Hop 1 ist die lokale Karte des Peers, Hop 2 ist eine Karte, die dieser Peer selbst von jemand anderem teilt. Dies auf 5 zu erhöhen, produziert nicht magisch mehr Karten — es erweitert nur, was Sie bereit sind zu akzeptieren, weiter unten in der Kette, und entfernte Karten bedeuten tendenziell langsamere, weniger zuverlässige ECM-Antworten. Beginnen Sie mit 1 oder 2. Wenn Ihre ECM-Zeiten schlecht sind, senken Sie die Zahl, anstatt sie zu erhöhen.

Ein cs378x-Leser zwischen zwei OScam-Boxen in Ihrem LAN

Wenn Sie zwei OScam-Installationen verknüpfen, die Sie kontrollieren, verwenden Sie cs378x anstelle von camd35 — es ist verschlüsselt, kostet Sie nichts an Leistung, und es gibt keinen Grund, die unverschlüsselte Variante in Ihrem eigenen Netzwerk im Jahr 2026 zu betreiben.

[reader]

Und die passende Seite in der upstream-Box oscam.user, damit Sie die Gruppenzuordnung von Ende zu Ende sehen können:

[account]

Beachten Sie, dass group = 2 auf beiden Seiten erscheint. Das ist der ganze Trick — ohne dieses Match kann die Verbindung auf TCP-/Login-Ebene erfolgreich sein und trotzdem niemals einen einzigen Schlüssel übermitteln.

Lesen des Leserstatus: Was CONNECTED, OFF und NEEDINIT Ihnen sagen

Hier hört die Konfigurationsdatei auf, abstrakt zu sein, und beginnt, debugbar zu sein. Die Statusspalte im Web-UI-Tab "Reader" ist ein diagnostisches Instrument, wenn Sie wissen, wie man sie liest.

OFF

Entweder ist enable=0 im Block gesetzt, oder — viel häufiger bei Anfängern — der Block wurde überhaupt nicht geparst. Gehen Sie zurück und bestätigen Sie, dass der Leser tatsächlich mit dem erwarteten Label erscheint. Wenn er völlig fehlt, haben Sie einen Syntaxfehler oder ein doppeltes Label, nicht ein Verbindungsproblem.

CONNECTING oder NEEDINIT, Schleife

Der Block wurde geparst, aber der Handshake wird nicht abgeschlossen. Dies ist fast immer der falsche Port, das falsche Protokollschlüsselwort oder falsche Anmeldeinformationen. Überprüfen Sie device= gegen protocol= — eine newcamd-Gerätelinie, die auf einen cccam-Port zeigt, wird hier für immer in einer Schleife bleiben.

CONNECTED, aber null ECMs gesendet

Dies ist der Fall "verbunden, aber nicht dekodierend", den jeder irgendwann erreicht. CONNECTED bestätigt nur, dass die TCP-Sitzung und der Login erfolgreich waren — es sagt nichts darüber aus, ob der Leser tatsächlich nach etwas gefragt wird. Überprüfen Sie der Reihe nach: erscheint der Gruppenwert des Lesers in der Gruppenzeile Ihres Clients in oscam.user, filtert eine caid/ident-Zeile stillschweigend den Kanal, den Sie testen, und enthält die Kartenliste des Lesers tatsächlich diesen CAID/Anbieter überhaupt?

CONNECTED, ECMs gesendet, alle "nicht gefunden"

Völlig anderes Problem — das bedeutet, dass die Anfrage den Leser korrekt erreicht und er ehrlich antwortet, dass er diesen speziellen Schlüssel nicht hat. An diesem Punkt fehlt der Quelle tatsächlich der CAID oder Anbieter, den Sie testen; keine Konfigurationsänderung auf Ihrer Seite behebt das.

Verfolgen Sie Ihr Protokoll mit etwas wietail -f /tmp/oscam.log | grep myreader1 (der Protokollstandort selbst stammt von logfile= in oscam.conf, nicht oscam.server) und beobachten Sie die gesendeten / gefundenen / nicht gefundenen / Timeout-Zähler auf dem Leser, während Sie einen Kanal einstellen. Ein gesendeter Zähler, der sich nie bewegt, bedeutet, dass die Anfrage Ihre Box nie verlassen hat — das ist ein Routing-/Gruppen-/Filterproblem. Ein gesendeter Zähler, der steigt, während gefunden bei null bleibt, bedeutet, dass die Quelle es nicht hat. Zwei völlig unterschiedliche Lösungen, und die Zähler sind das einzige, was sie unterscheidet.

Sicheres Bearbeiten: Syntaxregeln, Neuladevorgänge und Backups

Einige Gewohnheiten werden Ihnen hier echte Zeit sparen. Kommentare beginnen mit #, und bei einigen Builds wird ein Inline-Kommentar nach einem Wert in derselben Zeile nicht berücksichtigt — setzen Sie Kommentare zur Sicherheit in eine eigene Zeile. Leerzeichen und Groß-/Kleinschreibung sind wichtiger als die Leute erwarten: protocol=cccam funktioniert überall, aber protocol = cccam mit Leerzeichen um das Gleichheitszeichen schlägt bei einigen älteren Builds fehl. Im Zweifelsfall die Leerzeichen weglassen.

Neustart liest die gesamte Konfiguration von der Festplatte neu, einschließlich oscam.server. Neuladen (wo verfügbar) ist leichter und liest einen engeren Satz von Einstellungen neu — wenn Sie sich nicht sicher sind, welche Ihre Änderung übernommen hat, verwenden Sie Neustart und überprüfen Sie die Registerkarte Leser.

Hier ist das, was die Leute verbrennt: die OScam-Weboberfläche kann, wenn Sie eine beliebige Konfigurationsseite speichern, oscam.server aus ihrem eigenen In-Memory-Modell neu schreiben. Dieses Umschreiben entfernt Kommentare und lässt jeden Parameter weg, den Ihre spezielle Version nicht erkennt. Halten Sie also ein Backup außerhalb des Konfigurationsverzeichnisses — cp oscam.server oscam.server.bak — bevor Sie irgendetwas im Webeditor anfassen. Wenn Sie sich auf Kommentare verlassen, um sich zu erinnern, was ein Block tut, bearbeiten Sie stattdessen über SSH und nicht über die Registerkarte Dateien.

Achten Sie speziell bei Enigma2/Dreambox-Images auf symlinkte oder schreibgeschützte Konfigurationsverzeichnisse. Änderungen über die Web-UI können gut gespeichert erscheinen und sich nach einem Neustart zurücksetzen, weil die echte Datei, die OScam liest, woanders lebt — /etc/tuxbox/config versus /usr/keys ist ein häufiges Missverhältnis bei diesen Images. Überprüfen Sie das ConfigDir auf der Statusseite erneut, wenn Änderungen nicht bestehen bleiben.

Letzte Sache: Nicht jeder Parameter existiert in jedem OScam-Build. Führen Sie oscam -V aus, um Ihre Build-Informationen zu sehen, und überprüfen Sie die README, die mit Ihrer speziellen Quelle geliefert wurde, anstatt einem Parameter zu vertrauen, den Sie in einem fünf Jahre alten Forenbeitrag gefunden haben. Unbekannte Parameter werden nicht laut abgelehnt — sie werden normalerweise einfach ignoriert, was genau der Grund ist, warum kopierte Blöcke mit zusätzlichen Zeilen "funktionieren", während diese zusätzlichen Zeilen absolut nichts tun.

Wählen einer Leserquelle, ohne verbrannt zu werden

Es ist wert, direkt darüber zu sein: Der legitime Zweck von OScam besteht darin, jemandem mit einer gültigen Abokarte zu ermöglichen, diese über seine eigenen Geräte in seinem eigenen Netzwerk zu nutzen — seine eigene Karte von einer kopflosen Box im Schrank zu lesen, anstatt einen Receiver direkt an den Fernseher anzuschließen. Das Teilen eines Abonnements außerhalb Ihres eigenen Haushalts verstößt gegen die Bedingungen von praktisch jedem Anbieter und ist in vielen Rechtsordnungen illegal. Dieser Leitfaden handelt vom Verständnis der Konfigurationsdatei, nicht davon, Zugang zu erhalten, auf den Sie keinen Anspruch haben.

Wenn Sie eine Netzwerkleserquelle für Ihr eigenes legales Abonnement bewerten, beurteilen Sie sie nach messbaren Dingen und nicht nach Versprechungen. Eine angemessene ECM-Antwortzeit liegt bei einem gesunden Link weit unter einer Sekunde — wenn Sie konstant mehrere Sekunden sehen, stimmt etwas nicht upstream. Die Hop-Anzahl ist wichtig, wie oben behandelt: Eine Quelle, die auf cccmaxhops von 5 oder mehr besteht, um "alles zu bekommen", fordert Sie auf, entfernte, unzuverlässige Karten zu akzeptieren, anstatt ihre eigene Einrichtung zu reparieren. Die CAID-Abdeckung sollte spezifisch und überprüfbar sein, nicht eine vage "alles"-Behauptung.

Warnsignale, von denen es sich lohnt, sich zu entfernen: eine CAID-Liste, die unrealistisch breit ist für das, was ein oder zwei Abokarten sein sollten, keine Bereitschaft, Ihnen zu erlauben, vor einer Verpflichtung zu testen, oder jeglicher Druck, das Logging zu deaktivieren oder zu verbergen, mit was Sie sich verbinden. Und verwenden Sie niemals denselben Benutzernamen und dasselbe Passwort über mehrere Quellen hinweg — behandeln Sie jedes Set von Leseranmeldeinformationen als eigenes isoliertes Login, so wie Sie es mit jedem anderen Konto tun würden.