uniapp部署到服务器
部署 Uniapp 项目到服务器的步骤
打包 Uniapp 项目
在项目根目录下运行打包命令。H5 项目使用 npm run build:h5,微信小程序使用 npm run build:mp-weixin。打包后的文件会生成在 /dist 目录下。
上传文件到服务器
将 /dist/build/h5(H5 项目)或对应平台的打包文件通过 FTP/SFTP 上传到服务器。确保服务器已安装 Web 服务(如 Nginx、Apache)。
配置 Web 服务器
以 Nginx 为例,修改配置文件(通常位于 /etc/nginx/conf.d/default.conf),添加以下内容:
server {
listen 80;
server_name yourdomain.com;
root /path/to/your/h5;
index index.html;
}
重启 Nginx 服务使配置生效。
域名解析与 HTTPS
在域名管理平台添加 A 记录指向服务器 IP。使用 Certbot 或手动配置 SSL 证书启用 HTTPS,提升安全性和兼容性。
测试访问
通过浏览器访问域名,确认页面加载正常。检查控制台是否有资源加载错误,必要时调整服务器配置或文件路径。
注意事项
- 部署 H5 项目时注意路由模式。History 模式需服务器配置 Fallback 到
index.html,Hash 模式无需特殊处理。 - 静态资源路径问题可在
manifest.json中设置基础路径,或修改打包配置为相对路径。 - 跨域问题需在服务器配置 CORS 头部,或通过代理接口解决。
其他平台部署
- 微信小程序:需通过开发者工具上传,审核通过后发布。
- App:打包为 APK/IPA 文件后上架应用商店或直接分发。
根据项目实际需求选择部署方式,并确保服务器环境与项目要求匹配。







