4 Quick start

You can use phc after a few minutes if you do like this step by step:

1. Extract from source and enter the work dir:

             tar zxvf phc-1.2.tar.gz
             cd phc-1.2
        

2. Compile && Install:

             ./configure
             make
             make install
        

3. Phc will search configureation file and proxylist file in current dir. If you still in work dir, just create configuration file like this:

             cp doc/phc.conf.example phc.conf
        

   You can put phc.conf to /etc/phc.conf or ~/.phc.conf. Phc will search ./phc.conf,then ~/.phc.conf , at last /etc/phc.conf until it found the first one.

   Now read the configuration file "phc.conf". Notice: The line begin with '#' is commet line. The line after the line begin with '#' must be customized with you own setting. And the line begin with

   '#! if'
   

   need be updated only if the condition expression after "if" is true.

   5 Introduction to basic configuration

   • mytype The type of myproxy, which phc connect to directly. 1 for http proxy without authentication. 2 for socks5 proxy without authentication. 3 for http proxy with basic authentication. 4 for socks5 proxy with username/password authentication. -1 for connection to testproxy without myproxy(Testing).
   • myhost The ip of domain name of myproxy. This will be in effect only if mytype != -1
   • myport The http proxy service port of myproxy. This will be in effect only if mytype !=-1
   • myuser This will be read only if mytype=3 or 4.
   • mypass This will be read only if mytype=3 or 4.

     For example, you username at myproxy is abc, password is guest, then you should set myuser and mypass like this:

                    myuser=abc
                    mypass=guest
               

   • httptestmethod The http method which should be supported by the testproxy. httptestmethod=0(HTTP_GET) or 1(HTTP_CONNECT) is supported now. If you need a HTTP CONNECT proxy, just set it to 1:

     httptestmethod=1
          

   • socks5testmethod The socks5 command which should be supported by the testproxy. Only 2 support to (SOCKS5_CONNECT) is implemented now. You should leave it intact now:

     socks5testmethod=2
          

   • socks4testmethod BIND isnt't implemented for socks4. So you should leave it intact:

     socks4testmethod=5
          

   • logfilename The logfile with full path. If you prefer screen output:

     logfilename=.
          

     If you want to see it laterly:

     logfilename=./phc.log
          

4. If you have proxy list file like the file proxylist in directory doc, just rename it as proxylist. Otherwise, you can copy the proxylist file in doc to current directory to begin test immediately:

             cp doc/proxylist .
        

   Notice, phc.conf must be in the same directory now.

5. At last, start checking:

             phc
        

   Tips: If you have found enough free proxies, you can use "^C" to stop phc at any time. The result of validating will be printed on screen and saved to file named proxyout in current directory immediately after any free proxy is found .

6. Example of configuration.
   • Conditions: a socks5 proxy(socks.you.com) with username/password authentication. socks5 service port:1080, username:abc,password:def.

     Want to validate: free http CONNECT proxy and free socks5 proxy which support connect command.

     You configuration should look like this:

                    #You must customize the follow
                    mytype=4
                    myhost=socks.you.com
                    myport=1080
                    myuser=abc
                    mypass=def
                    httptestmethod=1
                    #You should leave the following items intact.
                    socks5testmethod=2
                    socks4testmethod=5
                    #Optional to be changed. But you SHOULD NOT comment or remove it.
                    threads=50
                    checksite=http://www.google.com:80/webhp?hl=en
                    key=2006 Google
                    user_agent=User-Agent: MSIE 6.0
                    myconreplysize=256
                    testconreplysize=256
                    testtagreplysize=65535
                    rcvtimeo=10
                    sndtimeo=5
                    logfilename=phc.log
               

   • Conditions: a http proxy(proxy.you.com) without authentication. http proxy service port:8080.

     Want to validate: Common free http proxy and free socks5 proxy which support connect command.

     Your setting will be similiar with this:

                    #The follow lines must be customized.
                    mytype=1
                    myhost=proxy.you.com
                    myport=8080
                    httptestmethod=0
                    #Please leave the following items intact.
                    socks5testmethod=2
                    socks4testmethod=5
                    #The follow lines is optional to be changed , but you should not
                    #delete or remove it.
                    threads=50
                    checksite=http://www.google.com:80/webhp?hl=en
                    key=2006 Google
                    user_agent=User-Agent: MSIE 6.0
                    myconreplysize=256
                    testconreplysize=256
                    testtagreplysize=65535
                    rcvtimeo=10
                    sndtimeo=5
                    logfilename=phc.log