Note: Special thanks Linus Yang for cross compiling python for iOS.

How to run goagent on iOS Devices.Note: This is only the client part, You should deploy the server-side part at first.Get in trouble? See FAQ section first,Or report an issue

Prerequisites

• A jailbreak iOS device.
• Have goagent server deployed.
• Change Cydia settings : Cydia -> Manage -> Settings -> Developer
• SBSettings

Step by step

• Add cydia source http://goagent-app.googlecode.com/svn/trunk/cydia/
• Install python 2.7.1 and goagent-local, search and install other denpendencies in cydia if needed.
• Fill in your appid in /User/goagent-local/proxy.ini #note: you can just use iFile
• Import Goagent Certificate(CA.cert). Open mobile safari to download it from here to install Or Use iPhone Configuration Utility,see this link
• Install goagent-toggle, Open SBSettings to toggle it on
• Open Settings -> Wi-Fi -> CurrentWiFi -> HTTP Proxy -> Auto -> file://localhost/var/mobile/goagent-local/8087.pac If not work, Tryfile://localhost/var/stash/Applications/MobileSafari.app/8087.pac
• Open Facebook to test it.

Todos

• Support iOS5
• Upgrade to Python 2.7 for iOS
• Auto change WIFI or APN proxy settings.
• iPhone Setting App for add custom urls to pac file.

FAQ

• Can not find python 2.6.5 in cydia?
• Change cydia settings : Cydia -> Manage -> Settings -> Developer or Download it from here

• Why need to import goagent certificate?
• The reason is same as using goagent on Windows.

• Can not open all web pages,Error code 502,Data format at not match issue.
• Make sure you have uploaded goagent server or php fetch server before. Check the appid in proxy.ini whether correct or not.

• Change proxy.ini, no corresponding effect？
• You need to restart goagent, just toggle it off then on.

• Is goagent available under 3G?
• Thanks for the testing by Arama(ljq…@gmail.com). See issue 1049 for details. You can try it by adding an new APN via iPhone Configuration Utility just like Onavo or 彩虹流量 or falcop does. or try change ProxyAutoConfigURLString in preferences.plist,see this link.

• Twitter in safari alerts “403 Forbidden (Rate Limit Exceeded)”
• GAE IPs banned by mobile twitter,You can use official Twitter client for iOS instead

• YouTube alerts “This movie format is not supported.”
• Caused by range fetch, m.youtube.com and youtube iOS client use different hosts which not in the autorange list.BTW Dolphin Browser and Safari with Frash both works.

• PAC file is invalid?
• The default port setting in pac is 8087 or 8088 (filename). Check with port setting in proxy.ini.You can use your own pac file instead. For some iOS devices, Mobile Safari seems not support local PAC file,i.e.”file://” not work.This is a known issue, see issues 873 for details.

• What happened when toggle Goagent SBSettings Toggle on?
• Actually Goagent SBSettings Toggle is a daynamic library will be loaded by SBSettings. When you toggle it on, The Toggle sends a command to sbsettingsd by calling notify_post(), this deamon would execute it.

• Goagent SBSettings Toggle is No icon?
• Only have icons for five default SBSettings themes

• Memory usage of goagent?
• Approximately 15Mb.

• Do not want to install SBSettings?
• Try the former methods or wait for new iOS APP(no ETA)

• How to upgrade goagent manually?
• Download latest goagent. Stop goagent and replace proxy.ini and proxy.py in /var/mobile/goagent-local.

• The former methods like mobile terminal or rove mobile admin client is still available?
• Yes.

• Run python proxy.py in mobile terminal alerts “OpenSSL Module : Disabled”
• You need to run as root.

• Run python proxy.py in mobile terminal alerts “socket.error: errno 48 Address already in use”
• The former python process is still runing. run “killall python”.

goagent 1.8.5 稳定版下载 http://goo.gl/pTt0W

最近更新

• [0506 是]去除python服务端对GAE的特定依赖，好处是速度有所提升，并且可以部署到其他平台或主机上。(主机环境使用需安装gevent)

简易教程

• 如何部署和使用goagent，以Windows为例
  1. 申请Google Appengine并创建appid。
  2. 下载goagent稳定版 http://code.google.com/p/goagent/
  3. 修改localproxy.ini中的[gae]下的appid=你的appid(多appid请用|隔开)
  4. 双击serveruploader.bat(Mac/Linux上传方法请见FAQ)，上传成功后即可使用了(地址127.0.0.1:8087)
  5. chrome请安装SwitchySharp插件，然后导入这个设置http://goagent.googlecode.com/files/SwitchyOptions.bak
  6. firefox请安装FoxyProxy，Firefox需要导入证书，方法请见FAQ

常见问题 FAQ

• goagent是什么？
• goagent是使用Python和Google Appengine SDK编写的网络软件，可以运行在Windows/Mac/Linux/Android/iTouch/iPhone/iPad/webOS/OpenWRT/Maemo上。

• 遇到FAQ没有解决问题怎么办?
• 首先请更新客户端和服务端到最新版(见首页)，如果还有问题的话请到http://code.google.com/p/goagent/issues/list 提出issue。提issue前建议先搜索下看是否是重复的问题，请尽量描述问题产生的原因，配置情况，网络情况等，这样有助于重现问题并解决。虽然我们可能顾不上回答，但是我们保证每个issue都会看的并尝试解决的。

• google reader提示404错误？
• 使用https://www.google.com/reader 访问.

• google plus不能看内嵌视频？
• 把*://*.ytimg.com/*加入规则

• youtube不能上传以及看直播？
• 请看issue 2668.

• 提示Error code 502错误怎么办？
  • 401: Unauthorized 一般是你处于内网环境中，需要设置proxy.ini里面的proxy段落
  • 404: Not Found 一般是proxy.ini里面appid没有填对，或者服务端没有部署成功。
  • 503: Service Unavailable 一般是流量用完了，请更换appid

• uploader上传失败？
  • 400: Bad Request 到http://appengine.google.com新建一个新的appid再上传。
  • 404: Not Found 对应的appid没有创建。
  • 10060 连接服务器超时，建议挂VPN后再上传
  • 10054 连接被重置，建议挂VPN后再上传

• 听说goagent保密性比较弱，如何加强？
• 下载最新版的客户端，编辑proxy.ini的google_cn google_hk域，mode=https即可.速度也相应变慢，呵呵。

• 最新版在哪下载？如何在旧版本上更新新版本？
• 还是直接到首页下载，那个链接永远是最新版。旧版本不用管，直接编辑新版的proxy.ini里面的appid即可。

• 我是Mac/Linux用户怎么办？
• 上传完服务端并设置好proxy.ini之后，在终端直接运行python proxy.py即可。需要Python版本2.6以上。Mac用户可以尝试 GoAgent Mac GUI或者GoAgentX

• Linux/Mac如何上传服务端？
• 在server目录下运行”python uploader.zip”(没有引号)，如果要上传python服务端的话，在server目录下运行”uploaddir=python python uploader.zip”(没有引号) 或者尝试GoAgentX

• 支持多个appid做负载平衡吗？
• 目前goagent最新版是支持的，在proxy.ini中的[gae]项目下这样配置即可appid=id1|id2|id3

• 配置多appid有什么用？
• 最新版的GAE服务端已经是python27，所以多appid现在只是起到增加流量配额的作用。提高并发的作用已经被GAE内置的功能取代了。

• GAE在2011-09-01推出了新版的收费计划，如何规避？
• 使用goagent 1.6以上版本的服务端。

• 如何使用php模式？
  1. 申请一个免费的php空间，然后通过在线代码编辑器或者ftp客户端把fetch.php上传到你申请到php网站的根目录。假设为http://goagent.php.com/fetch.php
  2. 访问你的fetch.php地址，比如http://goagent.php.com/fetch.php，如果没有问题的话，说明部署成功。
  3. 编辑proxy.ini[php]项目, enable=1和fetchserver=你的fetch.php地址，重启goagent.exe即可。
  4. 图文教程请见http://ishare.cn.ms/archives/552

• 如何设为系统服务（开机自启动）？
• 双击addto-startup.vbs即可。

• goagent支持IPv6网络吗？
• 支持的。profile=google_ipv6即可。

• 为什么goagent第一次运行需要管理员权限？
• 因为goagent会尝试调用certmgr.exe向系统导入IE/Chrome的证书，这需要管理员权限。

• Firefox怎么不能登陆twitter/facebook等网站, Firefox如何导入证书?
• 打开FireFox->选项->高级->加密->查看证书->证书机构->导入证书, 选择localca.crt, 勾选所有项，导入。

• Chrome下如何使用goagent?
• Chrome可以安装switchysharp插件，然后导入这个设置http://goagent.googlecode.com/files/SwitchyOptions.bak.

• 需要装Python或者Google Appenginge SDK后才能用goagent吗？
• 完全不用，goagent是绿色软件哦。

• goagent原理是什么？
• goagent是GAE应用，原理可以参考这个图原理示意图

• 支持gfwlist么？
• 这个问题考虑过，但是还是放弃了。goagent需要保持简单快速，支持gfwlist请使用autoproxy/switchysharp。

• 如何防止goagent被匿名使用(盗用)？
• 目前goagent最新版是支持的，注意:本功能不会影响网速，请放心使用。
  • golang版本：servergolangfetch.go中const段落开头修改Password = "123456"，重新上传fetch.go,然后在proxy.ini中的gae项目下这样配置即可password = 123456，即可。
  • python版本：先在serverpythonfetch.py中开头修改__password__ = '123456'，重新上传fetch.py,然后在proxy.ini中的gae项目下这样配置即可password = 123456，即可。

• 怎样设置不显示气泡提示？
• 用reshack/exescope等资源编辑工具把气泡提示字符串清空即可。

• 如何删除appengine.google.com上老的appid？
• 可以的，请看issue 1501

• 如何得到goagent的源代码？
• goagent的代码和程序是一起的，源代码就是运行程序。

• MultiplexConnection Cannot hosts错误？
• 看起来你的ISP封锁了google.cn，请尝试profile=google_hk这个选项，如果还不行，换PHP模式吧。

• 如何对goagent进行修改？
• 客户端代码直接改local/proxy.py,改完重启goagent.exe即可；服务端改server/fetch.py,改完用uploader.bat上传即可。

• 为什么要叫goagent，而不叫GoProxy？
• 一开始叫GoProxy的，后来Hewig说软件名字带有proxy字样不祥，于是就改成了goagent。

，http://dld.bz/caonima745