将你的 Astro 站点部署到 Seenode

Seenode 是一个用于构建和部署具有数据库、内置可观测性及自动扩展功能的 Web 应用部署平台。Astro 网站可通过服务端渲染（SSR）技术部署至 Seenode 平台。

本指南包含通过 Web 界面部署到 Seenode 的说明。

项目配置

SSR 适配器

要在你的 Astro 项目中启用按需渲染并部署到 Seenode，使用 astro add 命令添加 Node.js 适配器。这将安装适配器并对你的 astro.config.mjs 文件进行相应更改。

npx astro add node

pnpm astro add node

yarn astro add node

安装适配器后，更新你的 astro.config.mjs 并按 Seenode 的要求来配置服务器：

import { defineConfig } from 'astro/config';
import node from '@astrojs/node';

export default defineConfig({
  output: 'server',
  adapter: node({
    mode: 'standalone'
  }),
  server: {
    port: process.env.NODE_ENV === 'production' ? (Number(process.env.PORT) || 80) : 4321,
    host: true
  }
});

更新你的 package.json，添加一个启动脚本来运行已构建的服务器：

{
  "scripts": {
    "dev": "astro dev",
    "build": "astro build",
    "preview": "astro preview",
    "start": "NODE_ENV=production node ./dist/server/entry.mjs"
  }
}

请参考 Seenode 的 Astro 部署指南了解更多配置选项和故障排除方法。

如何部署

你可以通过 Web 界面连接你的 Git 仓库，将项目部署到 Seenode。

Web 界面部署

创建一个 Seenode 账户并登录。
推送代码到你的 Git 仓库（GitHub 或 GitLab）。
从 Seenode 控制面板创建一个新的 Web 服务 并连接你的仓库。
Seenode 会自动检测你的 Astro 项目。配置部署设置：
- 构建命令: npm ci && npm run build (或使用 pnpm / yarn 等效命令)
- 启动命令: npm start
- 端口: 80 (Web 服务必需)
选择你需要的实例大小并点击 创建 Web 服务。
你的应用将被构建并部署。完成后，你将收到一个 URL 来访问你的 Astro 网站，之后你可以将你的域名绑定到该网站。