MediaMTX中RTSP认证机制变更导致401错误的解决方案

问题背景

MediaMTX(原rtsp-simple-server)是一款开源的实时媒体服务器，在1.6.0版本中对认证系统进行了重大变更。许多用户在升级后发现原有的认证配置不再工作，特别是当使用ffmpeg推流时会出现401 Unauthorized错误。

版本差异分析

在1.4.2版本中，认证是通过readUser和readPass参数配置的，这种配置方式简单直接：

pathDefaults:
  readUser: sha256:WxKL6/7ES5Lndtry/HwZhGkWdy+Hyw7deUTqC0k7mpA=
  readPass: sha256:7b1vYRZRne5tsKw9czWjSTlVpQgeWB+05Zie3fVj8ic=

然而在1.6.0及更高版本中，认证系统被重构为更灵活的全局认证机制，原有的readUser和readPass参数被标记为已弃用。

新认证系统详解

新版本引入了authInternalUsers配置项，它允许定义多个用户并为每个用户指定不同的权限。一个完整的认证配置示例如下：

authInternalUsers:
- user: any
  pass: ""
  ips: []
  permissions:
  - action: publish
- user: carlo
  pass: carlo
  ips: []
  permissions:
  - action: read

关键配置项说明

1. user: 用户名
2. pass: 密码(可为空)
3. ips: 允许访问的IP地址列表(空数组表示允许所有IP)
4. permissions: 权限列表，包含read或publish操作

常见问题解决方案

401错误的主要原因

在1.6.0版本中，如果未显式设置ips参数，系统会默认使用127.0.0.1作为允许访问的IP地址。这会导致非本地主机的访问请求被拒绝，即使认证信息正确也会返回401错误。

正确配置方法

1. 显式设置ips参数：对于需要允许所有IP访问的用户，应将ips设置为空数组
2. 使用新版认证格式：完全替换旧的readUser/readPass配置
3. 权限分离：建议为发布和读取操作分别配置不同的用户

实际应用建议

1. 升级注意事项：从1.4.2升级到1.6.0+时，必须重写认证配置部分
2. 测试环境验证：在正式部署前，应在测试环境验证新的认证配置
3. 密码安全：虽然支持明文密码，但建议使用sha256哈希值提高安全性

总结

MediaMTX 1.6.0版本的认证系统变更带来了更灵活的权限管理能力，但也需要用户相应地调整配置。理解新的authInternalUsers机制并正确配置ips参数是解决401错误的关键。对于需要从旧版本迁移的用户，建议参考本文提供的配置示例进行平滑过渡。