NB文档doc.nbjs.ai
运维 / 常见问题

常见问题

启动报 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 里看不到

nb apps --json
curl http://localhost/_nb/health

子域名 HTTPS 打不开

控制台预览空白

如果提示 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 回退到上一个版本。