#生产环境部署

如果你的 NocoBase 已经能在服务器上正常跑起来，正式上线时通常只需要再补两件事：

1. 让应用在机器重启后能自动恢复运行
2. 给应用加上反向代理入口，对外提供稳定访问

对应到 NocoBase CLI，主要就是下面两组命令：

• nb app autostart
• nb env proxy

这篇页先把整体路径讲清楚，具体到 Nginx 或 Caddy 的配置细节，再继续看各自的子页。

#第一步：配置应用自启动

生产环境里，第一件事不是“先配域名”，而是先确认服务本身能稳定恢复。否则机器重启、容器重建或者运维操作之后，应用可能不会自动起来。

在 CLI 里，nb app autostart 是一组子命令，不是单条直接完成所有事情的命令。最常用的是：

• nb app autostart enable
• nb app autostart list
• nb app autostart run

先为当前 env 开启自启动标记：

nb app autostart enable

如果你要操作的不是当前 env，可以显式指定：

nb app autostart enable --env app1 --yes

开启后，可以检查哪些 env 已经标记为自启动：

nb app autostart list

当系统启动后，需要执行下面这条命令，把所有已开启自启动的 env 拉起来：

nb app autostart run

如果你想在排查时看到底层启动输出，可以加上：

nb app autostart run --verbose

#适用范围

nb app autostart 只适用于有 CLI 托管运行时的 env，也就是：

• local
• docker

如果这个 env 只是远程 API 连接，或者不是当前机器上由 CLI 管理运行的应用，那么这组命令不适合用来做自启动。

#第二步：配置反向代理

应用能自动恢复运行之后，第二步再处理外部访问入口。对生产环境来说，反向代理通常负责这几件事：

• 绑定域名或入口端口
• 转发 HTTP / WebSocket 请求到 NocoBase
• 接管 HTTPS、证书、缓存或访问控制

在 NocoBase CLI 里，推荐入口是：

• nb env proxy nginx
• nb env proxy caddy

#默认做法

如果你的应用已经保存成 CLI env，并且属于 local 或 docker，通常直接让 CLI 生成配置就够了：

nb env proxy nginx --env app1 --host app.example.com
nb env proxy caddy --env app1 --host app.example.com

如果当前 env 就是目标 env，也可以省略 --env：

nb env proxy nginx --host app.example.com

CLI 会顺手帮你处理几类手写时很容易漏掉的细节，比如：

• WebSocket 转发
• 子路径场景下的入口和静态资源地址
• SPA 回退页
• provider 共享配置文件

#什么时候选 Nginx，什么时候选 Caddy

通常可以这样判断：

如果你修改了 app-port、app-public-path 这类会影响代理结果的 env 配置，记得重新执行对应的 proxy 子命令。

#默认上线路径

如果你想按最省心的方式完成生产环境上线，通常照这个顺序就可以：

1. 先确认应用已经能在服务器本机正常启动
2. 执行 nb app autostart enable
3. 把 nb app autostart run 接入系统启动流程
4. 选择 Nginx 或 Caddy，并执行对应的 nb env proxy 子命令
5. 用域名或入口地址验证外部访问是否正常

#快速索引

#相关命令

# 开启某个 env 的自启动标记
nb app autostart enable --env app1 --yes

# 查看自启动状态
nb app autostart list

# 启动所有已开启自启动的 env
nb app autostart run

# 生成 Nginx 反向代理配置
nb env proxy nginx --env app1 --host app.example.com

# 生成 Caddy 反向代理配置
nb env proxy caddy --env app1 --host app.example.com