{"id":15325409,"url":"https://github.com/rainbend/frp-notify","last_synced_at":"2026-03-16T20:33:10.319Z","repository":{"id":38001668,"uuid":"252083296","full_name":"arugal/frp-notify","owner":"arugal","description":"一个专注于消息通知的 frp server manager plugin 实现，让你对进入 frps 的连接了如指掌。","archived":false,"fork":false,"pushed_at":"2023-12-04T07:24:51.000Z","size":457,"stargazers_count":123,"open_issues_count":7,"forks_count":29,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-26T05:52:00.554Z","etag":null,"topics":["frp","frp-server-manager","golang","notification"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arugal.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-04-01T05:45:34.000Z","updated_at":"2024-11-24T16:22:53.000Z","dependencies_parsed_at":"2024-06-20T14:45:40.209Z","dependency_job_id":"b64ebb82-c310-4c70-a07a-71c5c3d0cfeb","html_url":"https://github.com/arugal/frp-notify","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arugal%2Ffrp-notify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arugal%2Ffrp-notify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arugal%2Ffrp-notify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arugal%2Ffrp-notify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arugal","download_url":"https://codeload.github.com/arugal/frp-notify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230462906,"owners_count":18229864,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["frp","frp-server-manager","golang","notification"],"created_at":"2024-10-01T09:30:17.167Z","updated_at":"2026-03-16T20:33:10.266Z","avatar_url":"https://github.com/arugal.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"## frp-notify\n\n[![Build](https://github.com/arugal/frp-notify/workflows/Build/badge.svg?branch=master)](https://github.com/arugal/frp-notify/actions?query=branch%3Amaster+event%3Apush+workflow%3ABuild)\n\n一个专注于消息通知的 [frp server manager plugin](https://github.com/fatedier/frp/blob/master/doc/server_plugin_zh.md) 实现，让你对进入 `frps` 的连接了如指掌，不再裸奔。\n\n## 快速启动\n\n[下载地址](https://github.com/arugal/frp-notify/releases)\n\n### 目录介绍\n\n```bash\n* frp-notify\n└─── system\n|    |          frp-notify.service                  # linux 系统服务配置文件\n|\n│           frp-notify                              # frp-notify 程序\n|           frp-notify.json                      # 通知插件配置文件\n```\n\n### 打印帮助信息\n\n```bash\n./frp-notify --help\n```\n\n### 命令行启动\n\n```bash\n./frp-notify start -c /etc/frp-notify/frp-notify.json -b 127.0.0.1:50080\n```\n\n## 配置介绍\n\n### frps\n\n在 `frps.ini` 增加以下配置\n\n```\n[plugin.frp-notify]\naddr = 127.0.0.1:50080                             // frp-notify 地址\npath = /handler                                    // frp-notify url, 固定配置\nops = Login,NewProxy,NewWorkConn,NewUserConn       // 通知的操作\n```\n\n### 黑白名单配置（`IP` 过滤）\n\n先判断白名单，后判断黑名单。仅对 `NewUserConn` 有效 (**黑白名单配置支持热加载**)。\n\n```json\n{\n  \"blacklist\": [                                   // 黑名单\n    \"127.0.0.1\"\n  ],\n  \"whitelist\": [                                   // 白名单\n    \"127.0.0.1\"\n  ],\n  \"notify_plugins\": [\n    ...\n  ]\n}\n```\n\n### 通知插件配置\n\n插件列表：\n1. [log](#log)\n1. [dingTalk](#dingtalk)\n1. [wxwork](#wxwork)\n1. [飞书](#飞书)\n1. [gotify](#gotify)\n\n在 `frp-notify.json` 文件中按需配置通知插件，支持同时配置多个插件。\n\n#### log\n\n将消息打印到控制台，用于调试。\n\n```json\n{\n  \"notify_plugins\": [\n    {\n      \"name\": \"log\",                                                               // 固定配置\n      \"config\": {}\n    }\n  ]\n}\n```\n\n#### dingTalk\n\n将消息发送到钉钉。\n\n```json\n{\n  \"notify_plugins\": [\n    {\n      \"name\": \"dingTalk\",                                                               // 固定配置\n      \"config\": {\n        \"token\": \"df54651465c1189b76fd13f910b76bed361f8fff31bf9118b1896bc148500000\",    // dingTalk 自定义机器人 token\n        \"secret\": \"SEC97d8a209f9ddda25b89d63d82a0b2ad4065504cbe4bc043719fbb1a0000000\",  // dingTalk 自定义机器人 secret\n        \"is_at_all\": true                                                               // 发送消息时是否@所有人\n      }\n    }\n  ]\n}\n```\n\n![实例截图](doc/images/dingtalk.png)\n\n#### wxwork\n\n将消息发送到企业微信。\n\n```json\n{\n  \"notify_plugins\": [\n    {\n      \"name\": \"wxwork\",\n      \"config\": {\n        \"corp_id\": \"ww123456789\",\n        \"corp_secret\": \"UK__xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\n        \"agent_id\": 12345678,\n        \"to_user\": [],\n        \"to_party\": [],\n        \"to_tag\": [],\n        \"filter_regexp\": \".*\"\n      }\n    }\n  ]\n}\n```\n\n![实例截图](doc/images/wxwork.png)\n\n#### 飞书\n\n将消息发送到飞书\n\n```json\n{\n  \"notify_plugins\": [\n    {\n      \"name\": \"lark\",\n      \"config\": {\n        \"webhook_url\": \"\",\n        \"secret\": \"\",\n        \"at_users\": []\n      }\n    }\n  ]\n}\n```\n\n#### gotify\n\n将消息发送到 [gotify-server](https://github.com/gotify/server)。\n\n```json\n{\n  \"notify_plugins\": [\n    {\n      \"name\": \"gotify\",                                                                // 固定配置\n      \"config\": {\n        \"server_proto\": \"http\",                                                        // gotify-server 上报协议\n        \"server_addr\": \"127.0.0.1:40080\",                                              // gotify-server 服务地址\n        \"app_token\": \"token\"                                                           // gotify-server 配置的 app token\n      }\n    }\n  ]\n}\n```\n![实例截图](doc/images/gotify.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frainbend%2Ffrp-notify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frainbend%2Ffrp-notify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frainbend%2Ffrp-notify/lists"}