Light House使用手册
Light House是一款帮你自动接收和处理外部通知的工具。你可以把它理解为一个"智能中转站"：当外部平台（比如支付平台、代码仓库、监控软件）给你发送通知时，Light House能按照你设定的规则，自动把这些通知转发到你指定的地方（比如钉钉群、企业微信、你自己的服务器接口），或者自动发送邮件提醒。
一句话概括：外面平台给你发消息 → Light House 接收 → 按你的规则自动处理 → 通知到你想要的地方。
安全声明：Light House 不是 SaaS 平台，不会将您的业务数据上传到任何第三方服务器。考虑到数据安全性，您需要将其部署在自己的服务器上，所有 Hook 配置、任务记录和日志均存储在您自己的数据库中，数据完全由您掌控。
这款工具适合谁用？
独立开发者
你需要处理多个平台发来的回调通知，但不想搭建复杂的服务器程序。Light House 帮你一键搞定接收和转发。
微型电商 / 个人卖家
你使用支付宝、PayPal 等收款，需要实时知道客户有没有付款成功，并自动更新订单状态。
运维 / 技术支持
你需要把服务器告警、代码提交提醒等消息，实时推送到钉钉、飞书或 Slack，确保第一时间响应。
初创公司 / 小团队
你们没有专门的运维开发人员，但需要把各平台的通知串起来。Light House 免费、轻量、自托管，省去了购买昂贵 SaaS 工具的成本。
社群运营 / 自媒体
你想把不同平台的消息（比如新订单、新粉丝、新评论）自动汇总到同一个群里，避免频繁切换 App 漏掉重要信息。
系统集成爱好者
你喜欢把各种工具串在一起玩自动化，比如代码提交后自动发推文、表单提交后自动发邮件。Light House 是你的免费"胶水"。
高校学生 / 学习者
你正在学习编程或做毕业设计，需要一个真实的 Webhook 接收端来测试自己的项目。Light House 自带可视化界面，调试起来很方便。
注重数据隐私的用户
你不希望把核心业务数据（如支付信息、客户资料）交给第三方 SaaS 平台。Light House 部署在你自己的服务器上，数据完全由你掌控。
数据分析师 / 产品经理
你需要把各平台的数据变动（新订单、新用户注册、异常事件）自动汇总到一张表或一个群里，方便实时跟踪业务动态。
三大典型使用场景
收款到账自动通知
客户通过支付宝或微信付款后，支付平台会自动给你发一条"到账通知"。Light House 收到这条通知后，可以自动帮你：推送到钉钉群提醒发货、调用你的后台接口更新订单为"已付款"、或者发送邮件通知相关人员。
服务器告警实时转发
当你的服务器出现故障（比如 CPU 飙高、磁盘满了）时，监控平台会发告警。Light House 可以把这些告警实时转发到钉钉、飞书或邮件，让团队成员第一时间收到消息。
多平台消息自动同步
比如你在 GitHub 上提交了代码，想让团队群里自动收到提醒；或者电商平台来了新订单，想自动通知仓库系统。Light House 可以作为中间桥梁，让不同平台之间自动互通消息。
快速开始（3 步上手）
使用 Light House 非常简单，只需要三步就能跑通第一个自动化流程。
创建一个"接收地址"
进入左侧菜单的"Hook管理"页面，点击"创建Hook"按钮，填写一个名称（比如"支付宝收款通知"），保存后系统会给你一个专属的接收地址。把这个地址复制到支付平台的后台配置里即可。
设置触发规则
进入"触发配置"页面，选择你刚才创建的Hook，填写触发条件（系统提供了常用示例，可以直接复制），然后添加你要自动执行的动作，比如"发送钉钉消息"或"调用我的接口"。
查看执行结果
当外部平台发送通知到你的接收地址后，Light House 会自动按照你设定的规则处理。你可以在"任务记录"页面查看每一次处理的结果（成功还是失败），也可以在"实时日志"页面像看监控录像一样实时观察所有动态。
如何创建和管理接收地址？
"接收地址"是 Light House 最核心的概念。你可以把它理解为你的"门牌号"——外部平台需要知道这个地址，才能把通知准确送达。
创建步骤
- 点击左侧菜单的"Hook管理"，进入列表页。
- 点击右上角的"创建Hook"按钮。
- 填写名称（建议用你能看懂的名字，比如"PayPal到账通知"）。
- 选择触发类型：当前版本请选"接口触发"（表示外部平台通过接口发送通知）。手动触发、定时触发等功能将在后续版本推出。
- 签名密钥是可选的。如果你担心有人冒充平台给你发假通知，可以填一个密钥用于验证。不懂的话可以留空，后续再补。
- 点击"创建"，系统会生成一个专属的接收地址，格式类似：
/webhook/receive/abc123
小贴士：创建后记得点击地址旁边的复制按钮，把完整地址粘贴到外部平台的 webhook 配置页面里。每个 Hook 的地址都是唯一的，不要泄露给不信任的人。
管理已有地址
- 启用/禁用：点击状态标签可以快速开关。禁用后，外部平台发来的通知会被拒绝。
- 编辑：只能修改名称和描述，接收地址和 ID 是系统生成的，不能修改。
- 删除：删除时会同时清理关联的触发规则和任务记录，请谨慎操作。
如何设置触发规则？
触发规则决定了"收到通知后做什么"。你可以设置条件判断，也可以设置多个自动执行的动作。
第一步：选择 Hook
在"触发配置"页面，从下拉框中选择你要配置的接收地址。如果某个地址已经配置过规则，系统会自动加载之前的配置，方便你修改。
第二步：填写触发条件
触发条件就是"什么情况下才执行动作"。系统内置了几个常用示例，点击即可自动填入：
第三步：添加执行动作
触发条件满足后，系统会自动执行你配置的动作。目前支持三种类型：
向指定的网址发送请求，常用于调用你自己的后台接口，比如钉钉机器人、企业微信、你自己的服务器等。
通过 SMTP 发送邮件通知，适合告警场景或发送重要提醒。
自动写入需要记录的数据表，适合用户下单自动录入数据场景
更多功能开发中：用户下单微信通知、数据导出等功能将在后续版本推出，敬请期待。
最多可同时配置 5 个动作，系统会并行执行，互不等待。
如何查看任务执行记录？
每一次外部平台发来通知，Light House 都会生成一条"任务"。你可以随时查看这些任务的执行结果，排查问题。
任务列表页
进入左侧菜单的"任务记录"页面，你会看到所有任务的列表。列表上方有筛选工具，可以按状态（成功/失败/执行中）、Hook 名称、时间范围来查找。
任务详情页
点击列表中的任务 ID，可以进入详情页。详情页会展示：
- 基本信息：任务 ID、对应的 Hook 名称、触发时间、结束时间、总耗时。
- 动作执行日志：每个动作的执行结果。如果失败了，这里会显示红色的错误信息，方便你排查。
- 原始通知内容：外部平台发过来的完整通知数据，可以点击"展开"查看。
如何查看实时监控？
Light House 提供了仪表盘和实时日志两个监控工具，让你随时掌握系统运行状态。
仪表盘
打开首页（仪表盘），你可以看到以下核心数据：
- 当前活跃连接数：系统正在处理的连接数量。
- 当前执行任务数：正在执行中的任务数量。
- 今日成功率：今天所有任务中执行成功的比例。
- 趋势图：连接数变化趋势、成功率变化趋势。
- 耗时排行：今天执行时间最长的前 5 个任务。
实时日志
进入"实时日志"页面，你会看到一个类似监控台的界面，日志像流水一样实时滚动显示。每条日志包含时间、级别和具体内容。
- 绿色日志：普通运行信息。
- 红色日志：错误信息，需要关注。
- 黄色日志：警告信息，可能是临时异常。
页面顶部可以按 Hook 名称筛选，只看某个接收地址相关的日志。点击"清空"按钮可以清空当前屏幕上的日志（不会删除历史记录）。
典型场景完整教程
收款到账后自动通知发货
假设你有一个小型网店，使用支付宝收款，希望客户付款后自动在钉钉群里通知客服发货。
在"Hook管理"创建一个名为"支付宝收款通知"的 Hook，复制接收地址。
登录支付宝开放平台，在 webhook 配置里粘贴刚才复制的接收地址。
进入"触发配置"，选择"支付宝收款通知"，触发条件选择示例"支付回调成功"（或填 true 表示全部触发）。
添加动作：选择"发送网络请求"，填入你的钉钉群机器人地址，请求方式选 POST，请求体按钉钉格式填写。
点击保存。现在每当有客户付款，钉钉群就会自动收到一条到账提醒。
服务器告警自动推送到钉钉
你的服务器部署了监控软件，当 CPU 过高或磁盘满了时会发告警。你想让这些告警实时推送到钉钉群。
创建 Hook，命名为"服务器告警"，复制接收地址。
在监控软件（如 Zabbix、PrometheusAlert）的 webhook 配置里，填入这个接收地址。
进入"触发配置"，触发条件可以直接填 true（所有告警都转发），或者选"包含错误信息"来过滤。
添加"发送网络请求"动作，填入钉钉机器人地址，把告警标题和内容拼接到请求体里。
保存后，告警会在几秒内推送到钉钉。你可以在"实时日志"里看到推送记录。
GitHub 提交代码后自动通知团队
你使用 GitHub 管理代码，希望每次有人提交代码时，企业微信群里能收到提醒。
创建 Hook，命名为"GitHub 代码提交"，复制接收地址。
打开 GitHub 仓库的 Settings → Webhooks，粘贴接收地址，Content type 选 application/json。
回到 Light House 的"触发配置"，触发条件填 true（所有提交都通知）。
添加"发送网络请求"动作，填入企业微信机器人地址，请求体按企业微信的格式拼装（包含提交人、提交信息、仓库名等）。
保存后，团队成员每次 push 代码，群里都会收到提醒。
使用提醒
当前版本已实现的功能：接收外部平台通知（Webhook）、创建和管理接收地址、配置触发规则（条件判断）、自动发送网络请求（调用 API）、自动发送邮件、自动写入数据库、查看任务执行记录、实时监控仪表盘与日志。
如果你在按手册操作时找不到某个功能，说明该功能还在开发中。你可以先围绕已实现的「接收通知 → 配置规则 → 自动发送请求或邮件」流程上手使用。
常见问题
接收地址是什么？和网址有什么区别？ ▼
为什么任务显示"失败"？我该怎么办？ ▼
触发条件里的示例看不懂，可以直接全部触发吗？ ▼
true，表示不判断条件，所有收到的通知都会执行动作。适合刚开始试用时使用，后续再根据需求细化条件。
数据存在哪里？安全吗？ ▼
手机能查看和管理吗？ ▼
任务记录能保留多久？ ▼
联系作者
开源不易，如果觉得这个项目对你有帮助，欢迎加微信交流，或者请作者喝一杯咖啡 ☕
微信扫码，交个朋友
请作者喝杯咖啡 ☕