justsong/message-pusher

镜像概述

该Docker镜像用于搭建个人微信消息推送服务，提供便捷的消息推送能力，支持Markdown格式消息，可同时发送邮件消息，并支持直接部署在Heroku平台，无需用户自备服务器，降低部署与维护门槛。

核心功能特性

• 微信消息推送：支持向个人微信账号推送自定义消息，实现即时通知
• Markdown格式支持：消息内容可使用Markdown语法，支持标题、列表、链接等格式，提升消息可读性
• 邮件消息发送：除微信外，支持同步或单独发送邮件消息，满足多渠道通知需求
• Heroku部署支持：适配Heroku云平台，可直接部署运行，无需管理服务器硬件及基础环境
• 轻量化设计：无需复杂前置配置，通过简单参数即可快速启动服务

使用场景

• 个人通知中心：接收各类个人日程提醒、待办事项、重要日期通知等
• 系统监控告警：服务器状态、应用程序异常、日志告警等信息实时推送
• 信息同步工具：将新闻摘要、数据报告、学习资料等内容同步推送至微信/邮件
• 自动化工作流集成：配合GitHub Actions、定时任务等工具，实现事件触发式消息推送

使用方法

Docker 快速启动

通过以下命令启动容器，需替换示例中的环境变量值：

bash
docker run -d \
  --name wechat-push-service \
  -e WECHAT_TOKEN="your_wechat_api_token" \
  -e EMAIL_SMTP="smtp.example.com" \
  -e EMAIL_PORT=587 \
  -e EMAIL_USER="your_email@example.com" \
  -e EMAIL_PASSWORD="your_email_app_password" \
  -p 8080:8080 \
  [镜像名称]:latest

环境变量配置说明

部署到 Heroku 平台

1. 准备部署文件
   创建Procfile文件（无扩展名），内容如下：

   web: docker run -p $PORT:8080 [镜像名称]:latest
   

2. 配置环境变量
   在Heroku应用控制台的「Settings」→「Config Vars」中添加所需环境变量（参考上文环境变量说明）。

3. 部署方式

   • 通过Heroku CLI：

     bash
     heroku create your-app-name
     git add . && git commit -m "Initial commit"
     git push heroku main
     

   • 通过GitHub集成：
     在Heroku应用中关联GitHub仓库，开启「Automatic deploys」，实现代码提交后自动部署。

注意事项

• 微信推送功能需提前在对应微信开放平台完成账号注册及API配置，获取有效的WECHAT_TOKEN
• 邮件发送功能需确保已开启SMTP服务，部分（如QQ***、Gmail）需使用单独的应用授权码而非登录密码
• Heroku免费方案存在资源限制（如休眠时间、流量配额），高频推送场景建议选择付费方案
• 服务启动后，可通过访问http://localhost:8080（本地部署）或Heroku分配的应用域名进行接口调试与使用