[开源] Meridian：Emby / Jellyfin 多站点反向代理面板，支持多 VPS 节点调度

[开源] Meridian：Emby / Jellyfin 多站点反向代理面板

项目地址：

https://github.com/chanhui800/Meridian

当前版本：v1.9.0

Meridian 是一个 Emby / Jellyfin 多站点反向代理面板，用来统一管理多个站点、上游线路和 VPS 节点。

以前每台 VPS 都要单独安装面板、添加节点、配置域名，维护起来比较麻烦。现在只需要部署一台主控，其他 VPS 运行轻量 Agent，就可以统一管理。

主要功能

• 管理多个 Emby / Jellyfin 站点


• 每个站点支持主线路和备用线路


• 上游故障时自动切换线路


• 支持端口、路径前缀和域名前缀入口


• 自动处理 PlaybackInfo、HLS、DASH、30x 和 WebSocket 地址


• 支持主视频流反代或合法公网 30x 直连


• 请求日志记录最终后端地址和最终调度节点


• 按站点统计请求、收发字节和流量趋势


• 可选观看历史、媒体库数量、保号提醒和 TMDB 资料补全


• 支持 Telegram 日报


• 支持 ACME 泛域名证书和自动续签


• 支持加密备份与恢复


• 支持多 VPS Agent 节点调度

Docker 安装

services:

  meridian:

    image: ghcr.io/chanhui800/meridian:v1.9.0

    container_name: meridian

    restart: unless-stopped

    network_mode: host

    volumes:

      - ./data:/app/data

    environment:

      PORT: "9090"

      DB_PATH: /app/data/meridian.db



    

  

启动容器：

mkdir -p data

docker compose up -d

docker compose logs meridian



    

  

首次启动后，日志中会显示管理员初始化令牌。

Linux 原生安装：

curl -fsSL https://raw.githubusercontent.com/chanhui800/Meridian/main/install.sh | sudo bash



    

  

节点调度

节点调度是可选功能。

主控负责管理节点地址、端口、在线状态、流量额度、流量重置日、节点优先级、站点分配关系和 DNS 状态。

每台 VPS 只需要运行一个 meridian-agent，不需要再安装完整面板。

在主控的“节点调度”页面创建节点后，把生成的一键安装命令复制到目标 VPS 执行。Agent 会自动识别默认路由网卡，并定期向主控上报心跳、网卡累计收发流量、配置版本、监听错误和节点运行状态。

安装成功后，一次性注册令牌会被替换为长期 Agent 凭据。

自动和手动切换

站点可以单独选择是否启用节点调度。

自动模式下，系统会检查以下条件：

1. 节点在线。


2. HTTPS 健康检查通过。


3. 节点剩余流量足够。


4. 根据剩余额度、调度优先级和最近使用情况选择节点。

手动模式下，可以直接指定一个节点。指定节点离线或流量不足时，不会自动换到其他节点。

关闭节点调度后，站点继续使用原来的主控反代模式。

DNS 工作方式

启用节点调度后，主控会把站点的 Host 路由和证书配置同步到 Agent。

主控会通过节点 IP 发起 HTTPS 健康检查，检查通过后才创建或更新对应的 DNS 记录。

DNS 切换只影响新连接，已经建立的播放连接不会被强制迁移。

删除或停用调度时，只会清理 Meridian 自己创建并记录的 DNS 记录，不会删除用户手动添加的同名记录。

端口说明

每个节点只需要配置一个 HTTPS 端口。

创建节点时默认使用主控端口，之后可以单独修改。主控端口变化不会覆盖节点端口。

多个站点可以共用一个节点端口，通过 TLS SNI 和 HTTP Host 区分不同站点。

如果节点的 443 端口已经被 Xray、Nginx 或其他服务占用，可以改用 9090、9443 等空闲端口：

https://node.example.com:9090



    

  

节点端口必须没有被其他程序占用，Agent 不会自动接管已有的 443 监听。

流量统计

节点额度统计以 Agent 读取的网卡累计流量为准，用于判断节点剩余额度和自动切换。

按站点上报的收发字节和流量趋势主要用于请求日志、站点流量展示、节点调度排查和查看最终使用的节点。

每个节点可以设置独立的流量重置日，也可以在面板中手动校正已用流量。

面板截图

仪表盘

站点管理

节点调度

请求日志

流量统计

观看历史

TLS 设置

Telegram 日报

使用建议

正式环境可以使用固定版本镜像：

ghcr.io/chanhui800/meridian:v1.9.0



    

  

也可以使用：

ghcr.io/chanhui800/meridian:latest



    

  

升级前建议先从面板下载备份，并确认面板端口、节点端口和防火墙规则没有冲突。

项目目前主要用于 Emby / Jellyfin 反代和多 VPS 节点调度，欢迎反馈实际部署中遇到的问题。