部署到 Vercel
由于未知原因，Vercel 在进行项目构建时，其部署时包管理器安装行为似乎并不规范
我们已收到多起 Vercel 构建或部署失败的报告，均为 Vercel 部署时未执行 Post-install 或不正确下载二进制文件所致
所以，如果你并不强依赖 Vercel 平台的特性，建议使用 Netlify 或 EdgeOne 部署，这些平台未见有相关问题产生
Vercel 是一个现代化的前端部署平台，为 Astro 项目提供开箱即用的支持。部署 ShokaX 主题到 Vercel 非常简单，只需几分钟即可完成。
在开始之前，请确保：
步骤 1：导入项目
Section titled “步骤 1：导入项目”- 登录 Vercel Dashboard
- 点击 “Add New…” → “Project”
- 选择 “Import Git Repository”
TODO: 添加 Vercel Dashboard 导入项目界面截图
步骤 2：连接 GitHub 仓库
Section titled “步骤 2：连接 GitHub 仓库”- 在仓库列表中找到你的 ShokaX 项目
- 点击 “Import” 按钮
- 如果是首次导入，需要授权 Vercel 访问 GitHub
TODO: 添加选择 GitHub 仓库界面截图
步骤 3：配置项目
Section titled “步骤 3：配置项目”Vercel 会自动检测 Astro 框架并读取 vercel.json 配置，通常无需手动调整。
默认配置：
- Framework Preset: Astro
- Build Command:
bun run build - Output Directory:
dist - Install Command:
bun install
TODO: 添加项目配置界面截图
步骤 4：部署
Section titled “步骤 4：部署”- 检查配置无误后，点击 “Deploy” 按钮
- Vercel 会自动开始构建和部署
- 等待 1-3 分钟，构建完成后会显示部署成功页面
TODO: 添加部署进度界面截图
🎉 恭喜！ 你的 ShokaX 站点已成功部署，访问 Vercel 提供的 URL 即可查看。
- 进入项目的 Settings → Domains
- 输入你的域名（如
blog.example.com） - 点击 “Add”
TODO: 添加自定义域名设置界面截图
配置 DNS
Section titled “配置 DNS”Vercel 会提供 DNS 配置指引，通常有两种方式：
方式 1：CNAME 记录（推荐）
在你的域名服务商处添加 CNAME 记录：
| 类型 | 名称 | 值 |
|---|---|---|
| CNAME | blog | cname.vercel-dns.com |
方式 2：A 记录
| 类型 | 名称 | 值 |
|---|---|---|
| A | @ | 76.76.21.21 |
TODO: 添加 DNS 配置示例截图
津公网安备 12011402001353 号