OScam настройка Raspberry Pi: Полное Руководство 2026

Хотите превратить свой миниатюрный Raspberry Pi в мощный сервер для OScam? Если вы уже купили «малинку», USB-картридер и имеете карту доступа, но не знаете, с чего начать, то эта статья для вас. Я поделюсь своим опытом и покажу, как выполнить полную OScam настройка Raspberry Pi, от подготовки операционной системы до тонкой настройки конфигурационных файлов и запуска стабильного сервера. Забудьте про устаревшие гайды для x86 систем — мы сосредоточимся на специфике ARM и Raspberry Pi.

Многие сталкиваются с проблемами, когда пытаются настроить OScam на Raspberry Pi. Это и несовместимость картридеров, и ошибки при компиляции, и, конечно же, путаница в конфигах. Моя цель — дать вам пошаговую, проверенную инструкцию, которая поможет избежать этих ловушек. Мы даже разберем, как правильно настроить автозапуск через systemd и обеспечить безопасность веб-интерфейса.

Что нужно для запуска OScam на Raspberry Pi

Прежде чем мы приступим к установке софта, давайте убедимся, что у вас есть все необходимое железо и правильно подготовлена операционная система. От выбора модели Raspberry Pi и картридера зависит стабильность и производительность вашего будущего OScam-сервера.

Выбор модели Raspberry Pi: Pi 3B+, Pi 4, Pi 5 — что подходит

Сразу скажу: Raspberry Pi Zero или Zero 2W для OScam — не лучшая идея. Они слишком слабые, и стабильная работа с USB-картридером через OTG часто превращается в головную боль. Я бы не рекомендовал их для серьезных задач.

Мой минимум для OScam — это Raspberry Pi 3B+. Он достаточно производителен для 5-10 клиентов, имеет нормальные USB-порты и гигабитный Ethernet (хоть и через USB 2.0 контроллер). Если у вас есть Pi 3B+, он вполне подойдет.

Оптимальный выбор — Raspberry Pi 4 (2GB RAM). У него хороший запас по CPU, полноценный гигабитный Ethernet и USB 3.0. На Pi 4 вы без проблем сможете обслуживать 20-30 клиентов и даже больше, если ECM-тайминги будут в норме. Pi 5 тоже подойдет, но он, честно говоря, избыточен для OScam и может иметь свои нюансы с GPIO и USB для некоторых Phoenix-ридеров.

Совместимые USB-картридеры: какие чипсеты работают

Картридер — это сердце вашего OScam-сервера, если вы используете физическую карту доступа. Не все картридеры одинаково полезны. Я много экспериментировал и могу сказать, что самыми надежными оказались устройства на чипсетах Alcor Micro AU9540 и SCM Microsystems SCR3310. Их поддерживает большинство дистрибутивов Linux «из коробки».

Дешевые китайские картридеры без явного чипсета часто вызывают проблемы. Некоторые из них могут работать только в режиме Phoenix/Smartmouse, требуя прямого подключения через /dev/ttyUSBx, минуя pcscd. Перед покупкой лучше поискать отзывы о совместимости с Linux. Если у вас Phoenix-ридер, убедитесь, что он работает через стандартный последовательный порт, а не через экзотические драйвера.

Подготовка microSD-карты и установка Raspberry Pi OS Lite

Для OScam нам не нужен графический интерфейс. Он только зря расходует ресурсы и увеличивает поверхность для атак. Поэтому я всегда рекомендую использовать Raspberry Pi OS Lite (64-bit). Последние версии OS (Bookworm) могут потребовать немного другие пакеты зависимостей, но общая логика остается прежней.

Для записи образа на microSD-карту используйте официальный Raspberry Pi Imager. Он прост и надежен. В процессе записи Imager позволяет сразу включить SSH, задать имя пользователя и пароль, а также настроить Wi-Fi (если вы не планируете использовать Ethernet). Это очень удобно.

Первоначальная настройка SSH и сети

После первой загрузки Raspberry Pi, подключитесь к нему по SSH. Если вы использовали Imager, SSH уже должен быть включен. Если нет, это можно сделать через sudo raspi-config. Выберите «Interface Options» -> «SSH» -> «Yes».

Обязательно настройте локаль и часовой пояс через sudo raspi-config в разделе «Localisation Options». Это важно для корректного отображения логов OScam и работы веб-интерфейса. Например, установите ru_RU.UTF-8 и ваш часовой пояс.

Для стабильной работы OScam я настоятельно рекомендую использовать статический IP-адрес. Динамический IP может вызвать проблемы при перезагрузках или изменениях в вашей сети. Отредактируйте файл /etc/dhcpcd.conf:

sudo nano /etc/dhcpcd.conf

Добавьте в конец файла следующие строки, заменив значения на свои:

interface eth0
static ip_address=192.168.1.100/24
static routers=192.168.1.1
static domain_name_servers=192.168.1.1 8.8.8.8

Если используете Wi-Fi, замените eth0 на wlan0. После сохранения перезагрузите Raspberry Pi: sudo reboot. Проверьте IP-адрес командой ip a.

OScam настройка Raspberry Pi: Компиляция из исходников

Компиляция OScam из исходников — это лучший способ получить самую свежую версию с нужными вам функциями. Готовые бинарники с сайта streamboard.tv часто бывают устаревшими, а их функционал может быть ограничен. Мы соберем OScam специально для Raspberry Pi.

Установка зависимостей: gcc, libssl-dev, libusb-1.0, libpcsclite-dev

Прежде чем компилировать, нам нужно установить необходимые пакеты. Это компиляторы, библиотеки для работы с USB, SSL и PCSC (для картридеров).

sudo apt update
sudo apt upgrade -y
sudo apt install build-essential libssl-dev libpcsclite-dev libusb-1.0-0-dev pcscd -y

build-essential включает GCC и другие утилиты для сборки. libssl-dev нужен для поддержки SSL/TLS. libpcsclite-dev и pcscd — для работы с PCSC-совместимыми картридерами. libusb-1.0-0-dev — для прямой работы с USB-устройствами, что полезно для некоторых картридеров.

Получение исходного кода OScam через SVN

Исходный код OScam хранится в репозитории SVN. Для его получения нам понадобится SVN-клиент, который обычно уже установлен или будет установлен вместе с build-essential. Если нет, то sudo apt install subversion -y.

cd /usr/src
sudo svn checkout https://svn.streamboard.tv/oscam/trunk oscam-svn

Это создаст папку oscam-svn со всеми исходниками OScam в /usr/src/. Всегда лучше использовать последнюю версию из trunk, так как она содержит исправления и улучшения.

Параметры сборки: включение WebIf, DVB API, SmartReader

Перейдите в директорию с исходниками:

cd /usr/src/oscam-svn

Теперь нужно настроить параметры сборки. Я всегда использую следующие флаги, чтобы получить максимально функциональный OScam:

sudo ./config.sh --enable-webif --enable-dvbapi --enable-pcsc --enable-libusb --enable-ssl --with-ccapi-dir=/usr/local/lib --disable-gbox

• --enable-webif: Включает веб-интерфейс для управления OScam. Без него очень неудобно.
• --enable-dvbapi: Поддержка DVB API для работы с DVB-картами (если планируете использовать).
• --enable-pcsc: Поддержка PCSC-совместимых картридеров.
• --enable-libusb: Прямая поддержка USB-устройств.
• --enable-ssl: Включение поддержки SSL/TLS, критично для безопасных подключений.
• --with-ccapi-dir=/usr/local/lib: Указывает путь для CCAPI, если он нужен.
• --disable-gbox: Отключает устаревший протокол gbox, если он вам не нужен.

После выполнения config.sh вы увидите список активированных функций. Убедитесь, что все нужные флаги отмечены как «YES».

Сборка командой make и установка бинарника

Теперь, когда все настроено, можно приступать к сборке. Raspberry Pi 4 и 5 имеют несколько ядер, поэтому можно ускорить процесс, используя флаг -j с количеством ядер. У Pi 4 их четыре, так что -j4:

sudo make -j4

Если у вас Pi 3B+, используйте -j4 тоже. Это займет несколько минут. После успешной сборки, вы найдете исполняемый файл oscam в этой же директории.

Скопируйте его в системную директорию, чтобы OScam был доступен из любого места:

sudo cp oscam /usr/local/bin/

Убедитесь, что у него есть права на выполнение:

sudo chmod +x /usr/local/bin/oscam

Создание рабочих директорий /etc/oscam/ и /var/log/oscam/

OScam нужен набор конфигурационных файлов и место для логов. Создадим эти директории:

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

/etc/oscam/ будет хранить все ваши конфиги (oscam.conf, oscam.server и т.д.). /var/log/oscam/ — это место для логов OScam. Это стандартные и рекомендованные пути.

Настройка конфигурационных файлов OScam

Конфигурационные файлы — это душа OScam. Здесь мы определяем, как OScam будет работать, к каким серверам подключаться и как обслуживать клиентов. Все конфиги должны находиться в директории /etc/oscam/. Создайте их с помощью sudo nano /etc/oscam/НАЗВАНИЕ_ФАЙЛА.

oscam.conf — глобальные параметры и веб-интерфейс

Этот файл содержит глобальные настройки OScam и параметры для веб-интерфейса.

# /etc/oscam/oscam.conf
[global]
logfile                       = /var/log/oscam/oscam.log
maxlogsize                    = 1024
nice                          = -1 # Приоритет процесса OScam. -1 или -10 обычно хорошо
clienttimeout                 = 5000
fallbacktimeout               = 2500
clientmaxidle                 = 120
cachedelay                    = 100
bindwait                      = 120
resolvedelay                  = 30
serialreadertimeout           = 1500
dropdups                      = 1
cwlogdir                      = /var/log/oscam/cw
emmlogdir                     = /var/log/oscam/emm
blockemm-unknown              = 1
blockemm-g                    = 1
blockemm-s                    = 1
blockemm-u                    = 1
lb_mode                       = 1 # Loadbalancing - 1 = fastest reader

[webif]
httpport                      = 8888
httpuser                      = oscamuser
httppwd                       = oscampass
httpallowed                   = 127.0.0.1,192.168.0.0-192.168.255.255
httpreadonly                  = 0
httpssl                       = 0
httpforcesssl                 = 0

Обратите внимание на logfile и maxlogsize. Если вы беспокоитесь об износе SD-карты, можете установить logfile = /dev/null (логи не будут сохраняться) или настроить логирование в tmpfs. nice = -1 дает OScam небольшой приоритет CPU, что хорошо для стабильности.

В секции [webif] обязательно измените httpuser и httppwd на свои, более сложные значения. httpallowed ограничивает доступ к веб-интерфейсу. Я разрешил локальный хост и всю вашу домашнюю сеть 192.168.x.x. Это гораздо безопаснее, чем 0.0.0.0-255.255.255.255.

oscam.server — подключение к серверам (протоколы CCcam, Newcamd)

Здесь мы описываем «ридеры» (readers) — источники ECM-ответов. Это могут быть удаленные CCcam/Newcamd-серверы или ваш локальный USB-картридер. Я покажу примеры для обоих.

# /etc/oscam/oscam.server
[reader]
label                         = remote_cccam_server_1
protocol                      = cccam
device                        = cccam.example.com,12000
user                          = your_cccam_account
password                      = your_cccam_password
group                         = 1
cccversion                    = 2.3.2
cccmaxhops                    = 2
ccckeepalive                  = 1 # Отправлять keepalive-пакеты
inactivitytimeout             = 60 # Отключаться через 60 секунд бездействия
reconnecttimeout              = 10 # Попытка переподключения через 10 секунд

Для подключения к удаленному CCcam-серверу используйте protocol = cccam, укажите доменное имя или IP-адрес и порт (device), а также логин и пароль. group = 1 присваивает ридеру группу. cccversion = 2.3.2 — это распространенная версия CCcam-клиента. Параметры ccckeepalive, inactivitytimeout и reconnecttimeout очень важны для поддержания стабильной связи.

Если у вас есть локальный USB-картридер (например, на чипсете SCM Microsystems SCR3310), то конфиг будет выглядеть так:

[reader]
label                         = local_card_reader
protocol                      = pcsc
device                        = 0 # Номер ридера, если несколько. Обычно 0.
group                         = 2
caid                          = 0123 # CAID вашей карты, например, 0123
ident                         = 0123:000000 # CAID:ProviderID
detect                        = cd
mhz                           = 357 # Частота карты. Для некоторых карт 357, для других 600.
cardmhz                       = 357
emmcache                      = 1,3,2
blockemm-unknown              = 1
blockemm-g                    = 1
blockemm-s                    = 1
blockemm-u                    = 1

Если ваш картридер работает в режиме Phoenix/Smartmouse через последовательный порт (например, /dev/ttyUSB0), то протокол будет mouse:

[reader]
label                         = phoenix_reader
protocol                      = mouse
device                        = /dev/ttyUSB0 # Путь к последовательному порту
group                         = 2
caid                          = 0123
ident                         = 0123:000000
detect                        = cd
mhz                           = 357
cardmhz                       = 357
emmcache                      = 1,3,2

Важно: если вы используете protocol = mouse, убедитесь, что сервис pcscd остановлен и отключен, иначе он будет конфликтовать с прямым доступом OScam к порту.

oscam.user — аккаунты пользователей и группы

Этот файл определяет пользователей, которые могут подключаться к вашему OScam-серверу, и их права.

# /etc/oscam/oscam.user
[account]
user                          = client1
pwd                           = clientpass1
group                         = 1,2 # Разрешен доступ к ридерам из групп 1 и 2
au                            = 1 # Разрешает AU (Automatic Update) с ридера, если он поддерживает
betatunnel                    = 1801.000000:1702,1801.000000:1722 # Пример для Betacrypt

Создайте отдельные аккаунты для каждого клиента. group определяет, к каким ридерам этот пользователь имеет доступ. Например, если у вас есть локальный картридер в группе 2 и удаленные серверы в группе 1, пользователь с group = 1,2 сможет использовать оба. au = 1 позволяет клиенту отправлять запросы на обновление карты (если ридер это поддерживает и настроен).

oscam.dvbapi — привязка CAID/Provider к reader'ам

Файл oscam.dvbapi используется, если вы работаете с DVB-картой или эмуляторами, чтобы OScam знал, какой CAID/ProviderID к какому ридеру отправлять. Это оптимизирует запросы и уменьшает нагрузку.

# /etc/oscam/oscam.dvbapi
P: 0123:000000 1 # Привязывает CAID 0123, ProviderID 000000 к ридерам группы 1
I: 0123:000000:1234 # Игнорировать сервис 1234 для данного CAID/Provider