PY12306 购票助手：轻松掌握的火车票抢购神器
项目地址: https://gitcode.com/gh_mirrors/py/py12306 🚀 概述
还在为春运、节假日抢票而烦恼吗？PY12306 购票助手是一款基于 Python 开发的分布式、多账号、多任务火车票自动抢购工具，让你彻底告别手动刷票的烦恼！
通过本文，你将全面掌握：
- ✅ PY12306 的核心功能与架构设计
- ✅ 从零开始的完整安装配置指南
- ✅ 多账号管理与分布式集群部署
- ✅ Web 可视化界面操作技巧
- ✅ 高级功能配置与优化策略
📊 核心功能特性
| 功能模块 | 支持情况 | 说明 |
|---|---|---|
| 多日期查询 | ✅ 已支持 | 同时监控多个出发日期 |
| 自动打码 | ✅ 已支持 | 集成免费打码平台 |
| 分布式运行 | ✅ 已支持 | Redis 集群部署 |
| Docker 支持 | ✅ 已支持 | 容器化部署 |
| Web 管理 | ✅ 已支持 | 可视化界面操作 |
| 多通知方式 | ✅ 已支持 | 邮件、语音、钉钉等 |
| 代理池 | ❌ 暂不支持 | 正在开发中 |
🏗️ 系统架构设计
🛠️ 环境准备与安装
系统要求
- Python 3.6+ 版本
- Redis 服务器（集群模式需要）
- 稳定的网络连接
快速安装步骤
# 1. 克隆项目代码
git clone https://gitcode.com/gh_mirrors/py/py12306
# 2. 进入项目目录
cd py12306
# 3. 安装依赖包
pip install -r requirements.txt
# 4. 复制配置文件
cp env.py.example env.py
依赖包说明
主要依赖库及其作用：
| 库名称 | 版本要求 | 功能说明 |
|---|---|---|
| requests | >=2.18.4 | HTTP 请求处理 |
| redis | >=2.10.6 | Redis 连接池 |
| flask | >=1.0.2 | Web 界面框架 |
| pillow | >=5.2.0 | 图像处理 |
| qrcode | >=6.0 | 二维码生成 |
⚙️ 详细配置指南
基础账号配置
# env.py 配置文件示例
USER_ACCOUNTS = [
{
'key': 0, # 账号唯一标识
'user_name': 'your_username', # 12306 用户名
'password': 'your_password', # 12306 密码
'type': 'qr' # 登录方式: qr=扫码, 空=密码登录
}
]
查询任务配置
QUERY_JOBS = [
{
'job_name': '北京-上海', # 任务名称
'account_key': 0, # 使用的账号key
'left_dates': [ # 出发日期列表
"2025-01-20",
"2025-01-21"
],
'stations': { # 车站信息
'left': '北京',
'arrive': '上海'
},
'members': [ # 乘客信息
"张三",
"李四"
],
'seats': [ # 座位优先级
'一等座',
'二等座',
'硬卧'
],
'train_numbers': [ # 指定车次
"G1",
"G3",
"G5"
],
'period': { # 时间范围
'from': '06:00',
'to': '22:00'
}
}
]
通知系统配置
# 邮件通知配置
EMAIL_ENABLED = 1
EMAIL_SENDER = 'sender@example.com'
EMAIL_RECEIVER = 'receiver@example.com'
EMAIL_SERVER_HOST = 'smtp.example.com'
EMAIL_SERVER_USER = 'username'
EMAIL_SERVER_PASSWORD = 'password'
# 语音验证码通知
NOTIFICATION_BY_VOICE_CODE = 1
NOTIFICATION_VOICE_CODE_TYPE = 'dingxin'
NOTIFICATION_API_APP_CODE = 'your_app_code'
NOTIFICATION_VOICE_CODE_PHONE = '13800138000'
# 钉钉机器人通知
DINGTALK_ENABLED = 1
DINGTALK_WEBHOOK = 'https://oapi.dingtalk.com/robot/send?access_token=your_token'
🚀 启动与运行
单机模式运行
# 测试配置是否正确
python main.py -t
# 测试通知功能
python main.py -t -n
# 正式运行
python main.py
Docker 容器化部署
# 1. 拉取配置文件
docker run --rm pjialin/py12306 cat /config/env.py > env.py
# 2. 修改配置后运行
docker run --rm --name py12306 -p 8008:8008 -d \
-v $(pwd):/config -v py12306:/data \
pjialin/py12306
# 3. 查看日志
tail -f runtime/12306.log
Docker Compose 部署
# docker-compose.yml 示例
version: '3'
services:
py12306:
image: pjialin/py12306
ports:
- "8008:8008"
volumes:
- ./env.py:/config/env.py
- py12306_data:/data
restart: unless-stopped
volumes:
py12306_data:
🌐 Web 管理界面
启用 Web 管理功能后，可以通过浏览器访问 http://127.0.0.1:8008 进行可视化操作：
功能特性
登录配置
WEB_ENABLE = 1
WEB_USER = {
'username': 'admin', # 管理界面用户名
'password': 'password' # 管理界面密码
}
WEB_PORT = 8008 # 服务端口
🔧 高级功能配置
分布式集群部署
# 集群配置
CLUSTER_ENABLED = 1 # 启用集群模式
NODE_IS_MASTER = 1 # 主节点标识
NODE_SLAVE_CAN_BE_MASTER = 1 # 子节点可升级为主节点
NODE_NAME = 'master' # 节点名称
# Redis 配置
REDIS_HOST = 'redis-server' # Redis 服务器地址
REDIS_PORT = '6379' # Redis 端口
REDIS_PASSWORD = '' # Redis 密码
CDN 加速查询
CDN_ENABLED = 1 # 启用 CDN 查询
CDN_CHECK_TIME_OUT = 1 # CDN 检测超时时间(秒)
# CDN 列表文件 data/cdn.txt
# 格式: 每行一个 CDN 地址
cdn1.example.com
cdn2.example.com
cdn3.example.com
查询优化配置
# 查询间隔配置（单位：秒）
QUERY_INTERVAL = {
'min': 0.5, # 最小间隔
'max': 1.0 # 最大间隔
}
# 网络请求重试次数
REQUEST_MAX_RETRY = 5
# 用户心跳检测间隔
USER_HEARTBEAT_INTERVAL = 120
📈 性能优化建议
查询策略优化
内存与资源管理
| 优化项 | 推荐配置 | 说明 |
|---|---|---|
| 查询线程数 | 根据CPU核心数调整 | 避免过度并发 |
| Redis 连接池 | 10-20个连接 | 平衡性能与资源 |
| 日志输出 | 仅错误日志 | 减少磁盘IO |
| 心跳间隔 | 120秒 | 平衡实时性与负载 |
🐛 常见问题排查
登录失败处理
# 检查项列表
检查项 = [
"账号密码是否正确",
"网络连接是否正常",
"验证码识别服务是否可用",
"12306服务器状态"
]
处理步骤 = [
"尝试手动登录12306确认账号状态",
"检查网络代理设置",
"切换打码平台或使用免费打码",
"等待服务器恢复后重试"
]
查询无结果分析
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 一直查询中 | 网络连接问题 | 检查网络或使用CDN |
| 返回空数据 | 车次信息错误 | 确认车站名称和车次 |
| 频繁超时 | 服务器限制 | 调整查询间隔 |
| 验证码错误 | 打码服务异常 | 更换打码平台 |
🔮 未来发展规划
PY12306 项目持续更新迭代，未来计划包括：
- 代理池支持 - 集成 IP 代理池避免 IP 限制
- 智能路由选择 - 基于历史数据的智能车次推荐
- 移动端应用 - 开发手机客户端方便移动操作
- API 接口开放 - 提供 RESTful API 供第三方集成
- 云部署方案 - 一键部署到云平台的解决方案
💡 使用技巧与最佳实践
抢票时机选择
多账号策略
# 建议使用多个账号分散风险
USER_ACCOUNTS = [
{
'key': 'account1',
'user_name': 'user1@example.com',
'password': 'pass1',
'type': 'qr'
},
{
'key': 'account2',
'user_name': 'user2@example.com',
'password': 'pass2',
'type': ''
}
]
# 为不同账号分配不同任务
QUERY_JOBS = [
{
'account_key': 'account1',
# ... 任务配置
},
{
'account_key': 'account2',
# ... 任务配置
}
]
🎯 总结
PY12306 作为一款功能强大的火车票抢购助手，具备以下核心优势：
- 分布式架构：支持多节点集群部署，高可用性
- 多账号管理：同时管理多个12306账号，提高成功率
- 智能查询：CDN加速、多线程并发、智能重试机制
- 丰富通知：邮件、语音、钉钉等多种通知方式
- Web管理：可视化界面，操作简单便捷
- 开源免费：完全开源，社区持续维护更新
通过本文的详细指南，相信你已经掌握了 PY12306 的完整使用方法。无论是春运抢票还是日常购票，这款工具都能为你提供强大的技术支持。
立即开始使用 PY12306，告别手动刷票的烦恼，享受智能购票的便捷体验！
温馨提示：请合理使用抢票工具，遵守12306购票规则，共同维护良好的购票环境。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
