project: apnsagent
license: BSD
auth : jeffkit
apnsagent为多个iOS 应用提供集中式的推送服务，她有以下特点：
- 接入简单，可以同时服务于多个App
- 无缝支持开发和生产模式的推送
- 重用TCP连接，同时使用队列的异步发送，API调用效率高
- 自动忽略失效的Token
apnsagent的程序包括：
- 服务程序，它部署在你的Server上，仅运行一个实例，同时服务于多个应用
- WebServer监控服务器，用一个http后台查看系统运行状态
- 客户端API，应用的后端程序用来请求服务程序发送推送消息
服务程序配置及运行：
- 安装并运行redis，使用常规安装可快速开始。
- 首先，你需要有一个目录用于保存推送的证书和密钥(如何获取app的推送证书与密钥请参考apple的文档)，目录结构如下：
- apps
- com.toraysoft.yiqi # 某个应用文件夹，以id命名
- production # 生产环境证书
- cer.pem # 证书
- key.pem # 密钥，要求去掉passparse的
- develop # 开发环境证书，下同
- cer.pem - key.pem
- 安装apnsagent:
cd $apnsagent-home
python setup.py install (或使用pip安装)
- 运行服务
apnsagent-server.py config [options]
- config 服务器配置文件，下面是一个Sample，看一下就明白
[app]
app_dir = /Users/jeff/local/apps/
[redis]
host = 127.0.0.1
port = 6379
db = 0
password = ''
使用apnsagent-server.py -h 获得更多帮助。
客户端API使用示例：
from apnsagent.client import PushClient
client = PushClient(app_key) # 初始化一个推送客户端。
client.register_token(token,develop=True) # 可选，注册一个Token，不注册默认发到生产队列当中。
client.push(token,alert,badge,sound,custom) # 发送一条推送消息。
工程依赖
- PyAPNs 使用此版本:https://github.com/jeffkit/apnsagent
- redis-py
- simplejson
- flask (for 嵌入式监控web)
监控服务：
系统运行后，可以打开本地的5555端口，查看系统的运行状态：
- /login 登录界面，输入用户名和密码登录，用户名和密码在constants.py中配置，默认为用户名apns，密码12345
- /list 查看各个应用的运行情况
- /detail/<who> <who>为应用的app_key，可以查看该应用的无效token