{"id":16824228,"url":"https://github.com/panjf2000/proxy-server","last_synced_at":"2025-10-28T21:32:08.072Z","repository":{"id":79202751,"uuid":"58258168","full_name":"panjf2000/proxy-server","owner":"panjf2000","description":":snake: A proxy server in python, using tornado.","archived":false,"fork":false,"pushed_at":"2019-04-07T02:40:06.000Z","size":19,"stargazers_count":12,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-19T09:48:06.466Z","etag":null,"topics":["proxy","proxy-server","python","tornado"],"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/panjf2000.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":"2016-05-07T08:58:47.000Z","updated_at":"2024-06-25T15:55:12.000Z","dependencies_parsed_at":"2023-05-16T21:16:29.451Z","dependency_job_id":null,"html_url":"https://github.com/panjf2000/proxy-server","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/panjf2000/proxy-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panjf2000%2Fproxy-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panjf2000%2Fproxy-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panjf2000%2Fproxy-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panjf2000%2Fproxy-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/panjf2000","download_url":"https://codeload.github.com/panjf2000/proxy-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/panjf2000%2Fproxy-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264995105,"owners_count":23694883,"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":["proxy","proxy-server","python","tornado"],"created_at":"2024-10-13T11:10:28.569Z","updated_at":"2025-10-28T21:32:07.965Z","avatar_url":"https://github.com/panjf2000.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ProxyServer\n## a proxy server by python\n\n一个基于tornado开发的代理服务器：\n\n## 依赖：python2.7或者python3.5，tornado4.x\n\n- git clone git@github.com:panjf2000/ProxyServer.git\n- hash_ring: pip install hash_ring\n\n编写配置文件:  \n```\n{\n  \"port\": \"1234\",\n  \"proxy_pass\": [\n    \"127.0.0.1:80\",\n    \"127.0.0.1:8080\",\n    \"127.0.0.1:8088\",\n    \"127.0.0.1:8888\"\n  ],\n  \"auth\": false,\n  \"mode\": 0,\n  \"user\": {\n    \"name\": \"proxy\",\n    \"passwd\": \"secret\"\n  },\n  \"white_iplist\": []\n}\n```\n\n## 配置文件释义:  \n- port           # proxy server监听的端口  \n- proxy_pass     # 反向代理的服务器  \n- auth           # 是否开启代理认证  \n- mode           # 负载策略的模式,目前支持:IP HASH-0 ; 随机选取-1  \n- user           # 代理认证的用户信息  \n- white_iplist   # 白名单,若设置,则只有该名单内的ip方可使用此代理服务器  \n\n**运行：python proxy_server.py**\n\n\n## 项目结构：\n\n\u003e* ProxyServer/proxy_server.py        #server入口\n\n\u003e* ProxyServer/handler/               #tornado的转发类，负责转发请求以及处理response的数据\n\n\u003e* ProxyServer/custom_handler/        \n\n## 二次开发：\n\n\u003e之所以考虑用程序的方式来做代理而不是直接用Nginx来做代理，是因为用程序对转发的请求有较大的控制度，可以控制代理特定的请求，屏蔽特定的请求，甚至可以重写特定的请求。\n另外，有时候项目需要用到第三方的服务并对返回的数据进行自定义修改，调用第三方的API（比如百度地图），利用proxy server可以很容易的控制第三方API返回的数据并进行自定义修改。\n\n\u003e现在这个proxy server已经实现了最基本的内容转发代理，可以把转发端口的response完整地返回给代理端口，也可以进行二次开发，目前提供二次开发入口，若需要更复杂的转发或者需要适配特定项目需求的转发，\n只需要修改ProxyServer/custom_handler/目录下的my_handler.py脚本的代码，修改MyHandler class中的静态方法on_response_handle(),在此方法中实现自己的需求即可，这个函数的实现可参考MyHandler class中的on_response_handle()函数。\n还可以重写MyHandler class中的get()、post()、和put()等方法，然后在入口proxy_server.py脚本中，修改tornado的监听的RequestHandler为MyHandler,实现过滤request的需求。\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpanjf2000%2Fproxy-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpanjf2000%2Fproxy-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpanjf2000%2Fproxy-server/lists"}