66 lines
1.4 KiB
Markdown
66 lines
1.4 KiB
Markdown
# Sub Bot — Telegram 群订阅管理机器人
|
||
|
||
群成员共享的代理订阅管理 Bot，支持上传、获取、检测、自动清理。
|
||
|
||
## 功能
|
||
|
||
- `/vps` 打开交互菜单（添加/列表/获取/删除/检测）
|
||
- 直接发订阅链接自动识别入库（支持多条）
|
||
- 支持 ss/vmess/vless/trojan/hy2/tuic 协议 + Surge 格式
|
||
- 获取订阅：原始链接 / Base64 / Clash Meta 订阅 URL
|
||
- 节点存活检测（TCP 连通性）
|
||
- 每 6 小时自动清理不可用节点并通知群
|
||
- 所有 Bot 消息 60 秒后自动删除
|
||
- 内置 HTTP 订阅端点，客户端可直接导入
|
||
|
||
## 部署
|
||
|
||
```bash
|
||
pip install python-telegram-bot
|
||
```
|
||
|
||
配置环境变量：
|
||
|
||
```bash
|
||
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"
|
||
```
|
||
|
||
运行：
|
||
|
||
```bash
|
||
python3 bot.py
|
||
```
|
||
|
||
## systemd
|
||
|
||
```ini
|
||
[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
|
||
```
|