get-subscribe 1.0.0

免费机场/VPN 订阅自动获取工具 - Clash / V2Ray / Trojan / SSR 订阅链接自动抓取

✈️ get_subscribe

免费机场 / 免费 VPN — 自动获取 Clash / V2Ray / Trojan / SSR 订阅链接，间隔 12 小时持续更新

---

⚠️ 免责声明

• 链接来自网络，仅供学习研究使用
• 使用前请务必遵守当地法律法规
• 本项目不对任何使用后果负责

---

🌟 功能特性

• 自动抓取：从公开 RSS 源定时抓取最新免费订阅
• 多协议支持：Clash 配置（.yml）、V2Ray 文本（.txt）
• 变更检测：仅在内容实际变化时记录日志，避免重复通知
• 灵活使用：pip 安装 CLI 一键运行，或作为 Python 库集成
• 日志记录：按月自动归档运行日志，便于排查问题

---

🚀 快速上手

pip 安装（推荐）

pip install get-subscribe
get-subscribe          # 一键运行

或从源码安装

git clone https://github.com/adminlove520/get_subscribe.git
cd get_subscribe
pip install -e .
get-subscribe

Python API

from get_subscribe import GetSubscribe

fetcher = GetSubscribe(subscribe_dir="./my_subs")
results = fetcher.run()
# results = {'v2ray': 200, 'clash': 200}

---

📁 输出文件

运行后保存在 subscribe/ 目录：

文件	协议	说明
clash.yml	Clash.Meta	适用于 Clash Verge / Clash for Windows / ClashX
v2ray.txt	VLESS / VMess	适用于 v2rayN / Qv2ray / Shadowrocket

快速订阅地址

Clash 订阅：https://git.io/emzclash
V2Ray 订阅：https://git.io/emzv2ray

GitHub Actions 每 12 小时自动更新，点击即可复制使用。

---

📱 各平台客户端配置

Windows

• Clash Verge / Clash for Windows
• 下载 clash.yml，导入客户端使用

macOS

• ClashX Meta / Stash
• Safari 下载后直接拖入窗口导入

Android

• Clash Meta for Android
• v2rayNG（支持 v2ray.txt）

iOS

• Stash（Clash 协议）
• Shadowrocket（多协议）

---

⚙️ 配置与自定义

自定义订阅目录

fetcher = GetSubscribe(subscribe_dir="/path/to/your/subs")
fetcher.run()

仅检查（不保存文件）

fetcher = GetSubscribe(check_only=True)
fetcher.run()

与 cron 配合（Linux/macOS）定时运行

# 每 12 小时自动更新
crontab -e
# 添加：
0 */12 * * * /usr/local/bin/get-subscribe >> /var/log/subscribe.log 2>&1

GitHub Actions 自动部署

Fork 后开启 Actions，.github/workflows/ 中已包含定时任务配置。

---

🛠️ 开发

# 安装开发依赖
pip install -e ".[dev]"

# 构建发布包
python -m build

# 上传 PyPI（需配置 token）
twine upload dist/*

---

📝 License

MIT License · adminlove520