OScam wie installieren - Vollständiger Installationsleitfaden

Wenn du nach einer Möglichkeit suchstoscam wie installieren auf dein System, bist du an der richtigen Stelle. Die Installation von OScam ist ein Prozess, der mehrere Schritte erfordert, aber mit dem richtigen Leitfaden dauert es maximal eine Stunde. Dieser Artikel führt dich durch die Kompilierung aus den Quellen, die Konfiguration und das Testen — alles, was du wissen musst, um OScam auf Linux zu starten.

Bevor du anfängst, solltest du Zugang zu einem Server oder Router mit Linux-System (Debian, Ubuntu, OpenWrt, Alpine) und grundlegende Kenntnisse der Befehlszeile haben. Der Prozess ist wiederholbar, daher funktionieren die Schritt-für-Schritt-Anweisungen auch, wenn du neu in diesem Bereich bist.

Was ist OScam und warum sollte man es wählen

OScam ist ein Open-Source-Kartenemulator, geschrieben in C, direkt angepasst für die Arbeit mit Cardsharing-Systemen. Sein Hauptvorteil ist Leichtheit — es verbraucht wenig CPU und RAM, was es zur idealen Lösung für Router, Set-Top-Boxen und Server mit begrenzter Rechenleistung macht.

Im Cardsharing-Ökosystemoscam wie installieren auf dem eigenen System ist eine der ersten Fragen, die Benutzer sich stellen. OScam unterstützt CCcam-, Newcamd-, Gbox- und andere Protokolle, was große Flexibilität bei der Wahl der Inhaltsquellen bietet.

OScam vs andere CAM-Software

OScam zeichnet sich durch mehrere Merkmale aus. Erstens ist es leicht — auf einem älteren ARM-Router benötigt es etwa 2-3 MB RAM. Zweitens ist der Quellcode verfügbar zur Überprüfung und Änderung, was ein Gefühl der Kontrolle gibt.

Andere CAM-Software kann ressourcenintensiver oder schwieriger für Anfänger zu konfigurieren sein. OScam hat anständige Dokumentation und ein aktives Community-Forum, aber du musst wissen, wo du sie suchst, ohne dich auf vorgefertigte Pakete zu verlassen.

Systemanforderungen und Abhängigkeiten

OScam funktioniert auf den meisten Linux-Architekturen. Unterstützt werden ARM (32 und 64-Bit), x86_64, MIPS und andere. Die Mindestanforderungen sind:

• Prozessor: ARM Cortex-A7 oder schneller oder x86-Äquivalent
• RAM: 64 MB Minimum, 256 MB empfohlen
• Festplatte: 50 MB für die Installation + Platz für Logs (100-200 MB)
• System: Linux mit gcc, make, git

Wichtig: OScam benötigt Kryptografiebibliotheken (OpenSSL) und optional PCSC-Bibliotheken für Kartenleser. Ohne diese Abhängigkeiten schlägt die Kompilierung fehl.

Wo man OScam-Quellen herunterlädt

Die offiziellen OScam-Quellen befinden sich im Git-Repository. Lade OScam nicht von zufälligen Websites herunter — greifen Sie immer auf Quellen aus vertrauenswürdigen Repositories zu, die du selbst überprüfen kannst.

Das Repository ist öffentlich verfügbar und enthält die gesamte Änderungshistorie seit Version 1.0. Bevor du es herunterlädst, überprüfe, ob die Version, die du herunterlädst, nicht inoffiziell geändert wurde — klone am besten direkt aus der Quelle.

Vorbereitung der Umgebung für die Installation

Bevor du OScam kompilierst, musst du das System vorbereiten. Dies dauert nicht lange, aber das Überspringen eines Schritts führt zu Kompilierungsfehlern.

Systemaktualisierung und Paketmanager

Auf Debian/Ubuntu-Systemen:

sudo apt-get update

Auf OpenWrt:

opkg update

Diese Aktualisierung synchronisiert die Paketlisten mit den neuesten verfügbaren Versionen in den Repositories. Installiere dann die notwendigen Kompilierungswerkzeuge.

Installation des Compilers und erforderlicher Bibliotheken

Dies ist ein entscheidender Schritt. Ohne diese Pakete kannst du OScam nicht kompilieren.

Auf Debian/Ubuntu (alle apt-basierten Distributionen):

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

Wenn du fortgeschrittene Funktionen unterstützen möchtest (LCD, Kartenleser), füge hinzu:

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

Auf OpenWrt (wo Pakete kleiner sind):

opkg install build-essential git libssl libpcsclite-dev

Überprüfe, ob der GCC-Compiler ordnungsgemäß installiert wurde:

gcc --version

Du solltest eine GCC-Versionsnummer sehen (z. B. gcc version 10.2.1). Wenn "command not found" angezeigt wird, ist etwas schiefgelaufen — gehe zum Schritt der Installation von build-essential zurück.

Verfügbaren Speicherplatz überprüfen

OScam benötigt im endgültigen Zustand wenig Platz, aber der Kompilierungsprozess erstellt temporäre Dateien. Ich empfehle mindestens 200 MB freien Speicher.

df -h /

Wenn du weniger als 200 MB freien Speicher siehst, bereinige alte Pakete oder Logs vor der Installation:

sudo apt-get clean

Vorbereitung des Installationsverzeichnisses

Erstelle ein Verzeichnis, in dem OScam heruntergeladen und kompiliert wird. Dies ist normalerweise /opt oder /usr/local/src:

sudo mkdir -p /opt/oscam

Durch die Änderung des Eigentums musst du beim Klonen des Repositories nicht sudo verwenden. Das erspart Probleme mit Dateiberechtigungen.

Herunterladen, Kompilieren und Installieren von OScam

Hier beginnt die eigentliche Arbeit. Das Verständnis jedes Schritts hilft dir, Probleme zu beheben, falls sie auftreten.Oscam wie installieren korrekt hängt ab von der korrekten Ausführung dieser Befehle in der genauen Reihenfolge.

Repository von git klonen

Lade die neuesten OScam-Quellen aus dem offiziellen Repository herunter:

cd /opt/oscam

Der Klonprozess lädt alle Quelldateien herunter (normalerweise etwa 50 MB). Überprüfe nach Abschluss, ob das oscam-Verzeichnis eine configure-Datei und ein Makefile enthält:

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

Wenn die Dateien vorhanden sind, bist du bereit für den nächsten Schritt. Falls nicht — stelle sicher, dass git ohne Fehler installiert wurde.

Konfiguration der Kompilierungsoptionen (./configure)

Dies ist der Moment, an dem du entscheidest, welche Funktionen in OScam kompiliert werden. Verschiedene ./configure-Flags aktivieren oder deaktivieren die Unterstützung für verschiedene Funktionen.

Minimale Konfiguration mit SSl und Netzwerkprotokollen:

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

Vollständige Konfiguration (mit Unterstützung für PCSC-Leser und erweiterte Funktionen):

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

Die Flags bedeuten:

• --prefix=/usr/local — Installationsort für Binärdateien
• --enable-ssl — SSL/TLS-Verschlüsselungsunterstützung
• --enable-cccam — CCcam-Protokoll
• --enable-newcamd — Newcamd-Protokoll
• --enable-pcsc — Unterstützung für Smart Card PC/SC-Leser
• --enable-dvbapi — DVB-API-Schnittstelle für Tuner-Karten

Das Configure-Skript prüft zunächst die Verfügbarkeit von Bibliotheken. Wenn libssl-dev fehlt, siehst du einen Fehler wie "checking for OpenSSL... not found". Ignoriere solche Fehler nicht — gehe zurück zum Vorbereitungsabschnitt und installiere die fehlenden Pakete.

Wenn die Konfiguration erfolgreich ist, siehst du am Ende eine Zusammenfassung:

OScam version x.xx configured successfully

Kompilierung mit make und make install

Die Kompilierung ist ein Prozess, der Quellcode (C) in eine ausführbare Binärdatei umwandelt. Dies kann je nach Prozessorleistung zwischen einigen Sekunden und mehreren Minuten dauern.

make -j4

Das Flag `-j4` bedeutet Kompilierung auf 4 Kernen gleichzeitig (wenn du mehrere Kerne hast, erhöhe die Zahl für Beschleunigung). Versuche auf älteren Systemen `-j2` oder ohne Flag.

Warte, bis du eine Kompilierungsabschlussmeldung siehst. Dies ist normalerweise eine Meldung, die "oscam" und die Größe in Bytes enthält (z. B. "oscam (27 MB)"). Wenn ein Fehler auftritt, lies ihn — normalerweise zeigt er, welches Paket fehlt.

Nach erfolgreicher Kompilierung installiere die Binärdatei:

sudo make install

Dieser Befehl kopiert die oscam-Datei nach /usr/local/bin/oscam und erstellt notwendige Konfigurationsverzeichnisse.

Überprüfung der korrekten Installation

Überprüfe, ob OScam ordnungsgemäß installiert wurde:

/usr/local/bin/oscam --version

Du solltest die Versionsnummer, die Anzahl der Builds (SVN/GIT), das Kompilierungsdatum und eine Liste der aktivierten Funktionen sehen. Beispiel:

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

Wenn die Ausgabe die Version und Funktionen zeigt — alles ist in Ordnung. Wenn "command not found" angezeigt wird — überprüfe, ob der Pfad /usr/local/bin in der PATH-Variable vorhanden ist:

echo $PATH

Du solltest /usr/local/bin in der Liste sehen. Falls nicht, füge es hinzu:

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

Einstellung von Berechtigungen und Dateieigentum

OScam muss mit entsprechenden Berechtigungen laufen. Wenn du es als normaler Benutzer (nicht root) ausführst, musst du das Eigentum an einen bestimmten Benutzer ändern:

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

Erstelle Konfigurationsverzeichnisse mit korrektem Eigentum:

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

Wenn du auf einen PCSC-Kartenleser zugreifen möchtest, füge den oscam-Benutzer zur scard-Gruppe hinzu:

sudo usermod -aG scard oscam

Konfiguration der Dateien oscam.conf, oscam.server und oscam.user

Nun kommt der Moment, in dem du OScam "lehrst", wie es funktioniert. Die Konfiguration ist das Herz der ganzen Installation.Oscam wie installieren ist das eine, aber ohne richtige Konfiguration bleibt es eine nutzlose Binärdatei.

Struktur und Speicherort von Konfigurationsdateien

OScam sucht standardmäßig nach Konfigurationsdateien in /etc/oscam/. Die Hauptdateien sind:

• oscam.conf — Hauptkonfiguration (Ports, Protokolle, Logging)
• oscam.server — Definitionen von Quellen (Karten, CCcam/Newcamd-Server)
• oscam.user — Benutzer und Zugriffsgruppen
• oscam.dvbapi — DVB-API-Schnittstellenkonfiguration (optional)

Erstelle diese Dateien, falls sie nicht vorhanden sind:

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

Konfiguration des Listeners (Port, Protokoll, Verschlüsselung)

Ein Listener ist der Teil von OScam, der auf einem bestimmten Port und Protokoll abhört und auf Verbindungen von Clients wartet. Die Listener-Konfiguration in oscam.conf sieht so aus:

[global]

Erklärung der Parameter:

• logfile — Pfad zur Protokolldatei
• debug — Debug-Ebene (0-255, wobei 0 deaktiviert ist)
• port im Abschnitt [newcamd] — Abhörport für Newcamd-Protokoll (Standardwert 1234)
• key — Entschlüsselungsschlüssel für Newcamd-Kommunikation (16 Bytes hexadezimal)
• users — Liste der Benutzer mit Zugriff auf diesen Listener

Für das CCcam-Protokoll füge einen Abschnitt hinzu:

[cccam]

CCcam-Parameter:

• version — CCcam-Protokollversion (2.2.1 ist ein beliebter Standard)
• nodeid — 20-Byte-Knotenkennung (hexadezimal)
• reshare — wie viele Reshare-Ebenen du erlaubst (2 bedeutet Weitergabe an eine andere Person)

Hinzufügen von Quellen (Readern) - Karten, Server

Der Abschnitt [reader] in oscam.server definiert, woher OScam Daten abrufen soll — ob von einer physischen Karte oder von einem Remote-Server.

Beispiel eines physischen Kartenlesers (PCSC):

[reader]

Parameter:

• label — Name des Lesers (für Protokolle und Berichte)
• protocol — Protokolltyp (pcsc für Smart Card-Leser, dvbapi für DVB-Tuner)
• device — Gerätenummer (0 für ersten Leser, 1 für zweiten usw.)
• group — Gruppennummer (muss mit der Gruppe in oscam.user übereinstimmen)
• caid — CAID-Kennung der Karte (0500 für Viaccess, 0100 für Seca usw.)

Beispiel eines CCcam-Servers (Remote-Quelle):

[reader]

Für Newcamd-Server:

[reader]

Erstellung von Benutzern und Zugriffsgruppen

Die Datei oscam.user definiert, wer sich mit OScam verbinden kann und wer Zugriff auf welche Kanäle hat.

[user]

Bedeutung der Parameter:

• user,pwd — Benutzername und Passwort
• group — Zugriffsgruppen (müssen mit Gruppen in oscam.server übereinstimmen)
• au — Autorisierungsstufe (1 ist normaler Benutzer)
• iplimit — Limit für Verbindungen von verschiedenen IP-Adressen (0 = unbegrenzt)
• maxconnections — Maximale Anzahl gleichzeitiger Verbindungen für den Benutzer
• monlevel — Zugriff auf Monitoring und Protokolle (4 ist vollständiger Zugriff)

Einstellung von Protokollen und Debugging

Protokolle sind dein bestes diagnostisches Werkzeug. Stelle die Debug-Ebene in oscam.conf ein:

[global]

Debug-Ebene 127 gibt Informationen über EMM, ECM, Verbindungen und Fehler aus. Für die Produktion kannst du auf 0 oder 16 (nur Fehler) reduzieren.

Stelle sicher, dass das Verzeichnis /var/log/oscam die richtigen Berechtigungen hat:

sudo chown oscam:oscam /var/log/oscam

Verbindungstests und Diagnose

Bevor du OScam im Hintergrund als Dienst startest, teste es im interaktiven Modus. Dies ermöglicht es dir, Fehler in Echtzeit zu sehen und Zeit beim Debuggen zu sparen.

Starten von OScam im Debug-Modus

Starte OScam mit der Option -b (Background deaktiviert), die Protokolle auf der Konsole ausgeben:

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

Die Flags bedeuten:

• -c /etc/oscam/ — Konfigurationsverzeichnis
• -b — Hintergrund deaktivieren (run in foreground)

Wenn alles in Ordnung ist, siehst du Start-Meldungen:

OScam 1.20 starting (pid: 12345)

Wenn ein Fehler wie "Port 9000 already in use" angezeigt wird, bedeutet dies, dass ein anderer Prozess auf diesem Port abhört. Ändere den Port in oscam.conf oder beende den vorhandenen Prozess:

sudo lsof -i :9000<PID>

Überprüfung von Protokollen in der oscam.log-Datei

Wenn OScam ausgeführt wird, öffne ein zweites Terminalfenster und überwache die Protokolle live:

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

Suche nach Einträgen, die enthalten:

• "EMM processed" — Karten oder Server senden Autorisierungsdaten
• "ECM request" — Clients fordern Entschlüsselung an
• "Successfully decoded" — Entschlüsselung war erfolgreich
• "Connection from" — neuer Client ist verbunden

Beispiel korrekter Protokolle:

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

Fehler können so aussehen:

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

Verbindungstest vom Client (netcat, telnet)

Um zu testen, ob der Listener ordnungsgemäß abhört, verwende netcat:

nc -zv 127.0.0.1 1234

Wenn die Verbindung erfolgreich ist, siehst du "succeeded" oder "Connection to 127.0.0.1 port 1234 [tcp/*] succeeded". Wenn es nicht gelingt, überprüfe, ob OScam wirklich abhört:

sudo netstat -tlnp | grep oscam

Du solltest Zeilen mit Port 1234 und 9000 mit dem Prozess "oscam" sehen.

Überwachung der Systemressourcen

Überprüfe die Ressourcennutzung durch OScam:

ps aux | grep oscam

Typische Ausgabe:

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

Die Spalten bedeuten: Benutzer, PID, %CPU, %MEM, virtueller Speicher, realer Speicher, Startzeit. Wenn %CPU konsistent über 50% liegt, stimmt etwas nicht (normalerweise schwache Hardware oder eine Endlosschleife).

Überprüfe auch das Limit der offenen Dateien:

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

Behebung häufiger Startprobleme

Wenn OScam nicht startet, überprüfe diese Dinge in Reihenfolge:

Problem: "oscam: command not found" — Die Binärdatei befindet sich nicht im PATH. Überprüfe:

ls -la /usr/local/bin/oscam

Wenn die Datei vorhanden ist, füge /usr/local/bin zu PATH hinzu oder führe den vollständigen Pfad aus.

Problem: "Permission denied" beim Ausführen — Die Berechtigungen der Binärdatei sind zu restriktiv:

sudo chmod 755 /usr/local/bin/oscam

Problem: "Cannot open config directory" — Das Verzeichnis /etc/oscam existiert nicht oder der oscam-Benutzer hat keinen Zugriff:

sudo mkdir -p /etc/oscam

Problem: "Port already in use" — Der Abhörport wird von einem anderen Prozess belegt:

sudo lsof -i :9000<PID>

Oder ändere den Port in oscam.conf.

Problem: "Failed to load SSL certificates" — OpenSSL-Bibliothek fehlt oder falsche Version ist installiert:

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

Du solltest "libssl.so" mit einer Version sehen. Wenn "not found" angezeigt wird, installiere libssl-dev und baue OScam erneut.

Problem: Protokolle erscheinen nicht in oscam.log — Das Protokollverzeichnis existiert nicht oder hat keine Schreibberechtigungen:

sudo mkdir -p /var/log/oscam

Nach Behebung eines dieser Probleme versuche, OScam erneut im Debug-Modus zu starten.

Erstellung eines systemd-Dienstes und automatischer Start beim Systemstart

Damit OScam nach einem Neustart automatisch startet, erstelle eine systemd-Einheit.

Erstelle die Datei /etc/systemd/system/oscam.service:

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

Aktiviere und starte den Dienst:

sudo systemctl daemon-reload

Überprüfe den Status:

sudo systemctl status oscam

Du solltest "active (running)" sehen. Wenn OScam abstürzt, startet systemd es nach 10 Sekunden automatisch neu (Parameter RestartSec).

Aktualisierung und Wartung von OScam

OScam wird regelmäßig aktualisiert. Um zur neuesten Version zu aktualisieren:

cd /opt/oscam/oscam

Der Befehl `git pull` lädt die neuesten Änderungen aus dem Repository herunter. `make clean` löscht alte Kompilierungsobjekte, was Konflikte verhindert. Nach der Neuinstallation startet systemctl OScam mit der neuen Version neu.

Überprüfe die Version nach der Aktualisierung:

/usr/local/bin/oscam --version

Unterstützung mehrerer OScam-Instanzen auf einem System

Wenn du mehrere unabhängige OScam-Instanzen ausführen möchtest (z. B. für verschiedene Benutzer oder Konfigurationen), musst du auf die Isolierung von Konfigurationsverzeichnissen und Ports achten.

Erstelle separate Verzeichnisse:

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

Jede Instanz muss eigene oscam.conf-Dateien mit unterschiedlichen Ports haben:

# /etc/oscam-1/oscam.conf

Erstelle für jede Instanz separate systemd-Dienste (oscam-1.service, oscam-2.service) und ändere das Flag `-c` auf das entsprechende Konfigurationsverzeichnis.