OHIF Viewer 部署指南从本地开发到生产上线的完整路径【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers一句话定位解决什么问题OHIF Viewer 是一个开源零足迹医学影像查看器基于 DICOMweb 标准对接影像档案库浏览器里直接读片无需装客户端。谁会用PACS 集成工程师、医院信息科、影像 SaaS 团队——部署它就能快速上线一套可对接任意 DICOMweb 后端的影像浏览服务或作为二开底座嵌入自己的产品。三种部署路径怎么选先按目的选路再动手路径适合谁得到什么本地开发服务器看效果、改代码热重载、连本地 Orthanc零部署成本Docker 容器自托管有自己服务器的团队镜像 Nginx 托管环境变量可控可离线分发云端静态托管Netlify 等演示、联调、零运维推送即部署自带 CDN 与 HTTPS只想验证功能走路径一就够了要正式给同事或外部用户用优先路径二把发布变成一条命令的事。路径一本地开发体验最快上手场景打开浏览器CT 图像已经摆在那。仓库是 pnpm monorepo各子包靠 workspace 互相关联所以一律在根目录装依赖不要进子包单独 install。结构上platform/app是主应用platform/core是核心业务逻辑extensions/是各种功能扩展modes/是不同查看模式改哪块去哪个包。git clone https://gitcode.com/GitHub_Trending/vi/Viewers.git cd Viewers pnpm install pnpm dev要求 Node 24、pnpm 12想更快编译可换pnpm dev:fast。启动后把platform/app/public/config下配置里的 DICOMweb 数据源指到你的服务器地址刷新即可加载检查。路径二Docker 容器化自托管Dockerfile 是多阶段的第一段用 node:24-slim 装依赖并执行生产构建第二段把dist产物拷进 nginx-unprivilegedAlpine直接托管——构建环境不进最终镜像体积小、攻击面小。docker build -t ohif-viewer . docker run -p 80:80 ohif-viewer容器化自托管要配的几个变量PUBLIC_URL挂载路径默认/挂子路径如/viewer时必改Nginx 模板按它生成配置PORTNginx 监听端口默认 80APP_CONFIG一段完整的配置 JS容器启动时由 entrypoint 写入app-config.js把数据源指到你的 DICOMweb 档案库就靠它。另支持SSL_PORT变量切换 HTTPS 配置模板配合反代证书即可对外提供加密访问。路径三静态托管零运维不想管服务器就把构建产物丢给静态托管。以 Netlify 为例配置写在仓库根目录的netlify.toml构建命令pnpm run build:ci内部会先跑版本号更新发布目录platform/app/distNODE_VERSION 24.15.0且NODE_ENV development——注意别改成 production否则 devDependencies 不装、构建必挂。触发逻辑很简单向已连接仓库的分支推送代码平台自动拉取、执行构建、发布到dist产物每次推送都是一次可回滚的部署。netlify.toml 里还顺手声明了安全响应头X-Frame-Options、CSP report-only云托管方案里这类配置建议一并固化进文件而不是散在控制台里。上线自检清单发布完成不等于上线完成按这份清单逐条勾功能研究列表能拉出检查影像正常渲染窗宽窗位、缩放、测量工具可用数据源指向正确的 DICOMweb 端点且鉴权通过性能首屏加载时间在可接受范围缩略图预取不卡顿Web Worker 数量未超浏览器限制默认上限 3兼容性主流程在 Chrome、Edge、Firefox 下走一遍重点看 WebGL 渲染安全HTTPS 已启用安全响应头X-Frame-Options、CSP实际生效默认配置未开启本地文件等高危数据源。踩坑与后续维护上线后的问题基本逃不出三类。构建失败先对engines声明查 Node/pnpm 版本再看依赖是否装全、registry 是否可达Docker 构建慢大头在第一阶段的 install用构建缓存和镜像源别每次全量跑云端部署报错看构建日志里的产物路径最常见是发布目录和实际输出目录对不上。维护上三句话依赖定期升级并跑pnpm audit盯浏览器控制台与后端报错日志改动 DICOMweb 对接或配置前先在本地开发服务器验证一轮再进生产。【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考