FreeProxy中文文档

项目声明


本项目仅供python爱好者学习使用, 禁止用于商业用途, 希望大家合理利用该项目🙂

安装FreeProxy

环境配置

  • 操作系统: Linux or macOS or Windows

  • Python版本: Python3.6+

PIP安装(推荐)

在终端运行如下命令即可(请保证python在环境变量中):

pip install pyfreeproxy --upgrade

源代码安装

1.在线安装

运行如下命令即可在线安装:

pip install git+https://github.com/CharlesPikachu/freeproxy.git@master

2.离线安装

利用如下命令下载freeproxy源代码到本地:

git clone https://github.com/CharlesPikachu/freeproxy.git

接着, 切到freeproxy目录下:

cd freeproxy

最后运行如下命令进行安装:

python setup.py install

快速开始

FreeProxy类

实例化FreeProxy类的示例代码如下：

from freeproxy import freeproxy

proxy_sources = ['proxylistplus', 'kuaidaili']
fp_client = freeproxy.FreeProxy(proxy_sources=proxy_sources)

FreeProxy支持的参数如下：

  • proxy_type: 代理类型, 支持”https”, “http”和”all”, 默认值为”all”;

  • proxy_sources: 代理获取源, 支持”kuaidaili”, “ip3366”, “jiangxianli”, “proxylistplus”, “daili66”, “fatezero”, “ip89”, “seofangfa”, “zdaye”, “yqie”, “taiyanghttp”, 默认值为None, 即使用所有代理源;

  • init_session_cfg: 初始化session的参数, 支持的变量同requests.Session, 默认值为{};

  • logfilepath: 日志文件, 如果是None, 则不打印, 默认值为”freeproxy.log”。

GET请求

代码示例如下：

from freeproxy import freeproxy

proxy_sources = ['proxylistplus', 'kuaidaili']
fp_client = freeproxy.FreeProxy(proxy_sources=proxy_sources)
headers = {
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36'
}
response = fp_client.get('https://space.bilibili.com/406756145', headers=headers)
print(response.text)

GET请求支持的参数同requests.Session.get

POST请求

代码示例如下：

from freeproxy import freeproxy

proxy_sources = ['proxylistplus', 'kuaidaili']
fp_client = freeproxy.FreeProxy(proxy_sources=proxy_sources)
headers = {
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36'
}
response = fp_client.post('https://space.bilibili.com/406756145', headers=headers)
print(response.text)

POST请求支持的参数同requests.Session.post

随机获得一个免费代理

代码示例如下：

from freeproxy import freeproxy

proxy_sources = ['proxylistplus', 'kuaidaili']
fp_client = freeproxy.FreeProxy(proxy_sources=proxy_sources)
proxy = fp_client.getrandomproxy()

随机获得一个设置了免费代理的session

from freeproxy import freeproxy

proxy_sources = ['proxylistplus', 'kuaidaili']
fp_client = freeproxy.FreeProxy(proxy_sources=proxy_sources)
session = fp_client.getrandomproxysession()

实战案例

项目名 微信公众号文章介绍 源代码
用数万条数据带大家看看到底是哪些人在反对996 click click

开发日志

2022-02-19

  • 版本号: v0.1.0,

  • 更新内容: 支持11种代理源。

2022-02-21

  • 版本号: v0.1.1-0.1.3,

  • 更新内容: 增加getrandomproxysession和getrandomproxy两个API, 鲁棒性增强。

2022-03-25

  • 版本号: v0.1.4

  • 更新内容: 切换License, 增加作者信息打印。

项目推荐

关于作者

学生党, 主要研究方向是计算机视觉, 顺便对信息安全感兴趣。

我的个人微信公众号是: Charles_pikachu (欢迎搜索关注，或者搜”Charles的皮卡丘”)

我的Github账号是: https://github.com/CharlesPikachu (欢迎搜索关注)

我的知乎账号是: https://www.zhihu.com/people/charles_pikachu (欢迎搜索关注)

我的B站账号是: https://space.bilibili.com/406756145 (欢迎搜索关注)

个人邮箱: charlesblwx@gmail.com