Linux 宝塔部署总览

本章目标

按顺序完成宝塔单机部署；每个步骤的详细设置见对应章节。

前置条件

已完成服务器和源码准备，具备宝塔与 SSH 访问权限。宝塔本身的安装按宝塔官方文档执行。

部署顺序

1. 在宝塔安装 Nginx、MySQL 8、Redis 和 Node.js 24。命令行与项目使用同一套 Node.js。
2. 创建独立数据库及专用账号，记录数据库和 Redis 的实际连接地址。
3. 上传并解压客户发行包，安装依赖，生成客户环境文件。
4. 填写域名、数据库、Redis 和首次管理员信息。
5. 生成 Prisma 客户端、应用增量迁移、编译 API，执行客户空库初始化。
6. 构建前台、后台与 Worker，创建三个常驻 Node.js 进程。
7. 配置 Nginx、域名和 HTTPS，验证前后台登录及文件访问。
8. 完成站点设置、源码授权确认和第一篇文章发布。

重要说明

后台是静态文件，不需要再创建一个 Vite 开发进程。API 的 PORT 与前台的 NITRO_PORT 不能相同。前台 /api/ 必须保留 Nuxt 会话代理，后台走 /admin-api/。

完成检查

依次阅读左侧安装章节。不要跳过检查直接打开支付或 AI 功能；这些服务在站点可用后单独配置。