Invidious项目反向代理配置中的端口问题解析

在使用Invidious开源项目搭建个人YouTube前端服务时，许多用户选择通过反向代理来提供HTTPS访问。然而，在配置过程中容易出现一个典型问题：当启用Dash视频流时，视频无法正常加载，浏览器控制台显示请求被发送到了内部端口而非预期的外部端口。

问题现象

用户报告称，在通过Caddy等反向代理将Invidious服务暴露到公网时，普通视频播放（如HD720模式）工作正常，但切换到Dash模式后视频无法加载。浏览器开发者工具显示，视频片段请求被错误地发送到了内部服务端口（如3001），而非配置的外部HTTPS端口（443）。

根本原因分析

经过深入调查，发现这是配置文件中两个关键端口参数的误解导致的：

1. port参数：指定Invidious服务实际监听的内部端口
2. external_port参数：指定外部用户访问时使用的端口

常见错误是将external_port设置为反向代理的内部转发端口，而实际上它应该设置为最终用户访问时使用的公网端口（HTTPS通常为443）。

正确配置示例

在docker-compose配置中，应确保：

environment:
  INVIDIOUS_CONFIG: |
    domain: your.domain.com
    https_only: true
    port: 3000  # 容器内部监听端口
    external_port: 443  # 用户实际访问的端口

反向代理配置（以Caddy为例）应正确转发到容器暴露的端口：

your.domain.com {
    reverse_proxy localhost:3001  # 这里对应docker的端口映射
}

技术原理

Invidious生成Dash视频流URL时，会基于external_port参数构造完整的请求地址。如果该参数设置不正确，生成的URL会指向内部端口，导致：

1. 浏览器尝试直接访问内部端口
2. 由于安全策略或网络配置，这些请求通常会被阻止
3. 视频片段无法加载，播放器报错

解决方案验证

验证配置是否正确的方法：

1. 检查浏览器开发者工具中的网络请求
2. 确认视频片段请求的URL是否使用正确的域名和端口
3. 确保所有请求都通过HTTPS（当https_only启用时）

总结

正确理解Invidious的端口配置对于通过反向代理部署至关重要。记住两个基本原则：

1. port参数对应服务实际运行的内部端口
2. external_port参数是用户访问时使用的公网端口

这种区分使得Invidious能够灵活适应各种部署场景，包括容器化、反向代理等复杂网络环境。正确配置后，Dash视频流和其他所有功能都将正常工作。