copyparty 网页提示 Looks like javascript is broken 且怀疑 Cloudflare Rocket Loader 干扰怎么排查?

原创2026-09-08 19:30:471,683 阅读
文章标签:后端存储通信认证鉴权CLI

copyparty 网页提示 Looks like javascript is broken 且怀疑 Cloudflare Rocket Loader 干扰怎么排查?

copyparty 是一个单文件便携文件服务器(WebDAV、SFTP、断点续传上传、缩略图等)。当它的网页打开后只显示一句 Looks like javascript is broken; see "csp nonce" section in readme 而无法进入正常的目录浏览界面时,说明网页里的 JavaScript 没有执行。如果你是通过反向代理、CDN、WAF(例如 Cloudflare)暴露服务,且怀疑 Cloudflare Rocket Loader 这类中间层改写了响应,这篇文章就是官方文档给出的排查路径:先定位是否是托管栈干扰,再确认 content-security-policy 响应头与 HTML 中的 nonce 是否一致。

提示语的来源与两种可能原因

这句提示语内置在网页模板 browser.html 中,是 copyparty 在检测到 javascript 因托管栈配置错误而无法工作时展示的解释(见 docs/changelog.md)。

copyparty 默认通过 content-security-policy 强制 "script nonces" 来阻止未授权的 javascript,帮助防 XSS。正常情况下这套机制自动生效,无需任何配置;只有配置比较特殊的托管环境才会出问题。README 的 "csp nonce" 一节 列出了两种可能原因:

  1. 浏览器太老、无法理解这些 javascript —— 文档认为这种可能性很低,因为几乎每个浏览器都被支持,甚至包括 IE 11;
  2. 托管栈中某个环节改写了 copyparty 的响应,破坏了这项安全机制。元凶通常是配置不当的反向代理、CDN、WAF 或其他中间人,文档明确点名一个常见肇事者:"cloudflare rocket loader"。

第一步:临时关闭 CSP 头,定位是否是托管栈干扰

按 README 的排查方法,临时为 copyparty 添加全局选项 --csp-ui no 和 --csp-dl no 并重启,看问题是否消失。--csp-ui 控制 web-UI 的 CSP(默认值为 script-src 'unsafe-eval' 'nonce-{{ js_nonce }}'; worker-src 'self'),--csp-dl 控制静态文件的 CSP;设为 no 时服务端不再发送对应的 Content-Security-Policy 头(见 authsrv.py)。在现有启动命令上追加这两个参数即可,例如:

copyparty --csp-ui no --csp-dl no <你原有的参数>

重启后必须用 CTRL-SHIFT-R 强制刷新浏览器再检查,否则缓存的页面无法正确判断结果。

  • 如果加了这两个参数后网页恢复正常,说明原因就是第 2 种:托管栈中的某个环节在改写响应(Cloudflare Rocket Loader 是文档点名的常见来源)。修复方向是调整该中间环节,使其不再篡改 copyparty 的 HTML 响应;文档没有给出具体的 Cloudflare 控制台操作步骤,只指出问题出在 "dangerously misconfigured" 的托管栈环节。
  • 如果加了这两个参数后网页仍然打不开,则不属于本文描述的托管栈干扰路径,应转向浏览器兼容性或其他网络问题自行判断。

第二步:恢复默认配置,并在 Network 面板核对 nonce

定位完成后,必须移除这两个临时参数(文档强调 never keep them enabled,即不要长期保持关闭状态),重启 copyparty,然后打开浏览器的 Network 标签页并刷新网页,核对两处 nonce 是否一致:

  1. content-security-policy 响应头中应包含 nonce,例如 nonce-BxcJbvdu1z3S/ycPBjVWuA==(文档示例值,实际每次生成的值不同);
  2. 该响应的 HTML 内部应出现同样的值,形如 <script nonce="BxcJbvdu1z3S/ycPBjVWuA==">。

两处一致且页面恢复正常,说明配置正确、排查结束;如果响应头里带 nonce、但 HTML 里的 <script nonce="..."> 没有出现或值被改动,问题就坐实了:托管栈中某处配置不当,正在破坏 CSP nonce 机制,需要回到反向代理 / CDN / WAF 的配置上去找会改写 HTML 的环节。

限制与注意

  • --csp-ui no / --csp-dl no 只用于临时定位问题。文档原话是 "never keep them enabled":长期关闭等于放弃对网页的 XSS 防护,定位完成后必须恢复默认并重启 copyparty。
  • 每次重启后都要用 CTRL-SHIFT-R 强制刷新再观察,普通刷新可能命中缓存、误导判断。
  • 该排查路径针对的是"网页提示语 + 托管栈改写响应"这一组合现象;如果你看到的报错是 thank you for playing(误封)或 https 被识别成 http,那是 real-ip 与反向代理配置 一节的另一类问题,不属于本文范围。
登录后查看全文
copyparty