nuxt3项目打包部署到服务器后配置端口号和开启https

news2025/1/23 7:40:00

nuxt3打包后的项目部署相对于一般vite打包的静态文件部署要稍微麻烦一些，还有一个主要的问题是开发环境配置的.env环境变量在打包后部署时获取不到，具体的解决方案可以参考我之前文章 nuxt3项目打包后获取.env设置的环境变量无效的解决办法。
这里使用的方法是在部署时的项目根目录增加.env文件，并在server/index.mjs修改代码读取。网上搜索到的通过更改./server/chunks/_/nitro.mjs定义的port这种方法在现版本已不适用。

本文是只使用node的部署方案，未用nginx反向代理。

本次项目使用的主要依赖版本如下：

"node":"22.12.0",
"nuxt":"3.15.2",
"vue":"3.5.13",
"vue-router":"4.5.0"

部署项目的服务器版本为：

Windows Server 2022 Datacenter

我们先将项目执行打包，在成功打包后，会有一行代码提示：

✔ You can preview this build using node .output/server/index.mjs

也就是说只要执行node .output/server/index.mjs，我们的项目就能跑起来了，执行后终端输出：

Listening on http://[::]:3000

可以看到默认使用的是http并且端口号是3000，那如何修改到使用https和目标端口号呢，这时需要打开.output/server/index.mjs文件，看看代码是如何执行的，主要是这段代码：

const cert = process.env.NITRO_SSL_CERT;
const key = process.env.NITRO_SSL_KEY;
const nitroApp = useNitroApp();
const server =
  cert && key
    ? new Server({ key, cert }, toNodeListener(nitroApp.h3App))
    : new Server$1(toNodeListener(nitroApp.h3App));
const port = destr(process.env.NITRO_PORT || process.env.PORT) || 3e3;
const host = process.env.NITRO_HOST || process.env.HOST;
const path = process.env.NITRO_UNIX_SOCKET;
const listener = server.listen(path ? { path } : { port, host }, (err) => {
  if (err) {
    console.error(err);
    process.exit(1);
  }
const protocol = cert && key ? "https" : "http";

很明显，它都是通过环境变量来判断是开启http还是https，以及是否有定义端口号，那我们只需要这里定义的环境变量能正常获取就行了。

需要注意的是：开启https还需要提供相应的SSL/TLS证书

假如项目部署的根目录是：D:\server-project

先将.output下的全部文件复制到server-project文件夹下，然后新建ssl文件夹，将证书文件放入；
新建.env文件，定义环境变量，添加如下内容：

NITRO_PORT=443 //端口号
NITRO_SSL_KEY="./ssl/demo.key" //相对于根目录的路径
NITRO_SSL_CERT="./ssl/demo.crt" //相对于根目录的路径，也可以是.pem文件

结果如图：
在这里插入图片描述

修改server-project/server/index.mjs，修改处已加注释说明，全文如下：

import process from "node:process";
globalThis._importMeta_ = { url: import.meta.url, env: process.env };
import { Server as Server$1 } from "node:http";
import { Server } from "node:https";
import {
  t as toNodeListener,
  d as destr,
  u as useRuntimeConfig,
  a as trapUnhandledNodeErrors,
  s as setupGracefulShutdown,
  b as useNitroApp,
} from "./chunks/_/nitro.mjs";
import "node:crypto";
import "node:buffer";
import "node:fs";
import "node:url";
import "uuid";
import "node:path";
/*  新增加的代码--start */
import { resolve } from "node:path";
import { loadEnvFile } from "node:process";
import { readFileSync } from "node:fs";
loadEnvFile(resolve(process.cwd(), "./.env"));
/*  新增加的代码--end */
const cert = process.env.NITRO_SSL_CERT;
const key = process.env.NITRO_SSL_KEY;
const nitroApp = useNitroApp();

 /* server更改前
 const server =
   cert && key
     ? new Server({ key, cert }, toNodeListener(nitroApp.h3App))
     : new Server$1(toNodeListener(nitroApp.h3App));
*/

// server修改后，主要是将cert和key的值读取后返回给Server
const server =
  cert && key
    ? new Server(
        {
          key: readFileSync(resolve(process.cwd(), key)),
          cert: readFileSync(resolve(process.cwd(), cert)),
        },
        toNodeListener(nitroApp.h3App)
      )
    : new Server$1(toNodeListener(nitroApp.h3App));
// 修改代码结束
const port = destr(process.env.NITRO_PORT || process.env.PORT) || 3e3;
const host = process.env.NITRO_HOST || process.env.HOST;
const path = process.env.NITRO_UNIX_SOCKET;
const listener = server.listen(path ? { path } : { port, host }, (err) => {
  if (err) {
    console.error(err);
    process.exit(1);
  }
  const protocol = cert && key ? "https" : "http";
  const addressInfo = listener.address();
  if (typeof addressInfo === "string") {
    console.log(`Listening on unix socket ${addressInfo}`);
    return;
  }
  const baseURL = (useRuntimeConfig().app.baseURL || "").replace(/\/$/, "");
  const url = `${protocol}://${
    addressInfo.family === "IPv6"
      ? `[${addressInfo.address}]`
      : addressInfo.address
  }:${addressInfo.port}${baseURL}`;
  console.log(`Listening on ${url}`);
});
trapUnhandledNodeErrors();
setupGracefulShutdown(listener, nitroApp);
const nodeServer = {};

export { nodeServer as default };
//# sourceMappingURL=index.mjs.map

代码修改完成后，在server-project目录下执行：

node ./server/index.mjs

到这一步，输入域名后网站就能正常访问了。

本次项目使用的是pm2部署，那么就还需要在server-project目录下新建一个pm2的配置文件ecosystem.config.json（也可以是ecosystem.config.js）和logs文件夹，这个按自己的部署需求配置就可以了，我的配置如下：

{
  "apps": [
    {
      "script": "./server/index.mjs",
      "name": "web",
      "instances": 1,
      "error_file": "./logs/err.log",
      "out_file": "./logs/out.log",
      "log_date_format": "YYYY-MM-DD HH:mm:ss",
      "log_type": "json",
      "ignore_watch": ["node_modules", "ssl", "logs"],
      "port": 443
    }
  ]
}