TG

首次部署向导

填完以下模块即可启动监控服务

01 · 部门资讯
用作容器名后缀。安装后不可修改,请谨慎填写。
登入页与预警消息显示用
不同中心可能叫「广告主 / 客户 / 合作方 / 商家」等,会显示在 Sheet 表头和预警消息里。留空=「广告主」
不同中心可能叫「商务人员 / 业务员 / 负责人 / 客服 / 运营」等,会显示在 Sheet 每个分页 A2、3 个预警表表头、TG 预警消息里。改了后系统自动同步现有 Sheet,不用手动改。留空=「商务人员」
首次设置的即为主帐号(最高权限),设置完成后可自行新增其他管理员或普通成员
登入后台用的密码
02 · Telegram Bot
@BotFather 取得,要先把 Bot 加进预警群并设为群管理员
▸ 如何获取 Bot Token & 预警群 ID
一、创建 Bot 获取 Token
  1. 01 打开 Telegram 搜索 @BotFather → 发送 /newbot
  2. 02 按提示输入机器人名称(中英文皆可)和用户名(必须 _bot 结尾)
  3. 03 BotFather 会返回一串 123456:ABC-DEF... 格式的 Token,复制填入上方
二、把 Bot 加入预警群并设为管理员
  1. 01 在 Telegram 建一个预警群(或用现有群)
  2. 02 邀请你刚建的 Bot 加入群
  3. 03 群设置 → 管理员 → 添加管理员 → 选中 Bot(必须步骤,否则收不到预警)
三、获取群 Chat ID
  1. 01 把 @userinfobot 拉进预警群
  2. 02 它会自动发一条消息,里面的 Id: 那串负数就是 Chat ID(通常以 -100 开头)
  3. 03 拿到 ID 后可以把 @userinfobot 从群里踢掉
03 · Google Sheets
留空 + 完成下方 Google 授权 → 点「自动建表格」即可。 想用已有表格才手动填,URL 里 docs.google.com/spreadsheets/d/[SHEET_ID]/edit 中间那串就是。
▸ 授权 Google Drive(让客户图片/文件直接显示在 Sheet)
不需要这个功能就跳过,留空即可,系统照旧显示「[图片]/[文件]」文字占位。
▸ 连接 Google Drive(OAuth 授权) 点击会跳到 Google 授权页,完成后自动回到本精灵继续配置
⚠ 点之前必做:要授权的 Gmail 必须先加到 OAuth 同意屏幕 → 测试用户 白名单,不然 Google 会报 403 access_denied。
做法:打开上面链接 → 滚到「测试用户」区 → + ADD USERS → 填 Gmail → 保存。
▸ 如何创建 OAuth Client ID / Secret(7 步,在 Google Cloud Console 新建或用已有项目)
1. 打开 Google Cloud Console → 凭据 (用同一个 Google 帐号)
⚠ 1.5. 必做:启用 Drive API + Sheets API(不启用会「建 Spreadsheet 失败」)
新建项目默认关的,各点一次「启用」就行:
· 启用 Google Drive API
· 启用 Google Sheets API
点进去后顶部选对项目(跟凭据同一个) → 按「启用」→ 等 10 秒生效
2. 顶部 + 创建凭据 → 选 OAuth 客户端 ID
3. 应用类型选 「Web application / Web 应用」 ⚠ 不是「桌面」
4. 已获授权的重定向 URI 添加这个(必须完全一致):
http://YOUR_VPS_IP:5002/api/oauth/callback
↑ 这一行会自动填上你当前浏览器用的 IP/端口,直接复制就行
5. 点「创建」→ 弹出 Client ID 和 Client Secret,分别复制粘贴到上方两个输入框 → 点最下方保存
6. 关键步骤(忽略会 access_denied):打开 OAuth 同意屏幕 → 滑到下面 「测试用户」 区 → + ADD USERS → 把要授权的 Gmail 加进去
↑ 因为应用还在「测试」状态,只有名单里的用户能授权
7. 现在就可以授权:确认上方两个输入框已填好 Client ID / Secret → 点上方 「▸ 连接 Google Drive」 按钮 → 跳 Google 选帐号 (这个帐号必须已加进第 6 步的测试用户白名单) → 继续(可能出现「Google 没核实此应用」警告,点高级 → 转至 [项目名] (不安全)是正常的) → 同意 → 自动飞回精灵页,Drive 文件夹 + Sheet 自动建好 → 继续填其他字段 → 最后点底部「保存并启动」
▸ 常见报错
  • 建 Spreadsheet 失败 / SERVICE_DISABLED / 403:第 1.5 步两个 API 没启用,照上面两个链接点一下「启用」就好
  • redirect_uri_mismatch:第 4 步填的跟当前 URL 不完全一致。http vs https、端口、IP 都要对得上
  • access_denied:授权帐号没加到第 6 步的「测试用户」名单
  • 没拿到 refresh_token:到 myaccount.google.com/permissions 撤销旧授权再重试
授权 Google Drive 后系统会自动建一个「tg-monitor-媒体」文件夹并把 ID 填到这里。 想用自己的文件夹再手动改。留空 = 不上传,仅显示「[图片]/[文件]」文字。
▸ 想用自己现有的 Drive 文件夹?(高级)
⚠ 注意:OAuth 的 drive.file 权限只能管理本程序上传的文件。手动指定的文件夹自动清理可能失效,建议直接用自动建的文件夹。
1. drive.google.com 新建文件夹
2. 进入文件夹,地址栏 folders/ 后面那串字符就是 ID,复制填到上方
3. 点 「测试文件夹权限」 验证
▸ 启用前请了解的风险
启用后,客户发来的图片/文件都会上传到这个 Drive 文件夹:
  • 文件会被设为「任何拥有连结的人可查看」(=IMAGE 才能在 Sheet 渲染)
  • Google 会自动扫描已知病毒,但新型/伪装文件不一定能拦
  • 占用 Drive 配额(免费 15GB);超过下方「单文件上限」的大文件会被跳过
  • 不需要这个功能时留空就好,系统会自动 fallback 显示文字「[图片]/[文件]」
超过此大小的文件不会上传(防止刷爆 Drive),只显示文字占位。预设 20 MB
每天凌晨 03:00 (北京时间) 自动删除 Drive 文件夹里超过 N 天的文件,防止长期堆积。 删除后 Sheet 里的旧文件链接会失效,但文字记录(时间/发送人/内容)永久保留。 Drive 回收站还留 30 天,误删可以恢复。常用:30 / 60 / 90 天。
04 · 业务设置 (可留预设)
消息命中任一词立即推送预警
按工作时段累计,休息不计入
所有部门共用预设值,极少需要改
▸ 如何自行申请 Telegram API ID / Hash (进阶)
默认已填入共用值,一般部门无需修改。若要自建:
  1. 01 打开 my.telegram.org → 输入手机号登录(需收验证码)
  2. 02 进入 API development tools
  3. 03 首次使用需填表创建 App:
    - App title:应用名(例如 TG Monitor)
    - Short name:简称(例如 tgmonitor)
    - Platform:选 Other 或 Desktop
  4. 04 创建后会显示 App api_id(数字)和 App api_hash(32 字符),分别填上方
注意:API ID / Hash 绑定账号,泄露有风险,别公开贴到 GitHub。
系统在线 TG 监控 · v2.10.13