Deployment Adapters
astro-koharu 支持自动检测部署平台并选择对应的适配器。
支持的平台
| 平台 | 适配器 | 环境变量检测 |
|---|---|---|
| Vercel | @astrojs/vercel | VERCEL=1 |
| Cloudflare Pages/Workers | @astrojs/cloudflare | CF_PAGES=1 或 CLOUDFLARE |
| Netlify | @astrojs/netlify | NETLIFY=true |
| 自托管/Docker | @astrojs/node | 其他情况(保底) |
部署说明
Vercel
- 连接 GitHub 仓库到 Vercel
- 自动检测并使用
@astrojs/vercel适配器 - 一键部署:Deploy with Vercel
Cloudflare Pages
- 连接 GitHub 仓库到 Cloudflare Pages
- 构建命令:
pnpm build - 输出目录:
dist - 自动使用
@astrojs/cloudflare适配器
Netlify
- 连接 GitHub 仓库到 Netlify
- 构建命令:
pnpm build - 发布目录:
dist - 自动使用
@astrojs/netlify适配器
自托管(Node.js)
# 构建
pnpm build
# 运行
node dist/server/entry.mjs
或使用 Docker(见 /docker 目录):
./docker/rebuild.sh
本地测试
测试特定平台适配器:
# Vercel
VERCEL=1 NODE_ENV=production pnpm build
# Cloudflare
CF_PAGES=1 NODE_ENV=production pnpm build
# Netlify
NETLIFY=true NODE_ENV=production pnpm build
# Node.js (默认)
NODE_ENV=production pnpm build