NB文档doc.nbjs.ai
nb 命令行 / 配置与部署模板

配置与部署模板

根目录

默认 ~/.nb,可用进程环境变量 NB_HOME 覆盖。nb.toml、apps、cache、bin 都跟着根目录走。NB_HOME 不能写在 nb.toml 里。

全局配置

~/.nb/nb.toml:

[server]
port = 443
tls_cert = "/etc/letsencrypt/live/example.com/fullchain.pem"
tls_key = "/etc/letsencrypt/live/example.com/privkey.pem"
main_app = "space"
threads = 2
inflight = 8
lru_pool = 100

[backup]
remote = "s1:/root/uni-backup"
interval = 60

[mqtt]
enabled = true
host = "127.0.0.1"
port = 1883

[jwt]
secret = "..."

常用段:[server]、[backup]、[usage]、[static]、[sql]、[ws]、[mqtt]、[s3]、[jwt]。进程环境变量优先于同名项。

应用配置

应用目录的 nb.toml:

[app]
name = "demo"
modes = ["http"]
entry = "app.js"

[fs]
read = true
write = true
root = "files"
max_mb = 8

[sql]
enabled = true
mode = "async"

[security]
eval = false
function = false
wasm = false

[limits]
cpu_ms = 2000
request_ms = 30000
memory_mb = 128

平台全局配置是硬上限,应用只能收紧,不能放宽。

deploy.toml

远程部署时 app/deploy.toml 整体覆盖租户配置,渲染时替换 {{name}}:

配置优先级

进程环境变量 > 应用 nb.toml > 平台全局 nb.toml > 默认值

端口:-p > 环境变量 > [server] port > 默认值。