部署

Valaxy 的部署非常简单，我们推荐你直接通过第三方的 CI 构建并托管到任意平台。

自行部署 ​

执行 build 命令构建，dist 文件夹为构建后的内容。

SSG 构建（默认 Valaxy SSG 引擎）最低需要 ~2 GB 堆内存；传统 vite-ssg 引擎需要 ~2.3 GB。如果遇到 JavaScript heap out of memory 错误，请设置：

第三方部署 ​

GitHub Pages ​

在使用 pnpm create valaxy 创建模版项目时，已内置文件.github/workflows/gh-pages.yml 以实现 GitHub Actions 的自动部署工作流。

• 选择 Github Repo，打开 Settings-> Action -> General -> Workflow permissions，选择 read and write permissions。
• 上传至 GitHub Repo，打开 Settings -> Pages，选择 gh-pages 分支。

gh-pages 已由 .github/workflows/gh-pages.yml 自动部署。

注意修改 gh-pages.yml 中的 on.push.branches 为你源代码所在的分支，默认为 main。

Netlify ​

已内置 netlify.toml。

• 连接 GitHub 仓库，可自动部署。

Vercel ​

对于已有的 Valaxy 博客，在开始部署之前，您需要先对您博客的 vercel.json 进行修改以便启用 cleanUrls 支持：

对于新创建的 Valaxy 博客，您只需要直接进行接下来的步骤即可。

• 在 Vercel 的 Dashboard 上，点击 Add New...，随后点击 Project 新建一个项目。
• 在左侧选择要部署的仓库，点击 Import，随后将 Framework Preset 设置为 Other 并更改 Build and Output Settings。
• 将 Output Directory 设置为 dist 后，点击 Deploy。
• 等待屏幕上撒下彩带后访问即可。

Cloudflare Pages ​

• 登录你的 Cloudflare 账号，从侧边栏导航至 “Workers 和 Pages” 页面。
• 点击 创建项目、连接到 Git，选择你的 GitHub 或者 GitLab 仓库，并点击 开始设置。
• 选择你的部署分支。
• 将 构建命令 设置为 pnpm build 。
• 将 构建输出目录 设置为 dist 。
• 点击 保存并部署。

Nginx ​

Nginx Docs

下面是一个 Nginx 服务器块配置示例 nginx.conf。此配置包括对基于文本的常见资源的 gzip 压缩、使用适当缓存头为 Valaxy 站点静态文件提供服务的规则以及处理 cleanUrls: true 的方法。

本配置默认已构建的 Valaxy 站点位于服务器上的 /usr/share/nginx/html 目录中。如果站点文件位于其他位置，请相应调整 root 指令。

Docker ​

Docker Docs

下面是一个 Dockerfile 示例，用于构建 Valaxy 站点并将其部署到 Nginx 服务器中。

请参考 Nginx 部分配置 nginx.conf，并将其放置于 Dockerfile 同一目录下。

其他 ​

你还可以使用 Render 等进行托管。