Meridian

KO | EN

gitlite — search

#react #ai #typescript #llm #go #machine-learning #deep-learning #nodejs #cli #awesome-list #ios #mcp #openai #open-source

(★ 31)

轻量级 Emby/Jellyfin 反向代理管理面板，支持自动后端发现、TLS、流量统计、请求日志和 Telegram 日报

Meridian Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Meridian

[![CI](https://github.com/chanhui800/Meridian/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/chanhui800/Meridian/actions/workflows/ci.yml)
[![CodeQL](https://github.com/chanhui800/Meridian/actions/workflows/codeql.yml/badge.svg?branch=main)](https://github.com/chanhui800/Meridian/actions/workflows/codeql.yml)
[![Release](https://img.shields.io/github/v/release/chanhui800/Meridian)](https://github.com/chanhui800/Meridian/releases/latest)
[![License](https://img.shields.io/github/license/chanhui800/Meridian)](https://raw.githubusercontent.com/chanhui800/Meridian/main/LICENSE)

Meridian 是面向 Emby、Jellyfin 等媒体服务的多节点反向代理面板。本仓库基于 [snnabb/Meridian](https://github.com/snnabb/Meridian) 修改，并参考 [CF-EMBY-PROXY-UI](https://github.com/axuitomo/CF-EMBY-PROXY-UI) 优化界面与交互。

当前正式版本：`v1.8.36`

## 主要功能

- 多节点管理，支持独立端口、路径和域名前缀入口，以及主线路自动回切的多线路故障转移。
- 自动发现并改写 PlaybackInfo、HLS、DASH 和 HTTP 30x 播放地址。
- 主视频流可选“反代”或“直连”，默认反代；网盘服 30x 可校验后交给客户端直连。
- 支持 TLS 泛域名证书、静态资源缓存、流量统计和运行诊断。
- 请求日志可筛选资源类别，并分别记录客户端 UA、上游 UA 和最终后端地址。
- Telegram 每日或每周定时日报，默认使用北京时间，可自定义调度时区。
- 支持从全局设置下载密码加密备份，并在同机或新安装中安全恢复数据库与 TLS 数据。
- 白色/黑色主题、响应式侧栏和移动端日志布局。
- Docker 与 Linux systemd 均支持健康检查、优雅停止和自动重启。

HTTP `499` 表示客户端主动取消请求，不等同于 Meridian 或上游产生的 `502`。

## 界面预览

截图使用本地白色主题演示数据，不包含生产环境信息。

| 仪表盘 | 站点管理 |
| --- | --- |
| ![仪表盘](https://raw.githubusercontent.com/chanhui800/Meridian/main/docs/images/dashboard.png) | ![站点管理](https://raw.githubusercontent.com/chanhui800/Meridian/main/docs/images/sites.png) |
| 请求日志 | 流量统计 |
| ![请求日志](https://raw.githubusercontent.com/chanhui800/Meridian/main/docs/images/request-logs.png) | ![流量统计](https://raw.githubusercontent.com/chanhui800/Meridian/main/docs/images/traffic.png) |
| 全局设置 | Telegram 日报 |
| ![全局设置](https://raw.githubusercontent.com/chanhui800/Meridian/main/docs/images/global-settings-ui.png) | ![Telegram 日报](https://raw.githubusercontent.com/chanhui800/Meridian/main/docs/images/telegram-report.png) |

## Docker 部署

```yaml
services:
  meridian:
    image: ghcr.io/chanhui800/meridian:latest
    container_name: meridian
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./data:/app/data
    environment:
      PORT: "9090"
      DB_PATH: /app/data/meridian.db
```

```bash
mkdir -p data
docker compose up -d
docker compose logs -f meridian
```

首次启动会自动生成并持久化登录、上游请求头、动态路由和初始化所需的随机密钥，无需手动创建。查看容器日志获取首次管理员初始化令牌，然后访问 `http://服务器地址:9090`。

Linux Docker 使用 `network_mode: host`，面板和节点端口会直接监听宿主机，请在防火墙中放行相应端口。数据保存在 `./data`，升级容器不会清除数据库、证书和缓存。

## Linux 原生安装

安装脚本会下载当前正式版对应架构的二进制并校验 SHA-256：

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

管道执行时，交互菜单及后续输入会自动从当前终端读取。无终端的自动化安装可显式执行：

```bash
curl -fsSL https://raw.githubusercontent.com/chanhui800/Meridian/main/install.sh | sudo bash -s -- install -y --no-domain
```

默认数据库为 `/var/lib/meridian/meridian.db`，服务由 `systemd` 管理。日志可通过以下命令查看：

```bash
sudo journalctl -u meridian -f
```

## 站点与播放策略

新增站点后自动发现默认开启，不需要配置安全模式、发现来源或播放回源列表。Meridian 会自动识别播放后端，同时拒绝 localhost、回环、私网、链路本地及其他保留目标。

每个站点可配置一条主线路和最多七条备用线路。主线路不可用时按列表顺序切换，恢复后自动回切；备用线路沿用主线路的反代、自动发现、UA 和请求策略。添加或编辑站点时可统一测试全部启用线路的连通性与延迟。

- **反代**：主视频流继续经过 Meridian，适合统一入口和隐藏后端。
- **直连**：MP4、MKV、MOV、AVI、WebM 及 `/Videos/.../stream`、`/original`、`/download`、`/file` 等主视频请求会先访问主站；若上游返回合法公网 30x，客户端将直连最终 CDN。普通 API、HLS/DASH、字幕、图片和静态资源仍由 Meridian 反代。

媒体认证头默认完全透传。客户端 UA 默认透传，也可按站点改为预设或自定义 UA。

## 路径入口

路径入口让多个站点共用面板域名和端口。例如站点入口填写 `/movie` 后，客户端通过以下地址连接：

```text
https://panel.example.com:9090/movie
```

入口必须是唯一的单级路径，仅支持字母、数字、短横线和下划线，不能使用 `/api`、`/css`、`/js` 等面板保留路径。Meridian 会按本次请求的入口自动剥离外层路径，并处理 Emby/Jellyfin 返回地址中入口前缀与 `/emby`、`/jellyfin` Base URL 重复或顺序错位的情况。PlaybackInfo、HLS、DASH、30x、WebSocket、Cookie Path 和自定义播放路径都会继续经过对应站点，不需要为不同路径名称修改代码。

路径入口名称不会从上游自动创建。新增或编辑站点时选择“路径入口”并填写前缀即可；这样可以避免多个站点误占同一路径。若修改入口名称，客户端也需要改用新的访问地址。

## 域名前缀与 TLS

域名前缀入口使用“节点前缀 + 泛域名 + 面板端口”，例如：

```text
https://movie.example.com:9090
```

1. 将 `panel.example.com` 和 `*.example.com` 解析到服务器。
2. 先通过 HTTP 登录，在“全局设置 → TLS 设置”中填写面板前缀、泛域名和监听端口。
3. 填写 ACME 邮箱、DNS 服务商及 API Token 后申请证书。
4. 证书签发后启用 HTTPS 并重启。
5. 在站点管理中选择“域名前缀”，为各节点填写唯一域名。

DNS API Token 仅用于当前证书申请，不会保存到数据库或日志。修改监听端口或启用 TLS 会短暂中断连接。

## 日志与通知

日志设置分为三组：

- **资源类别写入**：决定哪些后续请求进入日志；图片海报和媒体元数据默认不写入。
- **日志字段写入**：决定后续新日志是否保存节点、资源类别、状态、客户端 IP、客户端 UA、上游 UA、后端地址和时间线。
- **日志字段展示**：只控制日志表格列，不改写历史数据。

Telegram 日报支持每天或每周发送请求量、流量、排行和客户端分布。Bot Token 加密存储，发送时间按“系统 UI”中的调度时区执行。

## 备份与恢复

“全局设置 → 备份与恢复”可下载带密码加密的 `.mrbak` 文件。备份包含账户、站点、流量与请求日志、全局设置和 Telegram 配置；TLS 设置、证书与 ACME 账户可选备份，默认不包含，用户主动勾选后才会写入备份。备份不包含静态缓存、`.env` 或部署密钥文件。

恢复前会校验备份密码、文件结构和 SQLite 完整性；校验通过后 Meridian 会优雅重启并原子替换数据，启动失败时自动回滚。未包含 TLS 的备份会保留目标服务器现有面板域名、端口、TLS 开关和证书。跨机器恢复会使用目标安装当前密钥重新加密自定义上游请求头和 Telegram Token。恢复后请使用备份中的管理员账户登录。

跨服务器恢复时会按目标服务器的入口能力迁移站点：支持原入口模式的站点保留配置并按备份状态直接启用；不支持原入口模式的站点仍会完整保留，但入口改为“未配置”并自动停用。用户在站点管理中选择当前服务器可用的入口并保存后即可启用，不会因此回滚其他恢复数据。

## 常用环境变量

| 变量 | 默认值 | 说明 |
| --- | --- | --- |
| `PANEL_BIND_ADDR` | `0.0.0.0` | 面板监听地址 |
| `PORT` | `9090` | 首次初始化监听端口 |
| `DB_PATH` | `meridian.db` | SQLite 数据库路径 |
| `JWT_SECRET` | 自动生成 | 登录会话签名密钥 |
| `UPSTREAM_HEADER_KEY` | 自动生成 | 固定上游请求头加密密钥 |
| `DYNAMIC_ROUTE_KEY` | 自动生成 | 动态路由加密密钥 |
| `SETUP_TOKEN` | 自动生成 | 首次管理员初始化令牌 |
| `TRUSTED_PROXY_CIDRS` | 空 | 可被采纳转发 IP 头的可信代理 CIDR |
| `ASSET_CACHE_DIR` | 数据库目录下 `asset-cache` | 静态资源缓存目录 |

只有来自 `TRUSTED_PROXY_CIDRS` 的代理，其 `X-Real-IP` 和 `X-Forwarded-For` 才会被信任。直连公网部署无需额外配置；使用 OpenResty、Cloudflare 或其他前置代理时再按实际网段填写。

## 更新与开发

Docker 更新：

```bash
docker compose pull
docker compose up -d --force-recreate
```

升级前请备份数据目录。数据库迁移会在启动时自动完成。

本地检查：

```bash
go test ./...
go vet ./...
git diff --check
```

安全策略见 [SECURITY.md](SECURITY.md)，贡献说明见 [CONTRIBUTING.md](CONTRIBUTING.md)。本项目沿用仓库中的 [LICENSE](LICENSE)。

Meridian

Meridian Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Meridian

Meridian Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README