一般用法

解压后运行PyProxySwitch.exe（Windows版本，在bin文件夹下），或者src下的PyProxySwitch.pyw（源代码版本），然后把浏览器或其他需要设置代理的程序的代理设置为127.0.0.1:8888，右击右下角系统托盘中的图标即可快速切换代理。

双击系统托盘图标（或者右击系统托盘图标，点击“设置”），会弹出设置对话框，可进行添加/删除/修改代理、设置本地端口、语言等操作。

批量添加代理

使用src目录下的pps_config.py（Windows平台用bin目录下的pps_config.exe）。首先将各个代理以“代理名称 代理地址:端口 用户名:密码 代理类型”的形式（代理名称可以是自定义的任何名字,[用户名:密码]仅用于需要认证的代理,一般情况下不需要,可省略。代理类型也可省略（默认是HTTP），支持的类型有SOCKS4和SOCKS5），每行一个，名称不要使用特殊字符/标点符号，最好使用字母、数字和下划线等，如：

test1 test.com:80 或

test2 1.2.3.4:8080

test3 test.com:80 user:pass

socks_proxy socksproxy.com:3128 SOCKS5 （可参考自带的proxy.txt的示例）

添加到src目录下的proxy.txt文件中【必须是UTF-8编码】，双击pps_config.py或pps_config.exe即可批量导入代理。

批量删除代理

使用bin下的pps_config，用法：pps_config del 代理名称1 代理名称2 代理名称3 ……

例如 pps_config del test1 test2

高级自定义

自定义代理及菜单项

使用pps_config(py源代码或者exe可执行文件)【推荐】

pps_config 是PyProxySwitch(PPS)的配置程序，可以为PPS添加或者删除代理

用法：

  • 添加代理(仅支持添加单个代理，批量添加请使用pps_config配合proxy.txt，其用法请见http://pyproxyswitch.kder.info/documentation或README_zh_CN.txt)：

pps_config add 代理名称 代理地址:端口 用户名:密码 代理类型

代理名称可以是自定义的任何名字，[用户名:密码]仅用于需要认证的代理，一般情况下不需要，可省略

代理类型也可省略（默认是HTTP），支持的类型有SOCKS4和SOCKS5

例如：pps_config add test1 test1.com:8080

pps_config add test2 test2.com:8080 user:pass

pps_config add socks_proxy socksproxy.com:3128 SOCKS5

或者：pps_config add test3 1.2.3.4:80

  • 删除代理(支持批量删除)：

pps_config del 代理名称1 代理名称2 ...

例如：pps_config del test1

pps_config del test1 test2 test3

【不推荐】手动设置代理及菜单项

cfg目录下的配置文件PPS.conf中可以定义菜单项，3proxy/polipo目录下是各个菜单项对应的配置文件，自带的几个仅是作者自用的代理设置，用户可根据需要进行自定义，其中最主要的是父级代理parentProxy的设置，其他更高级的用法可参见3proxy/polipo/iprelay各自的文档。

以polipo为例，比如你的代理地址是1.2.3.4:80

  1. 打开cfg/polipo目录下一个配置文件，例如Tor.conf，找到类似这一行 parentProxy = "127.0.0.1:9050"，将其改为你的代理地址：parentProxy = "1.2.3.4:80"，保存
  2. 然后把Tor.conf改为你想要的名称，例如proxy1.conf
  3. 修改cfg/PPS.conf文件，找到 “CFG_polipo = ” ，将它后面的列表中, 添加配置文件名,不加.conf，多个之间用逗号隔开，例如 ['proxy1']、['proxy1', 'proxy2']
  4. 退出，重新启动PyProxySwitch，右键，就可以切换到你新添加的代理了。

若用的是3proxy，则要修改cfg/3proxy目录下的对应文件中的parent 1000 http 1.2.3.4 80为 parent 1000 http 地址 端口 　的形式。

默认的本地代理程序是polipo（支持内容缓存，功能强大），另外还有3proxy（支持DNS缓存，不支持内容缓存，功能强大）和ip_relay（仅是端口转发，本身无代理功能）

系统需求

  1. 源代码版本:Python2.6+或3.x，和PyQt组件
    (在以下环境中测试通过：
    32位:
    Windows Vista + Python3.1.2 + PyQt4.7.4
    Windows Xp + Python2.7 + PyQt4.8.2
    Windows Xp + Python3.2 + PyQt4.8.3
    Ubuntu 11.04 + Python2.7.1 + PyQt4.8.3
    Fedora 13 + Python2.6.5 + PyQt4.7.4
    Slackware 13.1/Zenwalk Linux + Python2.6.4 + PyQt4.7.4
    Slackware 13.1/Zenwalk Linux + Python3.1.0 + PyQt4.7.4
    Arch Linux 2010.05 + Python2.6.5 + PyQt4.6.3
    )
  2. Windows可执行文件版本：32位 Windows XP/Vista （64位及其他系统未测试）

【注意】Windows版需要VC2008运行库vcredist才能运行。如果第一次运行时出现错误，请下载并安装2008的vcredist：https://www.microsoft.com/en-US/download/details.aspx?id=26368