How To Install And Use Goagent

Like GAppProxy and Hyk-proxy, Goagent is also a GAE proxy.

And for how to use Goagent, you can refer to its official site in Chinese, or you can check out the following 7 steps for an easier reference in English:

1. Create GAE applications

GAE app id freenutsdotorg

Goagent supports multiple app IDs, so that you can creat one or more new GAE applications, or use the old ones, but the "Storage Scheme" of each must be "High Replication".

2. Generate new application-specific password

new 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, which will be used when uploading the Goagent server to your GAE in step 4.

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

3. Download the Goagent packapge

Download goagent

Download the Goagent package (a zip file) via the link on the top of its homepage, as what you can see from the above image.

After that, extract the zip file, and you will get a "local" folder as well as a "server" folder.

4. Upload the Goagent server

Open the "server" folder, and upload the Goagent server to your GAE in the following ways:

4.1 How to upload the Goagent server on Windows

Upload goagent on windows

On Windows, open the "uploader.bat" file, enter your GAE app ID created in step 1, your Gmail address and the application-specific password, then you can start to upload.

And to use more than one app ID, you can separate them with the "|" mark.

4.2 How to upload the Goagent server on Mac

Upload Goagent on Mac

On mac, open the Terminal application, and enter the following command line:

cd the-path-to-the-server-folder

Such as the following:

cd /Users/air/Downloads/goagent-goagent-80e5f01\ 3/server

You can also just drag the "server" folder and drop it behind the "cd" command.

After that, enter the following command line:

python uploader.zip

Then, you can enter your App IDs, Gmail address and the application-specific password to upload the server.

By the way, do not bypass the first command line and use the "python the-path-to-uploader.zip" command directly, which may be not workable.

5. Change the proxy.ini file

Change the proxy.ini file

When the upload is finished, open the "proxy.ini" file in the "local" folder, and change the "appid" value from "goagent" to your real GAE application IDs.

By the way, you can also change the "profile" value from "google_cn" to "google_hk" for a better security with https mode.

6. Run the Goagent client

After saving the "proxy.ini" file, you can start to run Goagent.

6.1 How to run the Goagent client on Windows

Run Goagent on Windows

On Windows, you can just double-click on the "Goagent.exe" file in the "local" folder and run the proxy service.

6.2 How to run the Goagent client on Mac

Run Goagent on Mac

On Mac, you can open the Terminal application and enter the following command line:

python the-parth-to-proxy.py

This time, you can drag the "proxy.py" file from the "local" folder and drop it behind the "python" command.

7. Edit the browser proxies

Goagent browser proxy settings

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

After that, you can start to use Goagent to browse the internet anonymously and unblock the blocked sites in your area.

But, same as GAppProxy and Hyk-proxy, the Goagent proxy doesn't support https well, even though that you can double-click the "CA.crt" file in the "local" folder to install or import the certification, which will only work on Safari, but not Chrome or Firefox during my test for Twitter and Facebook.

By the way, besides Windows and Mac systems mentioned above, Goagent is also available for Linux, as well as Android, iOS, webOS, OpenWRT and Maemo operating systems.

This entry was posted in Free Online Anti-censorship Tools and tagged , , , , . Bookmark the permalink. Both comments and trackbacks are currently closed.

11 Comments

  1. Posted September 28, 2012 at 2:22 am | Permalink

    With increasing cases of censorship in india, it might be helpful for indians also.

  2. Tushar
    Posted September 29, 2012 at 10:03 am | Permalink

    Also you need to download gevent network library for it work

  3. Young
    Posted October 1, 2012 at 10:01 am | Permalink

    @Tushar Thanks for the comment, yes, Gevent is a MUST-have plugin to run Goagent for some versions, but not the latest one (2..0.11), nor the 2.0.6 version mentioned in this post.

  4. molko
    Posted October 6, 2012 at 1:15 am | Permalink

    young,
    can you help me how to set up skype by using GAE app?

    thx

  5. Young
    Posted October 6, 2012 at 8:14 am | Permalink
  6. ThoughtfulUser
    Posted February 22, 2013 at 4:00 am | Permalink

    For the last step you could also select “Automatic Proxy configuration URL” and input the PAC-server address given by proxy.py, which is typically http://127.0.0.1:8086/proxy.pac
    That way, only sites that are know to be blocked will pass through the proxy, while the rest uses the speedier direct connection.

  7. ThoughtfulUser
    Posted February 22, 2013 at 4:15 am | Permalink

    Another two suggestions:
    – I had to install gevent and pyopenssl, otherwise facebook chat wouldn’t work and images wouldn’t load.
    – On my system, GoAgent correctly installed the CA certificate, but in order for Firefox to trust it, you have to go to Preferences->Advanced->Encryption->View Certificates->Authorities, select GoAgent CA and click “Edit Trust”. Select here “This certificate can identify websites”.

  8. Vrst
    Posted October 28, 2013 at 12:54 pm | Permalink

    Hello, I am desperately trying to install Goagent on my macbook.
    I don’t know why, but when I try to input the command python uploader.zip in the terminal, the following message appears :
    MacBook-Pro-de-Vincent-ROUSSET:server vincentrousset$ python uploader.zip
    ===============================================================
     GoAgent服务端部署程序, 开始上传 python 应用文件夹
     Linux/Mac 用户, 请使用 python uploader.zip 来上传应用
     Windows 用户, uploader.exe 的审查方法请见 github.com/goagent/pybuild
    ===============================================================

    请输入您的appid, 多个appid请用|号隔开
    注意:appid 请勿包含 android/ios 字样,否则可能被某些网站识别成移动设备。

    Traceback (most recent call last):
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/runpy.py”, line 121, in _run_module_as_main
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/runpy.py”, line 34, in _run_code
      File “uploader.zip/__main__.py”, line 35, in <module>
      File “uploader.zip/__main__.py”, line 26, in main
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/posixpath.py”, line 336, in abspath
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/posixpath.py”, line 52, in isabs
    AttributeError: ‘NoneType’ object has no attribute ‘startswith’
    MacBook-Pro-de-Vincent-ROUSSET:server vincentrousset$ 

    Could you please help me solve this ?
    Many thanks,
    Vincent.

  9. Posted October 28, 2013 at 9:07 pm | Permalink

    Vrst I have no idea what was wrong, but it seems that you were supposed to enter your AppID before the “Traceback” line. Would you mind offering a screen shot for all the commends you entered when uploading the file?
    As for me, I would like to create a new AppID, to follow the tutorials step by step and to redo it again.   
    Another suggestion is that you can create a new issue on the Goagent site, or try to connect its owner by emailing to [email protected]

  10. Vrst
    Posted October 29, 2013 at 1:21 pm | Permalink

    Thank you for your feedback. I have actually followed the guidelines and I even tried to create a second application. Here is what I do on the terminal : 
    Last login: Mon Oct 28 12:49:34 on ttys000
    MacBook-Pro-de-Vincent-ROUSSET:~ vincentrousset$ cd /Users/vincentrousset/Documents/goagent-65b9542b98d2/server 
    MacBook-Pro-de-Vincent-ROUSSET:server vincentrousset$ python uploader.zip
    ===============================================================
    GoAgent服务端部署程序, 开始上传 python 应用文件夹
     Linux/Mac 用户, 请使用 python uploader.zip 来上传应用
     Windows 用户, uploader.exe 的审查方法请见 github.com/goagent/pybuild
    ===============================================================

    请输入您的appid, 多个appid请用|号隔开
    注意:appid 请勿包含 android/ios 字样,否则可能被某些网站识别成移动设备。

    Traceback (most recent call last):
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/runpy.py”, line 121, in _run_module_as_main
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/runpy.py”, line 34, in _run_code
      File “uploader.zip/__main__.py”, line 35, in <module>
      File “uploader.zip/__main__.py”, line 26, in main
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/posixpath.py”, line 336, in abspath
      File “/System/Library/Frameworks/Python.framework/Versions/2.6/lib/python2.6/posixpath.py”, line 52, in isabs
    AttributeError: ‘NoneType’ object has no attribute ‘startswith’
    MacBook-Pro-de-Vincent-ROUSSET:server vincentrousset$ 
    I have changed the Appid name in the proxy.ini file, so I don’t know why it doesn’t work…

  11. Posted October 29, 2013 at 9:05 pm | Permalink

    VrstSince there was no way to enter your Appid, the problem I think may be caused by the following 2 errors:
    1. You did not download the latest version of Goagent from https://goagent.googlecode.com/archive/3.0.zip
    2. GAE was blocked in your area, in this case, you can use a VPN to unblock it.
     Pls let me know if these still fail to resolve your problem.