跳到主要内容

Vercel 部署

本文档介绍如何在 Vercel 上部署 OpenHuman 静态网站。

部署方式​

方式一：Vercel CLI（推荐）​

  1. 安装 Vercel CLI：
npm install -g vercel
  1. 登录 Vercel：
vercel login
  1. 进入项目目录并部署：
cd openhumanwiki
vercel

  1. 按提示配置：

    • 设置范围：Your Account 或特定 Team
    • 项目名称：openhumanwiki
    • 构建命令：npm run build
    • 输出目录：build

  2. 部署完成，获取预览 URL

方式二：连接 Git 仓库​

  1. 登录 Vercel Dashboard
  2. 点击「Add New」→「Project」
  3. 导入 GitHub 仓库
  4. 配置构建设置：
    • Framework Preset：Docusaurus
    • Build Command：npm run build
    • Output Directory：build
  5. 点击「Deploy」

vercel.json 配置​

创建 vercel.json：

{
  "buildCommand": "npm run build",
  "outputDirectory": "build",
  "framework": "docusaurus",
  "rewrites": [
    {
      "source": "/zh/:path*",
      "destination": "/zh/:path*/index.html"
    },
    {
      "source": "/:path*",
      "destination": "/:path*/index.html"
    }
  ]
}

自定义域名​

添加域名​

  1. 进入项目 → 「Settings」→「Domains」
  2. 输入域名 openhumanwiki.com
  3. 点击「Add」
  4. 按照提示配置 DNS 记录

DNS 配置​

在您的域名注册商处添加：

类型    名称    内容
CNAME   www     cname.vercel-dns.com

自动 HTTPS​

Vercel 自动为所有域名提供 SSL 证书。

环境变量​

如需在构建时使用环境变量：

  1. 进入项目 → 「Settings」→「Environment Variables」
  2. 添加变量名和值
  3. 重新部署使变量生效

边缘函数（可选）​

如需添加边缘逻辑，创建 api Edge Function:

// vercel.json 中配置
{
  "functions": {
    "api/*.js": {
      "runtime": "edge"
    }
  }
}

部署流程​

环境触发方式URL 格式
Preview每个 PR*.vercel.app
Production合并到 mainopenhumanwiki.com

常见问题​

构建失败​

检查构建日志，确保：

  • Node.js 版本正确（20.x）
  • 所有依赖正确安装

路由 404​

确保 vercel.json 的 rewrites 配置正确。

域名验证失败​

DNS 更改需要几分钟到 48 小时传播。

下一步​