# 网站

网站发行会把项目编译为纯静态网页资源(PC Web、手机 H5),可以上传到 uniCloud 前端网页托管,也可以部署到自己的服务器或静态托管平台。

# 发行步骤

  1. 在 发行 菜单中选择 网站-PC Web或手机H5;
  2. 等待编译完成,产物默认生成在项目下的 unpackage/dist 目录(具体路径以命令输出为准)。

# 发行配置

配置项 说明
网站标题 发行类型为 H5 时可配置,不指定时默认为项目名称
网站域名 发行类型为 H5 时可配置
SSR(服务端渲染) 仅 Vue 3 项目生效

# 上传网站到服务器

# 上传到 uniCloud 前端网页托管

HBuilder V 内置 上传网站到服务器 命令,可以直接把网站产物上传到 uniCloud 前端网页托管:

  1. 确认已登录 DCloud 账号,并已开通包含前端网页托管的 uniCloud 服务空间;
  2. 在 发行 菜单中选择 上传网站到服务器,也可以在命令面板中执行同名命令;
  3. 在弹出的 前端网页托管 对话框中选择服务空间与上传目录,按需选择是否先构建项目,确认后开始上传;
  4. 上传完成后,用对话框提示的托管域名访问验证。

该命令仅支持 uni-app x(蒸汽模式)项目;如果提示"当前 uniCloud CLI 不支持网页托管上传",请升级 HBuilder V 或 uniCloud CLI 后重试。

# 上传到自有服务器

产物是纯静态文件,也可以直接上传到自己的 Web 服务器或静态托管:

  1. 把产物目录中的文件上传到 Web 服务器(如 Nginx、Apache、IIS)的站点根目录;
  2. 如果站点部署在子目录下,请先在 manifest.json 中配置 h5.router.base 并重新发行,否则会出现资源路径错误;
  3. 可以使用 FTP/SFTP 工具、scp、rsync 等方式上传,或接入 CI 自动发布;
  4. 上传完成后访问站点地址验证;H5 使用 history 路由时,需要在服务器配置回退到 index.html(如 Nginx 的 try_files)。

部署后如果接口请求失败,检查后端域名与跨域配置。

# SSR 发行

Vue 3 项目可以启用 SSR(服务端渲染) 发行:

  • SSR 发行时,如果网页托管服务商绑定了多个域名,需要指定域名;
  • 如果项目绑定了多个云服务空间,需要指定云函数上传的服务商(如 aliyun、alipay、tcb)。

# 常见问题

  • 部署后页面空白:检查 h5.router.base 是否与部署路径一致,以及服务器是否正确返回静态资源;
  • 刷新 404:H5 路由为 history 模式时,需要在服务器配置回退到 index.html;
  • 上传网站失败:确认已登录 DCloud 账号、已开通 uniCloud 服务空间,并检查 uniCloud CLI 版本。

更多问题见 常见问题。