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

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

▲ KindleEar 推送 RSS 的效果

KindleEar 目前的功能有：

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

下面这个是体验账号，可以添加一个 RSS 测试推送一下（需要把邮箱账号 kindlefere@gmail.com 添加到 Kindle 的推送信任列表），但请不要正式使用。测试时，请不要更改测试账号密码影响其他人测试。

体验测试账号：http://kindlefere-feed.appspot.com （用户名：test，密码：123456）

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

目录
一、准备工作
 二、上传程序
 方法一：自动上传
 方法二：手动上传
 三、设置推送
 四、常见问题
 五、其它事项

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

一、准备工作

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

1、下载科(fan)学(qiang)上网软件

因为在国内无法访问 Google 服务，所以需要借助科学上网软件实现访问。你可以使用你所习惯使用的或下面为你推荐的任意一款软件。为保证正常下载，请复制链接使用迅雷下载。

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

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

2、注册 Google 账号

点击下面的链接，注册一枚带 @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 也就是我们后面提到的 APPID。默认情况下，系统会根据你输入的项目名称自动生成项目 ID，但是自动生成字符没有意义，为了方便记忆最好是自定义。点击项目 ID 后面的【修改】按钮，将其修改成你喜欢的字符串组合。这样等 KindleEar 部署成功后，你就可以通过 http://APPID.appspot.com 访问了（注意把 APPID 换成你真实的 APPID）。

5、创建 Google App Engine 应用

Google Cloud 创建完成后需要继续创建一个 GAE 应用，否则直接上传会出现下面这样的错误提示：

Error 404: --- begin server output ---
This application does not exist (project_id=u'sample-appid'). To create an App Engine application in this project, run "gcloud beta app create" in your console.
--- end server output ---

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

方法一：上面那个错误提示给出了解决方案，直接在云端 Shell 中使用一行命令就能搞定。具体步骤为：点击页面右上角的 [ >_ ] 图标按钮（如下图所示），调出云端 Shell，输入以下命令按回车：

gcloud beta app create

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

方法二：点击 Google Cloud 页面左上角的菜单按钮，点击弹出菜单中的“App Engine”。在“您的第一个应用”那里点击“选择一种语言”，选择“Python”。接下来“选择位置”中页面中选择“us-central”，最后点击下一步就等待它自动部署，只到出现“让我们开始吧”的字样，就表示 GAE 应用创建成功。

二、上传程序

下面提供了两种上传 KindleEar 程序到 GAE 的方法。方法一是通过 Google 云端 Shell 的方式进行上传，使用 Kindle 伴侣提供的 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/kindlefere/KindleEar-Uploader/master/uploader.sh && \
chmod +x uploader.sh && \
./uploader.sh

4、按照脚本的提示，输入你的 Gmail 地址和准备好的 APPID，回车，等待上传成功即可。

注意，上面的代码只需要执行一次即可，如果想要重新上传或要更新代码，只需要直接运行 uploader.sh 这个 Shell 文件即可，即在云终端中输入下面这行代码即可：

./uploader.sh

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

方法二：手动上传

在开始手动上传部署 KindleEar 步骤之前，你需要保证已完成下面提到的准备工作。对于每一项准备工作，如果你已经具备条件，可忽略继续进行下一项。

[ 展开步骤 ]

1、下载并安装 Python 2.7

Mac OS X 系统可略过此步骤。为保证正常下载，请复制下面的链接使用迅雷下载。

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

2、下载并安装 GAE SDK for Python

为保证正常下载，请复制下面的链接使用迅雷下载。

GAE SDK for Python 下载：Windows ｜Mac OS X ｜ Linux ｜官方页面

3、安装配置 SocksiPy

SocksiPy 下载：下载链接｜官方页面

Mac OS X 无需下载此文件，打开“终端”输入以下命令安装 SocksiPy：

sudo pip install PySocks

*注意，如果提示找不到 pip 命令，请先下载 get-pip.py，然后运行 python get-pip.py 安装 pip。

在 Windows 中，将下载到的 SocksiPy 压缩包解压缩得到文件 socks.py，把这个文件拷贝到 GAE SDK for Python 安装目录，如果你是没有修改安装路径，默认情况下其路径如下所示：

C:\Program Files (x86)\Google\google_appengine

4、为 GAE SDK 配置代理

在 Windows 中，进入 GAE SDK for Python 安装目录，找到文件 appcfg.py，通过右键菜单“Edit with IDLE”，或使用代码编辑软件（如 Sublime Text）将其打开。

在 Mac OS X 中，进入“应用程序”目录，找到并右键点击 GoogleAppEngineLauncher 应用，在弹出的菜单中点击“显示包内内容”，在下面所示的路径中找到 appcfg.py，使用代码编辑器打开。

Contents/Resources/GoogleAppEngine-default.bundle/Contents/Resources/google_appengine/

找到下面这行代码：

"""Convenience wrapper for starting an appengine tool."""

在它上面添加下列代码：

import socks
import socket
socket.socket = socks.socksocket
socks.setdefaultproxy(socks.PROXY_TYPE_SOCKS5, "127.0.0.1", 8788)

注意，如果你使用的是 ShadowSocks，请把上面代码中的端口 8788 修改为 1080。

修改完毕后保存。

5、下载 KindleEar 源码

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

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

6、配置 KindleEar 程序

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

Windows 系统中，将其放到了 C 盘根目录，路径为：

C:\kindleear

Mac OS X 系统中，将其放到了用户目录下，路径为：

/Users/YOURNAME/Applications/kindleear

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

要修改的文件	要修改的内容	内容修改说明
app.yaml	`application: xxx`	红色部分修改为你创建的 APPID
module-worker.yaml	`application: xxx`	红色部分修改为你创建的 APPID
config.py	`SRC_EMAIL = "xxx@gmail.com"`	红色部分修改为你创建应用的 Gmail 邮箱
config.py	`DOMAIN = "https://xxx.appspot.com`“	红色部分修改为你创建的 APPID

7、上传 KindleEar 程序

快捷键 Win + R 调出“运行”对话框，输入“CMD”回车打开命令提示符，然后使用 cd 命令进入 GAE SDK for Python 安装目录。

在 Windows 系统中，如果你是没有修改安装路径，应该是输入以下命令（小窍门：输入 cd 后，把 google_appengine 文件夹拖到命令提示符上）：

cd C:\Program Files (x86)\Google\google_appengine

分别输入下面两条命令将 KindleEar 上传到 GAE：

C:\python27\python.exe appcfg.py update C:\kindleear\app.yaml C:\kindleear\module-worker.yaml
C:\python27\python.exe appcfg.py update C:\kindleear

在 MAC OS 系统中，打开“终端”，分别输入下面两条命令上传 KindleEar：

appcfg.py update ~/Applications/kindleear/app.yaml ~/Applications/kindleear/module-worker.yaml
appcfg.py update ~/Applications/kindleear

出现“Email”提示，输入你的 Gmail 邮箱地址，回车；出现“Password for xxx@gmail.com”，输入你的 Gmail 邮箱密码（密码输入时不显示），回车。

等待上传。在上传的过程中，如果第一次上传，会出现一个许可验证消息，如果是同一个电脑，直接打开链接验证即可。如果是不同的电脑，需要添加参数 --noauth_local_webserver，打开链接获取验证码，填写验证。

注意，--noauth_local_webserver 后缀是添加到 appcfg.py 后面，如下所示：

python appcfg.py --noauth_local_webserver ...

三、设置推送

打开浏览器输入：http://你的APPID.appspot.com，默认的登录名和密码都是“admin”（建议修改密码），进入推送控制台你会发现以下几个选项卡（若登录时候出现类似“internal serve error”请不要慌，只需要多等候一些时间重试即可），可以根据自己的需要进行设置：

1、我的订阅

可以在这里添加你自己的 RSS 地址。也可以在下方预置的一些订阅里选择自己感兴趣的。

在添加自定义 RSS 地址的时候请注意。KindleEar 仅支持 RSS/ATOM 格式的订阅（XML 格式），如果遇到添加的自定义 RSS 无法成功推送，请留意是否是格式错误导致的。比如有些 FeedBurner 烧制的 RSS 默认是 HTML 格式（可以通过查看源代码辨别），直接添加这种 RSS 地址不能成功推送，需要在添加的 RSS 地址后面添加一个参数 ?format=xml 或 ?fmt=xml 才行。

2、设置

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

3、投递日志

每次投递的记录。

4、账户管理

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

5、高级设置

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

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

四、常见问题

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

1、登录出现 Invalid username or password

如果确认输入的账号密码正确却仍然出现“Invalid username or password.”，请点击这里检查一下相关选项。首先找到“允许不够安全的应用”这个选项，确认是“已启用”状态。然后查看下账号登录是否被 Google 拦截，把可疑操作确认是自己操作，然后重新运行 uploader.bat 走一遍过程。如果取消拦截后还是出现“Invalid username or password.”这样的提示，请先使用浏览器登陆你的 Google 账号，看是否会有短信验证等提示，登录成功后重新运行 uploader.bat 走一遍过程。

2、无法为其它 Google 账号上传程序

当为一个 Google 账号下的 GAE 上传 KindleEar后，程序会自动记录登陆邮箱密码，这样使用其它账号就无法上传了。想要切换帐号，Windows 系统请前往目录“C:\用户\你的用户名\”下删除“.appcfg_cookies”，然后重新运行 uploader.bat。Mac 或 Linux 系统遇到同样问题，使用命令 rm ~/.appcfg_oauth2_tokens 删除。

3、访问页面提示 internal serve error

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

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

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

$ python appcfg.py update_indexes ./

注意，如果使用的是 Google 云端 Shell 直接使用 appcfg.py 命令即可：

$ appcfg.py update_indexes ./

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

4、投递状态显示 wrong SRC_EMAIL

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

首先点击下面的网址进入 GAE 应用设置（将其中的 APPID 换成你真实的 APPID）：

https://console.cloud.google.com/appengine/settings?project=APPID

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

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

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

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

五、其它事项

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

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

另外，如果你觉得 KindleEar 这款软件还不错，可以点击这里捐赠一下作者 cdhigh。

发表评论取消回复

小伙伴们发表了 598 条评论

alden说道：
2019年2月10日 22:13
配置成功可以正常推送，以后还需要定时登录google么？会不会一段时间后就不能用了，比如说试Google服务器的试用到期了？
回复
- 书伴说道：
  2019年2月11日 09:29
  你说的“试用”是针对 Computer Engine（GCE）而言的，KindleEar 使用的是另外一个产品模块 App Engine（GAE），这个是有免费配额的，只要使用的资源没有超过免费配额就一直是免费的。配额每 24 小时重置一次，如果应用使用的资源超过了配额就会自动停止服务，需要等到配额重置后才能再次继续使用。配额的使用详情可以通过 GAE 菜单中的“配额”查看。
  回复
le说道：
2019年1月26日 22:12
为什么显示nonews?设置没有错。
回复
- 书伴说道：
  2019年1月26日 22:30
  nonews 是指你添加的 RSS 源在你设置的那个时间段内没有新内容。
  回复
  - le说道：
    2019年1月27日 07:51
    可以详解吗?我设置的没有时间限制，而且肯定更新了，推送到kimdle角接收不到，我加了白名单。急急急！
    回复
    - 书伴说道：
      2019年1月28日 14:25
      日志中推送记录显示 nonews 是指 KindleEar 没有监测到更新内容，所以不会推送任何内容。你的 Kindle 肯定不会收到内容，因为压根没有推送。
      这个问题最好通过对比测试来排查，看是不是 RSS 源自身的问题。建议添加几个其它 RSS 源，然后在“设置”中点击“现在投递”来测试，看看是否能在“不限制”最旧文章的条件下推送成功。
      回复
      - le说道：
        2019年1月29日 12:41
        不是RSS源的问题，rss源自身很好。
        回复
        Jason Le说道：
        2019年1月29日 13:44
        现在显示send failed，为什么？
        回复
        书伴说道：
        2019年1月29日 14:39
        send failed 看不出问题所在，你需要查看 GAE 的日志，找到更详细的错误信息进行排查。
        回复
陈晓说道：
2019年1月10日 16:40
为什么按常见问题第四条成功添加了gmail，但手动推送后仍显示Wrong SRC email？
回复
- 书伴说道：
  2019年1月10日 18:43
  建议再检查一下是否确认成功保存。
  回复
额额额说道：
2019年1月8日 00:46
已缓存软件到手机，谢谢🌝
回复