FunPay Cardinal Remake

Модифицированная версия FunPayCardinalRemake для автоматизации работы с FunPay.

В этой сборке удалены рекламные интеграции, удаленные объявления, автозагрузка обновлений и автоматическое изменение профиля Telegram-бота. Обновления устанавливаются только вручную владельцем репозитория или сервера.

Возможности

• Автовыдача товаров.
• Автоподнятие лотов.
• Автоответ на заранее настроенные команды.
• Автовосстановление лотов после продажи.
• Автодеактивация лотов, если товары закончились.
• Уведомления о заказах, сообщениях и изменениях в Telegram.
• Управление настройками через Telegram-панель.
• Поддержка пользовательских шаблонов и переменных в текстах.
• Система плагинов для расширения функциональности.

Что изменено

• Удалены авторские рекламные ссылки и упоминания.
• Удалены удаленные объявления и загрузка рекламных фото.
• Удалены скрытые preview-ссылки на сторонние изображения.
• Отключены автообновления и установка релизов из чужих источников.
• Отключена автоматическая установка названия и описания Telegram-бота.
• Убрано требование, чтобы username Telegram-бота начинался с funpay.
• Удалены ссылки на сторонние Telegram-каналы, донаты и чаты.
• Удалены команды и обработчики backup-архивов.
• Удален водяной знак и автоматическое добавление подписи в сообщения.
• Удалены лишние команды Telegram-меню: /about, /sys, /power_off, /upload_chat_img, /upload_offer_img.
• Загрузка плагинов и конфигов через Telegram доступна только авторизованным пользователям.
• Настройки уведомлений разделены по Telegram-аккаунтам внутри одного бота.
• Неавторизованный пользователь получает короткий ответ ⛔ У тебя нет доступа.
• Авторизованные пользователи получают критическое уведомление о попытке входа постороннего пользователя.
• Уведомление о новом заказе приходит независимо от того, привязана ли к лоту автовыдача.
• В профиле и уведомлениях снова отображается рублевый баланс.
• Очищены временные файлы, кэши, старые update-файлы и funding-настройки.

Важно

После настройки и установки не публикуйте и не передавайте другим людям:

• golden_key;
• токен Telegram-бота;
• файлы из configs/;
• файлы из storage/;
• логи из logs/;
• приватные архивы с данными бота.

Эти данные могут дать доступ к вашему аккаунту или панели управления.

Установка на Windows

1. Установите Python 3.13 или новее.
2. При установке Python включите галочку Add python.exe to PATH.
3. Скачайте архив проекта со страницы репозитория или из раздела Releases.
4. Распакуйте архив в удобную папку.
5. Запустите Setup.bat и дождитесь установки зависимостей.
6. Запустите Start.bat.
7. При первом запуске пройдите настройку в консоли.

Если окно сразу закрывается, откройте папку проекта в cmd или PowerShell и выполните:

python main.py

Установка на Ubuntu/Debian

Автоматический установщик подходит для Ubuntu/Debian-серверов с systemd.

Выполните команду:

wget https://raw.githubusercontent.com/felusium/FunPayCardinal_Remake/main/install-fpc.sh -O install-fpc.sh && bash install-fpc.sh

Установщик:

• скачивает файлы только из этого репозитория;
• устанавливает системные зависимости;
• создает отдельного Linux-пользователя для запуска;
• создает виртуальное окружение Python;
• устанавливает Python-зависимости из requirements.txt;
• создает systemd-сервис FunPayCardinalRemake;
• предлагает добавить сервис в автозагрузку;
• запускает первичную настройку.

При повторном запуске установщик обновляет файлы проекта, но не удаляет приватные папки:

• configs/;
• storage/;
• plugins/;
• logs/.

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

sudo systemctl status FunPayCardinalRemake@fpc.service -n 100
sudo systemctl stop FunPayCardinalRemake@fpc.service
sudo systemctl start FunPayCardinalRemake@fpc.service
sudo systemctl restart FunPayCardinalRemake@fpc.service
sudo systemctl enable FunPayCardinalRemake@fpc.service
sudo journalctl -u FunPayCardinalRemake@fpc.service -n 100 --no-pager

Если при установке вы указали другого Linux-пользователя вместо fpc, замените fpc в командах на свое имя пользователя.

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

Этот вариант подходит для Linux без автоматического установщика или если вы хотите запустить бота вручную без systemd.

sudo apt update
sudo apt install -y python3 python3-venv python3-pip git
git clone https://github.com/felusium/FunPayCardinal_Remake.git
cd FunPayCardinal_Remake
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -U pip
pip install -r requirements.txt
python main.py

Для повторного запуска:

cd FunPayCardinal_Remake
source .venv/bin/activate
python main.py

Установка на Android через Termux

Termux не использует systemd, поэтому автоматический Ubuntu-установщик для него не подходит. Запускайте бота вручную или через tmux.

1. Установите Termux из F-Droid.
2. Откройте Termux и выполните:

pkg update && pkg upgrade
pkg install python git clang rust make pkg-config libjpeg-turbo zlib libxml2 libxslt openssl libffi
git clone https://github.com/felusium/FunPayCardinal_Remake.git
cd FunPayCardinal_Remake
python -m venv .venv
source .venv/bin/activate
python -m pip install -U pip setuptools wheel
pip install --no-cache-dir -r requirements.txt
python main.py

Чтобы бот продолжал работать после закрытия сессии, используйте tmux:

pkg install tmux
termux-wake-lock
cd FunPayCardinal_Remake
tmux new -s fpc
source .venv/bin/activate
python main.py

Отключиться от tmux, не останавливая бота: нажмите Ctrl+B, потом D.

Вернуться к боту:

tmux attach -t fpc

Остановить бота в tmux: нажмите Ctrl+C.

На Android работа в фоне зависит от прошивки и энергосбережения. Для стабильной работы отключите оптимизацию батареи для Termux.

Плагины

Не устанавливайте плагины из непроверенных источников. Плагин выполняется как обычный Python-код и может получить доступ к файлам, конфигам и аккаунту.

Установка плагина через Telegram-панель:

1. Напишите Telegram-боту команду /menu.
2. Откройте раздел Плагины.
3. Нажмите Добавить плагин.
4. Отправьте файл плагина.
5. Перезапустите бота.

Уведомления

Настройки уведомлений хранятся отдельно для каждого Telegram-аккаунта внутри одного Telegram-бота.

Например:

• пользователь A включил уведомления о новых заказах;
• пользователь B не включал уведомления;
• уведомления будут приходить пользователю A, но не будут автоматически включаться у пользователя B.

Критические уведомления используются для важных событий доступа, включая попытки входа посторонних пользователей.

Обновления

Автоматические обновления отключены.

Чтобы обновить проект вручную:

1. Остановите бота.
2. Скопируйте свои приватные папки configs/, storage/ и plugins/ в отдельное безопасное место.
3. Скачайте новую версию вручную.
4. Перенесите свои конфиги, товары и плагины обратно.
5. Проверьте работу бота перед запуском в постоянном режиме.

На Ubuntu/Debian можно повторно запустить install-fpc.sh: он обновит файлы проекта и сохранит приватные папки configs/, storage/, plugins/, logs/.

Ответственность

Используйте проект на свой риск. Соблюдайте правила FunPay, Telegram и GitHub. Не публикуйте приватные ключи, токены, cookie, конфиги, товары и логи.