Nuxt3应用API部分部署疑问：cPanel Node.js环境配置求助

第一步：构建完整的Nuxt服务端产物 #

你之前仅生成了静态前端，但Server API属于Nuxt的服务端运行部分，不能直接上传原server目录的TS文件（Node无法直接执行TypeScript）。需在本地完成完整构建：

• 先安装依赖：npm install
• 执行构建命令：npx nuxi build
  执行后会生成.output文件夹，里面包含编译后的API代码、启动文件等所有服务端运行所需内容。

第二步：上传构建产物到cPanel #

• 应用根目录：将.output文件夹内的所有文件（而非整个文件夹）上传到cPanel中你指定的应用目录（比如public_html/nuxt-api）。
• 启动文件：.output/server/index.mjs就是服务端启动文件，在cPanel的“应用启动文件”项中填写该路径（需对应你上传的实际位置，比如server/index.mjs）。

第三步：配置cPanel Node.js参数 #

• 应用模式：选择prod（生产环境）
• 应用URL：填写你绑定的API域名/子域名（比如api.yourdomain.com），确保域名已解析到主机IP。
• 路由重写配置：在应用根目录创建.htaccess文件，内容如下（替换PORT为cPanel分配给Node应用的端口，可在cPanel设置页面查看）：

RewriteEngine On
RewriteRule ^(.*)$ http://localhost:PORT/$1 [P]

该文件用于将外部请求转发到Node服务的端口。

第四步：验证API运行 #

启动cPanel中的Node应用后，访问https://api.yourdomain.com/api/person，测试GET/POST/PUT/DELETE请求是否正常响应。

注意：

• 务必使用Nuxt构建后的.output产物，不要直接上传原server目录的TS文件。
• 确保主机Node.js版本与本地开发版本一致（建议v18及以上，符合Nuxt 3要求）。

内容的提问来源于stack exchange，提问作者Meaulnes