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.1.tar.gz
             cd phc-1.1
        

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
        

   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
          

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 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 of validation 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
               socks5testmethod=2
               #Optional to be changed. But you SHOULD NOT comment or remove it.
               threads=50
               checksite=http://www.google.com:80/webhp?hl=en
               key=2005 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
               socks5testmethod=2
               #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=2005 Google
               user_agent=User-Agent: MSIE 6.0
               myconreplysize=256
               testconreplysize=256
               testtagreplysize=65535
               rcvtimeo=10
               sndtimeo=5
               logfilename=phc.log
               #All of the other setting(such as "user=","pass=") will be ignored.