视频、Office、PDF 预览失败的排查清单

预览是体验敏感区。失败时按文件类型对号入座，绝大多数在这四张清单里。

视频音频播不出来

• H.265 视频 / AC3 音轨：浏览器普遍不支持，换编码或改用外挂播放器，详见 影音播放
• Safari 播不了：跨域响应头问题，开启该存储的「Web 代理」让 OpenList 中转
• 有声音没画面（或反之）：编码组合问题，同第一条
• 阿里云盘文件想转码播放：确认用的是阿里云盘 Open 驱动 + 「Aliyun Video Previewer」播放器选项

Office 文档打不开

微软在线预览的硬性条件缺一不可（详见 文档预览）：

1. 站点必须是公网域名 + 80/443 端口，IP 与非标端口直接出局
2. 格式在支持列表内（docx / xlsx / pptx 系；老 doc / xls / ppt 不行）
3. 大小没超限（Word、PPT 10MB 内，Excel 5MB 内）

四条全满足还打不开，多为微软服务偶发抽风，稍后再试。

PDF 预览空白

• 需要 HTTPS + CORS：没上 HTTPS 先配（反向代理 或配置文件证书）
• CORS 报错：网盘直链不允许跨域读取，开存储的「Web 代理」中转解决
• 打包下载同样受这两条约束，一起修

Markdown / 压缩包异常

• Markdown 表格、代码显示怪：默认 XSS 过滤所致；内容可信的话在「设置 - 预览」关闭「过滤 README 文件中的脚本」（关闭后安全责任自负，官方原文如此）
• 压缩包文件名乱码：老 zip 编码问题，「设置 - 预览」里把 ZIP 备选编码设为 GBK
• README 不渲染：确认文件名大小写精确为 README.md，且目录列表缓存已刷新（网页浏览）

通用两步

1. 换浏览器验证：Chrome / Edge / Firefox 新版各试一次，先排除浏览器插件干扰
2. 看直链能不能开：复制直链新标签页打开——直链都打不开就不是预览问题，回 报错速查