部署

Node.js 部署是 Analog 为生产环境构建的默认预设输出。

在默认预设情况下运行 npm run build 时，编译结果就是一个 ready-to-run 的 Node 服务。

要单独启动这个服务，可以运行：

$ node dist/analog/server/index.mjs
Listening on http://localhost:3000

环境变量

你可以用下面的环境变量自定义一些服务器行为：

NITRO_PORT or PORT (defaults to 3000)
NITRO_HOST or HOST

内置的预设

Analog 可以一套代码为不同的主机托管商提供相应的输出格式，你可以通过环境变量或者 vite.config.ts 修改部署预设。

以来 CI/CD 的部署建议使用环境变量。

例如: 使用 BUILD_PRESET

BUILD_PRESET=node-server

例如: 使用 vite.config.ts

import { defineConfig } from 'vite';

export default defineConfig({
  plugins: [
    analog({
      nitro: {
        preset: 'node-server',
      },
    }),
  ],
});

部署时自定义 URL 前缀

如果你部署时需要指定一个自定义的 URL 前缀，例如 https://domain.com/ basehref/ 你必须确保服务端数据获取，HTML 标记和资源和动态 API 路由能在 basehref 下正常工作。

更新你的 vite.config.ts 文件。

export default defineConfig(({ mode }) => ({
  base: '/basehref',
  plugins: [
    analog({
      ...(mode === 'production'
        ? { apiPrefix: 'basehref' }
        : { apiPrefix: 'basehref/api' }),
      prerender: {
        routes: async () => {
          return [];
        },
      },
    }),
  ],
}));

更新 app.config.ts 文件。

这里告知 Angular 如何识别并生成对应的 URL。

import { ApplicationConfig } from '@angular/core';
import { APP_BASE_HREF } from '@angular/common';

export const appConfig: ApplicationConfig = {
  providers: [
    [{ provide: APP_BASE_HREF, useValue: import.meta.env.BASE_URL || '/' }],
    ...
  ],
};

HttpClient 使用 injectAPIPrefix()。

const response = await firstValueFrom(
  this.httpClient.get<{ client: string }>(`${injectAPIPrefix()}/v1/hello`),
);

在 CI 生产环境构建

不要设置 VITE_ANALOG_PUBLIC_BASE_URL，它应该使用 vite.config.ts 中的设置。如果构建期间存在 VITE_ANALOG_PUBLIC_BASE_URL，ssr 数据将在服务器和客户端上重新获取。

  # if using nx:
  npx nx run appname:build:production
  # if using angular build directly:
  npx vite build && NITRO_APP_BASE_URL='/basehref/' node dist/analog/server/index.mjs

在生产环境的镜像指定环境变量 NITRO_APP_BASE_URL。

NITRO_APP_BASE_URL="/basehref/"

本地预览：

npx vite build && NITRO_APP_BASE_URL='/basehref/' node dist/analog/server/index.mjs

环境变量​

内置的预设​

部署时自定义 URL 前缀​

环境变量

内置的预设

部署时自定义 URL 前缀