KindleEar 搭建教程：推送 RSS 订阅到 Kindle

更新时间：2022年4月8日编辑：书伴分类：推送专题 805 条留言

* 特别提示：自 2019 年 11 月 30 日起，必须向 Google Cloud 的结算账户添加支持美元支付的信用卡（如 Visa、MastCard 等）才能正常使用 GAE，绑卡后只要不超资源限额仍可持续免费使用。

KindleEar 是一款开源的 Python 程序，由网友 cdhigh 发起，托管在 Github。它可运行在免费的 Google APP Engine（GAE）上，把 RSS 生成排版精美的杂志模式的 MOBI 文件，并按照设置定时自动推送至你的 Kindle。如果你有 Python 和前端基础，还可以自定义排版，生成你需要的最完美的 MOBI 文件。

▲ KindleEar 搭建成功后的首页界面

▲ KindleEar 推送到 Kindle 的阅读效果

KindleEar 目前的功能有：

支持类似 Calibre 的 recipe 格式的不限量 RSS/ATOM 或网页内容收集
不限量自定义 RSS，直接输入 RSS/ATOM 链接和标题即可自动推送
多账号管理，支持多用户和多 Kindle
生成带图的杂志格式 mobi 或带图的有目录 epub
自动每天定时推送
强大而且方便的邮件中转服务
和 Evernote/Pocket/Instapaper 等系统的集成

看到这些让人心动、那些收费的推送服务网站才有的功能是不是很心动了？其实搭建起来其实很简单，如果你什么都不懂，只要按照本文所给出的步骤一步一步操作就可以搞定。本文是更新后的教程，原方法需要配置上传环境，较为繁琐，现在只需要保证能科学上网，通过 Google 云端 Shell，只需要一行命令就可以搞定。现在，立即开始搭建自己的私有专属的 RSS 推送服务器吧！

目录

一、准备工作
 1、能够科(fan)学(qiang)上网
 2、注册 Google/Gmail 账号
 3、对 Google 账号进行安全设置
 4、创建一个 Google Cloud 项目
 5、为结算账户添加支付方式
 6、创建 Google App Engine 应用
 7、授权 GAE 用 Gmail 发信
 二、上传应用
 方法一：自动上传（强烈推荐！）
方法二：手动上传
 三、访问应用
 四、设置推送
 1、添加订阅
 2、设置推送
 3、投递日志
 4、账户管理
 5、高级设置
 6、网友分享
 五、常见问题
 1、访问页面提示 internal serve error
2、投递状态显示 wrong SRC_EMAIL
3、如何修改 KindleEar 登录密码
 4、访问页面提示 500 Server Error
5、点手动推送显示 internal server error
六、其它事项
 七、自制订阅

本教程适用于 Windows 系统和 Mac OS X 系统，所以请注意下载适合你操作系统的软件，以及选择适合你操作系统的步骤。本文步骤没有多余的废话，请严格按照下面的步骤进行操作。遇到意外情况请留言提问，如果提出的问题文中已有说明将不再重复回答。

一、准备工作

KindleEar 依赖 Google APP Engine，所以你需要有一枚 Google 账号（注册完记得安步骤说明设置一下安全选项），然后创建一个 GAE 应用。以下步骤中，如果某个条件已具备，请忽略相应步骤继续。

1、能够科(fan)学(qiang)上网

对于中国大陆用户来说，由于无法正常访问 Google 的相关服务，需要借助科学上网软件实现访问。你可以使用你习惯使用的科学上网软件，也可以选择下面为你推荐的任意一款科学上网软件。

Lantern：Windows ｜Mac OS X * 傻瓜化，无需配置，安装即可使用
Psiphon3（赛风）：Windows ｜ Android（请用迅雷下载）

* 提示：Lantern 免费版限制流量，如果想要购买专业版，使用邀请码 HBNVPW 可获得 1 或 3 个月额外时长。

2、注册 Google/Gmail 账号

点击下面的链接，注册一枚带 @gmail.com 后缀的 Google 账号。

Google 账号注册页面：https://accounts.google.com/SignUp

3、对 Google 账号进行安全设置

Google 账号在默认可能会拒绝将 KindleEar 上传到 GAE，所以需要设置一下。点击下面的链接进入你的 Google 账号“登录与安全”设置页面，找到“允许不够安全的应用”这一项，点击右边的滑动按钮，将其状态切换为“已启用”。注意，为了账号安全，上传完之后建议将此设置恢复为停用状态。

Google 账号设置页面：https://myaccount.google.com/security#connectedapps

4、创建一个 Google Cloud 项目

KindleEar 只能运行在 Google Cloud 的 Google App Engine（GAE）上，因此你需要先创建一个 Google Cloud 项目，然后再创建一个 GAE 应用。点击下面的链接并用你的 Google 账号登录。

创建 Google Cloud 项目页面：https://console.cloud.google.com

点击页面左上角的“选择项目”，点击弹出对话框右上角的“新建项目”，然后在“新建项目”页面中输入你喜欢的“项目名称”。项目名称可随意填写，只要是你喜欢并且符合它限定的规则即可。

需要着重注意的是项目名称下方的“项目 ID”，这个 ID 也就是我们后面提到的项目 ID。默认情况下，系统会根据你输入的项目名称自动生成项目 ID，但是自动生成字符没有意义，为了方便记忆最好是自定义。点击项目 ID 后面的【修改】按钮，将其修改成你喜欢的字符串组合。这样等 KindleEar 部署成功后，你就可以通过 http://项目ID.appspot.com 访问了（注意把项目 ID 换成你真实的项目 ID）。

由于 KindleEar 需要用到 Cloud Tasks API 和 Cloud Scheduler API 这两个服务，请确保它们已开启。

5、为结算账户添加支付方式

通过菜单导航或以下链接（把 YOUR-PROJECT—ID 替换为你自己的项目 ID）进入“结算（Billing）”页面，点击左侧的“付款方式（Payment method）”添加一张支持美元支付的信用卡。

https://console.cloud.google.com/billing/linkedaccount?YOUR-PROJECT-ID

* 提示：自 2019 年 11 月 30 日起，Google App Engine 将使用 Google Cloud Build 构建，而使用 Google Cloud Build 必需关联有效支付账户。也就是说从这天起必需绑定信用卡后才能正常使用 Google App Engine 了。Google Cloud Build 提供了免费套餐，只要构建时间不超过 120 分钟就不会收费，Google App Engine 仍可在不超出免费配额的前提下免费使用。需要特别注意的是，和之前免费额度用完就自动关闭应用不同的是，新政策会在免费额度用完后会自动收取超出免费额度的费用。

6、创建 Google App Engine 应用

创建完 Google Cloud 项目之后，还需要手动创建一个 Google App Engine 应用。方法有两种：一种是使用云端 Shell 创建；另一种是在 Console 页面上进行。可根据自己的喜好选用。

方法一：直接在云端 Shell 中使用命令创建。具体步骤为：点击页面右上角的 [ >_ ] 图标按钮（如下图所示），调出云端 Shell，输入以下命令按回车：

gcloud app create

命令执行后会出现 Which region would you like to choose? 字样，询问选择应用的位置，在 Please enter your numeric choice: 之后输入数字 1（或其它项），稍等片刻即可完成 GAE 应用的创建。

方法二：点击 Google Cloud 页面左上角的菜单按钮，点击弹出菜单中的“App Engine”。在“您的第一个应用”那里点击“选择一种语言”，选择“Python”。接下来“选择位置”中页面中选择“asia-east2”（或者其它你想要使用的区域，注意此选择是永久性的，一旦选择今后将不可更改），然后点击下一步。

如果你没有预先为结算账户添加支付方式，可能会弹出为当前项目启用结算账号的对话框，点击【创建结算账号】按钮会引导你进入创建结算账号的页面。如果你想要正常部署 GAE 项目，必须根据提示创建结算账号并添加可用美元支付的信用卡。至此便准备好了用来部署 KindleEar 的基础环境。

7、授权 GAE 用 Gmail 发信

默认情况下 GAE 没有使用 Gmail 发信的权限，所以你需要在 GAE 的设置中将 Gmail 的发信权限授权给 GAE 应用，否则， KindleEar 无法推送成功，日志中会出现错误提示 wrong SRC_EMAIL。

授权步骤很简单，首先在 GAE 中点击菜单中的【设置】进入设置页面，然后切换到【电子邮件发件人】，在“Mail API 已获授权的发件人”添加你的 Gmail 邮箱地址。具体步骤参考以下示意动画：

以上一切准备完毕，就可以进入第二部分的步骤，将 KindleEar 程序上传部署到 GAE。

二、上传应用

下面提供了两种将 KindleEar 应用上传到 GAE 的方法。一种是通过 Google 云端 Shell 的方式进行上传，使用书伴提供的 Shell 脚本一条命令就能搞定，完全自动化，强烈推荐使用。另一种是手动配置上网环境、手动输入命令进行上传，步骤较多也较为繁琐。请根据自己的实际情况择优选用。

方法一：自动上传（强烈推荐！）

1、进入 Google 云端控制台：https://console.cloud.google.com/home/dashboard

2、点击右上角的 Shell 图标（如下图所示）激活 Google 云端 Shell。

3、复制下面的代码，粘贴到 Google 云端 Shell（如下图所示），回车执行。

rm -f uploader.sh* && \
wget https://raw.githubusercontent.com/bookfere/KindleEar-Uploader/master/uploader.sh && \
chmod +x uploader.sh && \
./uploader.sh

代码粘贴到云端 Shell 后的效果如下图所示：

* 提示：脚本默认拉取 KindleEar 官方源代码，如果想要指定其它 KindleEar 项目分支（比如想要部署自己修改后并上传到 Github 上的 KindleEar 源代码）可在 uploader.sh 后加一个空格，然后跟上 Github 项目的 Git 地址即可。

4、根据脚本的引导，输入你的“Gmail 邮箱”和“项目 ID”等信息，等待上传成功即可。需要特别注意的是，一定要再三确认你输入的 Gmail 邮箱是正确的，拼写是无误的，否则无法推送成功。

上面的代码只需要执行一次即可，如果想要重新上传或要更新代码，直接运行 uploader.sh 即可：

./uploader.sh

* 提示：此 KindleEar 安装脚本托管在 GitHub：https://github.com/bookfere/KindleEar-Uploader

方法二：手动上传

在开始手动部署 KindleEar 步骤之前，请确保已完成本文第一部分提及的准备工作。

[ 展开步骤 ]

1、安装 Python 2.7

Mac OS X 和 Linux 系统已预装 Python 2.7，可略过此步骤。如果你使用的是 Windows 系统，请检查一下是否已安装 Python 2.7，如已安装可略过此步骤，否则请下载安装。下载时建议用迅雷等下载工具。

Python 2.7 下载：Windows ｜ Mac OS X ｜ Linux ｜官方页面

Windows 系统安装 Python 时，请在安装过程中的“Customize Python”这一步把“Add python.exe Path”这一项选为“Will be installed on local hard drive”，以便能在命令提示符中直接运行 python 命令。

* 提示1：由于 KindleEar 所依赖的 Calibre 相关的代码使用的是 Python 2.7，所以这里没有使用 Python 3。
* 提示2：macOS 系统虽然内置了 Python 环境，但是并不推荐直接使用它，而是推荐使用 Homebrew 安装独立的 Python 环境。Homebrew 是一款包管理器，支持 macOS（或 Linux）系统，它能安装和管理独立于原生系统环境的工具包，可有效避免对原生系统环境产生影响，对于没有包管理器的 macOS 系统（或 Linux 系统中的非 root 用户）来说非常方便。

2、安装 Google Cloud SDK

Google Cloud SDK 是用于管理托管在 Google Cloud 平台上的资源和应用（当然包括我们所需要的 Google App Engine）的一套工具，里面包含 gcloud、gsutil 和 bq 命令行工具。由于 GAE 不再支持旧的 appcfg 命令部署应用，所以必须安装 SDK，用其中的 gcloud 命令上传部署 KindleEar 项目。

Google Cloud 的文档为不同的操作系统如 Windows、macOS、Linux（含分发版本 Debian、Ubuntu、Redhat、CentOS）提供了详细安装步骤，你可以按照其指示进行安装。需要注意的是，文档中提供了“版本归档”和“安装程序”两种安装方式，为了减少不必要的麻烦，书伴建议均使用“安装程序”安装。

相较之前使用 appcfg 命令部署程序，使用 Google Cloud SDK 部署程序可以说是一种全新方式，为节省小伙伴们的时间，书伴根据官方文档将安装步骤梳理了一下，对一些可能产生疑问的地方做了解释。

● Windows 系统安装步骤：

Google Cloud SDK 安装程序下载：官方下载｜百度网盘〈提取码 : ee68〉

下载并运行 Google Cloud SDK 安装程序，会出现如下图所示的安装界面：

和普通 Windows 程序的安装流程一样，各种下一步直至安装成功。

* 提示：由于在安装的过程中需要下载相关组件，所以需要耗费一些时间，请耐心等待。另外，书伴在测试时，发现安装过程中的下载不需要代理，如果你所在的网络环境在下载时遇到长时间停顿或出现了下载错误，可能需要使用全局网络代理。

● macOS & Linux 系统安装步骤：

在 macOS 和 Linux 系统中安装 Google Cloud SDK 全程都是在“终端（Terminal）”中进行的，所以你需要先打开“终端”，准备运行接下来提到的一些命令，这些命令只需粘贴复制并回车执行即可。

如果你身在中国大陆，需要让“终端”通过代理联网。如果你已经备好了可用的网络代理，你可以通过在“终端”中运行以下命令来应用 HTTP 代理（注意务必把命令中的 IP 和端口替换成真实可用的）：

PROXY=http://127.0.0.1:8888; export HTTP_PROXY=$PROXY HTTPS_PROXY=$PROXY

然后执行以下命令开始 Google Cloud SDK 的安装：

curl https://sdk.cloud.google.com | bash

* 提示：如果你的 macOS 系统安装了 Homebrew，也可直接执行命令 brew cask install google-cloud-sdk 安装。

该命令会自动下载程序安装包，并在下载完成后自动执行安装，这时你会看到类似如下所示的提示：

Installation directory (this will create a google-cloud-sdk subdirectory) (/Users/YOURNAME):

这个提示的意思是让你输入程序的安装路径（默认会安装在你的用户主目录下），为避免可能出现的文件或目录权限问题，如果没有特殊需要，书伴建议直接回车让其安装到默认目录即可。

接下来会有一通命令执行安装，直到出现如下所示的提示信息：

Do you want to help improve the Google Cloud SDK (y/N)?

这个提示的意思是“你是否想要帮助改善 Google Cloud SDK”，“是”输入 y 并回车，“否”输入 N 并回车。

接下来程序会安装使用 Google Cloud 平台所需所有核心命令行工具。直至出现如下提示：

Modify profile to update your $PATH and enable shell command completion?

Do you want to continue (Y/n)?

这个提示的意思是“是否修改 profile 以更新 $PATH 并启用 Shell 的命令补全功能”。如果你知道如何手动配置 $PATH 变量并且不想让程序自动修改，可输入 n 回车拒绝，否则输入 Y 回车（或直接回车）允许。

最后安装程序会出现以下提示：

The Google Cloud SDK installer will now prompt you to update an rc file to bring the Google Cloud CLIs into your environment.

Enter a path to an rc file to update, or leave blank to use
[/Users/YOURNAME/.zshrc]:

这个提示的意思是“Google Cloud SDK 安装程序将会提示你更新 rc 文件，以便把 Google Cloud 命令行界面引入你的系统环境”，这样你就能直接在“终端”通过输入命令名执行命令，而不必使用完全限定文件名（命令程序的完整路径）了。程序会提示你输入一个 rc 文件的路径，如果你知道这是什么，可根据自己的需要自行修改，否则，建议直接按回车继续，让程序自动修改它监测到的你正在使用的 rc 文件。

* 提示：不必担心 rc 文件被破坏，因为安装程序会自动备份原 rc 文件。如你使用的 Shell 是 zsh（macOS 自 Catalina 开始默认使用 zsh），那么程序就会自动将 zsh 的配置文件 .zshrc 备份为 .zshrc.backup，如今后有需要可随时恢复。

至此就完成了在 macOS 或 Linux 中安装 Google Cloud SDK 的全部步骤。

为确保你成功安装了 Google Cloud SDK，请关闭并重新打开“终端”，输入如下所示命令：

gcloud --version

如果出现了如下所示提示，就说明 Google Cloud SDK 已经成功安装，否则需要重新安装。

Google Cloud SDK 290.0.0
bq 2.0.56
core 2020.04.21
gsutil 4.49

成功安装 Google Cloud SDK 后还需要做一些简单的配置，以便将 KindleEar 部署到 GAE。

3、配置 Google Cloud SDK

如果你身在中国大陆，首先需要让 Google Cloud SDK 通过代理联网。你可以使用全局网络代理，也可以单独为 SDK 设置网络代理，如选择后者，可通过在“命令提示符”或“终端”中依次运行以下命令来应用开始准备好的 HTTP 代理。下面的命令以 127.0.0.1:8888 为例，请务必替换成真实可用的 IP 和端口：

gcloud config set proxy/type http
gcloud config set proxy/address 127.0.0.1
gcloud config set proxy/port 8888

然后我们需要初始化 SDK，对其做一些简单的配置。在“命令提示符”或“终端”中执行如下命令：

gcloud init

你将会看到如下所示的提示信息：

Pick configuration to use:
 [1] Re-initialize this configuration [default] with new settings
 [2] Create a new configuration
Please enter your numeric choice:

提示的意思是，你有两种选择，一种是重新初始化 default 配置，另一种是创建一个新的配置。如果你只是用一个 Google 账号，直接输入 1 即可（如果你有多个账号需要设置，可以通过重新运行 gcloud init 命令，并选择 2 为多账号创建新的配置文件）。选择创建方式并确认后，你会看到如下提示：

You must log in to continue. Would you like to log in (Y/n)?

提示的意思是，你必须登录 Google 账号以继续，请输入 Y 回车（或直接回车），这时“终端”或“命令提示符”会出现一个 URL，同时你的浏览器自动打开这个 URL。你需要在打开的网页总登录 Google 账号，并允许 SDK 访问你的账户（如果你的浏览器没有自动打开 URL，请手动用浏览器打开此 URL）。

账号登录成功后，你会在“终端”或“命令提示符”中看到如下提示：

Pick cloud project to use:
 [1] bookfere-test
 [2] Create a new project

提示的意思是请选择你要使用的项目，你可以输入项目对应的序号（或输入项目名称）按回车即可。

至此你已成功配置好 Google Cloud SDK，当你再次执行 gcloud 命令时，相关的操作会作用于你所设置的这个项目（如果今后想换成其它项目请参考官方文档）。接下来就可以上传部署 KindleEar 了。

4、下载 KindleEar 源码

点击下面的链接下载 KindleEar 源码。如果你习惯使用 Git，也可以将项目 Clone 到本地。

KindleEar 下载：下载链接｜项目页面

5、配置 KindleEar 程序

解压缩下载到的 KindleEar 压缩包（如果是通过 Git 的 Clone 命令获取的可略过此步），把 KindleEar 的源代码放到你喜欢的位置。为方便演示，本例中 KindleEar 源代码放置的位置如下所示：

Windows 系统中，将源代码放到了用户主目录下，路径为：

C:\Users\YOURNAME\kindleear

macOS 系统中，将源代码放到了用户主目录下，路径为：

/Users/YOURNAME/kindleear

Linux 系统中，将源代码放到了用户主目录下，路径为：

/home/YOURNAME/kindleear

接下来进入 KindleEar 源代码文件夹，按照下表修改文件并保存：

要修改的文件	要修改的内容	内容修改说明
app.yaml	`application: kindleear`	删除（或用 # 注释掉）这一行
app.yaml	`version: 1`	删除（或用 # 注释掉）这一行
module-worker.yaml	`application: kindleear`	删除（或用 # 注释掉）这一行
	`version: 1`	删除（或用 # 注释掉）这一行
	`module: worker`	红色加粗部分修改为 service
config.py	`SRC_EMAIL = "xxx@gmail.com"`	红色部分修改为你创建应用的 Gmail 邮箱
config.py	`DOMAIN = "https://xxx.appspot.com`“	红色部分修改为你创建的项目 ID

注意！一定要再三确认 SRC_EMAIL 参数值是正确的 Gmail 邮箱，拼写是无误的，否则无法推送成功。

6、上传 KindleEar 程序

打开“终端”或“命令提示符”，使用 cd 命令切换到 KindleEar 所在目录（小窍门：输入 cd 后，把 KindleEar 文件夹拖到命令提示符上），然后输入以下命令将 KindleEar 上传到 GAE：

gcloud app deploy *.yaml --version=1 --quiet

部署的过程可能需要较长的时间（取决于网络速度），请耐心等待，直到命令运行完毕。如果你能看到 Indexes are being rebuilt. This may take a moment. 字样，说明已经部署成功。

三、访问应用

部署成功后，就可以打开网页浏览器，输入 http://项目ID.appspot.com 来访问你搭建的 KindleEar 应用。注意！URL 中的“项目ID”务必更换成你自己的真实项目 ID，否则是无法正常访问的。

KindleEar 初始登录名和密码都是“admin”，建议登录后立即改成新密码。登录 KindleEar 后你会发现以下几个导航，你可以在这里增减 RSS 、查看推送记录或根据自己的需要进行一些个性化的设置。

对于刚部署完的 KindleEar 应用，在访问“我的订阅”页面的时候，可能会遇到“internal server error”的错误，这是由于 GAE 需要时间索引应用的相关数据，你需要耐心等待一段时间。如果长时间（如超过半个小时）仍然无法正常访问，请参考本文的“五、常见问题”中的第 1 条提供的解决方案。

* 提示：由于 appspot.com 需要科学上网才能访问，如果嫌每次都这样访问麻烦，可以按照文章《给 KindleEar 绑定可直接访问它的免费顶级域名》介绍的方法，为其绑定一个免费的顶级域名。当然你可以可以为其绑定现成的顶级域名。

四、设置推送

以下是 KindleEar 的常用功能的简要介绍，当然你也可以自行体验摸索各种功能。

1、添加订阅

登录应用后，可以点击导航上的“我的订阅”进入订阅页面，在这里在这里可以添加自定义的 RSS 地址。也可以在下方预置的一些订阅里选择自己感兴趣的。

在添加自定义 RSS 地址的时候请注意。KindleEar 仅支持 RSS/ATOM 格式的订阅（XML 格式），如果遇到添加的自定义 RSS 无法成功推送，请留意是否是格式错误导致的。

比如有些 FeedBurner 烧制的 RSS 默认是 HTML 格式（可以通过查看源代码辨别），直接添加这种 RSS 地址不能成功推送，需要在添加的 RSS 地址后面添加一个参数 ?format=xml 或 ?fmt=xml 才行。

2、设置推送

添加完订阅后，还需要设置一下推送。点击导航上的“设置”进入 KindleEar 的设置页面。在这里填写接收推送的“Kindle 邮箱”，选择投递日，所选投递日的投递时间，建议勾选“多本书籍合并投递为一本”、“使能自动定时投递”、“自动定时投递自定义 RSS”。同时还可以在“书籍标题”项填写显示在 Kindle 里的个性名称。当所有设置完后还可以点击“现在投递”测试一下。

3、投递日志

每次投递的记录。

4、账户管理

可以添加多用户，更改密码等。

5、高级设置

有手动推送订阅功能即“现在投递”，有邮件白名单、归档和分享、URL 过滤、封面图片设置。

6、网友分享

你可在此页面一键订阅他人分享的 RSS。当然你可以在“我的订阅”把自己 RSS 分享给他人。

OK，全部步骤结束。在你的 Kindle 处于联网状态时，这个你亲手建立的推送服务器，就会按照你设置的时间定时把精美的电子杂志推送到你的 Kindle 上了！Enjoy it！

五、常见问题

很多小伙伴在安装和使用 KindleEar 的过程中会遇到一些问题，这些问题很常见也很好解决，所以书伴将这些问题整理归纳如下。如果你遇到了新的问题也可以留言提出。

1、访问页面提示 internal serve error

如果是刚上传完 KindleEar，由于 GAE 需要一些时间索引数据，在此期间访问某些页面会出现“internal serve error”的错误提示，最长等待十来分钟即可正常访问。

如果等待很长时间仍然出现“internal serve error”，请尝试这样操作：点击 Google Cloud 左上角的菜单按钮，点击弹出菜单中的“数据存储”，再点击数据存储页面左侧导航中的“索引”进入索引页面。

查看一下 Book、DeliverLog、Feed 三项的状态，如果是绿色对勾则正常，否则就需要重新索引一下。具体操作为，进入 KindleEar 目录，运行下面这条命令更新一下索引：

gcloud app deploy index.yaml --version=1 --quiet

待索引状态全部变成“使用中”后，也就是每一项都变成绿色对勾，即可正常访问。

2、投递状态显示 wrong SRC_EMAIL

默认状态下 GAE 不允许发信，所以才会出现 wrong SRC_EMAIL 的提示，你需要设置一下把 Gmail 邮箱地址添加到“Mail API 已获授权的发件人”，这需要在 GAE 应用的设置中进行。

▲ 向 GAE 设置中添加 Gmail 邮箱示意动画

首先访问下面这个网址进入 GAE 应用设置（将其中的项目 ID 换成你真实的项目 ID）：

https://console.cloud.google.com/appengine/settings/emailsenders?project=项目ID

* 也可以点击左上角的菜单，在弹出的菜单中点击“App Engine”，然后再点击 APP 引擎页面左侧的“设置”。

切换到“电子邮件发件人”，看一下“Mail API 已获授权发件人（Mail API authorized senders）”账号里面有无添加发送邮箱地址，如果没有就点击上方的“添加”按钮或“添加已获授权的电子邮件发件人”按钮添加一下邮箱地址，注意添加完后要按回车确认一下，最后点击“添加”，此问题即可解决。

如果确认添加了正确邮箱，却仍然出现 wrong SRC_EMAIL 错误，就需要检查一下 KindleEar 配置文件 config.py 中的 SRC_EMAIL 参数，确保填写的是【拼写正确】的 Gmail 邮箱。

▲ 仔细检查源代码 config.py 中的 SRC_EMAIL 参数

3、忘记 KindleEar 的登录密码怎么办

忘记密码可以进入 GAE 重置密码，具体方法为：访问 https://console.cloud.google.com，点击左上角的菜单，点击菜单中的“数据存储”，然后在“按种类查询”的标签项下方的“种类”中，选择“KeUser”，最后点击用户记录“名称/ID”，编辑其中的 passwd，改成 e10adc3949ba59abbe56e057f20f883e，最后点击【保存】按钮保存一下，这样就把密码临时改成了123456，登录账号修改成新密码即可。

4、访问页面提示 500 Server Error

如果你部署的 KindleEar 之前运行正常，但是突然出现内容如下的 500 Server Error 页面：

Error: Server Error
The server encountered an error and could not complete your request.
Please try again in 30 seconds.

遇到此情况请检查你的 Google App Engine 所在的 Google Cloud 项目是否关联了有效支付账户。因为 KindleEar 所使用的 Google App Engine 依赖 Google Cloud Build 服务，而要使用此服务必需关联有效支付账户（即必需绑定信用卡后才能正常使用）。Google Cloud Build 提供了免费套餐，只要构建时间不超过 120 分钟就不会收费，Google App Engine 可在不超出免费配额的前提下免费使用。注意，免费额度用完不会自动关闭应用，而是自动收取超出免费额度的费用。

5、点手动推送显示 internal server error

由于 KindleEar 需要用到 Cloud Tasks API 和 Cloud Scheduler API 这两个服务，请确保它们已开启。

六、其它事项

上文已将 KindleEar 的部署步骤和使用方法详细列出，一般情况下你只需要按照步骤一步步操作就能部署成功。如果遇到问题，请访问 KindleEar 项目提供的常见问答（FAQ）。那里可以解决你在安装 KindleEar 时遇到的绝大部分问题。如果 FAQ 没有解决你的问题，可以自行搜索看是否有可行办法。

实在解决不了可以点击这里向开发者提交一个“New issue”请求解答，也可以在本页留言请求帮助。

另外，如果你觉得 KindleEar 这款软件还不错且有软件开发能力，欢迎贡献代码。

七、自制订阅

如果你想推送的内容不提供 RSS 供稿，并且 KindleEar 内置的订阅也不能满足你的需求，建议尝试通过下面这三篇文章提供的方法自制 KindleEar 抓取脚本，教程面向没有编程基础的小伙伴。

“Kindle推送”相关阅读

支持书伴创作更多高质量文章，捐助书伴

给这篇文章写一条留言取消回复

小伙伴们写下了 805 条留言

jacob说道：

2017年2月2日 18:13

因为有一些自定义的东西，我选择了手动上传，完全按照您贴出的步骤，但是出现了下面的错误提示，请求协助。

Traceback (most recent call last):
File “appcfg.py”, line 136, in
run_file(file, globals())
File “appcfg.py”, line 132, in run_file
execfile(PATHS.script_file(script_name), globals)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 5510, in
main(sys.argv)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 5501, in main
result = AppCfgApp(argv).Run()
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 2975, in Run
self.action(self)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 5157, in call
return method()
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 3859, in Update
self.UpdateUsingSpecificFiles()
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 3851, in UpdateUsingSpecificFiles
self.UpdateVersion(rpcserver, self.basepath, module_yaml, file_name)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 3824, in UpdateVersion
return appversion.DoUpload(paths, openfunc)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 2410, in DoUpload
self.error_fh)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 497, in GetResourceLimits
resource_limits.update(_GetRemoteResourceLimits(logging_context))
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 467, in _GetRemoteResourceLimits
yaml_data = logging_context.Send(‘/api/appversion/getresourcelimits’)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appcfg.p
y”, line 1719, in Send
result = self.rpcserver.Send(url, payload=payload, **kwargs)
File “C:\Program Files\Google\google_appengine\google\appengine\tools\appengin
e_rpc_httplib2.py”, line 246, in Send
url, method=method, body=payload, headers=headers)
File “C:\Program Files\Google\google_appengine\lib\oauth2client\oauth2client\c
lient.py”, line 579, in new_request
self._refresh(request_orig)
File “C:\Program Files\Google\google_appengine\lib\oauth2client\oauth2client\c
lient.py”, line 787, in _refresh
self._do_refresh_request(http_request)
File “C:\Program Files\Google\google_appengine\lib\oauth2client\oauth2client\c
lient.py”, line 806, in do_refresh_request
self.token_uri, method=’POST’, body=body, headers=headers)
File “C:\Program Files\Google\google_appengine\lib\httplib2\httplib2_init.
py”, line 1584, in request
(response, content) = self.request(conn, authority, uri, request_uri, metho
d, body, headers, redirections, cachekey)
File “C:\Program Files\Google\google_appengine\lib\httplib2\httplib2_init.
py”, line 1332, in _request
(response, content) = self.conn_request(conn, request_uri, method, body, he
aders)
File “C:\Program Files\Google\google_appengine\lib\httplib2\httplib2_init.
py”, line 1268, in conn_request
conn.connect()
File “C:\Program Files\Google\google_appengine\lib\httplib2\httplib2_init.
py”, line 1011, in connect
sock.connect((self.host, self.port))
File “C:\Program Files\Google\google_appengine\socks.py”, line 362, in connect

raise GeneralProxyError((5,_generalerrors[5]))
socks.GeneralProxyError: (5, ‘bad input’)

回复
黒幕組说道：

2017年1月24日 21:07

无论怎么样都没有办法使用定时投递的功能，但是如果现在投递就可以投递至kindle，求解答怎么回事

回复
- 黒幕組说道：
  
  2017年1月24日 21:13
  
  投递日志也没有显示
  
  回复
- 书伴说道：
  
  2017年1月24日 21:13
  
  黒幕組您好。请问您是怎么测试定时投递的？
  
  回复
  - 黒幕組说道：
    
    2017年1月24日 22:21
    
    选择一个时间，等待到最近选择的时间点，然后过一段时间看一看投递日志和kindle有没有来。
    
    回复
coder123说道：

2017年1月24日 20:42

请尊重一下造轮子的程序员好吗？ https://github.com/cdhigh/KindleEar 这个是项目地址。( ▼-▼ )

回复
- 书伴说道：
  
  2017年1月24日 20:56
  
  coder123 您好。本文开头提及了本程序的作者，文末提供了项目地址，并附上了原作者的捐助链接。请问哪里不尊重您所说的“造轮子的程序员”了？
  
  回复
林大大说道：

2017年1月23日 10:44

http://你的APPID.appspot.com 这个网址进不去了是什么情况？
显示Still unable to dial persistent://kindlefere-feed.appspot.com:80 after 3 attempts

回复
- 书伴说道：
  
  2017年1月23日 17:27
  
  林大大您好。请问您是指您自己上传的无法访问，还是示例中的网址无法访问呢？
  
  回复
  - 林大大说道：
    
    2017年1月23日 22:43
    
    网址无法访问
    
    回复
    - 书伴说道：
      
      2017年1月24日 10:29
      
      示例网址是可以访问的。请问您翻墙了吗？这个在大陆是无法直接访问的。
      
      回复
nujiy说道：

2017年1月12日 22:26

常见问题（FAQ）打开是GitHub的代码。。

回复
- 书伴说道：
  
  2017年1月13日 11:03
  
  nujiy 您好。谢谢提醒，链接已修正，现在可以正常显示页面了。
  
  回复
R说道：

2017年1月5日 05:41

您好，从微广场上抓取的微信rss，通过KindleEar，发到Kindle上全部内容都是链接内容跳转，无法正常阅读，可否帮忙看一下，怎样才可以正常阅读。谢谢

回复
- R说道：
  
  2017年1月5日 10:45
  
  我有找到方法了，说是单独订阅即可。
  可否再问一个问题之前KindleEar是用方法一，自动上传方式搭建的，之后我想更新books里的py文件，该如何上传更新？我查到，windows可以直接使用uploder，那Mac系统改如何更新？非常感谢
  
  回复
  - 书伴说道：
    
    2017年1月5日 12:56
    
    R 您好。更新和新上传的步骤是一样的。
    
    回复
    - R说道：
      
      2017年1月5日 21:39
      
      您好，我是想自制一些py，改如何上传？是采用方法二吗？非常感谢
      
      回复
  - 春子说道：
    
    2017年1月16日 18:22
    
    你好，你是怎么解决的这个问题，单独订阅的意思是？能说的详细点吗？感激不尽。
    
    回复
    - r说道：
      
      2017年1月17日 02:10
      
      訂閱的時候，勾選isfulltext就好了
      
      回复
李峰说道：

2017年1月3日 14:38

最后的账户密码忘记了有办法修改吗？

回复
- 书伴说道：
  
  2017年1月4日 17:29
  
  李峰您好。请进入 GAE 后台的“数据存储”，左侧菜单选择“实体”，右边“种类”选择“KeUser”，就可以看到账户列表，您可以在这里修改。最简单的方法就是删掉记录，让程序重置一下 admin 账户即可。
  
  回复
iox说道：

2017年1月2日 14:10

使用文章中自动上传GAE的方法上传KE后,如何升级KE。
前两天上传的KE版本为1.23.2然而现在最新为1.23.3，我该如何升级。

回复
- 书伴说道：
  
  2017年1月2日 16:25
  
  iox 您好。和第一次上传的步骤一样，再次上传新版本，就可以更新了。
  
  回复
buster说道：

2017年1月1日 02:51

GAE显示免费后端实例小时配额已满怎么办？每天只有9小时配额，重置时间是太平洋时区0点，换算过来每天北京时间下午重置，夜里耗尽，早上就不能自动推送了？

回复
Ck说道：

2016年12月27日 10:08

测试账号无法登陆

回复
- 书伴说道：
  
  2016年12月27日 14:20
  
  Ck 您好。谢谢反馈，测试账号已修复。
  
  回复
龙说道：

2016年12月26日 17:07

左上角的菜单，在弹出的菜单中点击“APP 引擎（App Engine）”，然后再点击 APP 引擎页面左侧的“设置（settings）”。
在这一步中出现 “在您无权查看此项目中的 App 引擎应用。”怎么处理

回复
- 书伴说道：
  
  2016年12月26日 17:34
  
  龙您好。是否切换账号了？不同的帐户不能访问彼此的项目，有时候切换账号时会出现这种情况。
  
  回复
  - 龙说道：
    
    2016年12月26日 18:00
    
    您好，已经处理，还有一个疑问，如何保持在谷歌托管的程序与GitHub上的最新源码一致。如果无法自动更新源码，手动如何操作？麻烦伴侣哥了。
    
    回复
    - 书伴说道：
      
      2016年12月26日 23:07
      
      龙您好。手动更新源码就是重新再上传一次。自动更新源码应该是可以通过 Webhooks 实现，不过感觉没这个必要。
      
      回复
余澈说道：

2016年12月19日 21:53

kindleear搭建完成了，基本上文章中列出的能遇到的问题我都遇到了233但都解决了
进入kindleear也完成了设置输入了正确的kindle email地址
gmail地址也在亚马逊加入了认可列表
点击现在投递后过一会儿刷新投递日志显示结果状态ok
但是我的kindle却没有收到任何推送
打开亚马逊账号的管理我的内容下面查看等待发送为空查看个人文档也没有该推送
why……………………

回复
- 书伴说道：
  
  2016年12月20日 22:15
  
  余澈您好。推送完成后并不是立即就能收到推送的，如果您的设置都没有错误，还是需要等待一小段时间才能收到亚马逊服务器的推送。
  
  回复
ming说道：

2016年12月18日 13:59

一、准备工作
5、创建 Google App Engine 应用
方法一：点击页面左上角的 [ >_ ] 图标按钮，调出云端 Shell，

（没看到那个按钮，能麻烦下贴个图片说明一下吗？）

方法二：选择“Python”

（提示的“未能加载”）

卡到这一步骤了，请问怎么解决？

回复
- 书伴说道：
  
  2016年12月18日 17:10
  
  ming 您好。抱歉，这是一处错误，应该是“右上角”，已改正并添加了指示图片。
  
  回复
  - 美味酱肘子说道：
    
    2017年1月14日 12:43
    
    第一步没看到有shell这个图标
    第二步不知道哪里添加python貌似现在改版了，从这一步完全卡住
    
    回复
    - 书伴说道：
      
      2017年1月14日 19:48
      
      美味酱肘子您好。1、shell 图标就在右上角，请按照给出的图示仔细找一下；2、不需要添加什么 Python，步骤中也没有让您添加 Python。
      
      回复
余澈说道：

2016年12月17日 14:41

自动上传的部分：
请输入你的 Gmail 地址：yoiiu0304@gmail.com
您输入的 Gmail 地址是：’yoiiu0304@gmail.com’
请输入你的 APP ID：yoiiu940304
您输入的 Gmail 地址是：’yoiiu940304′
02:37 PM Host: appengine.google.com
02:37 PM Application: yoiiu940304; version: 1
02:37 PM Starting update of app: yoiiu940304, version: 1
02:37 PM Getting current resource limits.
02:37 PM Scanning files on local disk.
Error 404: — begin server output —
This application does not exist (project_id=u’yoiiu940304′). To create an App Engine application in this project, run “gcloud beta app create” in your console.
— end server output —
02:37 PM Application: yoiiu940304; version: 1
02:37 PM Host: appengine.google.com
02:37 PM Starting update of app: yoiiu940304, version: 1
02:37 PM Getting current resource limits.
02:37 PM Scanning files on local disk.
Error 404: — begin server output —
This application does not exist (project_id=u’yoiiu940304′). To create an App Engine application in this project, run “gcloud beta app create” in your console.
— end server output —
yoiiu0304@yoiiu940304:~$

之后访问http://yoiiu940304.appspot.com/这个地址显示404

回复
- 书伴说道：
  
  2016年12月17日 16:44
  
  余澈您好。这是因为 Google Cloud 更改了策略导致的，现已更新教程，请查看“准备工作”的第 5 部分。
  
  回复
Herry说道：

2016年12月14日 09:43

刚才看了下Google cloud platform上面写着，您的应用已达到或接近免费资源限额。您应该启用结算功能以避免服务中断。我昨天才弄的这个，这情况怎么处理，谢谢

回复
- 书伴说道：
  
  2016年12月14日 20:42
  
  请到 GAE 后台查看一下日志什么的，看看到底是哪一项超出了限额。
  
  回复
Herry说道：

2016年12月14日 08:53

推送的时候状态栏显示over quota，内容大小3.3M

回复
- 书伴说道：
  
  2016年12月14日 20:41
  
  Herry 您好。推送的频率高吗？
  
  回复

KindleEar 搭建教程：推送 RSS 订阅到 Kindle

一、准备工作

1、能够科(fan)学(qiang)上网

2、注册 Google/Gmail 账号

3、对 Google 账号进行安全设置

4、创建一个 Google Cloud 项目

5、为结算账户添加支付方式

6、创建 Google App Engine 应用

7、授权 GAE 用 Gmail 发信

二、上传应用

方法一：自动上传（强烈推荐！）

方法二：手动上传

1、安装 Python 2.7

2、安装 Google Cloud SDK

3、配置 Google Cloud SDK

4、下载 KindleEar 源码

5、配置 KindleEar 程序

6、上传 KindleEar 程序

三、访问应用

四、设置推送

1、添加订阅

2、设置推送

3、投递日志

4、账户管理

5、高级设置

6、网友分享

五、常见问题

1、访问页面提示 internal serve error

2、投递状态显示 wrong SRC_EMAIL

3、忘记 KindleEar 的登录密码怎么办

4、访问页面提示 500 Server Error

5、点手动推送显示 internal server error

六、其它事项

七、自制订阅

1、如何用 KindleEar 推送无 RSS 的网站内容（上篇）

2、如何用 KindleEar 推送无 RSS 的网站内容（中篇）

3、如何用 KindleEar 推送无 RSS 的网站内容（下篇）

“Kindle推送”相关阅读

给这篇文章写一条留言取消回复

小伙伴们写下了 805 条留言

一、准备工作

1、能够科(fan)学(qiang)上网

2、注册 Google/Gmail 账号

3、对 Google 账号进行安全设置

4、创建一个 Google Cloud 项目

5、为结算账户添加支付方式

6、创建 Google App Engine 应用

7、授权 GAE 用 Gmail 发信

二、上传应用

方法一：自动上传（强烈推荐！）

方法二：手动上传

1、安装 Python 2.7

2、安装 Google Cloud SDK

3、配置 Google Cloud SDK

4、下载 KindleEar 源码

5、配置 KindleEar 程序

6、上传 KindleEar 程序

三、访问应用

四、设置推送

1、添加订阅

2、设置推送

3、投递日志

4、账户管理

5、高级设置

6、网友分享

五、常见问题

1、访问页面提示 internal serve error

2、投递状态显示 wrong SRC_EMAIL

3、忘记 KindleEar 的登录密码怎么办

4、访问页面提示 500 Server Error

5、点手动推送显示 internal server error

六、其它事项

七、自制订阅

1、如何用 KindleEar 推送无 RSS 的网站内容（上篇）

2、如何用 KindleEar 推送无 RSS 的网站内容（中篇）

3、如何用 KindleEar 推送无 RSS 的网站内容（下篇）

“Kindle推送”相关阅读

给这篇文章写一条留言 取消回复

小伙伴们写下了 805 条留言

给这篇文章写一条留言取消回复