入口模式

入口决定客户端如何访问站点，主地址决定 Meridian 如何连接 Emby。两者互不替代。

如何选择

模式	示例地址	适用情况	额外要求
路径	https://panel.example.com/cinema/	新建默认，已有 HTTPS 面板时最省事	客户端保留路径，网关不剥离前缀。
独立端口	http://panel.example.com:8001	需要独立监听或兼容不支持基础路径的客户端	端口可绑定、防火墙放行，Docker 映射，CDN 支持。
域名前缀	https://cinema.example.com:9090	每个站点使用自己的子域名	路由域名、DNS、匹配证书与原生 TLS 就绪。

示例端口只用于说明。实际地址以界面显示和网关配置为准。

路径入口

例如路径前缀填写 cinema，从共享面板入口访问：

https://panel.example.com/cinema/
https://panel.example.com:8443/cinema/

不会为每个站点额外开放监听端口。反向代理必须把完整请求路径传给 Meridian，由 Meridian 去掉站点前缀并回源。

前缀规则：

• 单个路径段，最长 64 个字符。
• 使用英文字母、数字、连字符 - 或下划线 _，保存时规范为小写。
• 同一个部署中必须唯一。
• 不能占用 api、css、js、fonts、_meridian 等面板保留路径。

客户端填写完整地址，不要只保留域名。上游本身使用 /emby 时，按实际主地址填写其基础路径。

独立端口

为站点指定一个 1–65535 的有效整数端口。它是 Meridian 的监听端口，不是 Emby 回源端口。

检查以下条件：

1. 没有与面板、其他站点或其他程序冲突。
2. 服务账户有权限绑定该端口；低于 1024 的端口可能需要额外能力。
3. 防火墙与服务器安全组允许访问。
4. Docker 已添加对应映射。
5. 前置 CDN / 网关支持该端口和媒体请求。

协议由 Meridian 的站点监听器决定。若只是外部 Nginx 将面板包装为 HTTPS，独立端口仍可能是 HTTP；不能把面板的 https:// 自动套到它上面。

域名前缀

先在 TLS 设置 配置面板域名、节点泛域名和证书。满足能力条件后，新增站点即可选择域名前缀。

例如：

面板域名：panel.example.com
节点泛域名：*.example.com
站点前缀：cinema
站点域名：cinema.example.com

证书必须覆盖 panel.example.com 与 *.example.com，DNS 应将实际站点子域名或通配记录解析到入口服务器。通配符只覆盖一层子域名，不覆盖 deep.cinema.example.com。

域名前缀使用共享监听入口，不需要新增站点独立端口。外部反向代理须识别站点 Host、提供覆盖该域名的证书，并将原 Host 转发给 Meridian。

只配置外部网关 HTTPS，不会自动开启新建表单的原生 TLS 能力。暂时不能选择域名前缀时，可先用路径入口。

旧版本配置

旧数据库或 API 可能保留 both（域名与端口同时提供）或未配置状态。当前新增表单提供上表三种模式。编辑旧站点时，应核对最终访问地址并明确选择所需入口。