OHIF Viewer Docker 容器中 app-config.js 配置加载问题解析

问题背景

在使用 OHIF Viewer 医学影像查看器的 Docker 容器部署时，从 3.10.0-beta.34 版本开始，用户报告无法通过 Docker 卷挂载方式正确加载自定义的 app-config.js 配置文件。这导致系统显示演示数据而非预期的 DCM4CHEE 服务器数据。

技术分析

该问题源于 PR#4559 引入的配置压缩优化机制。在此版本后，OHIF Viewer 开始采用压缩后的配置文件(app-config.js.gz)作为默认配置源。当用户通过传统方式挂载 app-config.js 文件时，系统会优先寻找并使用压缩版本，如果找不到则回退到演示数据模式。

解决方案

针对此问题，有两种可行的解决方法：

1. 删除压缩配置文件
   在挂载自定义配置前，确保容器内不存在 app-config.js.gz 文件，强制系统使用未压缩版本。

docker exec -it ohif-container rm /usr/share/nginx/html/app-config.js.gz

2. 提供压缩版配置文件
   将自定义的 app-config.js 预先压缩为 gz 格式，然后挂载压缩后的文件。

gzip -c app-config.js > app-config.js.gz

然后在 docker-compose.yml 中使用：

volumes:
  - ./config/app-config.js.gz:/usr/share/nginx/html/app-config.js.gz

验证方法

用户可以通过以下命令验证配置文件是否正确加载：

docker exec -it ohif-container /bin/sh
cat /usr/share/nginx/html/app-config.js

如果能看到预期的配置内容，但前端仍显示演示数据，则确认是压缩配置机制导致的问题。

最佳实践建议

1. 对于生产环境，推荐使用第二种方法（提供压缩版配置），这符合 OHIF Viewer 的性能优化方向
2. 在开发环境可以使用第一种方法，便于快速修改和测试配置
3. 更新部署文档，明确说明从 3.10.0-beta.34 版本开始的配置加载机制变化

总结

这个问题的出现反映了开源项目在性能优化过程中可能带来的兼容性变化。理解这种底层机制的变化有助于开发者更好地适应项目演进，也为其他类似项目提供了处理配置加载问题的参考模式。