I. OScam Ekosistemine Giriş
Bu teknik rehber, OScam yazılımının ve “OScam Panel” olarak bilinen yönetim arayüzünün kurulumu, yapılandırılması ve bakımı için kapsamlı bir yol haritası sunmaktadır. Rapor, temel kavramlardan başlayarak farklı platformlar için özel kurulum yöntemlerine, gelişmiş yapılandırma parametrelerine ve yaygın sorun giderme senaryolarına kadar tüm süreci ayrıntılı bir şekilde ele almaktadır.
1.1. Kavram Ayrımı: Doğru “OSCam”i Tanımlama
Analize başlamadan önce, “OSCam” teriminin doğru bağlamda anlaşılması kritik öneme sahiptir. Bu rapor, yalnızca Açık Kaynak Koşullu Erişim Modülü (Open Source Conditional Access Module) olan OScam yazılımına odaklanmaktadır. Bu yazılım, “softcam” olarak bilinen bir yazılım türüdür ve temel işlevi, bir set üstü kutusu (uydu alıcısı) veya sunucu üzerindeki dijital televizyon kanallarının şifresini çözmektir. Fiziksel bir Koşullu Erişim Modülüne (CAM) yazılım tabanlı bir alternatif olarak hizmet eder.
Araştırma sırasında karşılaşılan benzer isme sahip diğer varlıklardan ayırt edilmesi zorunludur. Örneğin, profesyonel bir drone şirketi olan OSCAM UK veya Occam’ın Usturası olarak bilinen felsefi ilke bu yazılımla ilgisizdir ve bu raporun kapsamı dışındadır. OScam’deki “OS” ibaresi, yazılımın Açık Kaynak (Open Source) doğasını vurgular. Bu özellik, onu CCcam veya Mgcamd gibi kapalı kaynaklı alternatiflerden ayırır ve geliştirme sürecinin halka açık olmasını, topluluk katkılarına olanak tanımasını sağlar.
1.2. OScam Panel: Web Arayüzünü (WebIf) Anlamak
Kullanıcının “Oscam Panel” talebi, genellikle yazılımın içine gömülü olarak gelen ve resmi olarak WebIf (Web Arayüzü) olarak bilinen web tabanlı grafiksel kullanıcı arayüzünü ifade eder. Bu arayüz, OScam sunucusunun standart bir web tarayıcısı üzerinden izlenmesine, yönetilmesine ve yapılandırılmasına olanak tanır.
Bununla birlikte, ekosistemde genellikle ticari olan ve daha gelişmiş özellikler sunan üçüncü taraf “Oscam Panelleri” de mevcuttur. Bu paneller, bayi yönetimi, kullanıcı limitleri, güvenlik duvarı, WHMCS gibi faturalandırma sistemleri için API desteği ve toplu iletişim araçları gibi büyük ölçekli operasyonlar için tasarlanmış gelişmiş yetenekler sunan ayrı yazılım paketleridir. Bu durum, OScam kullanıcı tabanında bir ayrışmaya işaret etmektedir: standart araçları kullanan hobi amaçlı kullanıcılar ve daha gelişmiş otomasyon ve ölçeklenebilirlik özelliklerine ihtiyaç duyan ticari operatörler. Bu rehber, standart OScam yazılımının ve onun entegre WebIf arayüzünün kurulumuna odaklanacaktır. Üçüncü taraf paneller, kendi özel kurulum gereksinimlerine sahip oldukları için bu belgenin kapsamı dışındadır.
1.3. Çekirdek Mimari: Sunucular, Okuyucular ve Kullanıcılar
OScam, bir istemci-sunucu modeli üzerinde çalışır. Çekirdek OScam uygulaması, bir kart sunucusu (card server) olarak görev yapar. Bu mimarinin temel bileşenleri şunlardır:
- Okuyucular (Readers): Bunlar, şifre çözme anahtarlarının kaynaklarıdır. Bir okuyucu, sunucuya bağlı fiziksel bir akıllı kart okuyucu (örneğin, bir uydu alıcısındaki dahili yuva veya Smargo gibi USB tabanlı bir okuyucu) olabileceği gibi, başka bir uzak kart sunucusuna yapılan mantıksal bir bağlantı da olabilir. Temelde bir okuyucu, yetkilendirme verilerini “okur”.
- Kullanıcılar/Hesaplar (Users/Accounts): Bunlar, belirli bir kanal için şifre çözme anahtarları talep etmek üzere OScam sunucusuna bağlanan istemcilerdir. Her kullanıcı, hangi okuyuculara (ve dolayısıyla hangi kanallara) erişebileceklerini belirleyen kimlik bilgileri ve izinlerle tanımlanır.
1.4. Anahtar Yapılandırma Dosyalarına Genel Bakış
OScam’in davranışı, temel olarak bir dizi düz metin yapılandırma dosyası tarafından kontrol edilir. Ayarların birçoğu WebIf aracılığıyla düzenlenebilse de, bu dosyaların temel düzeyde anlaşılması, gelişmiş kurulum ve sorun giderme için esastır.
oscam.conf
: Ana yapılandırma dosyasıdır. Genel ayarları, günlükleme (logging) parametrelerini, WebIf yapılandırmasını ve Newcamd ile DVB-API gibi çeşitli protokollerin ayarlarını içerir.oscam.server
: Bu dosya, tüm “okuyucuları” tanımlar. Her bir[reader]
bölümü, ister yerel bir fiziksel kart olsun ister uzak bir sunucuya bağlantı olsun, şifre çözme anahtarları için bir kaynak belirtir.oscam.user
: Bu dosya, tüm istemci “hesaplarını” tanımlar. Her bir[account]
bölümü, kullanıcının kimlik bilgilerini, izinlerini ve belirli okuyucu gruplarına erişim haklarını içerir.
II. Kurulum Öncesi Hazırlık ve Sistem Gereksinimleri
OScam kurulumuna geçmeden önce, sistemin donanım ve yazılım gereksinimlerini karşıladığından ve gerekli tüm bağımlılıkların yüklendiğinden emin olunmalıdır. Kurulum yönteminin seçimi, büyük ölçüde hedef donanıma ve kullanıcının amacına bağlıdır.
2.1. Genel Sistem Gereksinimleri
- İşletim Sistemi: OScam, yüksek taşınabilirliğe sahip olup çoğu Linux dağıtımında çalışır. Debian ve Ubuntu sıkça referans gösterilen sistemlerdir. Ayrıca CentOS , OpenATV gibi gömülü cihazlar için özelleştirilmiş Linux tabanlı işletim sistemleri ve Raspberry Pi OS (eski adıyla Raspbian) üzerinde de yaygın olarak kullanılmaktadır.
- Sistem Kaynakları: Temel bir sunucu için kaynak gereksinimleri minimum düzeydedir. Üçüncü taraf bir panel, minimum 1GB RAM belirtmektedir , bu da WebIf ile bir OScam sunucusu çalıştırmak için güvenli bir başlangıç noktasıdır. CPU kullanımı değişkenlik gösterebilir; bazı raporlar, birden fazla USB kart okuyucu kullanıldığında yüksek CPU yükü oluştuğunu belirtmektedir.
2.2. Derleme için Gerekli Ön Koşullar
Yazılımı kaynaktan derlemeyi seçen kullanıcılar için (en esnek yöntem), belirli bir geliştirme araçları setinin kurulması gerekmektedir. Bu araçlar, çeşitli rehberlerde tutarlı bir şekilde listelenmiştir.
- Derleme Araç Zinciri:
gcc
,g++
,make
vecmake
zorunludur. - Sürüm Kontrolü: Kaynak kodunu resmi depolardan çekmek için bir Subversion istemcisi (
svn
) gereklidir. - Çekirdek Kütüphaneler:
libssl-dev
(kriptografik fonksiyonlar için),libpcsclite-dev
(PC/SC akıllı kart okuyucuları için) velibusb-1.0-0-dev
(USB cihaz desteği için) temel bağımlılıklardır. - Kurulum Komutları:
- Debian/Ubuntu üzerinde:
sudo apt-get install build-essential cmake subversion libpcsclite-dev libssl-dev libusb-1.0-0-dev
- CentOS üzerinde:
sudo yum install gcc gcc-c++ make cmake subversion pcsc-lite-devel openssl-devel libusb1-devel
- Debian/Ubuntu üzerinde:
2.3. Donanım Değerlendirmeleri
- Ana Platform: OScam, CentOS çalıştıran yüksek performanslı Dell sunucularından , Raspberry Pi gibi düşük güçlü tek kartlı bilgisayarlara ve Vu+, Zgemma, Amiko gibi özel uydu alıcılarına kadar geniş bir donanım yelpazesinde kurulabilir.
- Akıllı Kart Okuyucular: Yerel bir abonelik kartı kullanmak için fiziksel bir kart okuyucu gereklidir. Yaygın türler şunlardır:
- Dahili Okuyucular: Uydu alıcılarına entegre edilmiş olanlar (örneğin,
/dev/sci0
). - USB Okuyucular: Smargo veya Omnikey gibi harici cihazlar. Bunlar genellikle sistemde
/dev/ttyUSB0
veya bir USB veri yolu yolu (USB bus path) olarak görünür.pcscd
velibccid
gibi sürücüler gerekebilir.
- Dahili Okuyucular: Uydu alıcılarına entegre edilmiş olanlar (örneğin,
Hedef donanım seçimi, en uygun kurulum yöntemini doğrudan belirler. Örneğin, tam teşekküllü bir sunucu (Debian/CentOS), Docker gibi daha sağlam yöntemlere veya maksimum kontrol için kaynaktan derlemeye daha uygundur ve genellikle merkezi sunucu olarak kullanılır. Öte yandan, bir gömülü alıcı (OpenATV) üzerindeki kurulum, ortamın kısıtlı olması ve yazılımın alıcının mevcut yazılımıyla (örneğin, Softcam Paneli) entegre olması gerektiğinden, oldukça spesifik .ipk
paket yöntemini kullanır ve bu cihazlar genellikle istemci olarak işlev görür.
III. Standart Linux Sistemleri için Kurulum Rehberi (Debian, Ubuntu, CentOS)
Bu bölüm, standart sunucu veya masaüstü Linux dağıtımlarında OScam kurmak için üç temel yöntemi adım adım açıklamaktadır. Her yöntemin kendine özgü avantajları ve kullanım senaryoları bulunmaktadır.
3.1. Yöntem 1: Kaynak Kodundan Derleme (İleri Düzey Kullanıcılar için Önerilir)
Bu yöntem, en güncel özelliklere ve hata düzeltmelerine doğrudan geliştiricilerden erişim sağlayarak en fazla kontrolü sunar. Süreç, çoğu Linux dağıtımında tutarlıdır. OScam topluluğundaki yaygınlığı, kullanıcıların paket yöneticilerinin yavaş güncelleme döngülerini beklemek yerine en son kod değişikliklerine anında erişme arzusunu yansıtmaktadır. Bu, özellikle yayıncıların şifreleme sistemlerinde yaptığı değişikliklere hızlı bir şekilde uyum sağlama ihtiyacından kaynaklanmaktadır.
- Adım 1: Ön Koşulları Kurun: Bölüm 2.2’de ayrıntılı olarak açıklanan tüm geliştirme araçlarını ve kütüphaneleri kurun.
- Adım 2: Kaynak Kodunu İndirin:
svn
komutunu kullanarak OScam’in en son sürümünü resmi Streamboard deposundan indirin.Bashcd /usr/src sudo svn checkout http://www.streamboard.tv/svn/oscam/trunk oscam-svn
- Adım 3: Derlemeyi Yapılandırın: Bir derleme dizini oluşturun ve derleme dosyalarını hazırlamak için
cmake
komutunu çalıştırın.Bashcd oscam-svn sudo mkdir build cd build sudo cmake..
- Adım 4: İsteğe Bağlı Modülleri Ekleyin (Opsiyonel):
cmake
komutuna bayraklar ekleyerek belirli özellikleri etkinleştirebilirsiniz. Web arayüzünü (WebIf) etkinleştirmek yaygın bir örnektir.Bashsudo cmake -DWEBIF=1..
- Adım 5: Yazılımı Derleyin: Kaynak kodunu çalıştırılabilir bir ikili dosyaya dönüştürmek için
make
komutunu çalıştırın.Bashsudo make
- Adım 6: İkili Dosyayı Kurun: Derlenmiş
oscam
dosyasını/usr/local/bin
gibi bir sistem yoluna kopyalayın.Bashsudo make install
- Adım 7: Yapılandırma Dosyalarını Yerleştirin: Servisi başlatmadan önce
oscam.conf
,oscam.server
veoscam.user
dosyalarınızın/usr/local/etc/
dizininde bulunduğundan emin olun.
3.2. Yöntem 2: Paket Yöneticilerini Kullanma (Ubuntu’da Basitlik için Önerilir)
Bu yöntem daha basittir ancak OScam’in en son sürümünü sağlamayabilir.
- Ubuntu için (PPA ile):
- Adım 1: OScam PPA’sını Ekleyin: Bu depo, önceden derlenmiş paketleri içerir.Bash
sudo apt-get install software-properties-common sudo add-apt-repository ppa:oscam/ppa sudo apt-get update
- Adım 2: OScam’i Kurun:Bash
sudo apt-get install oscam
- Not: Bu yöntemle kurulan yapılandırma dosyaları genellikle
/etc/oscam/
dizininde bulunur.
- Adım 1: OScam PPA’sını Ekleyin: Bu depo, önceden derlenmiş paketleri içerir.Bash
- Snap Etkin Herhangi bir Linux için:
- Adım 1: Snap Paketini Kurun:Bash
sudo snap install oscam
- Not: Yapılandırma dosyaları
/var/snap/oscam/current/etc/oscam/
dizininde bulunur ve WebIf varsayılan olarak 8083 portunu kullanır.
- Adım 1: Snap Paketini Kurun:Bash
3.3. Yöntem 3: Docker ile Konteynerleştirilmiş Dağıtım (Sunucular için Önerilir)
Bu yöntem, OScam ve bağımlılıklarını yalıtılmış bir konteyner içinde paketleyerek dağıtımı ve yönetimi basitleştirir. linuxserver.io
imajı, bu amaçla kullanılan popüler ve iyi bakımlı bir seçenektir.
- Adım 1: Docker ve Docker Compose’u Kurun.
- Adım 2: Ana Makine Ortamını Hazırlayın: Ana makinede yapılandırma dosyalarını saklamak için bir dizin oluşturun (örneğin,
/opt/oscam/config
). Bu dosyaların sahibi olacak kullanıcınınPUID
(Kullanıcı ID) vePGID
(Grup ID) değerleriniid <kullanıcı_adı>
komutuyla öğrenin. - Adım 3: Docker Compose ile Dağıtın (Tercih Edilen): Aşağıdaki içeriğe sahip bir
docker-compose.yml
dosyası oluşturun:YAML--- services: oscam: image: lscr.io/linuxserver/oscam:latest container_name: oscam environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC volumes: - /path/to/oscam/data:/config ports: - 8888:8888 devices: - /dev/ttyUSB0:/dev/ttyUSB0 # USB okuyucu için örnek restart: unless-stopped
Ardındansudo docker-compose up -d
komutunu çalıştırın. - Adım 4: Donanım Geçişi (Passing Through Hardware):
devices
bölümü, fiziksel kart okuyucuları kullanmak için hayati öneme sahiptir. Ana makinedeki cihaz yolunu (örneğin,/dev/ttyUSB0
veya/dev/bus/usb/001/001
) konteyner içine eşlemeniz gerekir.
IV. Gömülü ve Özel Platformlar için Kurulum Rehberi
OScam’in gömülü sistemlerdeki kurulum deneyimi, standart Linux sistemlerinden temel olarak farklıdır ve genellikle daha çok bir “cihaz” yönetimi modelini yansıtır. Bu platformlarda kullanıcı etkileşimi, komut satırı yerine uzaktan kumanda ve grafiksel menüler üzerinden gerçekleşir.
4.1. Yöntem 1: Enigma2 Tabanlı Uydu Alıcıları (ör. OpenATV)
Bu süreç, OpenATV gibi bir yazılım çalıştıran gömülü Linux alıcılarına özgüdür. Önceden paketlenmiş .ipk
dosyalarına ve alıcının yerleşik menülerine dayanır. Bu yaklaşım, son kullanıcının teknik karmaşıklıklarla uğraşmadan, bir “uygulama” kurar gibi softcam’i etkinleştirmesini sağlar.
- Adım 1: OpenATV İmajını Yükleyin: Alıcınız için doğru imajı indirin, FAT32 formatlı bir USB belleğe kopyalayın ve ekrandaki talimatları izleyerek alıcıya yükleyin.
- Adım 2: Ağ Yapılandırması ve SSH Erişimi: İlk kurulum sihirbazını tamamlayın ve alıcının bir IP adresi aldığından emin olun. SSH üzerinden
passwd
komutunu kullanarak bir root şifresi belirleyin. - Adım 3: OScam
.ipk
Paketini Alın ve Aktarın: Alıcınızın mimarisine (örneğin, MIPS veya ARM) uygunsoftcam-oscam-emu...ipk
dosyasını indirin. WinSCP gibi bir SCP istemcisi veyascp
komutunu kullanarak.ipk
dosyasını alıcıdaki/tmp
veya/root
dizinine yükleyin. - Adım 4: Paketi Kurun: SSH üzerinden bağlanın ve
opkg
paket yöneticisini kullanarak paketi kurun.Bashopkg install /path/to/enigma2-plugin-softcams-oscam....ipk
- Adım 5: Softcam’i Etkinleştirin: Alıcının uzaktan kumandasını kullanarak Softcam Paneline gidin (örneğin, Menü -> Bilgi Paneli -> Softcam paneli). Listeden OScam’i seçin ve başlatmak/etkinleştirmek için yeşil düğmeye basın. Durum “CAM1 aktif” olarak değişmelidir.
- Adım 6: Yapılandırma: Enigma2 sistemlerinde OScam yapılandırma dosyaları genellikle
/etc/tuxbox/config/
veya/usr/keys/
dizininde bulunur.
4.2. Yöntem 2: Raspberry Pi (Raspberry Pi OS)
Raspberry Pi, bir OScam sunucusu çalıştırmak için yetenekli bir platformdur. Kurulum süreci, Raspberry Pi OS’nin Debian tabanlı olması nedeniyle, Debian üzerinde kaynaktan derleme yöntemiyle neredeyse aynıdır.
- Bölüm 3.1: Yöntem 1: Kaynak Kodundan Derleme başlığında özetlenen adımları izleyin. Aynı ön koşullar ve komutlar geçerlidir.
- Performans Değerlendirmeleri: Potansiyel performans sorunlarına dikkat edilmelidir. Bir kullanıcı, güçlendirilmiş bir USB hub kullanmasına rağmen beş Smargo okuyucu bağladığında %50’ye varan yüksek CPU kullanımı bildirdi. Bu durum, özellikle Pi gibi düşük güçlü cihazlarda USB yönetimi veya CPU gücünde potansiyel darboğazlara işaret etmektedir.
V. İlk Panel Yapılandırması ve Çekirdek Kurulum
OScam başarıyla kurulduktan sonra, Web Arayüzü (WebIf) aracılığıyla temel güvenlik ayarlarının yapılması, okuyucuların ve kullanıcıların yapılandırılması gerekir. Bu adımlar, sistemin kararlı ve güvenli bir şekilde çalışması için zorunludur.
5.1. OScam Web Arayüzüne (WebIf) İlk Erişim
- Bir web tarayıcısı açın ve
http://<sunucu_ip>:<port>
adresine gidin. - Varsayılan port, kurulum yöntemine göre değişiklik gösterir:
- 8888: Kaynaktan derlemeler ve Docker imajları için yaygındır.
- 8081: OpenPLi paketleri için varsayılandır.
- 8083: Snap paketi için varsayılandır.
- 1211: Bir kılavuzda belirtilmiştir.
- Bu port,
oscam.conf
dosyasının[webif]
bölümündekihttpport
parametresi ile tanımlanır.
5.2. Temel Güvenlik: Panelinizi Güvence Altına Alma
- Adım 1: Varsayılan Kimlik Bilgilerini Değiştirin: Bu, en kritik ilk adımdır. Varsayılan kimlik bilgileri genellikle
admin
/admin
şeklindedir ve derhal değiştirilmelidir.- Bu işlem,
oscam.conf
dosyasının[webif]
bölümündekihttpuser
vehttppwd
parametreleri ayarlanarak yapılır.
- Bu işlem,
- Adım 2: Ağ Erişimini Kısıtlayın: WebIf’e erişimine izin verilen IP adreslerini veya aralıklarını beyaz listeye almak için
httpallowed
parametresini kullanın. Bu, internetten yetkisiz erişimi önlemek için çok önemli bir güvenlik önlemidir.- Örnek:
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255
.
- Örnek:
- Adım 3: Güvenlik Duvarı Yapılandırması: Sistemin güvenlik duvarını devre dışı bırakmayın. Bunun yerine, yalnızca gerekli portları (örneğin, WebIf portu ve yapılandırdığınız protokol portları) açın.
5.3. Okuyucu Yapılandırması (WebIf üzerinden)
Bu süreç, OScam’in şifre çözme anahtarlarını nereden alacağını tanımlar.
- Adım 1: “Readers” Sekmesine Gidin.
- Adım 2: Yeni Bir Okuyucu Ekleyin: “Add Reader” düğmesine tıklayın. Bir
label
(benzersiz bir isim) sağlamanız veprotocol
seçmeniz gerekecektir. - Adım 3: Okuyucuyu Yapılandırın:
- Yerel Bir Kart Okuyucu için:
- Protocol:
mouse
,internal
veyapcsc
. - Device: Okuyucunun yolu (örneğin,
/dev/sci0
,/dev/ttyUSB0
). - Group: Numaralandırılmış bir gruba atayın (örneğin,
1
). Bu, kullanıcıları okuyuculara bağlamak için zorunludur.
- Protocol:
- Uzak Bir Sunucu için (İstemci Modu):
- Protocol:
cccam
,newcamd
veyacs357x
. - Device: Uzak sunucunun IP/ana bilgisayar adı ve portu, virgülle ayrılmış olarak (örneğin,
uzak.sunucu.com,12000
). - User/Password: Uzak sunucuya giriş yapmak için kimlik bilgileri.
- Group: Bir gruba atayın.
- Protocol:
- Yerel Bir Kart Okuyucu için:
- Adım 4: Kaydedin ve Etkinleştirin: Yapılandırmayı kaydedin. Okuyucu listede görünmelidir. Durumunun “CONNECTED” veya benzeri bir şekilde göründüğünden emin olun. Bir açma/kapama düğmesine tıklayarak etkinleştirmeniz gerekebilir.
5.4. Kullanıcı Yönetimi (WebIf üzerinden)
Bu süreç, OScam sunucunuza bağlanacak istemciler için hesaplar oluşturur.
- Adım 1: “Users” Sekmesine Gidin.
- Adım 2: Yeni Bir Kullanıcı Ekleyin: “Add User” düğmesine tıklayın ve bir kullanıcı adı sağlayın.
- Adım 3: Kullanıcı Hesabını Yapılandırın:
- Password: Kullanıcı için güçlü bir şifre belirleyin.
- Group: Bu en önemli ayardır. Kullanıcıyı, erişim sağlaması gereken okuyuculara atadığınız aynı grup numaralarına atayın. Bu “Grup” mekanizması, OScam’in temel erişim kontrol mimarisini oluşturur. Bir kullanıcıya atanan grup numaraları, o kullanıcının hangi okuyucu kaynaklarını kullanabileceğini belirler, bu da farklı abonelik paketlerine veya hizmetlere erişimi ayırmak için esnek bir yol sunar.
- AU (Auto Update): Bu kullanıcının kart güncellemelerini (EMM’ler) kartınıza geri göndermesine ve kartı aktif tutmasına izin vermek için
1
olarak veya belirli bir yerel okuyucununlabel
‘ı olarak ayarlayın.
- Adım 4: Kullanıcıyı Kaydedin.
VI. Gelişmiş Yapılandırma Parametre Referansı
Bu bölüm, OScam’in davranışını ince ayar yapmak için kullanılan en önemli yapılandırma parametrelerini, her bir anahtar dosya için düzenlenmiş tablolar halinde sunmaktadır. Bu referanslar, çeşitli kaynaklardan derlenmiş bilgileri tek bir merkezi yerde toplayarak kullanıcıların yapılandırma sürecini kolaylaştırmayı amaçlamaktadır.
6.1. Tablo 1: oscam.conf
Parametreleri Açıklaması
Bu tablo, genel sunucu davranışı, günlükleme, WebIf ve protokoller için temel parametreleri detaylandırmaktadır.
Parametre | Bölüm | Açıklama | Örnek |
logfile | [global] | Ana günlük dosyasının yolunu tanımlar. Konsola yazdırmak için stdout kullanılabilir. | logfile = /var/log/oscam.log |
nice | [global] | İşlem önceliğini ayarlar (-20 ila +20). Düşük değer, daha yüksek öncelik anlamına gelir. | nice = -1 |
maxlogsize | [global] | Döndürülmeden önce günlük dosyasının KB cinsinden maksimum boyutunu ayarlar. | maxlogsize = 200 |
httpport | [webif] | Web Arayüzü için TCP portu. | httpport = 8888 |
httpuser | [webif] | WebIf girişi için kullanıcı adı. | httpuser = admin |
httpallowed | [webif] | WebIf’e bağlanmasına izin verilen IP’lerin/aralıkların virgülle ayrılmış listesi. | httpallowed = 127.0.0.1,192.168.1.0/24 |
enabled | [dvbapi] | TV yazılımıyla (Tvheadend gibi) doğrudan iletişim için DVB-API’yi etkinleştirir. | enabled = 1 |
user | [dvbapi] | DVB-API istemcisinin kullanacağı oscam.user dosyasındaki kullanıcı adı. | user = tvheadend |
port | [newcamd] | Newcamd protokolü için dinleme portunu ve ilişkili CAID/sağlayıcıyı tanımlar. | port = 15050@0963:000000 |
key | [newcamd] | Newcamd iletişimi için 14 baytlık DES anahtarı. | key = 0102030405060708091011121314 |
E-Tablolar’a aktar
6.2. Tablo 2: oscam.server
Parametreleri Açıklaması
Bu tablo, farklı protokoller ve donanım ayarlarını kapsayan [reader]
bölümüne odaklanmaktadır.
Parametre | Protokol(ler) | Açıklama | Örnek |
label | Tümü | Okuyucu için benzersiz, kullanıcı tanımlı bir isim. | label = yerel_kart |
protocol | Tümü | Okuyucu için iletişim protokolü. | protocol = internal |
device | Tümü | Cihaz yolu veya ağ adresi. Ağ protokolleri için hostname,port kullanın. | device = /dev/sci0 veya device = sunucu.com,12000 |
user | cccam, newcamd | Uzak bir sunucuya bağlanmak için kullanıcı adı. | user = uzak_kullanici |
group | Tümü | Okuyucuyu bir veya daha fazla gruba (1-64) atar. Erişim kontrolü için esastır. | group = 1,3 |
caid | Tümü | Okuyucuyu belirli CAID’lerle sınırlar. | caid = 0963 |
boxid | internal, mouse | Bazı kart sistemleri (ör. Nagra) tarafından istenen özel bir donanım kimliği. | boxid = 12345678 |
rsakey , boxkey | internal, mouse | Bazı kart sistemleri (ör. Nagra, Irdeto) tarafından istenen özel anahtarlar. | rsakey = AABB...FF |
cccversion | cccam | Taklit edilecek CCcam protokol sürümünü belirtir. | cccversion = 2.3.0 |
emmcache | Tümü | Kart güncellemelerinin (EMM’ler) nasıl önbelleğe alınacağını ve yazılacağını yapılandırır. | emmcache = 1,3,2 |
E-Tablolar’a aktar
6.3. Tablo 3: oscam.user
Parametreleri Açıklaması
Bu tablo, istemcileri tanımlamak için [account]
bölümünü detaylandırmaktadır.
Parametre | Açıklama | Örnek |
user | İstemcinin giriş kullanıcı adı. | user = oturma_odasi |
pwd | İstemcinin şifresi. | pwd = gizlisifre |
group | Kullanıcıyı okuyucu gruplarına atar. Bu, birincil erişim kontrol mekanizmasıdır. | group = 1,3 |
au | Bu kullanıcının kartları güncellemek için EMM göndermesine izin verir. Gruptaki tüm okuyucular için 1 veya belirli bir okuyucu label ‘ı olarak ayarlayın. | au = 1 |
caid | Kullanıcının erişimini belirli CAID’lerle sınırlar. | caid = 0963,0100 |
ident | Bir CAID içindeki belirli sağlayıcı kimliklerine erişimi sınırlar. | ident = 0100:00006A |
services | Önceden tanımlanmış hizmet listelerine (kanallar) erişim atar veya reddeder. | services =!hd_kanallar |
uniq | Bağlantı benzersizliğini kontrol eder (ör. 1 = kullanıcı başına yalnızca bir bağlantıya izin verilir). | uniq = 1 |
cccmaxhops | CCcam istemcileri için, kartları kaç “atlama” uzaktan alabileceklerini tanımlar. | cccmaxhops = 1 |
expdate | Hesap için YYYY-AA-GG formatında bir son kullanma tarihi belirler. | expdate = 2025-12-31 |
E-Tablolar’a aktar
VII. Sorun Giderme ve Bakım
Bu bölüm, OScam kurulumu ve kullanımı sırasında karşılaşılabilecek yaygın sorunları ele alır ve bu sorunları teşhis edip çözmek için pratik adımlar sunar. Etkili günlük analizi ve düzenli bakım, kararlı bir sistemin anahtarıdır.
7.1. Yaygın Sorunlar ve Çözümleri
Aşağıdaki tablo, forumlarda ve GitLab sorun kayıtlarında gözlemlenen yaygın sorunları ve bunlara yönelik çözüm önerilerini özetlemektedir.
Belirti | Olası Neden(ler) | Çözüm / Teşhis Adımları |
Derleme sırasında make komutu başarısız oluyor. | Eksik bağımlılıklar (build-essential , cmake , vb.). | Bölüm 2.2’deki apt-get veya yum komutunu yeniden çalıştırarak tüm ön koşulların kurulu olduğundan emin olun. |
Kart okuyucu (ör. Smargo) algılanmıyor. | Eksik çekirdek sürücüleri, pcscd servisinin çalışmaması, oscam.server dosyasında yanlış cihaz yolu. | Cihazın işletim sistemi tarafından görüldüğünü doğrulamak için dmesg veya lsusb kullanın. pcscd servisinin aktif olduğunu kontrol edin. device = yolunu iki kez kontrol edin. |
İstemci “zaman aşımı” hatası alıyor veya görüntü periyodik olarak donuyor. | Ağ gecikmesi; oscam.conf dosyasında yanlış clienttimeout ayarı; yavaş okuyucu. | Ağ bağlantısını kontrol edin. oscam.conf dosyasında clienttimeout değerini artırmayı deneyin. WebIf durum sayfasında okuyucu ECM sürelerini analiz edin. |
Okuyucu durumu “ERROR” veya “DISCONNECTED” olarak görünüyor. | oscam.server dosyasında yanlış IP, port, kullanıcı adı veya şifre. Güvenlik duvarının bağlantıyı engellemesi. | Uzak okuyucu için tüm bağlantı ayrıntılarını doğrulayın. İstemci ve sunucu arasındaki tüm güvenlik duvarlarında portun açık olduğundan emin olun. |
OpenATV Softcam Panelinde yeni OScam sürümü seçilemiyor. | OpenATV’de eski softcam’in kaldırılmadan önce seçiminin kaldırılması gereken bir hata. | Panelde mevcut softcam’i devre dışı bırakın, ardından eski paketi kaldırın, yeni paketi kurun ve son olarak yeni sürümü etkinleştirin. |
Birden fazla USB okuyucu ile yüksek CPU kullanımı. | Özellikle Raspberry Pi gibi düşük güçlü cihazlarda potansiyel USB sürücüsü veya donanım darboğazı. | Yüksek kaliteli, güçlendirilmiş bir USB hub kullanıldığından emin olun. Mümkünse okuyucuları farklı USB denetleyicilerine dağıtmayı deneyin. Sistem günlüklerini USB ile ilgili hatalar için izleyin. |
7.2. OScam Günlükleri ile Etkili Hata Ayıklama
Sorun giderme için birincil araç, oscam.conf
dosyasındaki logfile
parametresi ile tanımlanan OScam günlük dosyasıdır.
- Canlı Günlük İzleme: Bir istemci bağlanmaya veya bir kanalı çözmeye çalışırken günlüğü gerçek zamanlı olarak izlemek için
tail -f /path/to/oscam.log
komutunu kullanın. - Günlük Girdilerini Yorumlama: Başarılı ECM istekleri, kullanıcı giriş hataları, okuyucu bağlantı hataları gibi yaygın günlük mesajları, sorunun kaynağını belirlemede yardımcı olur. WebIf ayrıca canlı bir günlük görüntüleyici sunar.
7.3. Mevcut Bir Kurulumu Güncelleme Yöntemleri
Güncelleme prosedürü, orijinal kurulum yöntemine bağlıdır.
- Kaynak Derlemesi: Kaynak dizinine (
/usr/src/oscam-svn
) gidin, en son kodu almak içinsudo svn update
komutunu çalıştırın, ardındancd build
,sudo make
vesudo make install
komutlarını yeniden çalıştırın. Yeni ikili dosyayı kurmadan önce OScam servisini durdurmak iyi bir uygulamadır. - PPA/Snap: Sistemi güncellemek için sistemin paket yöneticisini kullanın (
sudo apt-get upgrade
veyasudo snap refresh oscam
). - Docker: En son imajı çekin (
docker-compose pull oscam
veyadocker pull lscr.io/linuxserver/oscam:latest
) ve ardından konteyneri yeniden oluşturun (docker-compose up -d
veyadocker stop/rm/run
). Eşlenmiş birimdeki yapılandırma korunacaktır.
VIII. Sonuç ve Stratejik Öneriler
Bu rehber, OScam yazılımının ve yönetim panelinin kurulumu ve yapılandırılması için çeşitli platformlara ve kullanıcı seviyelerine yönelik ayrıntılı metodolojiler sunmuştur. Analiz, doğru kurulum yönteminin seçilmesinin, sistemin kararlılığı ve yönetilebilirliği üzerinde doğrudan bir etkisi olduğunu ortaya koymaktadır.
8.1. Kurulum Yöntemleri ve Kullanım Senaryoları Özeti
Kullanıcıların kendi özel senaryoları için en iyi yöntemi seçmelerine yardımcı olmak amacıyla aşağıdaki öneri matrisi sunulmuştur:
Senaryo | Önerilen Yöntem | Gerekçe |
Merkezi Sunucu (Yüksek Kontrol) | Kaynak Kodundan Derleme | En son özelliklere ve hata düzeltmelerine anında erişim sağlar. İleri düzey kullanıcılar için idealdir. |
Merkezi Sunucu (Kolay Yönetim) | Docker ile Dağıtım | Yalıtılmış, taşınabilir ve kolayca güncellenebilir bir ortam sunar. Sunucu ortamları için en iyi uygulamadır. |
Masaüstü/Ubuntu (Basitlik) | PPA ile Paket Yöneticisi | Hızlı ve basit bir kurulum süreci sunar, ancak en son sürümleri içermeyebilir. |
Gömülü Uydu Alıcısı (örn. OpenATV) | .ipk Paketi | Cihazın mevcut yazılımıyla tam entegrasyon sağlar ve uzaktan kumanda ile yönetime olanak tanır. |
Düşük Güçlü Cihaz (örn. Raspberry Pi) | Kaynak Kodundan Derleme | Platform için optimize edilmiş, hafif bir ikili dosya oluşturulmasını sağlar. |
E-Tablolar’a aktar
8.2. Kararlı ve Güvenli Bir Ortam için Nihai Öneriler
OScam sisteminin uzun vadeli sağlığı ve güvenliği için aşağıdaki stratejik önerilere uyulması tavsiye edilir:
- Güvenliği Önceliklendirin: Varsayılan parolaları değiştirmek, WebIf erişimini
httpallowed
parametresi ile kısıtlamak ve sistem güvenlik duvarlarını doğru şekilde yapılandırmak, yetkisiz erişime karşı ilk savunma hattıdır ve asla göz ardı edilmemelidir. - Düzenli Yedekleme Yapın: Yapılandırma dizini (
/usr/local/etc
,/etc/oscam
veya Docker birim yolu), sistemin kalbidir. Bu dosyaların düzenli olarak yedeklenmesi, olası bir sistem arızası veya yanlış yapılandırma durumunda hızlı bir geri dönüş sağlar. - Aşamalı Yapılandırma Uygulayın: Özellikle yeni başlayanlar için, sisteme karmaşıklığı kademeli olarak eklemek en iyisidir. Tek bir yerel okuyucu ve tek bir kullanıcı ile başlayarak sistemi çalışır duruma getirin. Ardından, yeni okuyucular, kullanıcılar veya protokoller ekleyerek yapılandırmayı genişletin. Bu yaklaşım, sorun gidermeyi önemli ölçüde kolaylaştırır.
- Resmi Kaynaklardan Yararlanın: Bu rehberde ele alınmayan daha karmaşık sorunlar veya özellikler için, resmi OScam wiki’si ve geliştirici destek forumları en güvenilir bilgi kaynaklarıdır. Aktif topluluk, genellikle en güncel sorunlara ve çözümlere dair değerli bilgiler sunar.