Beste OScam-Konfigurationsanleitung: Optimale Einrichtung 2026

Wenn Sie OScam kompiliert und am Laufen haben, aber immer noch ECM-Zeiten von über 1500 ms beobachten oder ein Kanal jedes Mal für zwei Sekunden einfriert, wenn Sie umschalten, war das Binary nie das Problem. Die Konfiguration war es. Ich habe im Laufe der Jahre mehr oscam.conf-Dateien neu erstellt, als ich zählen kann, und fast jedes "es ist kaputt"-Ticket lässt sich auf dieselbe Handvoll falsch konfigurierte Werte zurückverfolgen. Diese Anleitung führt durch eine oscam-Konfiguration für das beste Setup von Grund auf — nicht eine Datei zum Kopieren und Einfügen, sondern die tatsächliche Begründung hinter jedem Parameter, damit Sie es für Ihre eigene Hardware und Links anpassen können.

Was eine "beste" OScam-Konfiguration tatsächlich bedeutet

Lassen Sie uns eines gleich zu Beginn klarstellen. Es gibt keine einzelne Datei, die objektiv die beste OScam-Konfiguration für alle ist. Was "beste" tatsächlich bedeutet, ist die niedrigste stabile ECM-Zeit und die wenigsten Einfrierungen für Ihre spezifische Hardware, Ihre spezifische Karte oder Netzwerkpartner und Ihren spezifischen Receiver. Eine Konfiguration, die auf einem Vu+ Duo4K mit einer lokalen Karte perfekt ist, verhält sich anders auf einer Dreambox, die alles von Netzwerklesern über einen mobilen Hotspot abruft.

Wenn also Menschen nach einer oscam-Konfiguration für das beste Setup suchen, brauchen sie tatsächlich eine Methodik, keinen Download-Link. Das ist es, was Ihnen diese Anleitung bietet.

Die vier Kernkonfigurationsdateien und was jede steuert

OScam verteilt seine Konfiguration auf vier Dateien, und das Verwechseln, was wo hingehört, ist eine häufige Quelle der Verwirrung für jeden, der neu darin ist.

• oscam.conf — globales Verhalten: Timeouts, Protokollierung, Caching, das WebIf und die dvbapi-Brücke zum Decoder Ihrer Box
• oscam.server — jeder Leser, mit dem Sie sich verbinden, sei es eine lokale Smartcard, ein CCcam-Partner oder ein newcamd-Server
• oscam.user — die Konten, die sich mit Ihrer OScam-Instanz verbinden und CWs von ihr abrufen dürfen
• oscam.dvbapi (oder der [dvbapi]-Block in oscam.conf, je nach Build) — wie OScam mit dem lokalen Demuxer für die Dekodierung auf der Box kommuniziert

Wenn Sie auch nur eine dieser Dateien falsch haben, zeigt sich das Symptom ganz woanders — ein fehlerhafter Lesereintrag in oscam.server sieht oft einfach wie "kein Bild" auf dem Receiver aus, ohne dass offensichtlich etwas in oscam.conf falsch ist.

Konfigurationsdateispeicherort: /etc/tuxbox/config vs /var/keys

Auf Enigma2-Receivern finden Sie die aktive Konfiguration typischerweise unter/etc/tuxbox/config/oscam/, obwohl viele Images dies auf/var/keys oder/usr/keys für Persistenz über Flashes hinweg symlink oder mounten. Auf einer eigenständigen Linux-Box, auf der Sie OScam selbst gebaut haben, ist der Standard normalerweise/usr/local/etc es sei denn, Sie haben einen anderen Pfad mit dem-c Start-Flag übergeben.

Raten Sie nicht. Der Pfad, den OScam tatsächlich liest, wird ganz oben im Protokoll beim Start angezeigt, und er wird auch im WebIf unter Status angezeigt. Wenn Sie eine Datei bearbeiten und die Änderungen keine Wirkung zeigen, bearbeiten Sie in neun von zehn Fällen die falsche Kopie.

Warum es keine einzige universelle beste Konfiguration gibt

CAIDs unterscheiden sich je nach Anbieter und Satellit. Reshare-Limits unterscheiden sich je nachdem, wer mit Ihnen teilt. Die Hardware der Karten unterscheidet sich — interne Leser verhalten sich ganz anders als USB Phoenix-Dongles. Eine Konfiguration, die für eine stabile Glasfaserverbindung zu einem lokalen Partner optimiert ist, wird bei einem mobilen 4G-Uplink Probleme haben. Deshalb sind das WebIf und die Protokolldatei Ihre echten Abstimmungsinstrumente, nicht ein Forumsthread. Sie passen einen Wert an, messen die Wirkung, und behalten, was funktioniert.

Optimierte oscam.conf: Globale Einstellungen, die wichtig sind

Hier findet der Großteil der tatsächlichen Abstimmung statt. Unten ist der [global]-Block, von dem ich jede Neugestaltung starte, mit der Begründung für jede Zeile.

[global] nice, maxlogsize, preferlocalcards und clienttimeout

[global]

nice = -1 erhöht die CPU-Scheduling-Priorität von OScam leicht über das Standardniveau, was auf unterdimensionierten ARM-Boxen wichtig ist, wo der Prozess während intensiver EPG-Scans hungrig werden kann.maxlogsize = 100 begrenzt das Protokoll auf 100KB vor der Rotation — genug Historie zum Debuggen, nicht so viel, dass es deinen Flash-Speicher frisst.

clienttimeout = 5000 bedeutet, dass OScam bis zu 5 Sekunden auf eine CW-Antwort wartet, bevor es vollständig aufgibt.fallbacktimeout muss niedriger sein — ich verwende 2500ms — damit ein langsamer oder toter Leser zugunsten einer Fallback-Quelle übersprungen wird, bevor die gesamte Anfrage abläuft. Wenn du fallbacktimeout gleich oder höher als clienttimeout einstellst, verlierst du den gesamten Sinn eines Fallbacks: OScam wartet einfach auf denselben langsamen Leser.

preferlocalcards = 1 sagt OScam, dass es eine direkt angeschlossene Smartcard gegenüber einem Netzwerkpeer bevorzugen soll, wann immer beide denselben CAID decodieren können. Wenn du eine lokale Karte hast, aktiviere dies immer — es ist die größte ECM-Zeitreduktion, die du kostenlos erhalten kannst, da kein Rundlauf über einen Netzwerk-Socket erforderlich ist.

[cache] und cw-Caching (cacheex-Grundlagen)

[cache]

Wenn du ein richtiges CW-Cache-Austausch-Setup zwischen mehreren Boxen in deinem eigenen Netzwerk betreibst (cacheex-Modus 1, 2 oder 3 je nach Rolle), aktiviere Statistiken, damit du die Trefferquoten im WebIf tatsächlich sehen kannst. Ohne dies tust du blindes Tuning. Ich werde hier nicht tief in die cacheex-Topologie eintauchen, da es eine eigene Beschreibung verdient, aber die Kurzversion: Ein Cache-Knoten, der hauptsächlich veraltete oder falsche CWs bereitstellt, wird deine ECM-Zeit schlimmer beeinträchtigen als kein Cache überhaupt, also achte auf die Statistiken, bevor du ihm vertraust.

[webif] auf Port 8888 mit httpuser/httppwd und TLS

[webif]verwende hier ein starkes, einzigartiges Passwort

Port 8888 ist der Standard, aber überprüfe, ob nichts anderes auf deiner Box bereits daran gebunden ist — einige Enigma2-Plugins und sogar bestimmte Streaming-Daemons verwenden standardmäßig 8888, und OScam wird einfach nicht binden können, wenn es belegt ist. Ändere es auf etwas wie 8889, wenn du auf einen Konflikt stößt.

Setzehttpallowed auf deinen LAN-Bereich, damit das WebIf von außerhalb deines Netzwerks überhaupt nicht erreichbar ist. Wenn du wirklich Remote-Zugriff benötigst, aktiviere TLS und verwende echte Anmeldeinformationen — lasse httpuser/httppwd niemals leer bei etwas mit einem öffentlich zugänglichen Port. Ein offenes WebIf übergibt die vollständige Kontrolle über Leser und Konten an jeden, der es findet.

[monitor] und [dvbapi] Blöcke

[monitor]

au = 1 aktiviert automatische EMM-Updates, damit deine Berechtigungen aktuell bleiben, ohne manuelles Eingreifen.pmt_mode = 6 sagt OScam, dass es PMT über die Standard-Socket-Methode lesen soll, die die meisten Enigma2-Images erwarten — wenn du auf einem anderen Empfängertyp bist, benötigst du möglicherweise stattdessen pmt_mode 0 oder 1, überprüfe die Dokumentation deines Images.user sollte auf ein in oscam.user definiertes Konto zeigen, was für die Gruppenübereinstimmung später wichtig ist.

Eine Anmerkung zum Logging: Erhöhe die Debug-Stufe mit-d 2 (oder-d 255 für den vollständigen Firehose) nur, während du aktiv ein Problem diagnostizierst. Das permanente Aktivieren von ausführlichem Debugging füllt dein Protokoll schnell und verursacht unnötige I/O-Überlastung auf flashbasiertem Speicher.

oscam.server und oscam.user: Leser- und Client-Tuning

Dies ist der Abschnitt, in dem die meisten "es verbindet sich einfach nicht"-Probleme tatsächlich auftreten. Stelle die Leser- und Kontodefinitionen richtig ein, und alles, was nachfolgt, funktioniert in der Regel.

CCcam-Leserblock: Gerät, Port, Schlüssel, Inaktivitätszeitüberschreitung

[reader]

inactivitytimeout = 30 trennt und verbindet einen Lesesocket, der 30 Sekunden lang ruhig war — nützlich, um halb tote Verbindungen zu erfassen, die "online" erscheinen, aber tatsächlich keine Daten übertragen.reconnecttimeout steuert, wie lange OScam wartet, bevor es nach einem Abbruch erneut versucht.ccckeepalive = 1sendet regelmäßige Keepalive-Pakete, damit NAT-Router und Firewalls die inaktive Verbindung nicht stillschweigend beenden, was eine sehr häufige Ursache dafür ist, dass ein Reader eine Stunde lang einwandfrei funktioniert und dann einfach stoppt.

newcamd/mgcamd Reader-Syntax und DES-Schlüssel

[reader]

DerSchlüssel ist der DES-Schlüssel, der mit diesem speziellen newcamd-Server ausgehandelt wurde — er ist nicht zwischen Anbietern austauschbar, und ein falscher Schlüssel führt zu einer sofortigen Verbindungsablehnung, die Sie im Protokoll als Authentifizierungsfehler sehen, nicht als Timeout, also überprüfen Sie das zuerst, wenn dieser Reader nicht funktioniert.

Gruppen-, CAID-, Ident- und Reshare-Limits

Das ist der Teil, den fast niemand richtig erklärt, und es ist die Hauptursache für die Mehrheit der Fälle von "Reader zeigt verbunden, aber kein CW kommt jemals an". Gruppennummern existieren ausschließlich, um Anfragen zu leiten — ein oscam.user-Konto mitgroup = 1 kann nur von Readers abrufen, die ebenfallsgroup = 1 haben (oder einer Gruppe, die sich über Bitmasken überschneidet, wenn Sie mehrere Gruppen verwenden). Wenn Ihr Konto Gruppe 1 ist und Ihr Reader Gruppe 2 ist, wird OScam niemals ein ECM zwischen ihnen leiten, Punkt. Und es gibt keine Fehlermeldung, die Ihnen dies direkt mitteilt — es findet einfach stillschweigend niemals ein CW.

Beschränken Sie Reader nach CAID und Ident, wo Sie können:

caid = 0500,1802

Das reduziert unnötige Last — OScam wird keine Zeit damit verschwenden, einen Reader nach einer CAID abzufragen, die er unmöglich dekodieren kann, was die tatsächliche Zeit bei der ECM-Suche verkürzt, wenn Sie mehrere Reader konfiguriert haben.

oscam.user: pwd, Gruppenabgleich, au und monlevel

[account]

Ein Konto pro Box, immer. Die Verwendung von Anmeldeinformationen über mehrere Receiver hinweg macht es unmöglich zu erkennen, welche Box ein bestimmtes ECM im Protokoll generiert, und es stört die clientbezogenen Statistiken im WebIf.monlevel = 1 erlaubt diesem Konto, seinen eigenen Verbindungsstatus im Monitorport ohne vollständige Admin-Sichtbarkeit zu sehen. Passen Sie denGruppen- Wert hier an die Reader an, von denen Sie möchten, dass diese spezielle Box abruft — dies ist die genaue Zuordnung, die die Leute ständig verwirrt, also überprüfen Sie es doppelt gegen oscam.server, bevor Sie woanders suchen.

Lokale Kartenlesung und dvbapi-Dekodierungssetup

Wenn Sie eine physische Smartcard im Receiver haben, sieht der Reader-Block ganz anders aus als ein Netzwerk-Peer, und die hardware-spezifischen Werte sind viel wichtiger, als die Leute erwarten.

Smartcard-Reader-Block: device = /dev/ttyUSB0 und Protokoll

[reader]

Für einen USB Phoenix-Style Smartcard-Reader,protocol = mouse und einen Gerätepfad wie/dev/ttyUSB0 ist Standard. Wenn Ihr Receiver stattdessen einen internen Kartensteckplatz hat, verwenden Sie normalerweiseprotocol = internal mit einem Gerätepfad wie/dev/sci0 unddetect = cd.

mhz, cardmhz und detect-Einstellungen für stabiles ATR

Das ist die Einstellung, die die Leute ständig falsch machen. Für einen USB Phoenix-Reader,mhz = 357 undcardmhz = 357 ist korrekt — das ist die native Taktrate der Karte. Für einen internen Leser auf den meisten Enigma2-Hardware,cardmhz = 2700 ist das, was du stattdessen benötigst. Setze den falschen Wert und die Karte wird entweder gar nicht initialisiert oder gibt dir ein instabiles ATR, das unter Last zufällig abfällt, was genau wie eine defekte Karte aussieht, selbst wenn die Hardware in Ordnung ist.

Bestätige, dass es funktioniert hat, indem du das Protokoll direkt nach dem Start von OScam überprüfst — du suchst nach einer Zeile, die die ATR-Bytes und eine erfolgreiche Karteninitialisierungsnachricht zeigt. Wenn du stattdessen wiederholte Rücksetzversuche siehst, ist das dein Hinweis, dass die mhz/cardmhz-Werte nicht mit deinem Lesertyp übereinstimmen.

oscam.services für CAID/Provider-Gruppierung

Wenn du CAIDs mischst — sagen wir, eine lokale Karte, die einen Provider-CAID verwaltet, und Netzwerkpartner, die andere verwalten —oscam.services ermöglicht es dir, CAID/Provider-Kombinationen unter einer benannten Dienstgruppe zu bündeln, auf die sowohl deine Leser als auch deine [dvbapi] sidtab verweisen können. Ohne diese Gruppierung hat dvbapi keinen sauberen Weg zu wissen, welcher Leser für welchen Kanal ausprobiert werden sollte, und du endest mit langsamerer, weniger vorhersehbarer ECM-Routing bei gemischten Setups.

sysfs/phoenix Leser Fehlersuche

Wenn ein USB Phoenix-Leser überhaupt nicht angezeigt wird, überprüfe zuerst, ob das Gerät tatsächlich existiert:ls -la /dev/ttyUSB0. Auf einigen Linux-Distributionen muss das Kernelmodul manuell geladen werden, oder udev weist eine andere ttyUSB-Nummer zu, wenn du andere USB-Seriellgeräte angeschlossen hast. Gehe nicht davon aus, dass es immer ttyUSB0 ist — überprüfedmesg | tail direkt nach dem Anschließen des Lesers, um zu bestätigen, auf welchem Geräte-Knoten es tatsächlich gelandet ist.

Überprüfung und Benchmarking deiner Konfiguration

Das Schreiben der Konfiguration ist die halbe Arbeit. Die andere Hälfte besteht darin, zu beweisen, dass sie tatsächlich funktioniert, und das ist der Schritt, den die meisten Anleitungen vollständig überspringen.

ECM-Zeit auf der WebIf-Statusseite lesen

Melde dich im WebIf an unterhttp://your-box-ip:8888 und gehe zu Status. Jeder aktive Client und Leser zeigt eine ECM-Zeit-Spalte, die live aktualisiert wird, während Anfragen eingehen. Diese Zahl, in Millisekunden, ist das nützlichste Maß, das du hast, um zu beurteilen, ob deine oscam-Konfiguration tatsächlich gut ist oder nur auf dem Papier gut aussieht.

Interpretation der Leserzustände: CONNECTED, CARD, OFF

Ein Leser, derCARD in grün anzeigt, bedeutet, dass eine lokale Smartcard initialisiert und bereit ist.CONNECTED in grün bedeutet, dass ein Netzwerkpartner authentifiziert und reaktionsfähig ist. Alles in rot — einschließlichOFF — bedeutet, dass dieser Leser gerade keine CWs beisteuert, und jeder Client, der ausschließlich auf ihn für einen bestimmten CAID angewiesen ist, wird fehlschlagen oder woanders zurückfallen, falls ein Fallback überhaupt existiert.

Verwendung des Protokolls (-d 255), um eine ECM-Anfrage von Ende zu Ende zu verfolgen

Starte OScam mit-d 255 vorübergehend und grepe die Ausgabe:

tail -f /tmp/oscam.log | grep -i "ecm\|not found"

Du wirst den gesamten Lebenszyklus einer Anfrage sehen — welcher Leser ausprobiert wurde, wie lange es gedauert hat und ob es erfolgreich war oder mit "nicht gefunden" zurückkam. Ein CAID, der konsequent "nicht gefunden" bei jedem konfigurierten Leser zurückgibt, bedeutet, dass keiner deiner Leser tatsächlich dieses Recht hat, was ein Bereitstellungsproblem und kein Konfigurationsfehler ist.

Zielmetriken: ECM-Zeit unter 500ms, null Zeitüberschreitungen

Als funktionierender Benchmark: unter 500ms gibt dir nahezu sofortiges Zappen, das von einem unverschlüsselten Kanal nicht zu unterscheiden ist. 500-1000ms ist nutzbar, aber du wirst eine Verzögerung beim Kanalwechsel bemerken. Alles, was konstant über 1000ms liegt, wird sichtbares Einfrieren erzeugen, insbesondere bei Kanälen mit kurzen CW-Zykluszeiten. Teste jeweils eine Parameteränderung — tausche fallbacktimeout, beobachte das WebIf für ein paar Minuten und gehe dann zum nächsten Wert über. Fünf Dinge auf einmal zu ändern bedeutet, dass du nie wissen wirst, welches tatsächlich geholfen hat.

Häufige Konfigurationsfehler und was nicht funktioniert

So nützlich wie zu wissen, was funktioniert, ist zu wissen, was zuverlässig nicht funktioniert, denn diese Fehler treten immer wieder auf.

Nicht übereinstimmende Gruppennummern zwischen Server und Benutzer

Oben erwähnt, aber es ist wert, es zu wiederholen, denn es ist die häufigste Ursache für "alles sieht verbunden aus, aber nichts dekodiert." Wenn Ihr Leser Gruppe 4 ist und Ihr Konto Gruppe 1, werden sie sich niemals sehen, und es gibt keinen expliziten Fehler — nur Stille, wo ein CW sein sollte.

Copy-paste 'beste' Konfigurationen aus Foren, die nicht mit Ihrem CAID übereinstimmen

Eine vollständige oscam.conf, die aus einem Forum-Thread heruntergeladen wurde, funktioniert fast nie so, wie sie ist. Die CAIDs, Ports und Gruppennummern in dieser Datei wurden für die Leser und Anbieter anderer Personen optimiert. Verwenden Sie bestenfalls eine bekannte gute Datei als strukturelles Skelett — das Abschnitts-Layout und die allgemeine Parametergruppe — aber jede Berechtigung, jeden Port, jeden CAID und jeden Gruppenwert muss durch Ihre eigenen ersetzt werden.

Zu hohe cccmaxhops verursachen Schleifen und langsame CWs

Einstellungcccmaxhopszu hoch — die Leute drehen es manchmal auf 10 oder mehr, in der Annahme, dass es mehr Quellen findet — macht tatsächlich das Gegenteil. Jeder zusätzliche Hop fügt der ECM-Route Latenz hinzu, und eine hohe Hop-Zahl in einer schlecht gewarteten Sharing-Kette erhöht das Risiko von Routing-Schleifen, die Anfragen vollständig blockieren. Halten Sie die Hops und die Reshare-Tiefe konservativ; 3-5 ist eine angemessene Obergrenze für die meisten Setups.

Falsche Dateiberechtigungen und Zeilenende (CRLF) Fehler

Zwei langweilige, aber sehr häufige Fehler. Erstens: Konfigurationsdateien unter Windows mit einem Editor zu bearbeiten, der Unix-Zeilenenden nicht verarbeitet, injiziert CRLF-Zeichen, die OScam inkonsistent analysiert — manchmal still, manchmal als beschädigte Zeile. Speichern Sie immer nur als LF oder bearbeiten Sie direkt auf der Box mit nano oder vi. Zweitens:chmod 600Ihre Konfigurationsdateien, da oscam.server und oscam.user Klartext-Passwörter enthalten und es keinen Grund gibt, warum andere Benutzer im System sie lesen können sollten.

Und noch eine Sache, die es wert ist, direkt gesagt zu werden — das vollständige Deaktivieren von clienttimeout oder das Setzen auf absurd hohe Werte behebt keine Einfrierungen. Es versteckt sie nur, denn jetzt sitzt OScam dort unbegrenzt und wartet auf einen toten Leser, anstatt schnell zu scheitern und einen Fallback zu versuchen. Wenn Einfrierungen Ihr Problem sind, senken und optimieren Sie die Timeout-Werte, entfernen Sie sie nicht.