部署总览

Nexus 是 Nuxt 4 应用，运行时需要应用服务、PostgreSQL 和持久化上传目录。生产环境推荐使用 Docker Compose 运行应用，并使用云数据库或独立维护的 PostgreSQL。

先选择部署方式

方式	数据库	适用场景	建议
本机开发	本机或临时 Docker PostgreSQL	开发、产品体验	按快速开始操作
App Only Compose	外部 PostgreSQL	测试、生产	当前推荐，完整读取项目 .env
Full Compose	Compose 内置 PostgreSQL	单机体验	当前编排未完整读取 .env，修正前不要用于生产

产品工程中的 docker-compose.yml 是 App Only 模式，会通过 env_file: .env 注入配置。docker-compose-full.yml 当前仍包含旧的 NUXT_SESSION_SECRET，且没有注入管理员、NUXT_AUTH_SECRET、站点 URL 等配置；直接使用会与文档期望不一致。

部署架构

上线顺序

1. 准备 Linux 服务器、域名、HTTPS 证书和 PostgreSQL。
2. 复制 .env.example 为 .env，填写数据库、认证密钥、站点 URL 和管理员。
3. 使用 App Only Compose 构建并启动应用。
4. 查看日志，确认数据库迁移和应用启动完成。
5. 配置 Nginx，将外部 HTTPS 请求转发到应用的 3000 端口。
6. 登录 /admin，按首次进入管理后台完成站点、邮件、AI 和运营配置。
7. 按上线检查清单逐项验收。

部署完成的判断标准

检查项	正常结果
docker compose ps	应用容器处于运行状态
应用日志	没有启动失败或数据库连接错误
站点首页	https://你的域名/ 可以访问
管理后台	https://你的域名/admin 可以登录
数据持久化	重建应用容器后用户数据和上传文件仍存在
HTTPS	浏览器证书有效，HTTP 自动跳转 HTTPS

具体命令见Docker 部署，全部配置项见环境变量。