/http-win-notice

一个运行在Windows本机的服务,监听http接口请求触发windows消息通知

Primary LanguageJavaScriptMIT LicenseMIT

Logo

HTTP Windows消息通知

GitHub GitHub release (with filter) GitHub repo size GitHub Repo stars GitHub all releases GitHub last commit (branch)

一个运行在Windows本机的服务,监听http接口请求触发windows消息通知

功能

  • http接口请求
  • Windows 消息弹窗
  • 历史消息记录
  • 开机启动
  • 托盘控制
  • 端口配置
  • frp内网穿透集成
  • 公网调用

架构

  • 内网环境下,局域网内可通过内网ip+端口调用,如http://192.168.124.11:19000
  • 公网环境可选择开启(默认关闭),配置开启后公网内可通过frps所在服务器公网ip+映射端口调用,如http://123.123.1.2:19001,此时请求经过公网服务器的frps服务转发给本机的frpc,frpc再将请求转发给本地web服务从而触发消息通知。详情查看开启frp内网穿透

使用

  1. 直接下载编译后的exe文件
  2. 双击exe启动
  3. 右击托盘图标勾选开机启动
  4. 通知调用
    • 方式1

      浏览器输入链接http://127.0.0.1:19000/api/toast?msg=哈喽,我是新的消息通知

    • 方式2 (python调用示例)

      import requests
         
      title = "自定义通知标题"
      msg = "我是测试消息通知啦啦啦啦啦"
      res = requests.get(f"http://127.0.0.1:19000/api/toast?msg={msg}&title={title}")
      print(res.json())
  5. 可右击托盘图标,点击配置文件修改端口号
  6. 可打开web界面查看历史消息记录

效果

  • 程序运行

  • 调用http消息通知接口

  • 消息通知记录

开启frp内网穿透

  • 开启frp需要有一台带公网ip的服务器,配置并开启后可实现公网调用接口发送通知。

  • 客户端内已集成了frpc(v0.51.3)

服务端配置

  1. 下载frps,选择对应服务器版本即可。下载地址
  2. 修改frps.ini配置文件,配置参考:
  • frps.ini
[common]
bind_port = 7000
token = httpwinnotice123456
  1. 启动服务端:
chmod +x ./frps
./frps -c frps.ini

客户端配置

  1. 右击托盘图标选择配置文件,修改配置文件内frp相关内容并保存。参考配置如下:
frp:
    enable: 1
    server_addr: 123.123.1.2
    server_port: 7000
    token: httpwinnotice123456
    remote_port: 19001

配置的各项解释如下:

  • enable: 1-开启frp,0-关闭frp
  • server_addr: 部署frps服务器的公网ip
  • server_port: frps服务端口号
  • token: 与服务器端配置token一致,建议将默认值修改
  • remote_port: 转发的远端端口号

注意服务器防火墙放开对应的端口号,以上示例配置在公网调用时使用http://123.123.1.2:19001/api/toast

配置好后重启程序即可

测试

浏览器打开http://123.123.1.2:19001/api/toast?msg=哈喽 如果windows通知出现证明开启成功(ip和端口号替换为自己的)