{"id":15997306,"url":"https://github.com/honmashironeko/ProxyCat","last_synced_at":"2025-10-21T05:30:22.576Z","repository":{"id":254112865,"uuid":"845436259","full_name":"honmashironeko/ProxyCat","owner":"honmashironeko","description":"一款部署于云端或本地的代理池中间件，可将静态代理IP灵活运用成隧道IP，提供固定请求地址，一次部署终身使用","archived":false,"fork":false,"pushed_at":"2025-02-06T01:48:18.000Z","size":4354,"stargazers_count":1272,"open_issues_count":0,"forks_count":128,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-02-06T02:37:08.381Z","etag":null,"topics":["cyber-security","cyber-security-tool","proxy","proxypool","security","security-tools"],"latest_commit_sha":null,"homepage":"https://y.shironekosan.cn","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/honmashironeko.png","metadata":{"files":{"readme":"README-EN.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":"2024-08-21T08:47:19.000Z","updated_at":"2025-02-06T01:43:31.000Z","dependencies_parsed_at":"2024-09-15T00:14:15.918Z","dependency_job_id":"c04c28f2-0bae-4b35-9a81-5ee82ac78cf1","html_url":"https://github.com/honmashironeko/ProxyCat","commit_stats":null,"previous_names":["honmashironeko/proxycat"],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/honmashironeko%2FProxyCat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/honmashironeko%2FProxyCat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/honmashironeko%2FProxyCat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/honmashironeko%2FProxyCat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/honmashironeko","download_url":"https://codeload.github.com/honmashironeko/ProxyCat/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237436562,"owners_count":19309933,"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":["cyber-security","cyber-security-tool","proxy","proxypool","security","security-tools"],"created_at":"2024-10-08T08:01:37.286Z","updated_at":"2025-10-21T05:30:22.571Z","avatar_url":"https://github.com/honmashironeko.png","language":"Python","funding_links":[],"categories":["Python","云安全"],"sub_categories":[],"readme":"![ProxyCat](https://socialify.git.ci/honmashironeko/ProxyCat/image?description=1\u0026descriptionEditable=A%20lightweight%20and%20excellent%20proxy%20pool%20middleware%20that%20implements%20automatic%20proxy%20rotation\u0026font=Bitter\u0026forks=1\u0026issues=1\u0026language=1\u0026logo=https%3A%2F%2Favatars.githubusercontent.com%2Fu%2F139044047%3Fv%3D4\u0026name=1\u0026owner=1\u0026pattern=Circuit%20Board\u0026pulls=1\u0026stargazers=1\u0026theme=Dark)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"/README-EN.md\"\u003eEnglish\u003c/a\u003e\n  ·\n  \u003ca href=\"/README.md\"\u003e简体中文\u003c/a\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n- [Development Background](#development-background)\n- [Features](#features)\n- [Installation and Usage](#installation-and-usage)\n- [Disclaimer](#disclaimer)\n- [Changelog](#changelog)\n- [Development Plan](#development-plan)\n- [Special Thanks](#special-thanks)\n- [Sponsor](#sponsor)\n- [Proxy Recommendations](#proxy-recommendations)\n\n## Development Background\n\nDuring penetration testing, it's often necessary to hide or change IP addresses to bypass security devices. However, tunnel proxies in the market are expensive, typically costing $3-6 per day, which is unaffordable for many. The author noticed that short-term IPs offer high cost-effectiveness, with each IP costing just a few cents, averaging $0.03-0.4 per day.\n\nTherefore, **ProxyCat** was born! This tool aims to transform short-term IPs (lasting from 1 to 60 minutes) into fixed IPs for other tools to use, creating a proxy pool server that can be used permanently after one deployment.\n\n![Project Principle](./assets/项目原理图.png)\n\n## Features\n\n- **Dual Protocol Listening**: Supports HTTP/SOCKS5 protocol listening, compatible with more tools.\n- **Triple Proxy Types**: Supports HTTP/HTTPS/SOCKS5 proxy servers with authentication.\n- **Flexible Switching Modes**: Supports sequential, random, and custom proxy selection for optimized traffic distribution.\n- **Dynamic Proxy Acquisition**: Get available proxies in real-time through GetIP function, supports API interface calls.\n- **Proxy Protection**: When using GetIP method, proxies are only fetched upon receiving requests, not at initial startup.\n- **Automatic Proxy Detection**: Automatically checks proxy validity at startup, removing invalid ones.\n- **Smart Proxy Switching**: Only obtains new proxies during request execution, reducing resource consumption.\n- **Invalid Proxy Handling**: Automatically validates and switches to new proxies when current ones fail.\n- **Authentication Support**: Supports username/password authentication and IP blacklist/whitelist management.\n- **Real-time Status Display**: Shows proxy status and switching times for dynamic monitoring.\n- **Dynamic Configuration**: Updates configuration without service restart.\n- **Web UI Interface**: Provides web management interface for convenient operation.\n- **Docker Deployment**: One-click Docker deployment with unified web management.\n- **Bilingual Support**: Supports Chinese and English language switching.\n- **Flexible Configuration**: Customize ports, modes, and authentication through config.ini.\n- **Version Check**: Automatic software update checking.\n\n## Tool Usage\n\n[ProxyCat Operation Manual](../main/ProxyCat-Manual/Operation%20Manual.md)\n\n## Error Troubleshooting\n\n[ProxyCat Investigation Manual](../main/ProxyCat-Manual/Investigation%20Manual.md)\n\n## Disclaimer\n\n- By downloading, installing, using, or modifying this tool and related code, you indicate your trust in this tool.\n- We are not responsible for any form of loss or damage caused to yourself or others while using this tool.\n- You are solely responsible for any illegal activities conducted while using this tool.\n- Please carefully read and fully understand all terms, especially liability exemption clauses.\n- You have no right to download, install, or use this tool unless you have read and accepted all terms.\n- Your download, installation, and usage actions indicate your acceptance of this agreement.\n\n## Changelog\n\n[Changelog Records](../main/ProxyCat-Manual/logs.md)\n\n## Development Plan\n\n- [x] Add detailed logging to record all IP identities connecting to ProxyCat, supporting multiple users.\n- [x] Add Web UI for a more powerful and user-friendly interface.\n- [ ] Develop babycat module that can run on any server or host to turn it into a proxy server.\n- [ ] Add request blacklist/whitelist to specify URLs, IPs, or domains to be forcibly dropped or bypassed.\n- [ ] Package to PyPi for easier installation and use.\n\nIf you have good ideas or encounter bugs during use, please contact the author through:\n\nWeChat Official Account: **樱花庄的本间白猫**\n\n## Special Thanks\n\nIn no particular order, thanks to all contributors who helped with this project:\n\n- [AabyssZG (曾哥)](https://github.com/AabyssZG)\n- [ProbiusOfficial (探姬)](https://github.com/ProbiusOfficial)\n- [gh0stkey (EvilChen)](https://github.com/gh0stkey)\n- [huangzheng2016(HydrogenE7)](https://github.com/huangzheng2016)\n- chars6\n- qianzai（千载）\n- ziwindlu\n\n## Sponsor\n\nOpen source development isn't easy. If you find this tool helpful, consider sponsoring the author's development!\n\n---\n| Rank |         ID          | Amount (CNY) |\n| :--: | :-----------------: | :----------: |\n|  1   |      **陆沉**       |   1266.62    |\n|  2   | **柯林斯.民间新秀** |     696      |\n|  3   |      **北**      |     170     |\n|  [Sponsor List](https://github.com/honmashironeko/Thanks-for-sponsorship)   |     Every sponsorship is a motivation for the author!      |      (´∀｀)♡      |\n\n---\n![Sponsor](./assets/赞助.png)\n\n## Proxy Recommendations\n\n- [First affordable proxy service - Get 5000 free IPs + ¥10 coupon with invite code](https://h.shanchendaili.com/invite_reg.html?invite=fM6fVG)\n- [Various carrier data plans](https://172.lot-ml.com/ProductEn/Index/0b7c9adef5e9648f)\n- [Click here to purchase](https://www.ipmart.io?source=Shironeko)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhonmashironeko%2FProxyCat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhonmashironeko%2FProxyCat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhonmashironeko%2FProxyCat/lists"}