3 条路线把 OHIF Viewer 部署上线医学影像查看器从本地调试到静态托管【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers如果你手上已经有一套 DICOMweb 后端比如 Orthanc 或 dcm4chee缺的只是一个浏览器端能直接开片的界面OHIF Viewer 就是为此而生的开源医学影像查看器前端零安装配置好数据源就能读片、测量、看三维。下面按“先跑通、再上线”的思路把本地调试、容器化、静态托管三条路一次讲清楚并顺手列出最容易卡住的配置和验收点。它适合谁先对号入座结论先行适合“后端已有 DICOMweb 服务、前端需要一个查看器”的团队以及想魔改前端界面的开发者。OHIF Viewer 只负责渲染和交互不存影像数据真正的数据来自你配置的后端。仓库是 monorepo 结构platform/app是主应用platform/core放核心逻辑extensions/下是按功能拆分的扩展包分割、结构化报告等modes/定义不同的读片模式。想改界面或加功能基本就在这几处动手主应用入口可以直接看 platform/app/。 最快跑通本地起一个能看片的地址前提只有一样装好 Node 24 和 pnpm仓库锁定了 pnpm 11别用 yarn 代替。拉取代码并安装依赖git clone https://gitcode.com/GitHub_Trending/vi/Viewers cd Viewers pnpm install --frozen-lockfile启动开发服务器浏览器打开终端里给出的地址pnpm dev能列出检查Study并正常翻片就算跑通了首次构建慢的话可以换成pnpm dev:fast。从本地到线上三条路线怎么选三条路线的产物都是静态文件区别只在“谁来托管”。自己调试走 A内网服务器走 B快速对外演示走 C。路线 A先出生产包把问题拦在容器外把开发态换成压缩优化后的产物pnpm build产物位于platform/app/dist用任意静态服务器nginx、npx serve指过去就能用。上线前建议先这样裸跑一遍确认没有问题再谈容器和云。 路线 BDocker 部署到自有服务器仓库根目录的 Dockerfile 是两阶段构建先用 Node 24 把应用打出来再塞进非特权 NginxAlpine镜像托管。在仓库根目录执行docker build -t ohif-viewer . docker run -p 80:80 ohif-viewer三个构建参数值得认识PUBLIC_URL控制应用挂在哪个路径下部署在/viewer就传它APP_CONFIG指定打进包里的配置脚本PORT是容器内端口。例如docker build --build-arg APP_CONFIGconfig/orthanc.js -t ohif-viewer .注意构建上下文必须是仓库根目录少了各扩展包的 workspace 文件会直接失败。☁️ 路线 CNetlify 静态托管Netlify 配置 放在仓库根目录构建命令是pnpm run build:ci发布目录platform/app/dist并预置了安全响应头如禁止 iframe 嵌套。把仓库连上 Netlify 后其余步骤自动完成适合做只读的外部演示站。关键配置告诉查看器“影像从哪来”查看器本身不带数据行为由两类配置决定打包期配置platform/app/public/config/下有一批现成脚本构建时用APP_CONFIG选中其一数据源地址、WADO 端点都写在这里。运行时配置启动后在页面里打开数据源配置面板直接挑选 DICOM store不用重新打包。改数据源时最常见的报错是浏览器控制台一片 CORS 红字——那是后端没开跨域属于后端问题改前端配置救不了。✅ 上线前检查清单与常见坑按顺序过一遍能避开绝大多数问题打开首页检查列表和缩略图正常加载翻到 CT/MR 序列2D 图像、窗宽窗位文字、三维视图都能渲染部署在子路径时确认PUBLIC_URL与 Nginx 或托管平台的路径一致否则静态资源 404核对响应头是否按预期带上了安全头Netlify 路线默认已有构建卡在依赖安装时先确认 Node 版本是否够新、有没有用错包管理器再看终端报错首行。清单过完后建议立刻做一件事复制platform/app/public/config/里的默认配置填入你自己的 Orthanc 地址重新pnpm build或直接在运行时面板里选打开任意一个 Study 验证读片——这一步过了部署才算真正完成。【免费下载链接】ViewersOHIF zero-footprint DICOM viewer and oncology specific Lesion Tracker, plus shared extension packages项目地址: https://gitcode.com/GitHub_Trending/vi/Viewers创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考