Astro生产预览无法开启公网访问问题求助（Node适配器）

核心问题梳理 #

你混淆了Astro的开发/预览命令和生产服务启动流程：

• npm run dev是开发模式，支持实时热更新；
• astro preview是构建后的本地预览工具，并非生产环境服务；
• Astro没有默认的npm run start生产启动命令，需要结合Node适配器的构建产物来启动。

分步解决方案 #

1. 正确的生产环境启动流程 #

首先执行构建命令生成生产产物：

npm run build

由于你配置了Node适配器的standalone模式，构建后会在dist/server目录生成可独立运行的入口文件，直接用Node启动即可：

# 指定公网可访问的地址和端口
HOST=0.0.0.0 PORT=3011 node dist/server/entry.mjs

• HOST=0.0.0.0：让服务监听所有网卡，允许公网/局域网访问；
• PORT=3011：指定服务运行端口。

2. 解决astro preview的端口与公网访问问题（仅用于预览，非生产） #

你之前执行npx astro preview -- --host --port=3011参数传递错误，Astro的preview命令不需要额外的--分隔符，正确命令是：

npx astro preview --host 0.0.0.0 --port 3011

或者在配置文件中给preview单独配置：

export default defineConfig({
  // 开发模式配置
  server: {
    port: 3011,
    host: true,
  },
  // 预览模式配置
  preview: {
    port: 3011,
    host: '0.0.0.0', // 明确指定监听所有网卡
  },
  output: "server",
  integrations: [
    tailwind({
      config: {
        applyBaseStyles: false,
      },
    }),
    svelte(),
  ],
  adapter: node({
    mode: "standalone",
  }),
});

此时执行npx astro preview就能公网访问了，但记住这只是预览工具，不适合生产环境。

3. Node适配器配置与Nginx配合 #

你的Node适配器standalone模式配置是正确的，生产环境下只需要：

• 确保Node服务启动时指定HOST=0.0.0.0，允许Nginx或外部请求访问；
• 配置Nginx反向代理，示例配置：

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:3011;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

这样用户访问你的域名时，Nginx会把请求转发到本地3011端口的Node服务。

总结 #

• 生产环境不要用astro preview，必须先build再启动Node产物；
• 公网访问的关键是让服务监听0.0.0.0而非默认的localhost；
• Node适配器的standalone模式无需额外修改，启动时通过环境变量指定host和端口即可。

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