Per user decision 2026-10-21 (reverses the 2026-10-20 drop-Telegram call): port the upstream 3x-ui v3.7.0-generation Telegram bot wholesale instead of rewriting a minimal set, adapted to this fork. - new internal/web/service/tgbot package (telego): bot lifecycle, commands, reports, callback router, send helpers; token validation via telego; custom API server URL passes the fork's SSRF sanitizer (loopback/private bases fall back to the default endpoint, logged) - settings: full upstream key set (tgBotEnable/Token/Proxy/APIServer/ ChatId, tgRunTime, tgBotBackup, tgCpu/tgMemory, tgLang, tgEnabledEvents) with getters/setters; settings page gains a Telegram tab + sidebar entry; token shown masked, clearTgBotToken honored - wiring (web.go): stats-notify cron registered from tgRunTime when the bot is enabled; CheckHashStorage job; CPU/memory alarm jobs gated on tgEnabledEvents + thresholds; login notifications via event bus; POST /panel/api/setting/testTgBot and /panel/api/backuptotgbot - lite adaptation: StatsNotifyJob no longer gates on a local Xray core (this panel never runs one) so the periodic report and the scheduled DB backup (sendDocument) can actually fire - translations: upstream TG keys restored across all locales End-to-end smoke (real binary + fake Telegram API over HTTPS at a public-looking address, browser form wire format): bot starts on settings change (getMe), testTgBot delivers, panel restart re-arms the bot, tgRunTime='@every 1m' cron really fires sendDocument carrying the panel SQLite DB (magic verified) plus the report sendMessage, login notification delivered, dead-endpoint failure is logged not silent. 13/13 PASS — see P9-REPORT.md.
37 lines
1.1 KiB
Go
37 lines
1.1 KiB
Go
package job
|
|
|
|
import (
|
|
"github.com/mhsanaei/3x-ui/v3/internal/web/service"
|
|
"github.com/mhsanaei/3x-ui/v3/internal/web/service/tgbot"
|
|
)
|
|
|
|
// LoginStatus represents the status of a login attempt.
|
|
type LoginStatus byte
|
|
|
|
const (
|
|
LoginSuccess LoginStatus = 1 // Successful login
|
|
LoginFail LoginStatus = 0 // Failed login attempt
|
|
)
|
|
|
|
// StatsNotifyJob sends periodic statistics reports via Telegram bot.
|
|
type StatsNotifyJob struct {
|
|
xrayService service.XrayService
|
|
tgbotService tgbot.Tgbot
|
|
}
|
|
|
|
// NewStatsNotifyJob creates a new statistics notification job instance.
|
|
func NewStatsNotifyJob() *StatsNotifyJob {
|
|
return new(StatsNotifyJob)
|
|
}
|
|
|
|
// Run sends a statistics report via Telegram bot.
|
|
//
|
|
// Lite-build adaptation: upstream gates the report on the local Xray core
|
|
// running, but this panel never runs a local core — the gate would mute the
|
|
// periodic report and the scheduled database backup (tgBotBackup) forever.
|
|
// The report content (panel host usage, exhausted clients, DB backup) does
|
|
// not depend on a local core, so the job always sends.
|
|
func (j *StatsNotifyJob) Run() {
|
|
j.tgbotService.SendReport()
|
|
}
|