一个简洁、高效的 12306 余票监控工具，当出现余票时，可通过多种方式推送通知。 感谢原作者：https://github.com/BobLiu0518/CRTicketMonitor
⚠️ 免责声明 本程序仅用于学习和监控 12306 官网的余票信息，并非抢票软件，也不会增加任何抢票相关功能。程序作者不对监控结果的准确性做出任何保证，不为任何因使用本程序而产生的商业或法律纠纷负责。
通过交互式界面可以：
- 🔍 输入出发地、目的地、日期，实时查询车次列表
- 📋 查看完整的车次信息和余票情况
- ⚙️ 动态选择监控车次和席别
- 📲 配置推送通知方式
- 💾 自动生成和保存配置文件
- 🚀 一键启动监控程序
详细使用说明请参考 CLI_GUIDE.md
在项目的 Releases 页面下载对应您操作系统的最新版本。 CNB(推荐) Github
首次运行程序会自动生成一份 config.yml 模板文件。请根据 参数配置 说明修改该文件。
将配置好的 config.yml 文件放置于可执行程序的同一目录下，然后直接运行即可。
前往 Node.js 官网 下载并安装，或使用 包管理器 安装。
直接 下载 Zip 文件，或使用 Git：
$ git clone https://github.com/wxory/CRTMonitor.git
$ git clone https://cnb.cool/wxory/CRTMonitor.git$ npm inpm start
项目内置了 run.sh 脚本，它使用 screen 来实现后台持久化运行。
# 确保已安装 screen: sudo apt install screen (Debian/Ubuntu)
./run.sh
程序启动时会查找同目录下的 config.yml 文件。如果文件不存在，将自动创建一个模板。
以下是一个完整的配置示例：
config.yml 示例:
# 🚄 China Railway Ticket Monitor 配置文件
# 详细配置说明请参考 README.md
# 查询列表 - 可添加多个查询条件
watch:
- # 基础信息
from: "上海" # 起点站（包含同城站）
to: "北京" # 终点站（包含同城站）
date: "20241001" # 日期（YYYYMMDD 格式）
# 车次列表（可选）- 不填时默认为全部车次
trains:
- code: "G2" # 车次号
from: "上海" # 指定起点站（可选）
to: "北京南" # 指定终点站（可选）
seatCategory: # 限定席别（可选，详见下文）
- "二等座"
checkRoundTrip: true # 查询全程车票情况（可选）
# 推送配置 - 支持多种推送方式（详见下文）
notifications:
- # 飞书推送
type: "Lark"
webhook: "" # 飞书机器人 Webhook URL
- # Telegram推送
type: "Telegram"
botToken: "" # Telegram机器人Token
chatId: "" # 接收消息的Chat ID
- # Bark推送
type: "Bark"
deviceKey: "" # Bark 设备密钥
serverUrl: "https://api.day.app" # 服务器地址（可选）
group: "火车票监控" # 推送分组（可选）
- # SMTP邮件推送
type: "SMTP"
host: "smtp.gmail.com" # SMTP服务器地址
port: 587 # SMTP端口号
user: "your-email@gmail.com" # 邮箱用户名
pass: "your-app-password" # 邮箱密码
to: "recipient@example.com" # 收件人邮箱
# 刷新间隔（分钟，可选，默认 15 分钟）
interval: 15
# 访问延迟（秒，可选，默认 5 秒）
delay: 5目前支持飞书推送、Telegram 推送、企业微信推送、Bark 推送和 SMTP 邮件推送通知。
获取飞书机器人的 webhook 地址可参考飞书开发文档
在 config.yml 中填写飞书机器人的 Webhook 地址即可，例如：
notifications:
- type: "Lark"
webhook: "https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-url"为了提高安全性，建议启用飞书机器人的签名校验功能：
- 在飞书群组中，进入自定义机器人的配置页面
- 在安全设置中选择"签名校验"
- 复制生成的密钥
- 在配置文件中添加
secret字段：
notifications:
- type: "Lark"
webhook: "https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-url"
secret: "your-secret-key" # 签名密钥（可选，启用签名校验时必填）注意事项：
- 签名密钥用于验证消息来源的可信性，防止恶意调用
- 启用签名校验后，所有请求都需要通过签名验证
- 签名算法使用 HmacSHA256 + Base64 编码
使用 Telegram 推送需要先创建一个 Telegram 机器人并获取相关信息：
- 在 Telegram 中找到 @BotFather 并发送
/newbot创建新机器人 - 按照提示设置机器人名称和用户名，获取机器人 Token
- 将机器人添加到您的聊天中，或直接与机器人私聊
- 获取 Chat ID：
- 发送消息给机器人后，访问
https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates - 在返回的 JSON 中找到
chat.id字段
- 发送消息给机器人后，访问
在 config.yml 中配置 Telegram 推送：
notifications:
- type: "Telegram"
botToken: "123456789:ABCdefGHIjklMNOpqrsTUVwxyz" # 机器人Token
chatId: "123456789" # Chat ID（可以是个人ID或群组ID）使用企业微信推送需要先创建企业微信群机器人：
- 在企业微信群中，点击群设置 → 群机器人 → 添加机器人
- 设置机器人名称和头像，获取 Webhook URL
- 复制完整的 Webhook URL（包含 key 参数）
在 config.yml 中配置企业微信推送：
notifications:
- type: "WechatWork"
webhook: "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=your-webhook-key"Bark 是一个 iOS 推送通知应用，支持通过 API 发送推送到 iPhone/iPad。
- 在 App Store 下载并安装 Bark 应用
- 打开应用，复制显示的设备密钥（Device Key）
- 可选：如果你有自己的 Bark 服务器，也可以修改服务器地址
在 config.yml 中配置 Bark 推送：
notifications:
- type: "Bark"
deviceKey: "your-device-key" # 必填：设备密钥
serverUrl: "https://api.day.app" # 可选：服务器地址，默认官方服务器
group: "火车票监控" # 可选：推送分组
sound: "default" # 可选：推送声音
# 高级选项（可选）
level: "active" # 推送级别：active(默认)/critical(重要)/timeSensitive(时效)/passive(静默)
icon: "https://example.com/icon.png" # 自定义图标URL
url: "https://example.com" # 点击推送后跳转的URL
autoCopy: false # 是否自动复制推送内容
isArchive: true # 是否保存到推送历史active（默认）：系统会立即亮屏显示通知critical：重要警告，在静音模式下也会响铃timeSensitive：时效性通知，可在专注状态下显示通知passive：仅将通知添加到通知列表，不会亮屏提醒
SMTP 邮件推送支持通过标准邮件服务器发送余票通知邮件。
在 config.yml 中配置 SMTP 邮件推送：
notifications:
- type: "SMTP"
host: "smtp.gmail.com" # 必填：SMTP服务器地址
port: 587 # 必填：SMTP端口号
user: "your-email@gmail.com" # 必填：邮箱用户名
pass: "your-app-password" # 必填：邮箱密码或应用密码
to: "recipient@example.com" # 必填：收件人邮箱地址
# 可选配置
from: "12306监控 <your-email@gmail.com>" # 发件人显示名称
cc: "cc@example.com" # 抄送邮箱
bcc: "bcc@example.com" # 密送邮箱
replyTo: "noreply@example.com" # 回复邮箱
secure: true # 是否使用SSL/TLS (465端口使用true，587端口使用false)Gmail:
host: "smtp.gmail.com"
port: 587
secure: false # 使用STARTTLS
# 需要开启两步验证并生成应用密码QQ 邮箱:
host: "smtp.qq.com"
port: 587
secure: false
# 需要开启SMTP服务并使用授权码163 邮箱:
host: "smtp.163.com"
port: 587
secure: false
# 需要开启SMTP服务并使用授权码Outlook:
host: "smtp-mail.outlook.com"
port: 587
secure: false- Gmail: 需要开启两步验证，生成应用专用密码
- QQ 邮箱: 需要在设置中开启 SMTP 服务，使用授权码作为密码
- 163 邮箱: 需要开启 SMTP 服务，使用授权码作为密码
- 企业邮箱: 根据企业邮箱服务商的要求配置
25: 标准 SMTP 端口（通常被 ISP 封禁）587: STARTTLS 加密端口（推荐）465: SSL/TLS 加密端口
这样，当有余票时，程序会通过相应的平台发送通知。
可选的席别如下：
- 卧铺：
高级软卧软卧（含动卧一等卧）硬卧（含二等卧）
- 坐票：
商务座特等座优选一等座一等座二等座软座硬座无座
- 其他：
其他（含包厢硬卧等）YB（未知类型）SRRB（未知类型）