message-pusher

消息推送服务

描述

1. 利用微信公众号测试号来给自己的微信推送消息。
2. 也可推送邮件消息，在微信中开启 QQ 邮件提醒后，也可以达到同样效果。
3. 支持 Markdown。
4. 可以使用 Heroku 的免费服务器，详见此处。

用途举例

1. 整合进自己的博客系统，每当有人登录时发微信消息提醒。
2. 在进行深度学习模型训练时，在每个 epoch 结束后将关键数据发送到微信以方便及时监控。
3. 在各种脚本运行结束后发消息提醒，例如监控 Github Star 数量的脚本。

在自己的服务器上的部署步骤

域名设置

先去你的云服务提供商那里添加一个子域名，解析到你的目标服务器。

服务器端配置

1. 配置 Node.js 环境，推荐使用 nvm。
2. 下载代码：git clone https://github.com/songquanpeng/message-pusher.git。
3. 修改根目录下的 config.js 文件：
   • （可选）可以修改监听的端口
   • （可选）配置是否选择开放注册
   • （必选）修改 href 字段，如 https://pusher.yourdomain.com/，注意后面要加 /，如果不修改此项，推送消息的详情页面将无法打开。
4. 安装依赖：npm i。
5. 安装 pm2：npm i -g pm2。
6. 使用 pm2 启动服务：pm2 start ./app.js --name message-pusher。
7. 使用 Nginx 反代我们的 Node.js 服务，默认端口 3000（你可以在 config.js 中进行修改）。
   1. 修改应用根目录下的 nginx.conf 中的域名以及端口号，并创建软链接：sudo ln -s /path/to/nginx.conf /etc/nginx/sites-enabled/message-pusher.conf ，注意修改这里的 /path/to/nginx.conf，且必须是绝对路径，当然如果不想创建软链接的话也可以直接将配置文件拷贝过去：sudo mv ./nginx.conf /etc/nginx/sites-enabled/message-pusher.conf。
   2. 之后使用 certbot 申请证书：sudo certbot --nginx。
   3. 重启 Nginx 服务：sudo service nginx restart。

微信公众平台端配置

1. 首先前往此页面拿到 APP_ID 以及 APP_SECRET。
2. 使用微信扫描下方的测试号二维码，拿到你的 OPEN_ID。
3. 新增模板消息模板，模板标题随意，模板内容填 {{text.DATA}}，提交后可以拿到 TEMPLATE_ID。
4. 填写接口配置信息，URL 填 https://你的域名/前缀/verify，TOKEN 随意，先不要点击验证。（前缀默认和用户名相同）
5. 现在访问 https://你的域名/，默认用户为 admin，默认密码为 123456，登录后根据系统提示完成配置，之后点击提交按钮。
6. 之后回到微信公众平台测试号的配置页面，点击验证。

验证是否配置成功

访问 https://你的域名/前缀/Hi，如果你的微信能够收到一条内容为 Hi 的模板消息，则配置成功。

在 Heroku 上的搭建步骤

在此之前，请先读一下“在自己的服务器上的部署步骤”这一节。 由于 Heroku 的限制，当 30 分钟内没有请求的话就会被冻结，之后再次启动时数据就丢了，因此这里我们采用配置环境变量的方式进行配置。

手动部署

1. Fork 本项目。
2. 在此处新建一个 Heroku APP，名字随意，之后可以设置自己的域名。
3. 在 Deployment method 处，选择 Connect to Github，输入 message-pusher 搜索本项目，之后点击 Connect，之后启用自动部署（Enable Automatic Deploys）。
4. 点击上方的 Setting 标签，找到下面的 Config Vars 配置环境变量，有以下环境变量需要配置。

KEY	VALUE
MODE	1（Heroku 模式）
WECHAT_APP_ID	你的测试号的 APP ID
WECHAT_APP_SECRET	你的测试号的 APP Secret
WECHAT_TEMPLATE_ID	你的测试号的模板消息的 ID
WECHAT_OPEN_ID	你的 Open ID
WECHAT_VERIFY_TOKEN	你自己设置的验证 token
EMAIL	你的默认目标邮箱
PREFIX	你的前缀，如 admin
SMTP_SERVER	smtp 服务器地址，如 smtp.qq.com
SMTP_USER	smtp 服务器用户邮箱
SMTP_PASS	smtp 服务器用户凭据
HREF	服务的 href，如 https://wechat-message.herokuapp.com/ ，注意后面要有 /

一键部署

发送消息的方式

1. 发送纯文本消息：直接 HTTP GET 请求 https://你的域名/前缀/消息，缺点是有字数限制，且只能是纯文本，这是微信模板消息的限制。
2. 发送 Markdown 消息，调用方式分为两种：
   • GET 请求方式：https://你的域名/前缀/?type=0&title=消息标题&description=简短的消息描述&content=markdown格式的消息内容&[email protected]
   • POST 请求方式：请求路径为 https://你的域名/前缀/，参数有：
     1. type：（可选）消息类型，默认为 0
        • 0：通过微信公众号测试号推送
        • 1：通过发送邮件的方式进行推送
     2. title：（可选）消息的标题
     3. description：（必填）消息的描述
     4. content：（可选）消息内容，支持 Markdown
     5. email：（可选）当该项不为空时，将强制覆盖 type 参数，强制消息类型为邮件消息，收件邮箱即此处指定的邮箱。如果 type 为 1 且 email 参数为空，则邮件将发送至用户设置的默认邮箱。

待做清单

• 支持多用户。
• 完善的用户管理。
• 支持 Markdown。
• 支持推送消息到邮箱。
• 支持在 Heroku 上部署
• 更加便于部署的 Go 语言的版本。
• 适配企业微信应用。
• 提供常见语言的调用示例。

敬请期待。