{"id":13468106,"url":"https://github.com/pjialin/py12306","last_synced_at":"2025-05-13T21:11:40.961Z","repository":{"id":33998531,"uuid":"164471183","full_name":"pjialin/py12306","owner":"pjialin","description":"🚂 12306 购票助手，支持集群，多账号，多任务购票以及 Web 页面管理 ","archived":false,"fork":false,"pushed_at":"2024-05-10T10:02:48.000Z","size":2453,"stargazers_count":14594,"open_issues_count":191,"forks_count":3587,"subscribers_count":326,"default_branch":"master","last_synced_at":"2025-04-28T14:57:29.396Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pjialin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-01-07T18:04:11.000Z","updated_at":"2025-04-28T10:30:00.000Z","dependencies_parsed_at":"2024-01-14T02:37:01.893Z","dependency_job_id":"fe7067c3-db22-4dff-896d-d6595cf4e8fe","html_url":"https://github.com/pjialin/py12306","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjialin%2Fpy12306","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjialin%2Fpy12306/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjialin%2Fpy12306/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pjialin%2Fpy12306/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pjialin","download_url":"https://codeload.github.com/pjialin/py12306/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254029004,"owners_count":22002283,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T15:01:05.594Z","updated_at":"2025-05-13T21:11:35.946Z","avatar_url":"https://github.com/pjialin.png","language":"Python","funding_links":[],"categories":["Python","Web Development","其他","Python (1887)","抢票工具"],"sub_categories":["C++/C Toolkit","网络服务_其他"],"readme":"# 🚂 py12306 购票助手\n分布式，多账号，多任务购票\n\n## Features\n- [x] 多日期查询余票\n- [x] 自动打码下单\n- [x] 用户状态恢复\n- [x] 电话语音通知\n- [x] 多账号、多任务、多线程支持\n- [x] 单个任务多站点查询 \n- [x] 分布式运行\n- [x] Docker 支持\n- [x] 动态修改配置文件\n- [x] 邮件通知\n- [x] Web 管理页面\n- [x] 微信消息通知\n- [ ] 代理池支持 ([pyproxy-async](https://github.com/pjialin/pyproxy-async))\n\n## 使用\npy12306 需要运行在 python 3.6 以上版本（其它版本暂未测试)\n\n**1. 安装依赖**\n```bash\ngit clone https://github.com/pjialin/py12306\n\npip install -r requirements.txt\n```\n\n**2. 配置程序**\n```bash\ncp env.py.example env.py\n```\n自动打码\n\n（若快已停止服务，目前只能设置**free**打码模式）\nfree 已对接到打码共享平台，[https://py12306-helper.pjialin.com](https://py12306-helper.pjialin.com/)，欢迎参与分享\n\n语音通知\n\n语音验证码使用的是阿里云 API 市场上的一个服务商，需要到 [https://market.aliyun.com/products/56928004/cmapi026600.html](https://market.aliyun.com/products/56928004/cmapi026600.html) 购买后将 appcode 填写到配置中\n\n**3. 启动前测试**\n\n目前提供了一些简单的测试，包括用户账号检测，乘客信息检测，车站检测等\n\n开始测试 -t \n```bash\npython main.py -t\n```\n\n测试通知消息 (语音, 邮件) -t -n\n```bash\n# 默认不会进行通知测试，要对通知进行测试需要加上 -n 参数 \npython main.py -t -n\n```\n\n**4. 运行程序**\n```bash\npython main.py\n```\n\n### 参数列表\n\n- -t 测试配置信息\n- -t -n 测试配置信息以及通知消息\n- -c 指定自定义配置文件位置\n\n### 分布式集群\n\n集群依赖于 redis，目前支持情况\n- 单台主节点多个子节点同时运行\n- 主节点宕机后自动切换提升子节点为主节点\n- 主节点恢复后自动恢复为真实主节点\n- 配置通过主节点同步到所有子节点\n- 主节点配置修改后无需重启子节点，支持自动更新\n- 子节点消息实时同步到主节点\n\n**使用**\n\n将配置文件的中 `CLUSTER_ENABLED` 打开即开启分布式\n\n目前提供了一个单独的子节点配置文件 `env.slave.py.example` 将文件修改为 `env.slave.py`， 通过 `python main.py -c env.slave.py` 即可快速启动\n\n\n## Docker 使用\n**1. 将配置文件下载到本地**\n```bash\ndocker run --rm pjialin/py12306 cat /config/env.py \u003e env.py\n# 或\ncurl https://raw.githubusercontent.com/pjialin/py12306/master/env.docker.py.example -o env.py\n```\n\n**2. 修改好配置后运行**\n```bash\ndocker run --rm --name py12306 -p 8008:8008 -d -v $(pwd):/config -v py12306:/data pjialin/py12306\n```\n当前目录会多一个 12306.log 的日志文件， `tail -f 12306.log`\n\n### Docker-compose 中使用\n**1. 复制配置文件**\n```\ncp docker-compose.yml.example docker-compose.yml\n```\n\n**2. 从 docker-compose 运行**\n\n在`docker-compose.yml`所在的目录使用命令\n```\ndocker-compose up -d\n```\n\n## Web 管理页面\n\n目前支持用户和任务以及实时日志查看，更多功能后续会不断加入\n\n**使用**\n\n打开 Web 功能需要将配置中的 `WEB_ENABLE` 打开，启动程序后访问当前主机地址 + 端口号 (默认 8008) 即可，如 http://127.0.0.1:8008\n\n## 更新\n- 19-01-10\n    - 支持分布式集群\n- 19-01-11\n    - 配置文件支持动态修改\n- 19-01-12\n    - 新增免费打码\n- 19-01-14\n    - 新增 Web 页面支持\n- 19-01-15\n    - 新增 钉钉通知\n    - 新增 Telegram 通知\n    - 新增 ServerChan 和 PushBear 微信推送\n- 19-01-18\n    - 新增 CDN 查询\n\n## 截图\n### Web 管理页面\n![Web 管理页面图片](https://github.com/pjialin/py12306/blob/master/data/images/web.png)\n\n### 下单成功\n![下单成功图片](https://github.com/pjialin/py12306/blob/master/data/images/order_success.png)\n\n### 关于防封\n目前查询和登录操作是分开的，查询是不依赖用户是否登录，放在 A 云 T 云容易被限制 ip，建议在其它网络环境下运行\n\nQQ 交流群 [780289875](https://jq.qq.com/?_wv=1027\u0026k=5PgzDwV)，TG 群 [Py12306 交流](https://t.me/joinchat/F3sSegrF3x8KAmsd1mTu7w)\n\n### Online IDE\n[![在 Gitpod 中打开](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io#https://github.com/pjialin/py12306)\n\n## Thanks\n- 感谢大佬 [testerSunshine](https://github.com/testerSunshine/12306)，借鉴了部分实现\n- 感谢所有提供 pr 的大佬 \n- 感谢大佬 [zhaipro](https://github.com/zhaipro/easy12306) 的验证码本地识别模型与算法\n\n## License\n\n[Apache License.](https://github.com/pjialin/py12306/blob/master/LICENSE)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpjialin%2Fpy12306","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpjialin%2Fpy12306","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpjialin%2Fpy12306/lists"}