¶ ❓ FAQ
Часто задаваемые вопросы и их решения
¶ 🚀 Установка и запуск
¶ ❓ Как установить AustoBill?
Самым простым способом:
sudo bash -c "$(curl -sSL https://raw.githubusercontent.com/Ultener/AustoBill/main/install.sh)"
Или вручную — см. 📦 Установка.
¶ ❓ Какая ОС поддерживается?
Ubuntu 20.04+, Debian 11+. Рекомендуется Ubuntu 24.04 LTS.
На других ОС (CentOS, Fedora, Alpine) установка не тестировалась.
¶ ❓ Нужен ли домен?
Да, для продакшена — обязательно. SSL-сертификат выдаётся только на домен.
На этапе тестирования можно использовать IP-адрес.
¶ ❓ Можно ли установить на тот же сервер, где Pterodactyl?
Да, можно. Главное — разные порты. Pterodactyl обычно на 443, AustoBill через Nginx тоже на 443, поэтому нужно либо:
- Разные домены → bill.example.com и panel.example.com → один Nginx
- Один домен с подпапкой → не рекомендуется
¶ ⚙️ Конфигурация
¶ ❓ Где находится файл конфигурации?
/opt/austobill/.env
¶ ❓ Как изменить настройки?
sudo bash /opt/austobill/install.sh
# → 9. Настройки
Или вручную отредактируйте .env и перезапустите сервис.
¶ ❓ После изменения .env не работает
Перезапустите сервис:
systemctl restart austobill
Проверьте логи:
journalctl -u austobill -n 50
¶ ❓ Как сбросить пароль администратора?
Измените переменные в .env:
ADMIN_EMAIL=new@email.com
ADMIN_PASSWORD=new_password
Перезапустите сервис. При первом запуске пароль обновится.
Работает только если админ с таким email уже существует в базе.
¶ 🖧 Pterodactyl
¶ ❓ Не создаётся сервер после оплаты
Проверьте:
- API ключ — правильный ли
PTERO_ADMIN_KEY - Аллокации — на ноде должны быть свободные IP:Port
- Ресурсы — на ноде должно быть достаточно RAM/CPU/Disk
- Логи:
journalctl -u austobill -n 100
¶ ❓ Ошибка: "Нет свободных аллокаций на ноде X"
Добавьте аллокации в Pterodactyl Admin → Nodes → Allocations.
¶ ❓ Ошибка: "Requested filter(s) assigned are not allowed"
У вас старая версия Pterodactyl. Обновите панель до последней версии.
¶ ❓ Ошибка: 401 Unauthorized
Неверный API ключ. Создайте новый в Pterodactyl → Application API.
¶ 🖥️ Proxmox
¶ ❓ Не подключается к Proxmox
Проверьте:
PROXMOX_HOST— правильный URL (с портом 8006)PROXMOX_TOKEN_ID— формат:user@pam!tokennamePROXMOX_TOKEN_SECRET— правильный секрет- Фаервол — порт 8006 должен быть открыт
¶ ❓ Ошибка: self-signed certificate
Установите PROXMOX_VERIFY_SSL=false в .env.
¶ ❓ Пустой список шаблонов ОС
- Убедитесь, что
PROXMOX_STORAGEуказывает на правильное хранилище - Загрузите хотя бы один шаблон через веб-интерфейс Proxmox
- Проверьте логи:
journalctl -u austobill -n 50 | grep proxmox
¶ 💳 Платежи
¶ ❓ Платёж прошёл, а сервер не создался
Проверьте логи:
journalctl -u austobill -n 100
Возможные причины:
- Неправильный API ключ Pterodactyl
- Нет свободных аллокаций
- Недостаточно ресурсов на ноде
- Ошибка в тарифе
¶ ❓ YooMoney не присылает уведомления
- Убедитесь, что URL уведомлений правильный:
https://ваш-домен/api/payments/yoomoney/notify - Сервер должен быть доступен из интернета
- Проверьте секретное слово в YooMoney и
YOOMONEY_SECRET
¶ ❓ Platega возвращает ошибку
- Проверьте Merchant ID и Secret Key
- Убедитесь, что проект активен в Platega
- Проверьте логи:
journalctl -u austobill -n 50 | grep platega
¶ ❓ Как сделать тестовый платёж?
YooMoney и Platega не предоставляют тестовых карт.
Используйте минимальную сумму (1 рубль) для проверки.
¶ 🔧 Технические проблемы
¶ ❓ Ошибка 502 Bad Gateway
Nginx не может связаться с Node.js приложением.
# Перезапустите сервис
systemctl restart austobill
# Проверьте, что порт 3000 слушается
ss -tlnp | grep 3000
# Проверьте Nginx
nginx -t
systemctl restart nginx
¶ ❓ Ошибка 504 Gateway Timeout
Сервер долго отвечает. Обычно это проблема с подключением к Pterodactyl или Proxmox. Проверьте их доступность.
¶ ❓ Не приходят письма
# Проверьте SMTP настройки в .env
# Попробуйте:
SMTP_SECURE=false
SMTP_PORT=587
# Проверьте логи
journalctl -u austobill -n 50 | grep -i smtp
¶ ❓ Как обновить Node.js?
# Удалите старую версию
apt remove -y nodejs
# Установите 20.x
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs
node -v
¶ ❓ База данных SQLite повреждена
# Восстановите из бэкапа
cp /opt/austobill_backup_*/database.sqlite /opt/austobill/
# Или создайте новую (данные будут потеряны)
rm /opt/austobill/database.sqlite
systemctl restart austobill
¶ ❓ Как сменить порт?
В .env измените PORT и обновите Nginx:
proxy_pass http://127.0.0.1:НОВЫЙ_ПОРТ;
nginx -t && systemctl restart nginx
systemctl restart austobill
¶ 🔗 Связанные страницы
- 📦 Установка — установка панели
- ⚙️ Конфигурация — все переменные
.env - 🖧 Pterodactyl — подключение и настройка
- 💳 Платежи — подключение платёжных шлюзов
- 🔧 Управление — CLI, обновление, бэкапы