- 发布:2026-02-06 11:24
- 更新:2026-02-06 11:24
- 阅读:8
Ask小助手 - Ask社区AI助手
欢迎到专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
uniapp 项目要“部署自己的域名”通常分两步:
- 前端静态资源(h5)绑定自定义域名;
- 如果用了 unicloud,云函数 / 前端网页托管也要绑定自定义域名。
下面给出在知识库中能找到依据的完整流程,按场景对号入座即可。
一、纯 H5(不依赖 unicloud)
- 在 HBuilderX 菜单「发行 → 网站-H5手机版」生成 dist 资源(unpackage/dist/build/web)。
- 把生成的文件上传到你自己的服务器(香港或任意节点均可)。
- 在域名服务商把域名解析到这台服务器 ip;服务器 nginx 做静态托管即可。
- 若使用 history 路由,nginx 需加
location / { try_files $uri $uri/ /index.html; }参考文档:H5开发注意事项
- 若使用 history 路由,nginx 需加
二、使用 unicloud(阿里云版)
A. 前端网页托管绑定自定义域名
- 登录 unicloud web 控制台 → 前端网页托管 → 域名管理 → 添加域名。
- 按提示做 cname 解析,等待证书自动下发即可。
官方指引:前端网页托管配置域名
B. 云函数 url 化绑定自定义域名
- 在「云函数」列表里选中需要暴露 http 的云函数 → 编辑 → 域名绑定 → 添加自定义域名。
- 同样做 cname 解析,完成后即可用
https://你的域名/函数路径访问。
参考文档:云函数 url 化
C. 跨域设置
把「前端网页托管域名」和「云函数域名」互相加入对方的跨域白名单,否则 h5 调用云函数会报 cors 错误。
操作入口:unicloud 控制台 → 安全中心 → 跨域配置。
参考文档:H5 中使用 unicloud 的跨域处理
三、海外(东南亚等)访问加速
若目标用户在港澳台或海外,建议:
- 开通阿里云的「全球加速 ga」服务,对自有的自定义域名做加速;
- 把加速后的域名 cname 到
api.next.bspapp.com; - 前端初始化 unicloud 时传入 endpoint 参数指向该加速域名。
参考知识库:“unicloud 港澳台及境外用户访问比较慢怎么办” 一节。
四、常见疑问
- spaceid、clientsecret 被打包到前端是否不安全?
知识库已说明:这相当于传统开发把 api 域名暴露给前端,只要云函数/ db schema 做好权限校验即可,无需担心。
参考知识库:“只要启用了 unicloud … 这个问题怎么解决呀” 一节。
一句话总结
前端静态文件直接放到任何支持静态托管的服务器并解析域名即可;
如果用了 unicloud,就在 unicloud 控制台分别给「前端网页托管」和「云函数 url 化」绑定同一个顶级域名或子域名,按官方文档做 cname 与跨域配置即可实现“部署自己的域名”。