访问线路

约 746 字大约 2 分钟

2026-04-18

对应前端侧边栏 开服 → 访问线路，为每个 Emby 实例配置多条访问线路，用户可通过 Bot /status 命令或用户面板查看和切换线路。

核心用途

当 Emby 有多条接入线路（如不同地区 CDN、不同端口）时，通过访问线路管理可以让用户自行选择最优线路，同时支持隐藏特定线路仅对白名单/永久用户开放。

页面结构

顶部有实例选择下拉、「探测」「添加」「保存」按钮。下方为线路列表，每条线路为一行内联编辑的卡片。

每条线路包含以下配置项，所有字段直接在列表行内编辑：

配置项	说明
线路名称	自定义名称（如「深圳电信」「香港 CN2」）
协议	下拉选择 `https` 或 `http`，切换协议时端口自动适配（443↔80）
域名/IP	Emby 服务器的域名或 IP 地址
端口	访问端口，使用默认端口（https=443, http=80）时 URL 中不显示端口号
启用	勾选框，取消勾选后该线路不对用户展示
隐藏	勾选框，隐藏线路不对普通用户展示
白名单可见	仅在勾选「隐藏」后可设置，勾选后白名单和永久用户仍可看到此线路

URL 字段拆分

线路 URL 被拆分为协议、域名、端口三个独立字段，避免手动拼接 URL 出错。系统自动合成完整 URL（如 https://emby.example.com:8920），默认端口会自动省略。

用户类型	普通线路	隐藏线路	隐藏+白名单可见
普通用户	✅ 可见	❌ 不可见	❌ 不可见
永久用户	✅ 可见	❌ 不可见	✅ 可见
白名单用户	✅ 可见	❌ 不可见	✅ 可见
管理员	✅ 可见	✅ 可见	✅ 可见

用户面板线路展示

用户面板中的线路列表会智能折叠：当多条线路使用相同协议和端口时，仅展示域名差异部分，减少视觉干扰。

点击顶部「探测」按钮，系统自动测试所有线路的可用性和响应延迟：

探测结果仅供参考，实际用户体验还受地理位置和网络环境影响。