EverywhereYouGo (EGo) v1.2.4

English | 中文

通用信息转发平台 — 数据 → 解析 → 路由 → 推送

接收任意 HTTP 请求，经解析器提取结构化字段，按条件路由到多个推送渠道。

Docker 部署

一键部署（推荐）：

curl -O https://raw.githubusercontent.com/codename-test/EverywhereYouGo/main/deploy/init.sh
chmod +x init.sh
./init.sh
# 按提示选择部署模式

支持 5 种部署模式：default（快速起步）、t1-host（host 网络）、t2-bridge（bridge 网络）、t3-nginx（Nginx + 手动证书）、t4-acme（Nginx + Let's Encrypt 全自动证书）。

更多部署形态说明见 deploy/README.md。

启动后：管理页面 https://<主机IP>:5001（自签名证书，浏览器需放行）；Webhook 接收与健康检查走 http://<主机IP>:5000。

架构

HTTP POST → 数据源 → 解析器 → 路由匹配 → 模板渲染 → 推送渠道

组件	说明
数据源	监听端口接收 HTTP POST
解析器	Python 脚本，提取字段并定义变量名
路由	条件表达式匹配渠道-模板对
模板	Simple / Jinja2 渲染标题和内容
渠道	企业微信、钉钉、飞书、Telegram、Bark

认证

设置 EGO_AUTH_TOKEN 环境变量后开启访问控制：

EGO_AUTH_TOKEN=your-secret-token python3 main.py

• Web 页面需通过登录页输入 Token
• API 调用需携带 Authorization: Bearer your-secret-token 请求头
• 健康检查 /api/health 无需认证

可选设置 EGO_SECRET_KEY 自定义 Flask session 密钥。

配置文件

配置持久化为 JSON 文件，位于 config/ 目录：

文件	内容
config/parsers.json	解析器元信息
config/sources.json	数据源定义
config/channels.json	推送通道配置
config/templates.json	推送模板
config/bindings.json	渠道绑定（含条件表达式）

可直接编辑 JSON 后重启生效，也可通过 WebUI 管理。系统设置（DND、日志级别等）和运行时数据（消息日志）存储在 SQLite（ego.db）中。

解析器

放在 parsers/ 目录下的 .py 文件，定义一个 parse() 函数：

def parse(raw_body: bytes, headers: dict, query_params: dict) -> dict:
    data = json.loads(raw_body)
    event = data.get("Event", "")
    name = data.get("Item", {}).get("Name", "")
    return {
        "title": name,
        "event": event,
        "name": name,
    }

返回 dict 中除 title 外的字段同时用于：

• 路由条件匹配：event == 'library.new' and media_type == 'Movie'
• 模板变量引用：{name} / {{ msg.name }}

路由条件

支持 and、or、括号分组：

示例	说明
event == 'library.new'	仅新入库
event == 'library.new' and media_type == 'Movie'	仅新入库电影
event == 'library.new' or event == 'test'	新入库或测试消息

功能特性

免打扰（DND）

设置免打扰时段后，消息进入队列等待，结束后自动刷新。紧急路由不受 DND 影响。

消息去重

渠道绑定可配置 dedup_key_expr 和 dedup_window（默认 3600 秒）。同一去重键在窗口内不重复发送。

并行推送

多渠道匹配时线程池并行发送，总延迟取决于最慢的单个渠道。

样本数据与在线调试

每个数据源自动保存最近 20 条请求样本，可在 WebUI 中选取样本进行测试解析和推送。

消息重发

失败消息支持原始重发（使用已解析的 msg_json）或重新解析后重发。

导入导出

• 备份：下载 ZIP 包（config/*.json + parsers/*.py）
• 恢复：上传 ZIP 包，覆盖配置后自动生效
• JSON 导入：支持 dry_run 预览、insert/overwrite 两种模式、依赖检查

国际化

内置中英文双语支持，通过导航栏右上角语言切换按钮随时切换。

通道类型

通道	方式	类型标识
企业微信 Bot	Webhook	wechat_work_bot
企业微信 API	应用消息	wechat_work_api
钉钉	Webhook	dingtalk
飞书	Webhook	feishu
Telegram	Bot API	telegram_bot
Bark	API	bark

环境变量

变量	默认值	说明
WEB_PORT	5000	HTTP 端口（Webhook 接收 / 健康检查）
WEB_SSL_PORT	5001	HTTPS 端口（管理页面，证书缺失时不启用）
EGO_SSL_ENABLED	1	设为 0 完全关闭内置 HTTPS（仅 HTTP，不跳转、不生成证书）
EGO_SSL_DIR	./certs	SSL 证书目录，ego.crt 和 ego.key 存放位置
EGO_SSL_CERT	./certs/ego.crt	证书文件路径（覆盖 EGO_SSL_DIR）
EGO_SSL_KEY	./certs/ego.key	私钥文件路径（覆盖 EGO_SSL_DIR）
DB_PATH	ego.db	数据库路径
LOG_LEVEL	INFO	日志等级
EGO_AUTH_TOKEN	(空)	访问控制 Token
EGO_SECRET_KEY	(自动)	Flask session 密钥

License

MIT