Skip to main content

Vyzkoušet 05.08.2025 - instalace Oscamu na RPI Claude

🔧 Kompletní návod na instalaci OSCam na Raspberry Pi

✅ Co budeš potřebovat

  • Raspberry Pi 4/5 s připojením k síti
  • microSD karta (min. 16 GB doporučeno)
  • Aktuální Raspberry Pi OS Lite 64bit (Bookworm)
  • Přístup přes SSH nebo připojený monitor a klávesnici

🔧 1. Příprava systému

⬇️ Stáhni OS a nahraj na SD kartu

  1. Stáhni Raspberry Pi Imager: https://www.raspberrypi.com/software
  2. Vyber:
    • OS: Raspberry Pi OS Lite (64-bit)
    • Úložiště: Vyber SD kartu
    • Klikni na ⚙️ a nastav:
      • povolit SSH
      • uživatel: pi, heslo dle výběru
      • nastavení WiFi (pokud nepoužíváš Ethernet)
  3. Nahraj obraz na SD kartu

🔌 První spuštění a základní nastavení

  1. Vlož SD kartu do Pi a zapni ho
  2. Přihlaš se přes SSH: ssh pi@IP_ADRESA nebo lokálně
  3. Získej práva roota:
sudo -i
  1. Aktualizuj systém:
apt update && apt full-upgrade -y
reboot

Po restartu se znovu přihlaš jako root: sudo -i

⚙️ 2. Instalace balíků pro kompilaci OSCam

Nainstaluj všechny potřebné balíky pro kompilaci:

apt install -y build-essential libssl-dev libpcsclite-dev libusb-1.0-0-dev cmake subversion pcscd pcsc-tools git

Vysvětlení balíků:

  • build-essential - základní nástroje pro kompilaci (gcc, make atd.)
  • libssl-dev - SSL knihovny pro šifrování
  • libpcsclite-dev - podpora pro čtečky karet
  • libusb-1.0-0-dev - USB podpora
  • cmake - build systém
  • git - pro stažení zdrojových kódů

📥 3. Vytvoření uživatele a adresářů

Vytvoření dedikovaného uživatele oscam

# Vytvoř systémového uživatele oscam (bez domovského adresáře v /home)
useradd -r -s /bin/false -d /opt/oscam oscam

Vytvoření adresářové struktury

# Vytvoř hlavní adresář pro oscam
mkdir -p /opt/oscam

# Vytvoř podadresáře
mkdir -p /opt/oscam/bin          # Pro binární soubor oscam
mkdir -p /opt/oscam/config       # Pro konfigurační soubory
mkdir -p /opt/oscam/logs         # Pro log soubory
mkdir -p /opt/oscam/tmp          # Pro dočasné soubory

# Nastav vlastnictví všech adresářů na uživatele oscam
chown -R oscam:oscam /opt/oscam

# Nastav správná oprávnění
chmod 755 /opt/oscam
chmod 755 /opt/oscam/bin
chmod 755 /opt/oscam/config
chmod 755 /opt/oscam/logs
chmod 755 /opt/oscam/tmp

📥 4. Stažení a kompilace OSCam

Stažení zdrojových kódů

# Přejdi do adresáře pro zdrojové kódy
cd /usr/src

# Stáhni nejnovější verzi OSCam z GitHubu
git clone https://github.com/oscam/oscam.git oscam-latest

# Přejdi do staženého adresáře
cd oscam-latest

Kompilace OSCam

# Vytvoř adresář pro build
mkdir build
cd build

# Nakonfiguruj cmake s potřebnými parametry
cmake -DWEBIF=1 -DHAVE_LIBUSB=1 -DHAVE_PCSC=1 -DWITH_SSL=1 ..

# Zkompiluj OSCam (využije všechna dostupná CPU jádra)
make -j$(nproc)

Vysvětlení cmake parametrů:

  • DWEBIF=1 - zapne webové rozhraní
  • DHAVE_LIBUSB=1 - zapne USB podporu
  • DHAVE_PCSC=1 - zapne podporu čteček karet
  • DWITH_SSL=1 - zapne SSL šifrování

⏰ Poznámka: Kompilace na Raspberry Pi může trvat 5-15 minut podle modelu.

📦 5. Instalace OSCam binárky

# Zkopíruj zkompilovaný OSCam do cílového adresáře
cp oscam /opt/oscam/bin/

# Nastav správná oprávnění pro spouštění
chmod 755 /opt/oscam/bin/oscam

# Nastav vlastnictví na uživatele oscam
chown oscam:oscam /opt/oscam/bin/oscam

⚙️ 6. Vytvoření systemd služby

Vytvoření service souboru

# Vytvoř nový systemd service soubor
nano /etc/systemd/system/oscam.service

Obsah service souboru

Vlož následující obsah do souboru:

[Unit]
Description=OSCam server - Digital TV Conditional Access
After=network-online.target
Wants=network-online.target

[Service]
Type=forking
ExecStart=/opt/oscam/bin/oscam -c /opt/oscam/config -d
ExecReload=/bin/kill -HUP $MAINPID
Restart=on-failure
RestartSec=10
User=oscam
Group=oscam
WorkingDirectory=/opt/oscam

# Zabezpečení služby
NoNewPrivileges=yes
PrivateTmp=yes
ProtectSystem=strict
ReadWritePaths=/opt/oscam

[Install]
WantedBy=multi-user.target

Vysvětlení parametrů služby:

  • Type=forking - OSCam se spustí jako daemon na pozadí
  • ExecStart - příkaz pro spuštění s parametrem -d (daemon mode)
  • Restart=on-failure - automatický restart při pádu
  • User=oscam - spuštění pod bezpečným uživatelem
  • ReadWritePaths - povolí zápis pouze do OSCam adresáře

Aktivace služby

# Znovu načti systemd konfiguraci
systemctl daemon-reload

# Povol automatické spuštění při startu systému
systemctl enable oscam

# Zatím nespouštěj - nejdřív vytvoříme konfiguraci

📝 7. Základní konfigurace OSCam

Vytvoření hlavního konfiguračního souboru

# Vytvoř hlavní konfigurační soubor
nano /opt/oscam/config/oscam.conf

Základní konfigurace oscam.conf

Vlož následující obsah:

[global]
# Základní nastavení
nice = -1
maxlogsize = 10MB
preferlocalcards = 1
dropdups = 1

# Nastavení logování
logfile = /opt/oscam/logs/oscam.log
usrfile = /opt/oscam/logs/oscamuser.log
cwlogdir = /opt/oscam/logs

[monitor]
port = 988
aulow = 120
hideclient_to = 25
appendchaninfo = 1

[webif]
# Webové rozhraní
httpport = 8888
httpallowed = 127.0.0.1,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255
httprefresh = 10
httppollrefresh = 5
httphideidleclients = 1
httpreadonly = 0

[dvbapi]
enabled = 1
au = 1
boxtype = pc

Vytvoření souboru pro uživatele (volitelné)

# Vytvoř soubor pro uživatele webového rozhraní
nano /opt/oscam/config/oscam.user

Obsah pro základního administrátora:

[account]
user = admin
pwd = admin123
group = 1
au = 1

Nastavení oprávnění konfiguračních souborů

# Nastav vlastnictví všech konfiguračních souborů
chown -R oscam:oscam /opt/oscam/config/

# Nastav bezpečná oprávnění (číst/zapisovat pouze pro oscam)
chmod 640 /opt/oscam/config/oscam.conf
chmod 640 /opt/oscam/config/oscam.user

🚀 8. Spuštění OSCam služby

# Spusť OSCam službu
systemctl start oscam

# Zkontroluj stav služby
systemctl status oscam

# Zkontroluj logy pro případné chyby
journalctl -u oscam -f

🌐 9. Přístup do webového rozhraní

  1. Otevři webový prohlížeč
  2. Zadej adresu: http://IP_RASPBERRY_PI:8888
  3. Přihlaš se pomocí:
    • Uživatel: admin
    • Heslo: admin123

Tip: IP adresu Pi zjistíš příkazem: hostname -I

🔧 10. Užitečné příkazy pro správu

Kontrola stavu služby

# Zobraz stav služby
systemctl status oscam

# Zobraz živé logy
journalctl -u oscam -f

# Zobraz poslední logy
journalctl -u oscam --no-pager

Správa služby

# Restart služby
systemctl restart oscam

# Zastavení služby
systemctl stop oscam

# Spuštění služby
systemctl start oscam

# Zakázání automatického spuštění
systemctl disable oscam

Kontrola běžících procesů

# Zobraz OSCam procesy
ps aux | grep oscam

# Zobraz otevřené porty
netstat -tlnp | grep oscam

🧹 11. Cron pro automatickou údržbu (volitelné)

Vytvoření cron úloh

# Edituj crontab pro uživatele root
crontab -e

Přidání úloh do crontabu

# Vyčištění cache každou hodinu (5. minuta)
05 * * * * echo 3 > /proc/sys/vm/drop_caches

# Restart systému každý den v 5:45 ráno
45 05 * * * /sbin/reboot

# Rotace logů jednou týdně (neděle v 3:00)
0 3 * * 0 find /opt/oscam/logs -name "*.log" -size +50M -delete

🔄 12. Aktualizace OSCam v budoucnu

Pro aktualizaci OSCam na nejnovější verzi:

# Zastavení služby
systemctl stop oscam

# Přejdi do zdrojového adresáře
cd /usr/src/oscam-latest

# Stáhni nejnovější změny
git pull

# Přejdi do build adresáře
cd build

# Vyčisti předchozí build
make clean

# Znovu zkompiluj
cmake -DWEBIF=1 -DHAVE_LIBUSB=1 -DHAVE_PCSC=1 -DWITH_SSL=1 ..
make -j$(nproc)

# Zkopíruj novou verzi
cp oscam /opt/oscam/bin/

# Nastav oprávnění
chmod 755 /opt/oscam/bin/oscam
chown oscam:oscam /opt/oscam/bin/oscam

# Spusť službu
systemctl start oscam

✅ Hotovo!

OSCam je nyní nainstalován a běží s těmito vlastnostmi:

  • ✅ Automatické spuštění při startu systému
  • ✅ Běží pod bezpečným uživatelským účtem
  • ✅ Webové rozhraní na portu 8888
  • ✅ Logování do /opt/oscam/logs/
  • ✅ Všechny soubory v /opt/oscam/
  • ✅ Systemd služba pro snadnou správu

Další kroky: Nyní můžeš přidat své karty, servery a další konfiguraci přes webové rozhraní nebo úpravou konfiguračních souborů v /opt/oscam/config/.

🆘 Řešení problémů

Služba se nespustí

# Zkontroluj logy
journalctl -u oscam --no-pager

# Zkontroluj konfiguraci
/opt/oscam/bin/oscam -c /opt/oscam/config -t

Webové rozhraní není dostupné

# Zkontroluj, zda OSCam běží
systemctl status oscam

# Zkontroluj otevřené porty
netstat -tlnp | grep 8888

Problémy s oprávněními

# Znovu nastav oprávnění
chown -R oscam:oscam /opt/oscam
chmod 755 /opt/oscam/bin/oscam

No comments to display

Back to top