GAE平台使用指导

以Windows 7为例，Linux / Mac上的区别，会指出的

GAE简介

• Google App Engine是Google提供的云服务器主机，免费用户最高可部署10个应用，每个应用每天可使用1G数据流量，限制文件上传和下载为1Mb（使用APJP下载文件，基本没有文件大小限制，测试中下载521Mb文件正常），支援Java及Python环境，搭建基于APJP于GAE平台，需要满足如下条件：

1. 需要一个Gmail帐号，然后到https://appengine.google.com 开通GAE免费服务（要验证手机号，中国+86 1××××××××××）
2. 开通后创建一个应用，该应用的网址为http（s）://your-app-id.appspot.com，Your-App-ID是自行选择的名称
3. 下载Google应用服务引擎Java SDK，下载点为：

https://code.google.com/intl/zh-CN/appengine/downloads.html#Google_App_Engine_SDK_for_Java

下载文件，然后解压（建议 存放路径 F:\appengine-java-sdk-1.6.5 ）

文件

1. APJP_KEY-0.1.0.zip
2. APJP_LOCAL-0.9.3.zip
3. APJP_REMOTE_APPENGINE-0.2.4.zip

点击即下载，下载后解压。(APJP_REMOTE_APPENGINE-0.2.4.zip 的 建议 存放路径: F:\APJP\APJP_REMOTE_APPENGINE )

• 安装Java, Java官方最新版下载: http://www.java.com/zh_CN/download/manual.jsp

生成Key

转到APJP_KEY目录，双击APJP_KEY.bat（Linux上运行APJP_KEY.sh)，会显示一个APJP的密钥，类似APJP_KEY=FkPMd40j6vzfsEbf

编辑appengine-web.xml文件

编辑F:\APJP_REMOTE_APPENGINE\war\WEB-INF\appengine-web.xml文件，右键，编辑（文本编辑器：Notepad即记事本即可。示例中使用Notepad2），打开文件，查找

<application></application>

变更为，

<application>Your-App-ID</application>

往下编辑，填写APJP_KEY.bat生成的Key，

<property name="APJP_KEY" value=""/>

变更为，

<property name="APJP_KEY" value="FkPMd40j6vzfsEbf"/>

[05.07]新增一句, 要保持图示格式的(原因:Using Concurrent Requests)

	<threadsafe>true</threadsafe>

保存变更，离开。

上传App

• Linux和Mac用户应该是比较熟悉终端操作的，只简单介绍指令，不配图。
• 上传时保证C:\Windows\System32\drivers\etc\hosts 文件没有appengine.google.com（不懂的，直接无视此句）

1.运行命令提示符 快捷键【Windows徽标键+R】，弹出运行程序->输入:“cmd” ->

点击“确定”->弹出命令提示符

2.转到Java SDK目录（如果是按上面两处建议存放路径，直接复制代码操作，回车，一次一条。否则，就需要稍微学习一下cmd的指令操作）

cd /d F:\appengine-java-sdk-1.6.5\bin
appcfg update  F:\APJP\APJP_REMOTE_APPENGINE\war\

成功后，可进行重复操作，在GAE上部署多个APJP应用。

• For Linux, Debian系快捷键Ctrl+Alt+T，其他系，自己运行Terminal，假设appengine-java-sdk-1.6.5和APJP_REMOTE_APPENGINE 皆置于Desktop.

cd ~/Desktop/appengine-java-sdk-1.6.5/bin
./appcfg.sh update ~/Desktop/APJP_REMOTE_APPENGINE/war/

Linux 下如果出现问题，执行。

chmod +x ~/Desktop/appengine-java-sdk-1.6.5/bin/appcfg.sh

编辑APJP_LOCAL/APJP.properties

编辑APJP_LOCAL/APJP.properties，右键，打开方式，选择记事本（图例使用Notepad++，文本编辑器都可）打开。

部署完成。

• 鉴于Google的443端口定时受到干扰。URL=https://google.cn/HTTP (S) 和URL=https://google.com/HTTP (S) 可能出现问题的。可以使用其他的Google 域名。例:google.co.jp or gmail.com ...
• 图中选择的地方，URL=单独一个Google IP也可,而且推荐此。例如：URL=https://203.208.46.240/HTTP (S)
• 教育网推荐IPv6: URL=https://ipv6.google.com/HTTP (S) 或 URL=https://2404:6800:8005::a0/HTTP (S)

详细的配置作用RoleOfConfigurations

使用

双击APJP_LOCAL/APJP.bat（Linux / Mac 运行APJP.sh），会看到APJP在自行测试连接服务器的讯息，如果正常会有5个“OK” （由于APJP代码,经常更新,具体视情形而定）

这表示APJP已经运行并连上服务器，但需要在浏览器进行简单设定，数据会经由APJP服务器流通

• 在Firefox中代理选项中，设置HTTP PROXY 为127.0.0.1 端口为10000，SSL PROXY也是127.0.0.1 端口10000

• IE Internet设置->连接->局域网设置（L）其旁边的一段话【LAN设置不应用到拨号连接。对于拨号设置，单击上面的“设置”按钮】，如需设置和局域网设置（L）一样。->勾选“为LAN使用代理服务器”地址：127.0.0.1 端口：10000

• Firefox可使用Autoproxy(https://addons.mozilla.org/en-US/firefox/addon/autoproxy/) 扩展，选择性使用代理

• Google Chrome建议使用扩展 SwitchySharp 【项目Wiki地址https://code.google.com/p/switchysharp/wiki/SwitchySharp_GFW_List_2 】或Proxy Switchy！【Chrome Web Store地址 https://chrome.google.com/webstore/detail/caehdcpeofiiigpdhbabniblemipncjj?hl=zh-CN&hc=search&hcp=main 】

补充

APJP为web tunnel的实现，对于HTTPS连接会出现证书警告

例:

故在APJP_LOCAL-0.8.4版本，增加IAIK_JCE.jar并会随机生成APJP.pem导入浏览器内可解决证书警告问题。

以下为Windows 7版 Google Chrome的导入方法:

• 首先运行APJP_LOCAL/APJP.bat，设置好浏览器代理，打开https://www.google.com/ncr (或者其他任何 https:// URL)，出现证书警告。同时APJP_LOCAL目录中生成APJP.pem 和APJP.jks，接着如下操作:

a.选项(O)->高级设定->HTTPS/SSL->证书管理（Chrome调用的是系统的证书，即IE上不需要再导入证书）

b.点击“证书管理”->选择“受信任的证书颁发机构”->点击“导入(I)”

c.打开并指向APJP_LOCAL/APJP.pem

e.其他浏览器例如:Firefox设置导入证书大致相同

• 注意 : 每次更新APJP，都要删掉上次APJP的证书文件，再导入APJP.pem。因为证书是运行程序后自己生成的，具有唯一性。

关于使用图形界面

自APJP_LOCAL-0.8.5开始,本地客户端加入图形介面,方便一些对命令列不熟悉的用户

Windows用户可双击APJP_UI.bat或者直接双击APJP.jar运行图形界面，按Start连接服务器，无论Linux或Windows，双击桌面的工作列托盘图标，就可进行隐藏/显示APJP的图形界面

Linux用户。在APJP_LOCAL目录下执行chmod +x APJP.sh APJP_UI.sh，使用图形界面执行./APJP_UI.sh。如果在Shell脚本加入其他的Shell来执行，例如:/bin/zsh，在文件行首加入sha-bang #! /bin/zsh而得到zsh^M: bad interpreter no such file or directory。原因是文件以DOS/Windows格式存储，以致出现错误，请执行以下命令

tr -d '\r' < APJP_UI.sh > a ; mv -f a APJP_UI.sh ; chmod 755 APJP_UI.sh 

重新执行./APJP_UI.sh即可