Shaka Packager容器中pssh-box.py工具缺失依赖问题分析

问题背景

Shaka Packager是Google开发的一款开源媒体打包工具，用于处理DASH和HLS等流媒体格式。该项目提供了Docker容器镜像以便快速部署使用。在最新版本的容器镜像中，用户发现pssh-box.py工具无法正常工作，报错提示缺少google.protobuf模块。

问题现象

当用户在最新版Shaka Packager容器中执行pssh-box.py工具时，会出现以下错误：

Traceback (most recent call last):
  File "/usr/bin/pssh-box.py", line 46, in <module>
    import widevine_pssh_data_pb2
  File "/usr/bin/pssh-box-protos/widevine_pssh_data_pb2.py", line 6, in <module>
    from google.protobuf import descriptor as _descriptor
ModuleNotFoundError: No module named 'google'

相比之下，使用v2.5.1版本的容器镜像时，该工具可以正常解析PSSH(Protection System Specific Header)数据。

技术分析

pssh-box.py是一个用于解析和生成PSSH盒子的Python工具，它依赖于Google Protocol Buffers(Python实现)来处理Widevine DRM相关的数据格式。错误表明容器环境中缺少Python的protobuf库。

在Docker镜像构建过程中，可能由于以下原因导致该问题：

1. 基础镜像变更：新版本可能使用了更精简的基础镜像，移除了非必要的Python依赖
2. 依赖管理调整：项目可能重构了依赖管理方式，但未完全测试所有工具
3. 构建流程变化：构建脚本可能没有正确安装所有运行时依赖

解决方案

开发团队已确认该问题并在后续版本中修复。临时解决方案包括：

1. 使用v2.5.1等旧版本镜像
2. 在容器中手动安装缺失的依赖：

   pip install protobuf
   

技术延伸

PSSH盒子是MP4/CMAF容器中用于DRM系统信息的重要数据结构，包含：

• 系统ID：标识DRM系统(如Widevine、PlayReady等)
• 密钥ID：内容加密密钥标识
• 其他DRM特定数据

pssh-box.py工具可以解析这些信息，对于DRM系统集成和调试非常有用。理解PSSH结构对于流媒体工程师处理加密内容至关重要。

最佳实践建议

1. 在使用容器化工具时，注意检查版本兼容性
2. 对于关键工具链，考虑固定特定版本以避免意外变更
3. 开发环境中可预先测试所有工具功能
4. 生产环境中建议使用经过充分验证的稳定版本