运维 / 常见问题
常见问题
启动报 No such file or directory
Failed to initialize a JsRuntime: No such file or directory
shim.js 没有嵌入二进制。确认使用 ops::extension(),并重新构建。
rustls CryptoProvider 错误
Could not automatically determine the process-level CryptoProvider
rustls 同时启用了 ring 和 aws-lc-rs。tokio-rustls 只保留 ring。
启动即退出
日志提示“无法确定用户目录”时,检查 systemd 是否设置了 Environment=HOME=/root。
已加入 但 apps 里看不到
- 可能跑的是旧二进制,仍按
%USERPROFILE%\.nb找应用。 - 可能另一个实例占着端口。
nb apps --json
curl http://localhost/_nb/health
子域名 HTTPS 打不开
- 检查
*.nbjs.ai是否有通配符证书。 - 检查子域 DNS 是否指向服务器。
- 平台二级域名由 Host 第一段路由,找不到应用返回 404。
控制台预览空白
如果提示 X-Frame-Options,平台已经统一移除应用的该响应头。应用需要防点击劫持时改用 CSP 的 frame-ancestors。
本地 agent 余额为 0
agent 服务端访问 ai.localhost 会被 nb 的内网地址策略拦截。本地页面显示 0 是预期行为,线上 ai.nbjs.ai 正常。
PDF 中文失败
pdf_create 内置字体只支持英文。中文用 docx_create 或 ppt_create,PDF 用 pdf_merge 合并现成文件。
部署成功但页面 500
nb logs demo --limit 50
先看请求日志和 console 输出,再用 nb history demo 回退到上一个版本。