Chapter Two Part Four: GAppProxy

Looking for a simple, stable and significant VPS as your web hosting? Check out DigitalOcean, only $5 per month, and you can get $10 in credit just for signing up now.

GAppProxy hasn't been updated since the 2.0.0 version in 2010, and doesn't support https well.

But as a GAE proxy, it is still available for you to surf anonymously and get access to the blocked sites.

For how to install and use GAppProxy, you can check out the following 7 steps:

1. To create a GAE application

To create a GAE application

Log in your Google App Engine account and create an available application ID, such as "freenutsdotorg" used for this post.

2. Generate a new application-specific password

GAppProxy application-specific password

On the "Security" page of your "Google Accounts", click the "Edit" button of "Authorizing applications and sites", and generate a new application-specific password.

But you can skip this step if you do not use 2-step verification for your Gmail account.

3. Download GAppProxy


On the GAppProxy Downloads page, you can download the packages according to your operating systems.

3.1 Download the Windows packages

To run GAppProxy on Windows, you need to download the following 2 packages:


After download, you can extract them and get the following 2 folders:

  • uploader-2.0.0-win
  • localproxy-2.0.0-win

3.2 Download the Mac/Linux packages

And to run GAppProxy on Mac/Linux, you need to download the following 2 packages instead:

  • localproxy-2.0.0.tar.gz

Extract the packages, then you can get the following 2 folders:

  • fetchserver-2.0.0
  • localproxy-2.0.0

4. Edit the app.yaml file

Edit GAppProxy app.yaml

On Windows, you can find the app.yaml file in the "fetchserver" directory of the "uploader-2.0.0-win" folder; and on Mac/Linux, you can find the app.yaml file in the "fetchserver-2.0.0" folder.

After that, open the app.yaml file, and change the "your_application_name" to your GAE app ID created in step 1.

5. Upload the GAppProxy server

5.1 How to upload the GAppProxy server on Windows

Windows upload GAppProxy server

Open the "uploader-2.0.0-win" folder, double-click the "uploader.exe" file, and enter your App ID, Gmail address and password, then you are done.

5.2 How to upload the GAppProxy server on Mac/Linux

How to upload the GAppProxy server on Mac/Linux

To upload the GAppProxy server on Mac/Linux, we need a third-party tool.

5.2.1 Download Google App Engine SDK for Python

Download Google App Engine SDK for Python of Mac or Linux version, and install it.

5.2.2 Add new application

Run GoogleAppEngineLauncher, click "New Application" in the "File" option on the top menu bar, enter your GAE app ID as "Application Name", and assign a folder as "Application Directory", or just use the default one it offers.

5.2.3 Move the server files

Copy "app.yaml" and "" files in the "fetchserver" folder and paste them into the "Application Diretory" folder.

5.2.4 Upload the server

Back to GoogleAppEngineLauncher, click on the "Deploy" button, enter your Gmail address and password, then you can upload the GAppProxy server to GAE.

5.3 Test the GAppProxy server

Open your browser, and enter the following URL:

Remember to replace "APP_ID" with your own GAE app ID, and if you can see the following result:

GAppProxy Success

Then the GAppProxy server is uploaded successfully, if not, you can try to change "http" to "https", or to run an anti-censorship tool (such as proxy, ssh or VPN), and try again, if still not, then you need to upload the server again.

6. Run the GAppProxy client

When the server is uploaded successfully, you can run the GAppProxy on your computer.

6.1 How to run the GAppProxy client on Windows

For Windows, there is an executive application, clicking on which, you can run the GAppProxy, but you need to edit the "proxy.conf" file first.

6.1.1 Edit the proxy.conf file

Open the "proxy.conf" file in the "localproxy-2.0.0-win" folder, edit the last line by changing "your-fetch-server" to your GAE app ID, and deleting the "#" mark, as what you can see from the following image:

edit GAppProxy proxy.conf file

After that, save the file.

6.1.2 Run the GAppProxy client

You can double-click the "proxy.exe" file in the same folder to run the GAppProxy client.

6.2 How to run the GAppProxy client on Mac/Linux

On Mac/Linux, you can use the Terminal application to run the GAppProxy client, but you also need to edit the "proxy.conf" file first.

6.2.1 Edit the proxy.conf file

Same as what you do on Windows, but the "proxy.conf" file is located in the "localproxy-2.0.0" folder.

6.2.2 Run the GAppProxy client

run GAppProxy on Mac

Open the Terminal application, and enter the following command line:

python xxx/localproxy-2.0.0/

Remember to replace "xxx" with the full path to the "localproxy-2.0.0" directory, or you can just drag the "" file and drop it behind "python".

7. Edit the browser proxies

GAppProxy 浏览器代理设置

When the GAppProxy client is running, you can edit the browser network settings and change the proxy address to " 8000", as what you need to do with any proxy service.

By the way, since GAppProxy only supports HTTP with 80 port and HTTPS with 443 port, you can leave the SOCKS and FTP proxies empty.


Take the "freenutsdotorg" app ID for example, if you can't open the site of the following URL on your browser:

But you can do that after changing "http" to "https", then you need to make the same change for the "fetch_server" link in the last line of the "proxy.conf" file, such as the following:

fetch-server =

And if you still fail to open the site after changing "http" to "https", then your app ID is blocked and you won't be able to use the GAppProxy service, in that case, you can create a new GAE app and try again.

Spread the love
This entry was posted in E-book and tagged , , . Bookmark the permalink.