部署指南

Fumomo-Nuxt 项目已针对 Vercel 部署进行了优化，同时也支持其他主流部署平台。

部署到 Vercel

自动部署（推荐）

这是最简单的部署方式：

1. Fork 或推送代码到 GitHub

   将你的项目代码推送到 GitHub 仓库。

2. 导入到 Vercel

   访问 Vercel，使用 GitHub 账号登录，然后导入你的仓库。

3. 自动检测并部署

   Vercel 会自动检测到这是一个 Nuxt 项目，并进行相应配置和部署。

4. 获取域名

   部署完成后，你将获得一个 .vercel.app 域名，可以立即访问你的网站。

手动部署

如果你更喜欢使用命令行：

# 安装 Vercel CLI
npm i -g vercel

# 登录 Vercel
vercel login

# 部署到生产环境
vercel --prod

环境变量配置

在 Vercel 控制台中配置以下环境变量：

变量名	说明	示例
RSS_URL	RSS 订阅地址	https://blog.example.com/rss.xml
NUXT_PUBLIC_SITE_URL	网站公开 URL	https://your-site.vercel.app

在 Vercel 控制台中：

1. 进入项目设置 Settings
2. 选择 Environment Variables
3. 添加上述变量

Vercel 部署优化

项目已包含以下 Vercel 优化配置：

• ✅ 使用 vercel-edge 预设，提升性能
• ✅ 预渲染首页，提高 SEO
• ✅ 自动缓存静态资源
• ✅ 支持 Serverless Functions

使用部署脚本

项目提供了一个便捷的部署脚本 deploy.sh：

#!/bin/bash

# 检查是否安装了 Vercel CLI
if ! command -v vercel &> /dev/null; then
    echo "❌ Vercel CLI 未安装"
    echo "请先安装: npm i -g vercel"
    exit 1
fi

# 构建项目
echo "📦 构建项目..."
pnpm build

if [ $? -eq 0 ]; then
    echo "✅ 构建成功!"

    # 部署到 Vercel
    echo "🌐 部署到 Vercel..."
    vercel --prod
fi

运行脚本：

chmod +x deploy.sh
./deploy.sh

部署到其他平台

Netlify

1. 在 Netlify 创建新站点
2. 连接你的 GitHub 仓库
3. 配置构建命令：
   • Build command: pnpm build
   • Publish directory: .output/public
4. 添加环境变量

自托管

如果你想自己托管：

# 构建项目
pnpm build

# 使用 Node.js 运行
node .output/server/index.mjs

或者使用 PM2：

pm2 start .output/server/index.mjs --name fumomo

自定义域名

在 Vercel 添加自定义域名

1. 进入 Vercel 项目设置
2. 选择 Domains
3. 添加你的域名
4. 按照提示配置 DNS 记录

DNS 配置示例

如果使用根域名：

A     @     76.76.21.21

如果使用子域名：

CNAME www   cname.vercel-dns.com

故障排除

构建失败

1. 确保 Node.js 版本 >= 18
2. 检查依赖是否正确安装
3. 查看 Vercel 构建日志

RSS 无法获取

1. 检查 RSS_URL 环境变量是否正确配置
2. 确保 RSS 源支持 CORS 或在服务端获取

样式异常

1. 清除浏览器缓存
2. 检查 Tailwind CSS 配置
3. 确认所有依赖版本兼容