部署
部署到 EdgeOne Pages
将 HackerStart 部署到腾讯云 EdgeOne Pages
HackerStart 使用 EdgeOne Pages 作为默认部署平台。EdgeOne Pages 是腾讯云提供的边缘计算部署服务，支持全球加速和自动 SSL。
前提条件
- 一个 EdgeOne Pages 账户
- 项目代码推送到 Git 仓库
- 已完成
.env环境变量配置
本地开发
使用 EdgeOne 适配器在本地开发：
# 启动开发服务器（port 3000）
pnpm dev
# 使用 EdgeOne 适配器启动
edgeone pages dev生产构建
pnpm build构建产物输出到 dist/ 目录，包含 dist/client/ 和 dist/server/ 两部分。
部署到 EdgeOne Pages
方式一：CLI 部署
edgeone pages deploy方式二：Git 集成（推荐）
- 在 EdgeOne Pages 控制台创建新项目
- 连接 Git 仓库
- 配置构建设置：
- 构建命令：
pnpm build - 输出目录：
dist
- 构建命令：
- 配置环境变量（从
.env.example复制） - 推送代码触发自动部署
环境变量配置
在 EdgeOne Pages 控制台中配置以下环境变量：
| 变量 | 说明 | 必需 |
|---|---|---|
INSFORGE_URL | InsForge 服务地址 | ✅ |
INSFORGE_ANON_KEY | InsForge 匿名密钥 | ✅ |
INSFORGE_API_KEY | InsForge API 密钥 | ✅ |
SESSION_SECRET | Session 加密密钥 | ✅ |
VITE_INSFORGE_URL | 浏览器端 InsForge 地址 | ✅ |
VITE_INSFORGE_ANON_KEY | 浏览器端 InsForge 密钥 | ✅ |
自定义域名
在 EdgeOne Pages 控制台的「域名设置」中绑定自定义域名。
常见问题
构建失败
检查 Node.js 版本是否 >= 22，在 EdgeOne Pages 构建设置中指定 Node 版本。
环境变量未生效
确保 VITE_ 前缀的变量同时存在于构建设置中（客户端变量需要在构建时注入）。