文档
部署指南
实用指南：发布静态网站、准备框架构建输出、连接自定义域名，以及在 DeployPages 更新项目。
快速开始
部署就是把本机网站文件变成别人能打开的网址。DeployPages 是为静态输出设计，因此第一次发布可以从文件夹开始，不需要服务器设置。
选项 1：拖放部署
这是静态项目最快的路。网站已经是 HTML、CSS、JavaScript 或完成的构建文件夹时，可以直接上传。
适合
- 1准备项目文件夹
可部署文件夹应在根目录包含 index.html，并包含页面依赖的样式、script 或图片资源。
范例文件夹结构my-site/├── index.html├── styles.css├── script.js└── images/ ├── logo.png └── hero.jpg常见错误
如果 index.html 缺失或被放在子文件夹里，上传后网站无法正确解析。 - 2打开上传区
使用 DeployPages 的上传区。你可以先发布临时项目，之后想保留时再登录。
- 3上传文件夹
把完整文件夹拖进上传区，或从文件选择器选取。框架项目请上传构建输出文件夹，不是源码目录。
- 4开启生成的网址
上传完成后，DeployPages 会回传上线网址，可立即用于测试或分享。
选项 2：CLI 流程
当同一个 build 会反复发布，部署应该放进 script、CI job 或发布清单时适用。
项目变得可重复时使用
安装 CLI
使用你偏好的 package manager 全域安装 CLI。
npm install -g @deploypages/cli验证身份
执行 login 指令并完成浏览器授权流程。
deploypages login部署当前文件夹
从构建输出目录执行 deploy 指令。
deploypages deploy框架构建指南
现代框架上传前需要构建步骤。目标都一样：生成浏览器可直接打开的静态文件。
“build”是什么意思
React / Vue / Vite
npm run build上传 dist 文件夹本身，不是项目根目录。
Next.js static export
npm run build构建前先在 next.config.js 设置 output: 'export'。
纯 HTML
不需要构建步骤只要让 index.html 放在根目录。
Hugo / Hexo
hugo or hexo generate上传生成后的 public 文件夹。
Next.js export 范例
/** @type {import('next').NextConfig} */const nextConfig = { output: 'export', images: { unoptimized: true },};
module.exports = nextConfig;Static export 限制
自定义域名
第一次部署后，DeployPages 可以接上你自己的域名，让项目从系统网址移到品牌正式网址。
什么算域名？
步骤 1：在 Console 新增域名
进入项目设置，打开域名分页，加入你想连接的主机名。
步骤 2：设置 DNS
DeployPages 会提供所有权验证和流量路由所需的 DNS 目标。
步骤 3：等待验证
DNS 传播后，域名状态会变健康，HTTPS 设置也能完成。
| 类型 | 主机 | 值 | 用途 |
|---|---|---|---|
| CNAME | www | cname.deploypages.site | 把流量指向平台 |
| TXT | _deploypages-challenge | deploypages-verify=... | 验证域名所有权 |
选择主机记录
- 连接 www.example.com 时使用 www。
- 连接根域名 example.com 时使用 @。
- 连接 blog.example.com 时使用 blog 这类子域名标签。
更新网站
同一流程，新版本
- 1修改原始文件
在本机修改文案、样式、媒体或资源。
- 2必要时重新构建
如果项目使用框架，请先生成新的构建输出目录。
- 3打开项目 Console
回到 DeployPages 的项目页。
- 4上传新版本
用最新文件夹取代先前构建结果。部署历史会让新版本可追踪。
上传完成后，新构建结果会成为上线版本，上一个版本仍可用于回滚。