[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82310":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},82310,"Free-Residential-IP-Proxy-Controller","a6216abcd\u002FFree-Residential-IP-Proxy-Controller","a6216abcd",null,"JavaScript",79,66,24,1,0,14,43,48,65,84.24,false,"main",true,[],"2026-06-12 04:01:37","[💬 Telegram 交流群](https:\u002F\u002Ft.me\u002Fkejikkkcom) | [📺 YouTube 频道：科技KKK](https:\u002F\u002Fwww.youtube.com\u002F@%E7%A7%91%E6%8A%80KKK)\n\n---\n\nKUI面板正在集成融合免费免费住宅IP代理调度系统 https:\u002F\u002Fgithub.com\u002Fa6216abcd\u002FK-UI\n\n# 免费住宅IP代理调度系统 🌐\n\n这是一个轻量级的智能代理调度系统。基于 Cloudflare Workers 与 D1 数据库构建中心控制节点，配合 VPS 守护进程，实现高频自动切换、优选纯净住宅 IP 的 Socks5\u002FHTTP 代理服务。\n\n系统资源占用极低，非常适合用于个人量化交易、网络测试或轻度数据抓取。\n\n\u003Cimg width=\"1733\" height=\"1603\" alt=\"图片\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F2c25b18b-6f2a-441e-9eb0-602453231b71\" \u002F>\n\u003Cimg width=\"1692\" height=\"1380\" alt=\"图片\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fa25f6ab3-820c-4dba-8c88-0829f76d97ae\" \u002F>\n\n\n## ✨ 核心特性\n\n* **⚡ 毫秒级极速调度**：采用 5 秒超时设定与 5 秒高频蓄水池抓取机制，节点假死后几秒内自动熔断并顶替新节点。\n* **🏠 纯净解锁双重质检**：内置节点检测器，自动判定并剔除机房（Hosting\u002FDatacenter）IP；同时强制探测 YouTube 流媒体连通性，确保线路真正纯净且可用。\n* **🔄 主动强制换 IP**：支持面板一键发送时间戳指令，主动将当前 IP 关入小黑屋并触发重拨，彻底解决因延迟排序导致总是连上同一节点的问题。\n* **📊 Serverless 全息看板**：零服务器成本部署控制端，提供可视化 Web UI，支持实时监控 VPS 状态与一键切换目标国家。\n* **🚀 一行命令纳管**：VPS 节点端（Agent）无需复杂环境配置，一行 Bash 命令即可完成自动化部署与守护进程驻留。\n* **🚀 IP评分模块实现**：IP评分感谢：https:\u002F\u002Fip.net.coffee\u002Fip\n---\n\n## 🛠️ 架构说明\n\n1. **C2 控制端 (Cloudflare Workers)**：负责下发国家策略、处理主动换 IP 指令、提供 Web 面板、分发节点端脚本以及存储心跳数据。\n2. **状态存储 (Cloudflare D1)**：轻量级 SQLite 数据库，记录全局配置和 VPS 纳管状态。\n3. **VPS 节点端 (Python3)**：作为执行单元，拉取 VPN 节点快照，进行双重质检（住宅判定 + YT 连通性），建立隧道，并对外提供鉴权的 Socks5\u002FHTTP 代理端口。\n\n---\n\n## 🚀 部署指南\n\n### 第一步：创建 Cloudflare D1 数据库\n\n1. 登录 Cloudflare 控制台，进入 **Workers & Pages** -> **D1 SQL Database**。\n2. 点击 **Create database**，创建一个数据库（例如命名为 `proxy-db`）。\n\n> **注意**：无需手动建表，系统代码内置了自动建表逻辑。\n\n### 第二步：部署 Cloudflare Worker\n\n1. 进入 **Workers & Pages**，点击 **Create application** -> **Create Worker**，随意命名（例如 `proxy-controller`）并部署。\n2. 点击刚创建的 Worker，进入 **Settings** -> **Variables**。\n3. **绑定 D1 数据库**：\n\n* 在 `D1 Database Bindings` 处添加绑定。\n* **Variable name** 必须填入：`DB`\n* **D1 Database** 选择第一步创建的 `proxy-db`。\n\n4. **配置环境变量 (Environment Variables)**（必须设置！！！不填则使用系统默认值非常不安全！！！）：\n\n| 变量名 | 默认值 | 作用说明 |\n| --- | --- | --- |\n| `WEB_USER` | `admin` | 面板 Web 登录用户名 |\n| `WEB_PASS` | `admin888` | 面板 Web 登录密码 |\n| `PROXY_USER` | `proxy` | Socks5\u002FHTTP 代理连接用户名 |\n| `PROXY_PASS` | `888888` | Socks5\u002FHTTP 代理连接密码 |\n\n5. 进入 **Quick edit**（编辑代码），将本仓库提供的 Worker 代码全量复制并粘贴，点击 **Save and Deploy**。\n\n### 第三步：纳管 VPS 节点\n\n准备一台干净的 Linux VPS（推荐 Ubuntu\u002FDebian 系统），通过 SSH 登录。\n\n访问您刚才部署的 Cloudflare Worker 域名（会自动弹出 Basic Auth 认证，输入您配置的 `WEB_USER` 和 `WEB_PASS` 登录）。在面板右上角复制一键安装命令并执行：\n\n```bash\nbash \u003C(curl -sL https:\u002F\u002F您的worker域名.workers.dev\u002Fagent)\n\n```\n\n脚本将自动执行以下操作：\n\n1. 安装 OpenVPN、Python3 等依赖环境。\n2. 从 C2 控制端拉取最新版本的调度引擎。\n3. 配置并启动 `proxy-lite.service` 系统守护进程。\n\n---\n\n## 💻 面板使用与客户端连接\n\n### 管理面板\n\n直接在浏览器访问您的 Worker 域名。\n\n* **修改国家策略**：在“策略配置”区域，输入目标国家代码（如 `JP`, `US`, `KR` 等），点击“强制下发配置”，VPS 节点将在下一次心跳周期内自动切换到新国家的节点。\n* **更换新 IP**：点击紫色的“更换新IP”按钮，系统会在 15 秒的心跳周期内主动拉黑当前节点，并从蓄水池中调取新的纯净住宅 IP 顶替。\n* **监控状态**：底部列表会实时显示已纳管的 VPS 母机 IP、当前隧道物理 IP、心跳状态及 `● 纯净解锁 (YT)` 的质检状态。\n\n### 代理调用\n\n系统提供了一个直链 API，用于快速提取当前的代理信息（兼容量化程序和代理插件批量导入格式）：\n\n```http\nGET https:\u002F\u002F您的worker域名.workers.dev\u002Fapi\u002Fproxies\n\n```\n\n> **注意**：调用此 API 同样需要带有 Basic Auth Header (Base64 编码的 `WEB_USER:WEB_PASS`)。\n\n**客户端连接格式：**\n\n```text\nsocks5:\u002F\u002F代理用户名:代理密码@\u003CVPS母机IP>:自定义端口\nhttp:\u002F\u002F代理用户名:代理密码@\u003CVPS母机IP>:自定义端口\n\n```\n\n**VPS 实时日志查看命令：**\n\n```bash\njournalctl -u proxy-lite.service -f\n\n```\n\n**VPS agent卸载命令：**\n\n```bash\n# 1. 停止并禁用守护进程\nsystemctl stop proxy-lite.service 2>\u002Fdev\u002Fnull\nsystemctl disable proxy-lite.service 2>\u002Fdev\u002Fnull\nrm -f \u002Flib\u002Fsystemd\u002Fsystem\u002Fproxy-lite.service\nsystemctl daemon-reload\n\n# 2. 强杀残留的 Python 调度器和 OpenVPN 进程\npkill -f \"lite_manager.py\" 2>\u002Fdev\u002Fnull\npkill -f \"proxy_server.py\" 2>\u002Fdev\u002Fnull\npkill -f \"openvpn.*tun0\" 2>\u002Fdev\u002Fnull\n\n# 3. 清理策略路由 (防止断网)\nip rule del table 100 2>\u002Fdev\u002Fnull\nip route flush table 100 2>\u002Fdev\u002Fnull\n\n# 4. 删除所有代码和配置文件\nrm -rf \u002Fopt\u002Fproxy_lite\n\necho \"✅ 代理引擎及所有配置已彻底卸载清理完毕！\"\n```\n---\n\n## ⚠️ 声明与限制\n\n* **合规性**：请确保您使用本系统抓取或访问的网络行为符合您所在国家及目标服务器所在地区的法律法规。\n","这是一个轻量级的智能代理调度系统，基于 Cloudflare Workers 和 D1 数据库构建中心控制节点，配合 VPS 守护进程，实现高频自动切换和优选纯净住宅 IP 的 Socks5\u002FHTTP 代理服务。其核心功能包括毫秒级极速调度、双重质检确保IP纯净度、主动强制换IP以及Serverless全息看板等。系统资源占用极低，适合个人量化交易、网络测试或轻度数据抓取等场景使用。通过简单的部署步骤，用户可以快速搭建并管理自己的代理服务。",2,"2026-06-11 04:08:21","CREATED_QUERY"]