GoAgent v3.2.2 - 快速自建GAE翻墙代理服务器

图文教程

一、申请 Google App Engine 并创建 appid

1. 申请注册一个 Google App Engine 账号。没有 Gmail 账号先注册一个， 用你的 Gmail 账号登录。 申请 GAE 帐号：
2. 登录之后，自动转向 Application 注册页面，如下图：
3. 接下来的页面，输入你的手机号码，需要注意的是，手机号码前面要+86(中国区号) 格式如：+86 13888888888。
   • 然后等待收取手机短信，收到短信后(一串数字号码)填入下图表单，点 send 提交.(有的手机收不到信息，到https://appengine.google.com/waitlist/sms_issues 提交该情况，一个工作日就能收到谷歌提示Google App Engine成功开通)。
4. 提交完成之后，GAE 账号即被激活，然后就可以创建新的应用程序了。转入 "My Applications" 页面，点击 "Create an Application" 新建应用
   • 一个Gmail账户最多可以创建十个GAE应用，每个应用每天 1G 免费流量。这里我们只创建一个应用就可以了。进入下一步，填写新应用的必要信息，如下图。在图中第一处添加一个应用名称，如 abc555 ,验证一下是否可用，如果显示 "Yes" 那么 abc555 就是你的 Appid(记住这个id)，而 abc555.appspot.com 就是你的应用服务器地址了。第二个空可随便填，点击 Create Application 按钮提交
   • 提交之后，就能看到下图这个页面，就说明你已经成功创建了一个新的应用,你也可以点击应用名称，进入控制面板进行管理。
   • 如果你要建立多个 appid，只需要从步骤 4 开始再重复操作多次就行了。

二、下载 goagent 并上传至 Google App Engine

1. 下载 goagent 并解压，https://github.com/goagent/goagent
2. 编辑 local\proxy.ini，把其中 appid = goagent 中的 goagent 改成你之前申请的应用的 appid (用 windows 的记事本也可以)
   • 如果要使用多个appid，appid之间用|隔开，如：appid1|appid2|appid3，每个 appid 必须确认上传成功才能使用

   [gae]
appid = appid1|appid2|appid3


3. 运行 goagent.exe
4. 上传
   • Windows 用户：双击 server 文件夹下的 uploader.bat，输入你上步创建的 appid (同时上传多 appid 在 appid 之间用 | 隔开,一次只能上传同一个谷歌帐户下的 appid )填完按回车。根据提示填你的谷歌帐户邮箱地址，填完按回车。根据提示填你的谷歌帐户密码(注意：如果开启了两步验证，密码应为16位的应用程序专用密码而非谷歌帐户密码，否则会出现 AttributeError: can't set attribute 错误)，填完按回车。
   • Linux/Mac OSX用户上传方法：在server目录下执行：python uploader.py
   • 如遇到上传困难的情况，可以先运行 goagent.exe(要先修改 appid )再运行 uploader.bat
   • 上传成功就会看图下图界面

三、运行客户端

1. Windows 用户运行 local 文件夹中的 goagent.exe，Linux/MacOSX 用户运行 python proxy.py
   • 设置浏览器或其他需要代理的程序代理地址为 127.0.0.1:8087
   • 注意：使用过程中要一直运行 goagent.exe/proxy.py
   • 代理地址 127.0.0.1:8087；如需使用 PAC，设置pac地址为 https://127.0.0.1:8086/proxy.pac
   • 也可以配合 SwitchySharp/FoxyProxy 等浏览器扩展 (SwitchySharp 用户可从 local 文件夹中的 SwitchyOptions.bak 文件导入配置)
2. 导入证书
   • IE/Chrome：使用管理员身份运行 goagent.exe 会自动向系统导入 IE/Chrome 的证书，你也可以双击 local 文件夹中的 CA.crt 安装证书(需要安装到 "受信任的根证书颁发机构" )；
   • 下一步 -> 完成 -> 确定
   • Firefox：需要单独导入证书，打开FireFox?->选项->高级->加密->查看证书->证书机构->导入证书, 选择 local\CA.crt, 勾选所有项，导入；
   • opera：导入证书方法：首选项→高级→安全性→管理证书→证书颁发机构->导入->选择 local\CA.crt文件->依次确认

浏览器设置方法

1. 使用 GoAgent 自带代理设置功能
   • 该功能可以为 IE 内核浏览器和未安装代理类扩展的 Chrome/Opera 等默认使用 IE 代理的浏览器和软件设置代理，但不能给 FireFox 设置代理
   • 右击 GoAgent 托盘图标，在 "设置IE代理" 菜单中选择要使用的模式。
   • 禁用代理 什么也不做，需要用户自己手动为软件设置代理
   • https://127.0.0.1:8086/proxy.pac 使用自带的PAC自动判断是否使用代理
   • <127.0.0.1:8087> 全部使用 GoAgent 代理
2. 谷歌 Chrome 配合 SwitchySharp 扩展
   • 安装扩展
   • 地址栏输入 Chrome://extensions/ 后按回车，打开扩展管理页，将 local 文件夹中的 SwitchySharp.crx 拖拽到该页面之后点击确定即可安装，扩展也可以从 Chrome 应用商店获得https://chrome.google.com/webstore/detail/proxy-switchysharp/dpplabbmogkhghncfbfdeeokoefdjegm
   • 导入设置
     • 点击 SwitchySharp 图标->选项->导入/导出
     • 浏览到 SwitchyOptions.bak，点击确定导入设置
     • 更新自动切换规则(如果遇到无法更新规则列表，可以先运行 goagent ，并把浏览器代理设置为 GoAgent 模式再更新规则，不更新规则只会影响自动切换模式，不会影响其他模式的使用，若确实无法更新也可不更新，直接使用 PAC 模式即可)
     • 在扩展设置页点击 "切换规则" ，点击 "立即更新列表" ，最后点击 "保存" 。
   • 单击地址栏右侧Proxy SwitchySharp图标即可进行模式选择
     • GoAgent 模式 除匹配 proxy.ini 中 profile 的直连外，其他全部通过GAE
     • GoAgent PAAS模式 全部通过PAAS
     • GoAgent PAC模式 根据 GoAgent 自带的 PAC 文件自动判断是否经过代理
     • 自动切换模式 根据切换规则自动选择是否进行代理，并根据所设情景模式自动选择使用何种代理
     • 遇到规则中没有的，可以使用扩展的 "新建规则" 按钮自行添加，选情景模式为 "GoAgent" ，使用此模式可以方便的定制自己的代理切换规则
     • 这个扩展偶尔会出BUG，出现设置无误但浏览器提示错误130无法连接到代理服务器，可以将自己的设置导出之后卸载重装
     • 如果遇到无法更新规则列表，可以先运行 goagent，并把浏览器代理设置为 GoAgent 模式再更新规则，不更新规则只会影响自动切换模式，不会影响其他模式的使用，若确实无法更新也可不更新，直接把扩展设置为 GoAgent PAC 模式即可
3. Firefox 配合 FoxyProxy 扩展
   • 安装扩展 https://addons.mozilla.org/zh-cn/firefox/addon/foxyproxy-standard/
   • 设置
     • 右击 foxyporxy 图标即可选择代理模式
   • 添加代理规则订阅(可选)
     • 这里以添加 gfwlist 为例，你也可以自行添加其他规则订阅
   • 更多设置请自行探究
4. Firefox 配合 AutoProxy 扩展(新版Firefox请将此扩展升级至最新版)
   • 安装扩展 https://addons.mozilla.org/zh-cn/firefox/addon/autoproxy/
   • 设置
     • 添加代理服务器 注意:新版 autoproxy 已内置GoAgent配置，可直接进行下一步
     • 添加规则订阅
     • 选择自己需要的模式
       • 自动模式 根据规则自行选择是否使用代理
       • 全局模式 全部使用代理
       • 禁用代理 全部不使用代理
5. opera 浏览器设置
   • 同 IE 一样有两种方式可选，不过不会影响系统其他程序的联网
   • 设置代理为 127.0.0.1:8087，全部使用 goagent 代理
   • 使用 PAC 自动代理
   • 不使用时应恢复为无代理状态
6. IE浏览器设置
   • 工具->Internet 选项->连接，局域网用户单击"局域网设置"。宽带用户选中自己正在使用的宽带连接之后单击"设置"，不要选 "局域网设置"
   • 局域网用户设置方法
     • 设置代理为 127.0.0.1:8087 ，全部使用 goagent 代理(不建议)
     • 使用 PAC 自动代理
   • 宽带用户设置方法
     • 选中自己正在使用的宽带连接之后单击"设置"
     • 设置代理为 127.0.0.1:8087，全部使用 goagent 代理(不建议)
   • 不使用时要将IE恢复无代理状态

适用环境

• 适用：浏览器，支持 http 代理的下载软件等
• 不适用：游戏客户端等需要稳定网络的程序，QQ，tor(验证证书)。待添加。。。

关于软件更新

• 更新历史中带有[是]则需要重新上传，否则不用重新上传。注意：是否需要重新上传是相对于前一版的，若你之前版本与当前版本之间某一版或多版带有[是]仍然需要重新上传。
• appid 并不绑定任何客户端，如果本次更新无需重新上传，只需修改 proxy.ini 中的 appid 即可使用。同样，你也可以把 appid 共享给朋友，或者在自己其他机器上使用，一个 appid 可以多人多机器同时使用，在无需更新服务端的情况下，只需成功上传一次即可。在没有设定密码的情况下，只需要知道 appid 就可以使用你的 appid 的流量，为防止被盗用可以加上密码。
• goagent 每一版下载的都是全部文件，你可以选择覆盖原文件或者将新版放另一个文件夹，旧版你可以选择留存或者删除，修改新版 proxy.ini 中相关设置即可运行。如果旧版添加了开机启动，需要将旧开机启动删除。如果旧版已经在运行，需先将旧版关闭。
• 如果之前版本没有ssl错误，使用新版出现 ssl 错误可以把原来的 CA.crt 和 certs 文件夹内的文件覆盖当前的这些文件。或者将CA.crt 和 certs 文件夹删除，同时删除浏览器中所有goagent ca 的证书，再重启 goagent，会生成新证书，重启浏览器再导入新证书即可。浏览器证书中只能有一个 goagent ca 的证书。

常见问题

1. 是否每次更新都要重新上传？
   

   更新历史中带有"是"需要重新上传，否则不用重新上传。 注意：是否需要重新上传是相对于前一版的，若你之前版本与当前版本之间某一版或多版带有[是]仍然需要重新上传。

2. 遇到FAQ没有解决问题怎么办?
   

   首先请更新客户端和服务端到最新版(见首页)，如果还有问题的话请提出 issue 。 提 issue 前建议先搜索下看是否是重复的问题。虽然我们可能顾不上回答，但是我们保证每个issue都会看的并尝试解决的。

3. 用 goagent 访问twitter ,自动跳转为 mobile.twitter.com 并返回 403 Forbidden。
   

   检查查自己的 id 是不是以 android 开头或者 apple, iphone 啥的开头的了

4. 在 Linux/Mac 下如何安装 gevent?
   

   easy_install gevent

5. youtube 不能上传以及看直播？
   

   请看配置选项 wiki 介绍。https://github.com/goagent/goagent/wiki/ConfigIntroduce

6. 提示 HTTP Error code 错误怎么办？
   

   400: BAD Request 一般是 iplist 配置不对，尝试使用默认 iplist。 401: Unauthorized 一般是你处于内网环境中，需要设置 proxy.ini 里面的 proxy 段落。 404: Not Found 一般是 proxy.ini 里面 appid 没有填对，或者服务端没有部署成功。 500: 一般是 server/client 版本不匹配，可能是没有上传成功，使用你正在使用的版本重新上传。 503: Service Unavailable 一般是流量用完了，请更换appid。

7. GAE 免费流量配额是多少？
   

   每个谷歌帐号可以在 GAE 创建10个 appid，每个 appid 每天1G免费流量，urlfetch 每分钟 22M, 传入传出带宽每分钟 56M，GoAgent 使用 urlfetch，故受每分钟 22M 的限制。 流量重置时间为加州时间的午夜，一般即北京时间 16 点。

8. uploader 上传失败？
   

   404: Not Found 对应的 appid 没有创建或者 appid 与 Gmail 账户不对应。 10060 连接服务器超时，建议挂 VPN 后再上传 10054 连接被重置，建议挂 VPN 后再上传 10061 目标计算机积极拒绝 挂 VPN 或者运行 goagent 后把IE代理设置为 127.0.0.1:8087 Cannot set attribute，请暂时停用两部验证，并且到 google.com/settings/security 确认"不够安全的应用的访问权限"已启用。

9. 听说 goagent 保密性比较弱，如何加强？
   

   下载最新版的客户端，编辑 proxy.ini, [gae]validate = 1

10. Linux/Mac 如何上传服务端？
    

    在 server 目录下运行"python uploader.py"(没有引号)

11. 支持多个 appid 做负载平衡吗？
    

    目前 goagent 最新版是支持的，在 proxy.ini 中的配置多个 appid 即可。

12. 如何防止 appid 被别人盗用？
    

    请看 https://goagent.github.io/?/wiki/SetPassword.md 。

13. 如何使用 php 模式？
    

    申请一个免费的 php 空间，然后通过在线代码编辑器或者 ftp 客户端把 index.php 上传到你申请到 php 网站的根目录。 假设为 https://goagent.php.com/index.php 。访问你的index.php地址，如果没有问题的话，说明部署成功。编辑proxy.ini
    [php]
enable = 1
fetchserver = 你的index.php文件的地址

    重启 goagent.exe 即可。

1. 如何设为系统服务（开机自启动）？
   

   双击 addto-startup.js 即可。

2. goagent 支持 IPv6 网络吗？
   

   支持的。[gae]ipv6 = 1 即可。

3. 为什么 goagent 第一次运行需要管理员权限？
   

   因为 goagent 会尝试向系统导入 IE/Chrome 的证书，这需要管理员权限。

4. Firefox 怎么不能登陆 twitter/facebook 等网站?
   

   打开 FireFox->选项->高级->加密->查看证书->证书机构->导入证书, 选择local\CA.crt, 勾选所有项，导入。

5. goagent 原理是什么？
   

   goagent是GAE应用，原理可以参考这个图

6. 如何防止 goagent 被匿名使用(盗用)？
   

   目前 goagent 最新版是支持的，请见密码设置 wiki 介绍。

7. 怎样设置不显示气泡提示？
   

   用 reshacker/exescope 等资源编辑工具把气泡提示字符串清空即可。

8. 如何删除appengine.google.com上老的appid？
   

   可以的，请登录 appengine.google.com 删除。

9. 如何得到 goagent 的源代码？
   

   goagent 的代码和程序是一起的，源代码就是运行程序。

10. 如何对 goagent 进行修改？
    

    客户端代码直接改 local/proxy.py, 改完重启 goagent.exe 即可；服务端改 server/gae.py, 改完用 uploader.bat 上传即可。

11. 为什么要叫 goagent，而不叫 GoProxy？
    

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

12. Windows 系统下，出现 ioerror:cannot watch more than 2560 sockets
    

    使用 goagent-uv.exe 启动。

13. 为什么使用 goagent 后访问 google.com 仍然跳转到 google.com.hk?
    

    先访问 https://www.google.com/ncr 一下即可。

14. 出现Address already in use 错误。
    

    原因：可能是goagent已经在运行或者端口被其他软件占用，比如搜狗浏览器开启全网加速会使用8087端口，比如旧版goagent加入开机启动没有删除、旧版已经在运行。 解决办法：关闭旧版goagent或者其他占用该端口的软件再重启goagent即可。

配置介绍

[listen]
#监听ip，如果需要允许局域网/公网使用，设为0.0.0.0即可
ip = 127.0.0.1
#使用GAE服务端的默认8087端口，如有需要你可以修改成其他的
port = 8087
#8087端口验证的用户名和密码，设置后可以防止局域网内其他人使用你的GoAgent
username =
password =
#启动后goagent窗口是否可见，0为不可见（最小化至托盘），1为不最小化
visible = 1
#是否显示详细debug信息
debuginfo = 0
#GAE服务端的配置
[gae]
#是否启用 GAE 服务端。
enable = 1
#你的 Google Appengine AppID, 也就是服务器部署的 APPID，配置多 ID 用|隔开
appid = goagent
#密码,默认为空,你可以在 server 目录的 gae.py 设定,如果设定了,此处需要与 gae.py 保持一致
password = 123456
#服务端路径,一般不用修改,如果不懂也不要修改.
path = /_gh/
#使用http还是https(SSL加密传输)连接至GAE
mode = https
#是否启用 ipv6
ipv6 = 0
#ip评优算法每次选出的ip数量
window = 6
#是否缓存ip评优算法生成的临时连接
cachesock = 1
#连接 ip 后是否使用 http HEAD 请求测试, 启用可以更好的测试该 ip 的质量。
headfirst = 1
#是否使用 http/1.1 的 keepalive 功能
keepalive = 0
#是否开启流量混淆
obfuscate = 0
#是否通过 pagespeed 服务中转访问 GAE
pagespeed = 0
#是否对服务器证书进行验证
validate = 0
#是否打开透明代理功能（和iptables配合使用）
transport = 0
# 如果设置为 rc4 则开启 rc4 加密，需在 password 设置密码，否则不开启，一般mode为https时无需开启
options =
#根据IP所在地区设置是否直连，比如 regions = cn|jp 可以让国内和日本的网站走直连。更多国家请见 <https://dev.maxmind.com/geoip/legacy/codes/iso3166/>
regions =
#每次urlfetch最大返回的文件大小
maxsize = 2097152
# 用于连接GAE的IP列表
[iplist]
google_cn = www.g.cn|www.google.cn
google_hk = www.google.com|mail.google.com|www.google.com.hk|www.google.com.tw|www.l.google.com|mail.l.google.com
google_talk = talk.google.com|talk.l.google.com|talkx.l.google.com
google_ipv6 = ipv6.google.com
# 匹配规则，支持 host 配置， host 后缀匹配，和 url 正则匹配
# 匹配规则有： 1. withgae 优先走 gae
# 2. withphp 优先走 php
# 3. direct 直连
# 4. fakehttps 使用 goagent 证书替换网站本身证书
# 5. nofakehttps 禁用 goagent 证书替换网站本身证书
# 6. forcehttps 强制 http 连接跳转到 https 网址
# 7. noforcehttps 禁用 http 连接跳转到 https 网址
# 8. google_* 使用 iplist 提供的地址直连
[profile]
play.google.com = withgae
wenda.google.com.hk = withgae
clients.google.com = withgae
scholar.google.com = nocrlf,noforcehttps,nofakehttps
scholar.google.com.hk = nocrlf,noforcehttps,nofakehttps
scholar.google.com.cn = nocrlf,noforcehttps,nofakehttps
books.google.com.hk = nocrlf,noforcehttps,nofakehttps
webcache.googleusercontent.com = crlf,noforcehttps,nofakehttps
mtalk.google.com = direct
talk.google.com = google_talk
talk.l.google.com = google_talk
talkx.l.google.com = google_talk
1-ps.googleusercontent.com = google_cn
2-ps.googleusercontent.com = google_cn
3-ps.googleusercontent.com = google_cn
4-ps.googleusercontent.com = google_cn
.google.cn = google_cn
.appspot.com = google_hk,crlf
.google.com = google_hk,forcehttps,fakehttps
.google.com.hk = google_hk,forcehttps,fakehttps
.googleapis.com = google_hk,forcehttps,fakehttps
.googleusercontent.com = google_hk,forcehttps,fakehttps
.googletagservices.com = google_hk,forcehttps,fakehttps
.googletagmanager.com = google_hk,forcehttps,fakehttps
.google-analytics.com = google_cn,forcehttps,fakehttps
.gstatic.com = google_hk,fakehttps
.ggpht.com = google_hk,fakehttps
.googlegroups.com = google_hk,forcehttps,fakehttps
.googlecode.com = google_hk,forcehttps,fakehttps
.youtube.com = forcehttps,fakehttps
.android.com = google_hk
www.dropbox.com = withgae
.dropbox.com:443 = direct
.box.com:443 = direct
.copy.com:443 = direct
https?://www\.google\.com/(?:imgres|url)\?.*url=([^&]+) = $1
https?://www\.google\.com\.hk/(?:imgres|url)\?.*url=([^&]+) = $1
#针对指定URL返回一个本地文件
; https?://www\.example\.com/.+\.html = file:///C:/README.txt
#取消注释（删除行首分号）使用 google_cn 地址作为 google 搜索
; https?://www\.google\.com(\.[a-z]{2})?/($|(search|url|gen_204)\?|(complete|images)/) = google_cn
#取消注释（删除行首分号）播放youtube上地区限制的vevo视频，此法可正常播放大部分vevo视频
; https?://www\.youtube\.com/watch = google_hk
#取消注释看直播
; .c.youtube.com =
; .youtube.com = google_hk
; .googlevideo.com =
#代理自动配置脚本(Proxy auto-config)设定
[pac]
#是否启用，若启用，浏览器代理自动配置地址填https://127.0.0.1:8086/proxy.pac
enable = 1
# pacserver的监听地址
ip = 127.0.0.1
port = 8086
# pac文件的名称
file = proxy.pac
#被墙规则订阅地址
gfwlist = https://autoproxy-gfwlist.googlecode.com/svn/trunk/gfwlist.txt
#广告拦截规则订阅地址
adblock = https://adblock-chinalist.googlecode.com/svn/trunk/adblock.txt
#自动更新间隔时间
expired = 86400
#对应php server 的设置
[php]
enable = 0
password = 123456
crlf = 0
validate = 0
listen = 127.0.0.1:8089
fetchserver = https://.cm/
#二级代理,一般内网会用到
[proxy]
#是否启用
enable = 0
autodetect = 1
#代理服务器地址
host = 10.64.1.63
#代理服务器端口
port = 8080
#代理服务器登录用户名
username = username
#密码
password = 123456
# 自动分段下载，需远程服务器支持Rang
[autorange]
#匹配以下域名时自动下载
hosts = *.c.youtube.com|*.atm.youku.com|*.googlevideo.com|*av.vimeo.com|smile-*.nicovideo.jp|video.*.fbcdn.net|s*.last.fm|x*.last.fm|*.x.xvideos.com|*.edgecastcdn.net|*.d.rncdn3.com|cdn*.public.tube8.com|videos.flv*.redtubefiles.com|cdn*.public.extremetube.phncdn.com|cdn*.video.pornhub.phncdn.com|*.mms.vlog.xuite.net|vs*.thisav.com|archive.rthk.hk|video*.modimovie.com|*.c.docs.google.com
# 自动对列表中文件类型启用分段下载功能
endswith = .f4v|.flv|.hlv|.m4v|.mp4|.mp3|.ogg|.avi|.exe|.zip|.iso|.rar|.bz2|.xz|.dmg
# 禁用分段下载的文件类型
noendswith = .xml|.json|.html|.php|.py|.js|.css|.jpg|.jpeg|.png|.gif|.ico|.webp
# 线程数
threads = 3
#一次最大下载量
maxsize = 1048576
#首次读写量
waitsize = 524288
#后续读写量
bufsize = 8192
#DNS模块，可以用来防止DNS劫持/污染
[dns]
enable = 0
#DNS监听地址，使用时将系统DNS设置为127.0.0.1
listen = 127.0.0.1:53
#远程DNS查询服务器
remote = 8.8.8.8|8.8.4.4|114.114.114.114|114.114.115.115
#缓存大小
cachesize = 5000
#超时时间
timeout = 2
#模拟用户浏览器类型,在User-Agent里提交给服务器你的浏览器操作系统等信息
[useragent]
#是否启用
enable = 0
#可自行修改的，前提是你知道怎么改
string = Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Version/3.0 Mobile/1A543a Safari/419.3
[fetchmax]
local =
server =
#不用理会,显示在控制台上方的公益广告
[love]
#不愿意看到这广告就把1改成0
enable = 1
tip = \u8bf7\u5173\u6ce8\u5317\u4eac\u5931\u5b66\u513f\u7ae5~~