sub-bot/README.md

Sub Bot — Telegram 群订阅管理机器人

群成员共享的代理订阅管理 Bot，支持上传、获取、检测、自动清理。

功能

• /vps 打开交互菜单（添加/列表/获取/删除/检测）
• 直接发订阅链接自动识别入库（支持多条）
• 支持 ss/vmess/vless/trojan/hy2/tuic 协议 + Surge 格式
• 获取订阅：原始链接 / Base64 / Clash Meta 订阅 URL
• 节点存活检测（TCP 连通性）
• 每 6 小时自动清理不可用节点并通知群
• 所有 Bot 消息 60 秒后自动删除
• 内置 HTTP 订阅端点，客户端可直接导入

部署

pip install python-telegram-bot

配置环境变量：

export BOT_TOKEN="your_bot_token"
export ADMIN_ID="your_telegram_id"
export SUB_SECRET="random_secret_string"
export SUB_HOST="your_server_ip:18888"

运行：

python3 bot.py

systemd

[Unit]
Description=Sub Bot
After=network.target

[Service]
Type=simple
WorkingDirectory=/opt/sub-bot
Environment=BOT_TOKEN=your_token
Environment=ADMIN_ID=your_id
Environment=SUB_SECRET=your_secret
Environment=SUB_HOST=your_ip:18888
ExecStart=/usr/bin/python3 /opt/sub-bot/bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

订阅端点

http://your_ip:18888/{SUB_SECRET}/download?target=ClashMeta
http://your_ip:18888/{SUB_SECRET}/download?target=raw
http://your_ip:18888/{SUB_SECRET}/download?target=ClashMeta&type=ss