{"repo":"Cp0204/ChinaTelecomMonitor","free":true,"listed":false,"github":"https://github.com/Cp0204/ChinaTelecomMonitor","clone":"git clone https://github.com/Cp0204/ChinaTelecomMonitor.git","description":"中国电信 话费、通话、流量 套餐用量监控，支持青龙，支持 Docker 部署成 API 服务。","language":"Python","stars":321,"topics":["qinglong","telecom","docker"],"license":"AGPL-3.0","category":"deployment-docker-iac","readme_excerpt":"ChinaTelecomMonitor 中国电信 话费、通话、流量 套餐用量监控。 本项目是部署在服务器（或x86软路由等设备）使用接口模拟登录，定时获取电信手机话费、通话、流量使用情况，推送到各种通知渠道提醒。 特性 - [x] 支持青龙 - [x] 支持通过 json push config 字段独立配置通知渠道 - [x] 本地保存登录 token ，有效期内不重复登录 - [x] Docker 独立部署 API 查询服务 使用案例 - 提供一个ios的自制UI面板 --- By: LRZ9712 - HomeAssistant插件集成 CTM电信 --- By: hlhk2017 - Homeassistant中国电信接入，视频教程 --- By: 米哟MIO 部署 青龙监控 拉库命令： 环境变量 示例 备注 ---------------------- --------------------- --------------------------------------------- TELECOM USER 18912345678password 手机号密码直接拼接，密码为6位数字，会自动截取 TELECOM FLUX PACKAGE true (默认) 推送流量包明细， false 则只推送基本信息 TELECOM ONLY WARN false (默认) true 则只在流量使用超过均匀范围时通知 推送内容示例： 图标 状态说明 举例 (当月共30天，今天10号) ---- ------------------- --------------------------- 🟢 均匀使用范围内 总流量30GB，已用 50% 总流量30GB，15GB 30GB ⚫ 无流量 总流量=0 Docker API 服务 Docker 部署的是 API 服务，没有监控提醒功能，主要是用于第三方（如 HomeAssistant 等）获取信息，数据原样返回。 [!WARNING] 警告： 登录成功后，会在服务器 config/login info.json 中 记录账号包括 token 在内的敏感信息 ，token 长期有效，直到在其他地方登录被挤下线，程序获取数据时会先尝试用已记录的 token 去请求，避免重复发出登录请求。 ⚠️请勿使用他人部署的 API 服务，以免敏感信息外泄⚠️ 部署命令： docker-compose.yml： 环境变量 示例 备注 --------------- ------------------------- ------------ WHITELIST NUM 18912345678,13312345678 手机号白名单 接口URL - http://127.0.0.1:10000/login 登录，返回用户信息；无须单独请求，请求以下接口时，如未登录会自动登录 - http://127.0.0.1:10000/qryImportantData 返回主要信息，总用量 话费、通话、流量 等 - http://127.0.0.1:10000/userFluxPackage 返回流量包明细 - http://127.0.0.1:10000/qryShareUsage 返回共享套餐各号码用量 - http://127.0.0.1:10000/summary /qryImportantData 的数据简化接口，非原样返回，简化后返回格式： 接口均支持 POST 和 GET 方法，如 GET ： POST 时 Body 须为","default_branch":null,"files":null,"tree":[],"storefront":"/r/Cp0204","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/Cp0204/ChinaTelecomMonitor/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}