{"id":19497698,"url":"https://github.com/oreomeow/warpplus","last_synced_at":"2026-03-11T00:03:08.403Z","repository":{"id":49958156,"uuid":"518469405","full_name":"Oreomeow/warpplus","owner":"Oreomeow","description":"Get WARP+ referral quota and notify users with Telegram Bot","archived":false,"fork":false,"pushed_at":"2022-08-31T11:58:35.000Z","size":412,"stargazers_count":180,"open_issues_count":1,"forks_count":29,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-25T22:35:10.118Z","etag":null,"topics":["python-telegram-bot","warp-plus","wgcf"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Oreomeow.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}},"created_at":"2022-07-27T13:27:28.000Z","updated_at":"2025-03-14T15:10:10.000Z","dependencies_parsed_at":"2022-08-12T20:50:51.391Z","dependency_job_id":null,"html_url":"https://github.com/Oreomeow/warpplus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Oreomeow/warpplus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oreomeow%2Fwarpplus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oreomeow%2Fwarpplus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oreomeow%2Fwarpplus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oreomeow%2Fwarpplus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Oreomeow","download_url":"https://codeload.github.com/Oreomeow/warpplus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Oreomeow%2Fwarpplus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30362722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"ssl_error","status_checked_at":"2026-03-10T21:40:59.357Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["python-telegram-bot","warp-plus","wgcf"],"created_at":"2024-11-10T21:47:40.541Z","updated_at":"2026-03-11T00:03:08.360Z","avatar_url":"https://github.com/Oreomeow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WARP+ 推荐奖励 Telegram Bot\n\n![warpplus](https://socialify.git.ci/Oreomeow/warpplus/image?description=1\u0026descriptionEditable=Get%20WARP%2B%20referral%20quota%20and%20notify%20users%20with%20Telegram%20Bot\u0026font=Raleway\u0026forks=1\u0026issues=1\u0026language=1\u0026logo=https%3A%2F%2Fraw.githubusercontent.com%2FOreomeow%2Fwarpplus%2Fmain%2FLogo.png\u0026pattern=Floating%20Cogs\u0026pulls=1\u0026stargazers=1\u0026theme=Light)\n\n\u003e 利用 **Telegram Bot** 获取 **WARP+** 推荐奖励流量并通知用户\n\n## 功能 (Functions)\n\n- [x] 刷取一定次数\n  - [x] 不指定次数按 +∞ 刷取\n  - [x] 指定次数刷取\n  - [x] 刷取结果统计\n- [x] 添加管理命令\n- [x] 支持他人刷取\n- [x] 查询当前流量\n- [ ] 设置定时任务\n- [ ] 支持多种语言\n\n## 部署 (Deploy)\n\n\u003e **Warning** 需要 Python \u003e= 3.7\n\n### 克隆仓库\n\n```bash\ngit clone --depth=1 https://github.com/Oreomeow/warpplus \u0026\u0026 cd warpplus\n```\n\n### 安装依赖\n\n```bash\npip3 install -r requirements.txt\n```\n\n### 配置参数\n\n- 通过 [@BotFather](https://t.me/botfather) 获取 Bot API Token\n\n- 通过 WARP APP 获取 ID\n\n  [![WARP APP 图示](https://user-images.githubusercontent.com/62703343/136070323-47f2600a-13e4-4eb0-a64d-d7eb805c28e2.png)](https://github.com/fscarmen/warp)\n\n- 根据 `config.example.json` 在同目录生成 `config.json` 配置文件\n\n  ```json\n  {\n      \"TOKEN\": \"# Telegram bot API Token (可在 @botfather 获取，如 10xxx4:AAFcqxxxxgER5uw)\",\n      \"USER_ID\": \"# Telegram 用户 ID (给 @getidsbot 发送 /start 获取到的纯数字 ID，如 1434078534)\",\n      \"GIFT_LIMIT\": \"# 限制其他用户单次刷取次数，如 10，不限制则输入 0\",\n      \"REFERRER\": \"# WARP 应用 (如 1.1.1.1) 内的设备 ID\",\n  }\n  ```\n\n### 运行测试\n\n```bash\npython3 warpplus.py\n```\n\n`Ctrl + C` 退出\n\n### 持久化运行\n\n从以下方法中任选其一即可，或参考 [Linux 守护进程的启动方法](https://www.ruanyifeng.com/blog/2016/02/linux-daemon.html)\n\n- [Systemd](https://www.ruanyifeng.com/blog/2016/03/systemd-tutorial-commands.html) (推荐)\n\n  一键脚本\n\n  ```bash\n  bash install.sh\n  ```\n\n  查看 `warpplus` 状态\n\n  ```bash\n  systemctl status warpplus\n  ```\n\n  查看 `warpplus` 日志\n\n  ```bash\n  journalctl -u warpplus\n  ```\n\n  启动 `warpplus`\n\n  ```bash\n  systemctl start warpplus\n  ```\n\n  停止 `warpplus`\n\n  ```bash\n  systemctl stop warpplus\n  ```\n\n  重启 `warpplus`\n\n  ```bash\n  systemctl restart warpplus\n  ```\n\n  杀死 `warpplus` 所有子进程\n  \n  ```bash\n  systemctl kill warpplus\n  ```\n\n- [nohup](https://www.runoob.com/linux/linux-comm-nohup.html)\n\n  ```bash\n  nohup python3 warpplus.py \u003e warpplus.log 2\u003e\u00261 \u0026\n  ```\n\n  查看日志\n\n  ```bash\n  tail -f warpplus.log\n  ```\n\n- [Screen](https://www.runoob.com/linux/linux-comm-screen.html)\n\n  1. 创建会话\n\n     ```bash\n     screen -S warpplus\n     python3 warpplus.py\n     ```\n\n     然后，按下 `Ctrl + A` 和 `Ctrl + D` ，回到原来的会话\n\n  2. 如果要查看日志，可以使用 `screen -r warpplus` ；如果要停掉会话，按下 `Ctrl + C` 和 `Ctrl + D`\n\n- [Tmux](http://www.ruanyifeng.com/blog/2019/10/tmux.html)\n\n  1. 安装\n\n     ```bash\n     # Debian or Ubuntu\n     apt install -y tmux\n\n     # CentOS or RedHat\n     yum install -y tmux\n     ```\n\n  2. 新建会话\n\n     ```bash\n     tmux new -s warpplus\n     python3 warpplus.py\n     ```\n\n  3. 分离会话\n\n     ```bash\n     tmux detach\n     ```\n\n     或键盘按下 `Ctrl + B D` 即可将当前会话与窗口分离\n\n  4. 如果要查看日志，可以使用 `tmux attach -t warpplus` ；如果要杀死会话 `tmux kill-session -t warpplus`\n\n### `/bind` 命令说明\n\n```text\n/bind \u003creferrer\u003e - 绑定 WARP 应用 (如 1.1.1.1) 内的设备 ID\n/bind t \u003caccess_token\u003e - 绑定 wgcf-account.toml 中的 access_token\n/bind i \u003cdevice_id\u003e - 绑定 wgcf-account.toml 中的 device_id\n/bind \u003caccess_token\u003e \u003cdevice_id\u003e - 绑定成对\n```\n\n其中 `\u003creferrer\u003e` 和 `\u003cdevice_id\u003e` 其实是同一个，只是 `\u003creferrer\u003e` 可以在手机 APP `1.1.1.1` 中找到，而从 `wgcf-account.toml` 提取的 `\u003caccess_token\u003e` 和 `\u003cdevice_id\u003e` 必须绑定成对，否则无法进行流量查询\n\n在安装了 [wgcf](https://github.com/ViRb3/wgcf) 的机器上可以使用 `Scripts/get.sh` 进行快捷提取\n\n也可以运行以下命令提取\n\n```bash\nif ! [ -f '/etc/wireguard/wgcf-account.toml' ]; then\n    echo \"wgcf-account.toml 文件不存在，请查看是否已安装 wgcf。相关仓库 https://github.com/fscarmen/warp\"\nelse\n    ACCESS_TOKEN=$(grep 'access_token' /etc/wireguard/wgcf-account.toml | cut -d \\' -f2)\n    DEVICE_ID=$(grep 'device_id' /etc/wireguard/wgcf-account.toml | cut -d \\' -f2)\n\n    echo \"====================== 请复制以下内容 (不包括此行) ======================\"\n    echo \"${ACCESS_TOKEN} ${DEVICE_ID}\"\n    echo \"====================== 请复制以上内容 (不包括此行) ======================\"\nfi\n```\n\n## 命令 (Commands)\n\n```text\nstart - 开始使用\nquery - 查询流量\nplus - (\u003cn\u003e) 💂‍♂️管理员账号添加流量，不输入次数视为 +∞\nbind - [点击查看具体用法] 绑定账号\nunbind - 解除绑定\ngift - (\u003cn\u003e) 获取流量，不输入次数视为 +∞\nstop - 💂‍♂️管理员停止运行中的任务\n```\n\n## 贡献 (Contributors)\n\n- [Silentely](https://github.com/Silentely)\n\n## 鸣谢 (Thanks)\n\n- [ALIILAPRO/warp-plus-cloudflare](https://github.com/ALIILAPRO/warp-plus-cloudflare)\n\n- [fscarmen/warp](https://github.com/fscarmen/warp)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foreomeow%2Fwarpplus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foreomeow%2Fwarpplus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foreomeow%2Fwarpplus/lists"}