FAQ
Часто задаваемые вопросы и решение типичных проблем.
Установка
Ошибка: listen tcp :888: bind: address already in use
Порт 888 уже занят другим процессом. Варианты:
- Найти и остановить процесс:
lsof -i :888
kill <PID>- Если старый сервис lampac ещё запущен:
systemctl stop lampac
systemctl disable lampac- Установить на другой порт:
curl -fsSL dev.alcopa.cc/install | bash -s install --port 8080Docker: контейнер не запускается
Проверьте логи:
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Авторизация
Не приходит уведомление о новом пользователе
Проверьте:
- Бот запущен — в логах нет ошибок
tgauth AdminIDкорректен — проверьте у @userinfobotBotTokenне истёк — создайте новый у @BotFather
Авто-одобрение не работает
- Убедитесь, что
AutoApprove: trueв конфиге или вкладке TG Настройки - Проверьте
AutoApproveDays > 0 - Авто-одобрение работает только для новых пользователей
Забыл ссылку на админ-панель
Отправьте /admin в Telegram-бот. Или посмотрите в логах:
journalctl -u alcopac | grep "admin panel"Ошибка 2FA — код не подходит
Проверьте время на сервере:
date
timedatectl statusTOTP-коды зависят от точности системного времени. Синхронизируйте:
timedatectl set-ntp trueБалансеры
Балансер показывает ошибку 403
CDN блокирует прямой доступ. Решения:
- Подключите прокси для этого балансера
- Проверьте, не истёк ли токен
- Некоторые CDN блокируют серверные IP — используйте прокси из другого региона
TLS/x509 certificate error
Ошибка сертификата на стороне балансера (upstream). Обычно это временная проблема CDN:
- Подождите — сертификат может обновиться
- Попробуйте альтернативный хост для балансера
- Это не ошибка Al(co)pac — проблема на стороне источника
Видео не воспроизводится, но поиск работает
Возможные причины:
- Балансер требует токен (Filmix Pro, Collaps, Mirage)
- CDN блокирует IP сервера — настройте прокси
- CDN сменил домен — обновите
hostв настройках балансера
Filmix показывает только SD-качество
Для HD и выше нужна Pro-подписка. Укажите Pro-токен:
[online.filmix]
token = "ваш_pro_токен"Без токена доступно только SD-качество.
Mirage не работает / manifestLoadError
Возможные причины:
- Не установлен Chromium —
apt install chromium-browser - Не указан токен Mirage в конфигурации
- 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 не находит фильм
Collaps возвращает 422
collaps.
MSX (Media Station X)
MSX показывает ‘Start parameter error: JSON Parse error’
MSX ожидает JSON, но получает HTML-страницу авторизации. Сервер автоматически определяет MSX-запросы по заголовку Accept и отдаёт JSON вместо HTML.
Если ошибка сохраняется:
- Убедитесь, что сервер обновлён до последней версии
- MSX вводит только хост (без пути) — сервер сам отдаёт
msx/start.json - Проверьте, что Telegram-авторизация не блокирует MSX — путь
/msx/*пропускается без авторизации
MSX работает, но Lampa внутри не грузит плагины
DLNA
Smart TV не видит сервер в списке DLNA
- Убедитесь, что DLNA включён:
[dlna]
enable = true
upnp = true- Сервер и ТВ должны быть в одной локальной сети
- UPnP использует UDP multicast (порт 1900) — проверьте, не блокирует ли файрвол:
ufw allow 1900/udp
ufw allow 1338/tcp- Перезапустите сервер после изменения конфига
Транскодирование
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 > значения по умолчанию.
Как редактировать конфиг?
Три способа:
- Через админ-панель — вкладка «Конфиг» (редактирование config.toml через веб-интерфейс)
- Через админ-панель — вкладки «Балансеры», «Проксирование», «TG Настройки» и др. для конкретных секций
- Вручную — отредактировать
/opt/lampac/config.tomlи перезапустить:systemctl restart alcopac
Изменения в config.toml не применяются
Перезапустите сервер после редактирования:
systemctl restart alcopacУбедитесь, что формат TOML валиден (нет опечаток в скобках, кавычках).
Прокси
VLESS-прокси не работает
- Проверьте URI — скопируйте из клиента (v2rayNG, Nekobox)
- Убедитесь, что XRay/Mihomo установлен:
which xray
which mihomo- Проверьте, назначены ли балансеры прокси
- Проверьте логи на ошибки подключения
YouTube
Ошибка ‘Access blocked’ при авторизации YouTube
Пока приложение в режиме Testing (по умолчанию), авторизоваться могут только добавленные тестовые пользователи. Добавьте email Google-аккаунта в OAuth consent screen → Test users в Google Cloud Console.
Подробнее → Настройка OAuth.
YouTube-подписки не появляются в ленте
Проверьте:
- Аккаунт привязан — отправьте
/profileв бот, должен быть указан YouTube-канал - В
config.tomlуказаныclient_idиclient_secret - Плагин
youtube_feedвключён (по умолчанию включён) - У аккаунта есть подписки на YouTube
Если ранее работало и перестало — refresh-токен мог быть отозван. Повторите /youtube_auth.
Где хранятся YouTube-токены?
database/ytauth/tokens.json. Каждый пользователь идентифицируется по Telegram ID. При переносе сервера скопируйте этот файл.
Общие
Как перенести сервер на другой VPS?
- На старом сервере скопируйте директорию:
tar -czf lampac-backup.tar.gz /opt/lampac/config /opt/lampac/database /opt/lampac/cache/aeskey- На новом сервере установите Al(co)pac:
curl -fsSL dev.alcopa.cc/install | bash -s install- Замените конфиги:
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