Skip to content

配置说明

PostForwarder 的配置界面分为两个主要区域:服务配置卡片和运行日志卡片。

服务配置

监听端口

属性
默认值1403
取值范围1 - 65535
说明HTTP 服务监听的端口号

手机端通过 http://<电脑IP>:<端口> 发送请求。如果默认端口被占用,可以修改为其他可用端口。

防火墙

修改端口后,请确保 Windows 防火墙放行该端口,否则手机端无法访问。

允许来源 IP 白名单

属性
格式每行一个 IP 地址
空值行为留空 = 全部禁止
说明仅允许白名单内的 IP 发送请求

示例:

192.168.1.100
192.168.1.101
  • 每行填写一个 IP 地址
  • 空行和重复 IP 会被自动忽略
  • 留空时所有请求都会被拒绝(返回 403 Forbidden)

转发目标

属性
目标地址http://127.0.0.1:47300/api/activities
是否可修改否(硬编码)

所有接收到的有效请求都会被转发到这个固定的目标地址。手机端请求的路径会被忽略,统一转发到该目标路径。

手机端配置

SMSForwarder 下载链接

通用设置

打开转发应用通知按钮,并选择自动消除通知选项

打开启动时异步获取已安装App列表,并选择用户应用选项

打开开机启动、忽略电池优化设置、在最近列表中隐藏、启用Cactus增强保活措施(会增加耗电)按钮,并可以选择后台播放无声音乐

其他的按需打开

发送通道

点击右上角加号添加Webhook通道类型

选择POST请求方式

在Webhook Server里配置网址http://<电脑IP>:<端口(默认为1403)>/

设置一个通道名称并点击保存

转发规则

应用

点击右上角加号添加转发规则

点击发送通道右边的倒三角并选择刚刚添加的发送通道

匹配字段改为APP包名

匹配模式改为是

匹配的值可以在已装APP列表选择微信或直接复制微信包名:com.tencent.mm

打开启用自定义模板并在下面的输入框中复制以下JSON代码

{"id": "{{PACKAGE_NAME}}", "title": "{{TITLE}}", "subtitle": "{{MSG}}", "kind": "{{APP_NAME}}", "icon": "https://s1.aigei.com/src/img/png/6f/6f4cf83ced6049f386d172aa523fae63.png?imageMogr2/auto-orient/thumbnail/!282x282r/gravity/Center/crop/282x282/quality/85/%7CimageView2/2/w/282&e=2051020800&token=P7S2Xpzfz11vAkASLTkfHN7Fw-oOZBecqeJaxypL:ZJLDaOpWrc7iSRIFFF2KTTWrtoc=", "show_progress": 0, "ttl_ms": 3000}

以上JSON内容可以修改的仅有icon、show_progress和ttl_ms

icon可以在网上找任意一个(微信)图标复制链接放进去

show_progress只有两个值,分别是0和1。填入“0”时NSDPRO触发消息时灵动岛不会显示进度条,填入“1”时会显示。请自行选择

ttl_ms是触发消息后消息显示/持续的时间,如果去掉ttl_ms将会永久持续,需要修改的话直接修改数值即可,单位为ms(毫秒)。

配置完后即可点击保存,此时手机端已经配置完成

启动/停止服务

  • 点击「启动服务」按钮开始监听
  • 服务运行中按钮变为「停止服务」,点击可停止
  • 服务运行时,端口和白名单输入框会被禁用,需停止后才能修改

状态指示

配置界面右下角的状态徽章显示当前服务状态:

  • 🔴 未运行 — 服务未启动
  • 🟢 运行中 — 服务正在监听

系统托盘

程序支持最小化到系统托盘后台运行:

操作效果
关闭窗口最小化到托盘,服务继续运行
双击托盘图标打开配置界面
右键托盘图标显示菜单:打开配置界面 / 退出程序

退出程序

通过托盘菜单的「退出程序」才能完全关闭应用。直接关闭窗口只是最小化到托盘。

运行日志

日志区域实时显示服务的运行信息,包含四种级别:

级别颜色说明
INFO灰色一般信息,如服务启动、收到请求
OK绿色成功操作,如转发成功
WARN橙色警告,如 IP 不在白名单、解析失败
ERROR红色错误,如服务启动失败、转发失败

每条日志格式为:[时间] [级别] 消息内容

点击「清空」按钮可清除所有日志。日志最多保留 2000 条,超出后会自动删除最早的 200 条。

配置持久化

配置信息保存在 Windows 注册表中,不产生配置文件:

  • 注册表路径:HKCU\Software\NSDPRO\PostForwarder
  • 保存时机:启动服务时、退出程序时
  • 保存内容:监听端口、IP 白名单

基于 VitePress 构建