arch-wiki-md-repo
Version:
All arch-wiki articles in markdown format, updated every two days.
226 lines (139 loc) • 11.6 kB
Markdown
**警告:** goagent已经停止维护，本页面内容失效，请使用其他代理方法，参考[General recommendations (简体中文)](/index.php/General_recommendations_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "General recommendations (简体中文)")一文中的[中国大陆用户的推荐解决方案-代理](/index.php/General_recommendations_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87)#.E4.BB.A3.E7.90.86 "General recommendations (简体中文)")，选择其他工具。
GoAgent 是使用 [Python](/index.php/Python "Python") 和 Google App Engine SDK 编写的免费代理软件，利用 Google App Engine 充当代理服务器。
GoAgent 的运行原理于其他代理工具基本相同，其借由 Google App Engine 的服务器作为中传，将数据数据包后传送至 Google 服务器，再由 Google 服务器转发至目的服务器，接收数据时方法也类似。相对其他代理工具而言 GoAgent 要稳定许多。
## Contents
* [1 安装](#.E5.AE.89.E8.A3.85)
* [2 配置](#.E9.85.8D.E7.BD.AE)
* [2.1 服务器端](#.E6.9C.8D.E5.8A.A1.E5.99.A8.E7.AB.AF)
* [2.2 客户端](#.E5.AE.A2.E6.88.B7.E7.AB.AF)
* [2.2.1 Chrome/Chromium](#Chrome.2FChromium)
* [2.2.2 亚全局](#.E4.BA.9A.E5.85.A8.E5.B1.80)
* [3 运行](#.E8.BF.90.E8.A1.8C)
* [3.1 以 daemon 形式运行 (推荐)](#.E4.BB.A5_daemon_.E5.BD.A2.E5.BC.8F.E8.BF.90.E8.A1.8C_.28.E6.8E.A8.E8.8D.90.29)
* [3.1.1 屏蔽日志输出](#.E5.B1.8F.E8.94.BD.E6.97.A5.E5.BF.97.E8.BE.93.E5.87.BA)
* [3.1.2 日志输出至TTY](#.E6.97.A5.E5.BF.97.E8.BE.93.E5.87.BA.E8.87.B3TTY)
* [3.2 手动运行(不推荐+不支持)](#.E6.89.8B.E5.8A.A8.E8.BF.90.E8.A1.8C.28.E4.B8.8D.E6.8E.A8.E8.8D.90.2B.E4.B8.8D.E6.94.AF.E6.8C.81.29)
* [4 疑难解答](#.E7.96.91.E9.9A.BE.E8.A7.A3.E7.AD.94)
* [4.1 Firefox 31.0 及以上版本提示安全连接失败：证书包含未知的关键扩展。](#Firefox_31.0_.E5.8F.8A.E4.BB.A5.E4.B8.8A.E7.89.88.E6.9C.AC.E6.8F.90.E7.A4.BA.E5.AE.89.E5.85.A8.E8.BF.9E.E6.8E.A5.E5.A4.B1.E8.B4.A5.EF.BC.9A.E8.AF.81.E4.B9.A6.E5.8C.85.E5.90.AB.E6.9C.AA.E7.9F.A5.E7.9A.84.E5.85.B3.E9.94.AE.E6.89.A9.E5.B1.95.E3.80.82)
* [4.1.1 解决方法 1 （推荐）](#.E8.A7.A3.E5.86.B3.E6.96.B9.E6.B3.95_1_.EF.BC.88.E6.8E.A8.E8.8D.90.EF.BC.89)
* [4.1.1.1 重新生成新的 GoAgent 证书](#.E9.87.8D.E6.96.B0.E7.94.9F.E6.88.90.E6.96.B0.E7.9A.84_GoAgent_.E8.AF.81.E4.B9.A6)
* [4.1.1.2 在 Firefox 中导入新证书](#.E5.9C.A8_Firefox_.E4.B8.AD.E5.AF.BC.E5.85.A5.E6.96.B0.E8.AF.81.E4.B9.A6)
* [4.1.2 解决方法 2](#.E8.A7.A3.E5.86.B3.E6.96.B9.E6.B3.95_2)
* [5 参阅](#.E5.8F.82.E9.98.85)
## 安装
[官方软件源](/index.php/Official_repositories_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Official repositories (简体中文)")已收录 [goagent](https://www.archlinux.org/packages/?name=goagent)，直接用 [pacman](/index.php/Pacman_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Pacman (简体中文)") 安装即可.
## 配置
### 服务器端
申请 Google Appengine 并创建 appid 。具体教程可参考[此](http://www.douban.com/note/262773856/)。
**注意:** appid请勿包含android/ios等关键词，否则有可能被某些网站识别为移动设备用户。
上传(使用root用户，否则会出现权限不够的问题）：
`# python2 /usr/share/goagent/server/uploader.py`
**注意:** 原来的uploader.zip在新版本已经不存在了，代替它的是uploader.py。如出现不能上传的情况可以去github上git下来用里面的那个uploader.py试试
**注意:** 无效的 hosts 可能会导致上传失败，可尝试清空 `/etc/resolv.conf` 再上传。 将来的版本更新可能会要求重新上传。请参看[官方的更新历史](https://code.google.com/p/goagent/#更新历史_2013)，带有[是]标记的则需要重新上传。此外是否需要重新上传是相对于前一版的，若您之前版本与当前版本之间某一版或多版带有[是]仍然需要重新上传
**提示：** 首次上传后，可以再任意修改 Appid，无需再重新上传，不过最好重启以生效
执行时会要求您再输入 appid ，请保持与 `proxy.ini` 中已有的一致；接着还要输入 Google 邮箱及密码。
**注意:** 若您的 Google 账户有开通两步验证功能，则密码应为16位的应用程序专用密码。
至此，代理服务器 127.0.0.1:8087 已搭建完毕。现在以 [Chrome/Chromium](/index.php/Chromium_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Chromium (简体中文)") 为例，示范使用代理服务器的方法。
**注意:** 若浏览器类软件要通过 GoAgent 代理访问 Internet，可能均需要导入证书
### 客户端
**提示：** goagent 3.1.2-2 引入了用户配置文件(goagent.user.ini), 配置方法有所变动. 如果您是从旧版本升级, 可以在按照如下方法配置后放心删除以前的 /etc/goagent.pacsave. 此次变动之后, 您将不再需要在每次升级后合并该配置文件.
打开 `/etc/goagent` (默认情况下该文件为空), 增加类似下面的段落:
```
[gae]
appid = your_appid
password = yourpassword
```
修改 `your_appid` 为您所申请的 appid。如果您申请了多个 appid 用于负载均衡, 用竖线 | 分隔多个id (不含空格). 如果您使用的服务端没有配置密码, 可以省略掉 `password =` 开头的一整行.
goagent 3.1.5-1 新增 dnsproxy 功能, 基本配置依然是修改 `/etc/goagent` 文件, 加入类似以下内容:
```
[dns]
enable = 1
listen = 127.0.0.1:5353
```
如果希望 DNS 服务跑在 53 端口, 需要使用 root 用户运行服务. 新增 `/etc/systemd/system/goagent.service.d/use_root.conf` 文件, 加入以下内容即可:
```
[Service]
User=root
```
#### Chrome/Chromium
请安装 [SwitchySharp 插件](https://chrome.google.com/webstore/detail/proxy-switchysharp/dpplabbmogkhghncfbfdeeokoefdjegm)，接着导入[该设置](https://goagent.googlecode.com/files/SwitchyOptions.bak)。可参考[该扩展提供的图解流程](https://code.google.com/p/switchysharp/wiki/SwitchySharp_GFW_List_2)。
打开设置－管理证书－授权中心－Authorities，导入 `/usr/share/goagent/local/CA.crt`，弹出窗口的三条选项均勾选。
**注意:** 如果第一次安装 GoAgent 尝试到此步骤时发现该文件不存在，请先启动一次 GoAgent 后再重新尝试。
#### 亚全局
在 Unix 和 GNU/Linux 中，大多 HTTP 应用程序均支持调用环境变量 `http_proxy` 和 `https_proxy` 进行代理，就像 lynx、 [wget](/index.php/Wget "Wget") 和 curl，甚至也包括了 [Chromium (简体中文)](/index.php/Chromium_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Chromium (简体中文)") 和 [git (简体中文)](/index.php/Git_(%E7%AE%80%E4%BD%93%E4%B8%AD%E6%96%87) "Git (简体中文)")。此外该环境变量的大小写其实并没有统一标准，有个别程序就只支持全大写的环境变量。所以为方便起见，直接在 `~/.bash_profile` 或 `~/.zshenv` 添加以下即可：
```
export http_proxy=[http://127.0.0.1:8087/](http://127.0.0.1:8087/)
export https_proxy=$http_proxy
export HTTP_PROXY=$http_proxy
export HTTPS_PROXY=$HTTP_PROXY
```
**注意:** 虽然 Chrome 浏览器也可以通过其环境变量进行全局代理从而不再需要 Proxy Extension，但不建议这么做，因为会导致访问国内网站的速度下降，甚至个别网站就拒绝境外代理访问，例如收录了大量版权视频的网站。
再执行以下命令，以导入证书进 Arch Linux。至此，就可以实现 Arch Linux 亚全局代理：
```
# ln -s /usr/share/goagent/local/CA.crt /etc/ca-certificates/trust-source/anchors/GoAgent.crt
# trust extract-compat
```
2014-12-11 官方发布新闻[证书导入采用新方法](https://www.archlinux.org/news/ca-certificates-update/)。若在此之前导入过证书，请进行清理：
```
# rm -fr /usr/share/ca-certificates/goagent
# rm -fr /etc/ca-certificates/conf.d
```
## 运行
### 以 daemon 形式运行 (推荐)
```
# systemctl start goagent
```
若想开机自启动，执行：
```
# systemctl enable goagent
```
**提示：** 可通过`# journalctl -u goagent`来查询日志
#### 屏蔽日志输出
如果不想让 GoAgent 的输出信息进入日志，可以通过屏蔽 goagent.service 里的对应行解决，方法如下：
1\. 创建目录 `/etc/systemd/system/goagent.service.d`
2\. 创建文件 `/etc/systemd/system/goagent.service.d/nostdout.conf`, 写入如下内容:
```
[Service]
StandardOutput=null
```
#### 日志输出至TTY
如果不想让 GoAgent 的输出信息进入日志，但是又想得到 GoAgent 的运行情况，可以通过修改 goagent.service 里的对应行解决，方法如下：
1\. 创建目录 `/etc/systemd/system/goagent.service.d`
2\. 创建文件 `/etc/systemd/system/goagent.service.d/totty.conf`, 写入如下内容:
```
[Service]
StandardOutput=tty
StandardError=tty
TTYPath=/dev/ttyX #X为数字，ttyX不能正在被使用，推荐为1-12之间的整数，用Ctrl+Alt+FX切换至
#TTYVTDisallocate=yes #若需要在启动前清理所在TTY的虚拟终端，取消本行前的注释
```
3.运行：
```
# systemctl daemon-reload && systemctl restart goagent
```
### 手动运行(不推荐+不支持)
由于不明原因，总有个别用户无法成功以 daemon 形式运行GoAgent，可改试手动运行：
```
$ sudo -u nobody python2 /usr/share/goagent/local/goagent
```
若是在更新后发生问题，可尝试清空`/usr/share/goagent/local/certs`目录，甚至卸载并手动删除`/etc/`和`/usr/share/`下的有关文件，然后重新安装和配置。
## 疑难解答
### Firefox 31.0 及以上版本提示安全连接失败：证书包含未知的关键扩展。
从 Firefox 31.0 开始默认使用新的 mozilla::pkix 为证书验证库。GoAgent 证书已被证实和此证书验证机制不兼容。新证书认证会导致提示“安全连接失败：证书包含未知的关键扩展。 （错误码： sec_error_unknown_critical_extension）”。解决的方法有两种，推荐使用解决方法 1 。
#### 解决方法 1 （推荐）
##### 重新生成新的 GoAgent 证书
取得 Root 权限并执行以下命令：
```
# rm /usr/share/goagent/local/CA.crt
# rm -rf /usr/share/goagent/local/certs
# systemctl restart goagent
```
##### 在 Firefox 中导入新证书
在 Firefox 中点击右上角的菜单按钮（三道杠），在弹出的菜单中点击“首选项”（齿轮图标），打开首选项页面，点击"高级"-"证书"-"查看证书“，弹出一个新窗口，点击”证书机构“，在列表中找到"GoAgent CA"项并选中该项，点击"删除或不信任"，即完成删除原来的证书。点击"导入"，弹出文件选择窗口，进入目录 /usr/share/goagent/local/ ，选择文件 CA.crt 并点击打开，即完成导入新证书。点击确定关闭弹出窗口，重新启动 Firefox 即可。
#### 解决方法 2
在 Firefox 的地址栏上输入 about:config ，在输入框中输入 security.use_mozillapkix_verification ，在下面的列表中找到该项并双击修改为 false 。
## 参阅
* [GoAgent 在 Google Code 的主页](https://code.google.com/p/goagent/)
* [GoAgent 在 GitHub 的主页](https://github.com/goagent/goagent)
* 两位开发者的 Twitter 帐号：[@hewigovens](https://twitter.com/hewigovens),[@phuslu](https://twitter.com/phuslu)
* [讨论亚全局代理的 Email List](https://groups.google.com/forum/#!topic/archlinux-cn/_PPW2dZHltE)