Plik konfiguracyjny OSCam oscam.server wyjaśniony dla początkujących (2026)

Jeśli udało Ci się skompilować i uruchomić OScam, interfejs webowy ładuje się poprawnie na porcie 8888, a następnie otwierasz oscam.server i po prostu się w niego wpatrujesz — nie jesteś sam. To jest plik konfiguracyjny oscam oscam.server wyjaśniony dla początkujących, napisany na dokładnie ten moment, w którym się teraz znajdujesz: czytelnicy pokazujący OFF lub POŁĄCZENI, ale nie dekodujący, blok, który skopiowałeś z wątku na forum, który "powinien" działać, i brak pomysłu, które linie są naprawdę istotne, a które OScam cicho ignoruje.

Odbudowałem ten plik od podstaw więcej razy, niż chciałbym przyznać, na wszystkim, od Raspberry Pi działającego na wersji źródłowej po odbiorniki Enigma2 z ich dziwnymi folderami konfiguracyjnymi z symlinkami. Dobra wiadomość: gdy zrozumiesz, do czego każda linia jest właściwie przeznaczona, oscam.server przestaje być magią. Ten przewodnik przechodzi przez plik linia po linii, pokazuje trzy w pełni działające bloki czytelników i — to jest część, którą większość przewodników pomija — uczy, jak czytać kolumnę statusu czytelnika, abyś mógł diagnozować własną konfigurację zamiast zgadywać.

Co oscam.server właściwie robi (i czego nie robi)

Największym błędnym przekonaniem, które widzę u osób nowych w OScam, jest traktowanie oscam.server jako "pliku konfiguracyjnego". To nie jest to. OScam dzieli swoją konfigurację na trzy pliki, a każdy z nich ma określone zadanie. Mieszanie ich to powód, dla którego połowa przewodników konfiguracyjnych wprowadza ludzi w błąd — mówią ci, aby dodać numer portu do oscam.server, a on po prostu tam siedzi, nic nie robiąc, ponieważ porty nie żyją tam.

Gdzie plik się znajduje

Na wersji źródłowej zazwyczaj jest to /usr/local/etc/oscam.server. Na odbiornikach Enigma2/Dreambox zazwyczaj jest to /etc/tuxbox/config/oscam.server, chociaż niektóre obrazy ukrywają go pod /var/keys/. Nie zgaduj — sprawdź stronę statusu interfejsu webowego OScam, która pokazuje ConfigDir, którego OScam faktycznie używa. Jeśli uruchomiłeś OScam z flagą -c (na przykład, oscam -c /etc/oscam/), ta ścieżka nadpisuje wszystko inne, w tym jakikolwiek plik znajdujący się w domyślnej lokalizacji.

Zasada w jednym zdaniu

oscam.server definiuje źródła deszyfracji. oscam.user definiuje konsumentów deszyfracji. Jeśli nie zapamiętasz nic innego z tego artykułu, zapamiętaj to. Za każdym razem, gdy masz pokusę, aby dodać coś do oscam.server, co brzmi jak "kto może używać mojego serwera", zatrzymaj się — to jest zadanie oscam.user.

Jak blok czytelnika odpowiada czemuś rzeczywistemu

Każdy blok [reader] w oscam.server odpowiada dokładnie jednej rzeczy: fizycznej karcie inteligentnej znajdującej się w czytniku USB, jednemu partnerowi sieciowemu, z którego pobierasz klucze, lub lokalnemu emulatorowi, takiemu jak CCcam-emu lub Newcamd-emu. To jest mapowanie 1:1. Jeśli masz dwie fizyczne karty, potrzebujesz dwóch bloków czytelników. Jeśli masz jedną linię CCcam, to jest jeden blok.

Czytanie pliku, który OScam faktycznie załadował

Oto część, która ciągle myli ludzi: OScam analizuje oscam.server przy starcie i ponownie, gdy naciśniesz Restart w interfejsie webowym — nie wtedy, gdy zapisujesz plik tekstowy przez SSH. Jeśli w bloku występuje błąd składni lub duplikat etykiety, OScam nie wyświetla okna dialogowego ani nie zapisuje głośnego błędu. Po prostu cicho pomija ten blok. Czytnik po prostu nie będzie istniał. Zawsze przejdź do Config > Reader w interfejsie webowym po restarcie i potwierdź, że nazwa czytnika, którą wpisałeś, jest faktycznie wymieniona. Jeśli jej brakuje, blok nigdy nie został przeanalizowany — koniec, nie trać czasu na rozwiązywanie problemów z siecią dla czytnika, którego OScam nigdy nie załadował.

Anatomia bloku czytelnika: każda linia, co robi, kiedy ją pominąć

To jest część, której wszyscy naprawdę potrzebują, więc zbudujmy to od podstaw. Oto minimalny działający blok czytelnika newcamd — sześć linii, nic fancy:

[reader]

To naprawdę wystarczy, aby połączyć czytnik newcamd. Teraz oto pełniejszy blok z parametrami, o które ludzie naprawdę spierają się na forach:

[reader]

Teraz przejdźmy przez to, co każda linia właściwie robi, i — co ważniejsze — kiedy można ją bezpiecznie pominąć.

label

Wewnętrzna nazwa dla tego czytnika. Pojawia się w interfejsie webowym, w twoich logach i jest tym, do czego odwołuje się oscam.user pośrednio przez numery grup. Musi być unikalna w całym pliku — duplikaty etykiet powodują, że jeden blok cicho nadpisuje lub zostaje pominięty, a objawem jest czytnik, który po prostu brakuje w zakładce Czytnicy bez wyjaśnienia. Trzymaj to krótko, bez spacji, jeśli to możliwe, i coś, co rozpoznasz za sześć miesięcy.

protocol

Mówi OScam, jaki to rodzaj źródła: cccam, camd35, cs378x, newcamd, internal (do lokalnej emulacji) lub mouse / smartreader dla fizycznej karty w czytniku USB. Ta linia jest obowiązkowa i musi odpowiadać temu, co jest faktycznie po drugiej stronie — serwer cccam nie odpowie na handshake newcamd, niezależnie od tego, jak poprawna jest reszta twojego bloku.

device

Ta jedna linia oznacza dwie zupełnie różne rzeczy w zależności od protokołu. Dla fizycznej karty to ścieżka szeregowa, taka jak /dev/ttyUSB0 lub /dev/sci0. Dla jakiegokolwiek protokołu sieciowego (newcamd, cccam, camd35, cs378x) to host,port — na przykład server.example.net,12000. Mieszanie ich to klasyczny błąd kopiowania i wklejania: wklejenie ścieżki urządzenia szeregowego do bloku czytnika sieciowego, lub odwrotnie, nie robi nic poza wytworzeniem czytnika utkwionego w pętli łączenia.

user / password

Dane uwierzytelniające do logowania się do zdalnego źródła. Pochodzą od kogoś, kto zarządza tym źródłem — nie są to twoje dane logowania do interfejsu webowego OScam, ani nie są to dane uwierzytelniające w twoim pliku oscam.user. Trzy oddzielne zestawy danych uwierzytelniających, trzy oddzielne cele. Mylenie ich jest niezwykle powszechne i prowadzi do natychmiastowego odrzucenia logowania.

group

To jest najczęściej źle rozumiana linia w całym pliku i jest bezpośrednim połączeniem między oscam.server a oscam.user. group to lista liczb całkowitych oddzielonych przecinkami — group = 1 lub group = 1,3,7. Czytnik w grupie 1 będzie obsługiwał tylko klientów, których linia grupy w oscam.user również zawiera 1. Jeśli twój czytnik to group=2, a twój testowy klient to group=1, czytnik może być w pełni POŁĄCZONY i zdrowy, a twój klient otrzyma dokładnie zero ECM-ów od niego, na zawsze. Ta niezgodność jest najczęstszą przyczyną "czytnik jest połączony, ale nic nie dekoduje", i rzadko jest to właściwie wyjaśniane gdzie indziej.

caid, ident, chid, boxid

Myśl o nich jak o filtrach białej listy. Pozostaw je puste, a OScam zapyta czytnik o jakiekolwiek CAID, które czytnik sam zgłasza. Wypełnij caid = 1802, a mówisz OScam "pytaj ten czytnik tylko o CAID 1802" — wszystko inne zostanie zignorowane, nawet jeśli czytnik technicznie je ma. To jest przydatne do ograniczenia niepotrzebnego ruchu ECM i utrzymania równoważenia obciążenia w porządku, ale błędna wartość CAID powoduje, że czytnik łączy się poprawnie, ale nigdy nie otrzymuje pojedynczego żądania ECM, co wygląda dokładnie jak problem z siecią, ale nim nie jest. ident zawęża dalej do konkretnych identyfikatorów dostawcy w ramach CAID, chid do konkretnych identyfikatorów kanałów, a boxid łączy czytnik sieciowy z konkretnym identyfikatorem boxa, którego niektórzy dostawcy wymagają. Pozostaw wszystkie te pola puste, gdy po raz pierwszy uruchamiasz czytnik, a następnie zawężaj je, gdy potwierdzisz, że działa.

cccversion, cccmaxhops, ccckeepalive, cccwantemu

Te parametry dotyczą tylko protokołu=cccam, a OScam całkowicie je ignoruje dla każdego innego protokołu. cccversion ustawia wersję protokołu CCcam, którą twój czytnik ogłasza (2.3.0 jest powszechne). cccmaxhops ogranicza, jak daleko karta może być i nadal się liczyć — więcej na ten temat w poniższym przykładzie. ccckeepalive utrzymuje sesję TCP przy życiu za pomocą okresowych pingów, aby nie wygasła cicho. cccwantemu informuje partnera, czy jesteś gotów zaakceptować emulowane (nie-kartowe) źródła przez ten link.

inactivitytimeout, reconnecttimeout, lb_weight, fallback, disablecrccws

Linie dostrajania. inactivitytimeout (sekundy) odłącza i ponownie łączy czytnik, który zamilkł — przydatne dla niestabilnych źródeł sieciowych. reconnecttimeout kontroluje opóźnienie przed ponownym próbą połączenia; zwiększ to, jeśli sieć twojego boxa potrzebuje czasu, aby się uruchomić po włączeniu. lb_weight wpływa na to, jak równoważnik obciążenia OScam priorytetyzuje ten czytnik w porównaniu do innych obsługujących ten sam CAID — wyższa waga oznacza, że jest wybierany częściej, zakładając, że równoważenie obciążenia jest włączone w oscam.conf. fallback = 1 oznacza, że czytnik jest traktowany jako ostateczność, używany tylko wtedy, gdy twoje główne czytniki nie mogą odpowiedzieć. disablecrccws tłumi specyficzne wykrywanie wymiany kart oparte na CRC, które niektóre konfiguracje nie potrzebują.

Parametry, które dotyczą tylko fizycznych kart

mhz i cardmhz ustawiają prędkość zegara, którą OScam używa do komunikacji z fizyczną kartą smart — typowe wartości to 357/357 lub 600/357 w zależności od karty i sprzętu czytnika. detect kontroluje, jak OScam wykrywa włożenie/wyjęcie karty na niektórych sprzętach czytników. readnano jest dla specyficznych typów kart, które potrzebują dodatkowego przetwarzania ATR. Żaden z tych parametrów nie działa w protokole sieciowym. Nadal widzę bloki cccam i newcamd zamieszczone na forach z mhz=368 w nich — to jest nieszkodliwe, ale to martwy ciężar, i mówi ci, że osoba, która napisała post, nie do końca rozumiała, co wkleja.

Trzy bloki czytników, w pełni opracowane

Teoria jest w porządku, ale przyszedłeś tutaj, aby napisać działający blok. Oto trzy, obejmujące konfiguracje, które ludzie faktycznie uruchamiają.

Lokalna karta smart w czytniku USB

Najpierw znajdź rzeczywistą ścieżkę urządzenia — nie zgaduj. Uruchomdmesg | grep ttytuż po podłączeniu czytnika, lub sprawdźls /dev/serial/by-id/w poszukiwaniu trwałej nazwy, która przetrwa ponowne uruchomienia (kolejność enumeracji USB może przesunąć /dev/ttyUSB0 do /dev/ttyUSB1 po ponownym uruchomieniu, co cicho złamie twardo zakodowaną ścieżkę).

[reader]

Niektóre czytniki w stylu phoenix używają zamiast tego /dev/sci0, a starsze czytniki portów szeregowych pojawiają się jako /dev/ttyS0. Jeśli karta jest wykrywana, ale otrzymujesz sporadyczne NEEDINIT, to bardzo często para mhz/cardmhz, a nie problem z siecią lub konfiguracją — spróbuj 600/357, zanim założysz, że karta lub czytnik jest uszkodzony.

Czytnik sieciowy przez newcamd

[reader]

Linia klucza to 14-bajtowy klucz DES, który otrzymujesz od osoby, która prowadzi źródło — to nie jest coś, co wymyślasz. Zauważ, że caid jest tutaj ustawiony jawnie, a nie pozostawiony pusty; to nie jest opcjonalna konwencja, to dlatego, że protokół newcamd zazwyczaj przenosi jeden CAID na port, więc źródło oczekuje, że zadeklarujesz, dla którego się łączysz.

Czytnik sieciowy przez cccam

[reader]

cccmaxhops = 2 oznacza, że zaakceptujesz karty do dwóch linków w dół: hop 1 to lokalna karta partnera, hop 2 to karta, którą partner dzieli z kimś innym. Zwiększenie tego do 5 nie sprawi, że magicznie pojawi się więcej kart — tylko poszerza to, co jesteś gotów zaakceptować z dalszej części łańcucha, a odległe karty zazwyczaj oznaczają wolniejsze, mniej niezawodne odpowiedzi ECM. Zacznij od 1 lub 2. Jeśli czasy ECM są złe, zmniejsz liczbę, a nie zwiększaj.

Czytnik cs378x między dwoma boxami OScam w twojej sieci LAN

Jeśli łączysz dwie instalacje OScam, które kontrolujesz, użyj cs378x zamiast camd35 — jest szyfrowany, nie kosztuje cię nic w wydajności, a nie ma powodu, aby uruchamiać nieszyfrowaną wersję w swojej sieci w 2026 roku.

[reader]

A odpowiadająca strona w pliku oscam.user upstream boxa, abyś mógł zobaczyć parowanie grupy od początku do końca:

[account]

Zauważ, że group = 2 pojawia się po obu stronach. To cały trik — bez tego dopasowania, połączenie może być udane na poziomie TCP/logowania, a mimo to nigdy nie przekroczy pojedynczego klucza.

Odczytywanie statusu czytnika: Co oznaczają CONNECTED, OFF i NEEDINIT

Tutaj plik konfiguracyjny przestaje być abstrakcyjny i zaczyna być możliwy do debugowania. Kolumna statusu w zakładce Czytniki interfejsu webowego jest narzędziem diagnostycznym, jeśli wiesz, jak ją odczytać.

OFF

Albo enable=0 jest ustawione w bloku, albo — znacznie częściej dla początkujących — blok w ogóle nie został sparsowany. Wróć i potwierdź, że czytnik rzeczywiście pojawia się z oczekiwaną etykietą. Jeśli jest całkowicie brakujący, masz błąd składni lub zduplikowaną etykietę, a nie problem z łącznością.

CONNECTING lub NEEDINIT, w pętli

Blok został sparsowany, ale handshake nie kończy się. To prawie zawsze zły port, zły słowo kluczowe protokołu lub złe dane uwierzytelniające. Sprawdź ponownie device= w porównaniu do protocol= — linia urządzenia newcamd skierowana na port cccam będzie tutaj pętliła w nieskończoność.

CONNECTED, ale zero ECM wysłanych

To jest przypadek "połączony, ale nie dekodujący", z którym wszyscy w końcu się spotykają. CONNECTED tylko potwierdza, że sesja TCP i logowanie powiodły się — nic nie mówi o tym, czy czytnik jest rzeczywiście pytany o cokolwiek. Sprawdź w kolejności: czy wartość grupy czytnika pojawia się w linii grupy twojego klienta w oscam.user, czy linia caid/ident cicho filtruje kanał, który testujesz, i czy lista kart czytnika rzeczywiście zawiera ten CAID/dostawcę.

CONNECTED, ECM wysłane, wszystkie "nie znalezione"

Całkowicie inny problem — to oznacza, że żądanie dociera do czytnika poprawnie i on uczciwie odpowiada, że nie ma tego konkretnego klucza. W tym momencie źródło rzeczywiście nie ma CAID lub dostawcy, którego testujesz; żadna zmiana konfiguracji z twojej strony tego nie naprawi.

Śledź swój log za pomocą czegoś takiego jaktail -f /tmp/oscam.log | grep myreader1 (lokalizacja logu pochodzi z logfile= w oscam.conf, a nie oscam.server) i obserwuj liczniki wysłanych / znalezionych / nie znalezionych / przekroczeń czasu na czytniku, gdy dostrajasz się do kanału. Licznik wysłanych, który nigdy się nie zmienia, oznacza, że żądanie nigdy nie opuściło twojego urządzenia — to problem z routowaniem/grupą/filtracją. Licznik wysłanych, który rośnie, podczas gdy znaleziony pozostaje na zero, oznacza, że źródło go nie ma. Dwa całkowicie różne rozwiązania, a liczniki to jedyna rzecz, która je odróżnia.

Edycja w sposób bezpieczny: zasady składni, przeładowania i kopie zapasowe

Kilka nawyków zaoszczędzi ci naprawdę czas. Komentarze zaczynają się od #, a w niektórych wersjach komentarz w linii po wartości na tej samej linii nie jest honorowany — umieszczaj komentarze w osobnej linii dla bezpieczeństwa. Białe znaki i wielkość liter mają większe znaczenie, niż ludzie się spodziewają: protocol=cccam działa wszędzie, ale protocol = cccam z odstępami wokół znaku równości nie jest poprawnie analizowany w niektórych starszych wersjach. W razie wątpliwości, usuń odstępy.

Restart ponownie odczytuje całą konfigurację z dysku, w tym oscam.server. Przeładuj (gdzie dostępne) jest lżejsze i ponownie odczytuje węższy zestaw ustawień — gdy nie jesteś pewien, które z nich przyjęło twoją zmianę, użyj Restart i sprawdź zakładkę Readers.

Oto to, co pali ludzi: interfejs webowy OScam, gdy zapisujesz dowolną stronę konfiguracyjną, może przepisować oscam.server z własnego modelu w pamięci. To przepisanie usuwa komentarze i pomija każdy parametr, którego twoja konkretna wersja nie rozpoznaje. Dlatego trzymaj kopię zapasową poza katalogiem konfiguracyjnym — cp oscam.server oscam.server.bak — zanim dotkniesz czegokolwiek w edytorze webowym. Jeśli polegasz na komentarzach, aby zapamiętać, co robi blok, edytuj przez SSH zamiast przez zakładkę Pliki.

W przypadku obrazów Enigma2/Dreambox szczególnie zwróć uwagę na symlinkowane lub tylko do odczytu katalogi konfiguracyjne. Edycje przez interfejs webowy mogą wydawać się zapisywać poprawnie, a następnie cofać się po ponownym uruchomieniu, ponieważ rzeczywisty plik, który OScam odczytuje, znajduje się gdzie indziej — /etc/tuxbox/config w porównaniu do /usr/keys to częsty błąd w tych obrazach. Sprawdź ConfigDir na stronie statusu ponownie, jeśli zmiany nie są trwałe.

Ostatnia rzecz: nie każdy parametr istnieje w każdej wersji OScam. Uruchom oscam -V, aby zobaczyć informacje o swojej wersji, i sprawdź readme, które zostało dostarczone z twoim konkretnym źródłem, zamiast ufać parametrowi, który znalazłeś w pięcioletnim poście na forum. Nieznane parametry nie są odrzucane głośno — zazwyczaj są po prostu ignorowane, co jest dokładnie powodem, dla którego bloki skopiowane i wklejone z dodatkowymi liniami "działają", podczas gdy te dodatkowe linie nie robią absolutnie nic.

Wybór źródła czytnika bez poparzenia

Warto być bezpośrednim w tej kwestii: legalnym celem OScam jest umożliwienie komuś z ważną kartą subskrypcyjną korzystania z niej na własnych urządzeniach w swojej sieci — odczytywanie własnej karty z bezgłowego urządzenia w szafie zamiast pozostawiania odbiornika podłączonego bezpośrednio do telewizora. Dzielenie się subskrypcją poza własnym gospodarstwem domowym jest sprzeczne z warunkami praktycznie każdego dostawcy i jest nielegalne w wielu jurysdykcjach. Ten przewodnik dotyczy zrozumienia pliku konfiguracyjnego, a nie uzyskiwania dostępu, do którego nie masz prawa.

Jeśli oceniasz źródło czytnika sieciowego dla własnej legalnej subskrypcji, oceniaj je na podstawie mierzalnych rzeczy, a nie obietnic. Rozsądny czas odpowiedzi ECM jest znacznie poniżej sekundy na zdrowym łączu — jeśli widzisz wiele sekund konsekwentnie, coś jest nie tak w górę. Liczba skoków ma znaczenie, jak opisano powyżej: źródło nalegające na cccmaxhops wynoszące 5 lub więcej, aby "zdobyć wszystko", prosi cię o zaakceptowanie odległych, niepewnych kart zamiast naprawienia własnej konfiguracji. Pokrycie CAID powinno być konkretne i sprawdzalne, a nie niejasne roszczenie "wszystkiego".

Czerwone flagi, od których warto odejść: lista CAID, która jest nierealistycznie szeroka dla tego, co powinno być jedną lub dwiema kartami subskrypcyjnymi, brak chęci pozwolenia na testowanie przed zobowiązaniem się do czegokolwiek lub jakiekolwiek naciski na wyłączenie logowania lub ukrycie tego, do czego się łączysz. I nigdy nie używaj tego samego nazwy użytkownika i hasła w wielu źródłach — traktuj każdy zestaw danych logowania czytnika jako osobne, izolowane logowanie, tak jak traktowałbyś każde inne konto.