Netlify

更新于 2026年11月12日

Netlify 会读取项目根目录中一个小小的 netlify.toml，从中获取构建命令和发布目录。其余部分（Git 预览、原子部署、自定义域名）都会自动处理。

构建站点

livemark build

输出位于 .livemark/build/client/。

配置 `netlify.toml`

netlify.toml

[build]
command = "livemark build"
publish = ".livemark/build/client"

这就是 Netlify 所需的全部配置。如果你想在本地模拟平台的边缘行为，同一个文件还能让你使用 netlify dev。

使用 git 集成部署

推荐的方式：在 app.netlify.com/start 连接你的仓库。Netlify 会读取 netlify.toml，运行构建，并把每次推送到 main 的内容发布到生产环境。其他分支和 PR 会自动获得独立的部署预览 URL。

使用 CLI 部署

适用于一次性或脚本化的部署：

livemark build
netlify deploy --prod --dir=.livemark/build/client

首次运行时会提示你执行 netlify login，并将该目录关联到一个站点。

使用 GitHub Actions 部署

Netlify 的 git 集成通常就足够了，但使用工作流可以让部署以测试通过为前提：

.github/workflows/deploy.yaml

name: deploy

on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v5
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          cache: pnpm
          node-version: 24
      - run: pnpm install
      - run: pnpm test
      - run: pnpm livemark build
      - uses: nwtgck/actions-netlify@v3
        with:
          publish-dir: .livemark/build/client
          production-deploy: true
        env:
          NETLIFY_AUTH_TOKEN: ${{ secrets.NETLIFY_AUTH_TOKEN }}
          NETLIFY_SITE_ID: ${{ secrets.NETLIFY_SITE_ID }}

在 User settings → Applications → Personal access tokens 中获取认证令牌，在 Site settings → General 中获取站点 ID。

自定义域名

在站点控制台中进入 Domain management → Add a domain。Netlify 会配置 DNS 和证书。在 livemark.config.ts 中将同一域名设为 site。

另请参阅

站点元数据：site 用于填充 sitemap 和 RSS 订阅源的 URL。
部署：返回托管平台索引。