FAQ

Часто задаваемые вопросы и решение типичных проблем.

Установка

Ошибка: listen tcp :888: bind: address already in use

Порт 888 уже занят другим процессом. Варианты:

  1. Найти и остановить процесс:
lsof -i :888
kill <PID>
  1. Если старый сервис lampac ещё запущен:
systemctl stop lampac
systemctl disable lampac
  1. Установить на другой порт:
curl -fsSL dev.alcopa.cc/install | bash -s install --port 8080
Docker: контейнер не запускается

Проверьте логи:

docker compose logs -f alcopac

Частые причины:

  • Порт занят — измените LAMPAC_GO_PORT в .env
  • Конфигурация невалидна — проверьте JSON-синтаксис config/init.json
  • Старый контейнер go-lampa — обновите через ./install.sh update
TorrServer не устанавливается через скрипт

Ручная установка:

ARCH=$(uname -m)
case "$ARCH" in
  x86_64) TS_ARCH="linux-amd64" ;;
  aarch64) TS_ARCH="linux-arm64" ;;
esac

curl -L "https://github.com/YouROK/TorrServer/releases/latest/download/TorrServer-${TS_ARCH}" \
  -o /opt/lampac/torrserver/TorrServer
chmod +x /opt/lampac/torrserver/TorrServer
systemctl restart alcopac

Авторизация

Не приходит уведомление о новом пользователе

Проверьте:

  1. Бот запущен — в логах нет ошибок tgauth
  2. AdminID корректен — проверьте у @userinfobot
  3. BotToken не истёк — создайте новый у @BotFather
Авто-одобрение не работает
  1. Убедитесь, что AutoApprove: true в конфиге или вкладке TG Настройки
  2. Проверьте AutoApproveDays > 0
  3. Авто-одобрение работает только для новых пользователей
Забыл ссылку на админ-панель

Отправьте /admin в Telegram-бот. Или посмотрите в логах:

journalctl -u alcopac | grep "admin panel"
Ошибка 2FA — код не подходит

Проверьте время на сервере:

date
timedatectl status

TOTP-коды зависят от точности системного времени. Синхронизируйте:

timedatectl set-ntp true

Балансеры

Балансер показывает ошибку 403

CDN блокирует прямой доступ. Решения:

  1. Подключите прокси для этого балансера
  2. Проверьте, не истёк ли токен
  3. Некоторые CDN блокируют серверные IP — используйте прокси из другого региона
TLS/x509 certificate error

Ошибка сертификата на стороне балансера (upstream). Обычно это временная проблема CDN:

  • Подождите — сертификат может обновиться
  • Попробуйте альтернативный хост для балансера
  • Это не ошибка Al(co)pac — проблема на стороне источника
Видео не воспроизводится, но поиск работает

Возможные причины:

  1. Балансер требует токен (Filmix Pro, Collaps, Mirage)
  2. CDN блокирует IP сервера — настройте прокси
  3. CDN сменил домен — обновите host в настройках балансера
Filmix показывает только SD-качество

Для HD и выше нужна Pro-подписка. Укажите Pro-токен:

[online.filmix]
token = "ваш_pro_токен"

Без токена доступно только SD-качество.

Mirage не работает / manifestLoadError

Возможные причины:

  1. Не установлен Chromium — apt install chromium-browser
  2. Не указан токен Mirage в конфигурации
  3. CDN сменил домен — обновите link_host:
[online.mirage]
link_host = "https://quadrillion-as.stloadi.live"
Videoseed выдаёт 404 или не грузит потоки

CDN Videoseed (storage.videoseedcdn.com) ограничен по гео (СНГ). Если сервер вне СНГ — нужен прокси:

[[proxy.vless.entries]]
uri = "vless://..."
balancers = ["videoseed"]
VideoDB не находит фильм
VideoDB использует каскад из 3 CDN. Если фильм не найден ни на одном — он отсутствует в каталоге. Это не ошибка. Попробуйте другой балансер (Collaps, Rezka, Zetflix).
Collaps возвращает 422
Ошибка 422 означает гео-блокировку по IP. Collaps API доступен только из СНГ. Подключите прокси с российским/украинским IP для балансера collaps.

MSX (Media Station X)

MSX показывает ‘Start parameter error: JSON Parse error’

MSX ожидает JSON, но получает HTML-страницу авторизации. Сервер автоматически определяет MSX-запросы по заголовку Accept и отдаёт JSON вместо HTML.

Если ошибка сохраняется:

  1. Убедитесь, что сервер обновлён до последней версии
  2. MSX вводит только хост (без пути) — сервер сам отдаёт msx/start.json
  3. Проверьте, что Telegram-авторизация не блокирует MSX — путь /msx/* пропускается без авторизации
MSX работает, но Lampa внутри не грузит плагины
Lampa внутри MSX загружается без Telegram-авторизации. Плагины требуют токен. Решение — авторизоваться через Telegram-бот с того же устройства или использовать Lampa-приложение напрямую.

DLNA

Smart TV не видит сервер в списке DLNA
  1. Убедитесь, что DLNA включён:
[dlna]
enable = true
upnp = true
  1. Сервер и ТВ должны быть в одной локальной сети
  2. UPnP использует UDP multicast (порт 1900) — проверьте, не блокирует ли файрвол:
ufw allow 1900/udp
ufw allow 1338/tcp
  1. Перезапустите сервер после изменения конфига

Транскодирование

502 ошибка при транскодировании 4K/HEVC видео
Ошибка Codec 'hevc' is not supported by the bitstream filter 'h264_mp4toannexb' возникала при транскодировании HEVC-контента. Исправлено — сервер автоматически определяет кодек (H.264/HEVC) и применяет правильный bitstream filter. Обновите сервер до последней версии.

Конфигурация

Где находится конфигурация?

Основной файл — config.toml в корне установки (по умолчанию /opt/lampac/config.toml).

Legacy-файлы init.conf и current.conf поддерживаются для обратной совместимости. При первом запуске настройки из init.conf мигрируются в config.toml.

Приоритет: переменные окружения > config.toml > init.conf > current.conf > значения по умолчанию.

Как редактировать конфиг?

Три способа:

  1. Через админ-панель — вкладка «Конфиг» (редактирование config.toml через веб-интерфейс)
  2. Через админ-панель — вкладки «Балансеры», «Проксирование», «TG Настройки» и др. для конкретных секций
  3. Вручную — отредактировать /opt/lampac/config.toml и перезапустить: systemctl restart alcopac
Изменения в config.toml не применяются

Перезапустите сервер после редактирования:

systemctl restart alcopac

Убедитесь, что формат TOML валиден (нет опечаток в скобках, кавычках).

Прокси

VLESS-прокси не работает
  1. Проверьте URI — скопируйте из клиента (v2rayNG, Nekobox)
  2. Убедитесь, что XRay/Mihomo установлен:
which xray
which mihomo
  1. Проверьте, назначены ли балансеры прокси
  2. Проверьте логи на ошибки подключения

YouTube

Ошибка ‘Access blocked’ при авторизации YouTube

Пока приложение в режиме Testing (по умолчанию), авторизоваться могут только добавленные тестовые пользователи. Добавьте email Google-аккаунта в OAuth consent screenTest users в Google Cloud Console.

Подробнее → Настройка OAuth.

YouTube-подписки не появляются в ленте

Проверьте:

  1. Аккаунт привязан — отправьте /profile в бот, должен быть указан YouTube-канал
  2. В config.toml указаны client_id и client_secret
  3. Плагин youtube_feed включён (по умолчанию включён)
  4. У аккаунта есть подписки на YouTube

Если ранее работало и перестало — refresh-токен мог быть отозван. Повторите /youtube_auth.

Где хранятся YouTube-токены?
В файле database/ytauth/tokens.json. Каждый пользователь идентифицируется по Telegram ID. При переносе сервера скопируйте этот файл.

Общие

Как перенести сервер на другой VPS?
  1. На старом сервере скопируйте директорию:
tar -czf lampac-backup.tar.gz /opt/lampac/config /opt/lampac/database /opt/lampac/cache/aeskey
  1. На новом сервере установите Al(co)pac:
curl -fsSL dev.alcopa.cc/install | bash -s install
  1. Замените конфиги:
tar -xzf lampac-backup.tar.gz -C /
systemctl restart alcopac
Как посмотреть все логи?
# Последние 100 строк
journalctl -u alcopac -n 100

# В реальном времени
journalctl -u alcopac -f

# За последний час
journalctl -u alcopac --since "1 hour ago"

# Docker
docker compose logs -f --tail 100 alcopac
Как полностью удалить Al(co)pac?
# Linux
curl -fsSL dev.alcopa.cc/install | bash -s remove --purge

# Docker
./install.sh remove
rm -rf config database cache torrserver module data