vue3项目在宝塔上线
时间: 2025-04-16 13:14:25 浏览: 28
### 如何在宝塔面板上部署和配置 Vue3 项目
#### 准备工作
确保服务器已安装好宝塔面板,并能够正常访问。如果尚未安装,可以通过官方提供的链接进行下载并按照指引完成安装过程[^4]。
#### 创建环境变量文件
为了区分开发环境与生产环境的不同配置,在项目根目录下分别创建 `.env.production` 和 `.env.development` 文件用于定义不同环境下 API 接口的基础路径以及其他必要的参数设置[^5]:
对于生产环境下的 `.env.production` 文件应包含如下内容:
```bash
VITE_APP_BASE_API='接口的域名'
```
而对于开发环境中使用的 `.env.development` 则可以保持默认值或根据实际情况调整:
```bash
VITE_APP_BASE_API='/api'
```
同时需要更新 `axios` 中请求的基础 URL 及 Vite 构建工具的相关代理规则来适配这些变化:
```javascript
// 修改 axios 请求基础URL
baseURL: import.meta.env.VITE_APP_BASE_API;
// 调整 vite.config.js 内部关于跨域处理的部分
server: {
proxy: {
'/api': {
target: import.meta.env.VITE_APP_BASE_API,
changeOrigin: true,
rewrite: (path) => path.replace(/^\/api/, ''),
},
}
}
```
#### 编译构建项目
当所有的准备工作完成后就可以执行项目的编译操作了。进入 Vue 项目的根目录运行以下命令来进行打包:
```bash
npm run build
```
这将会生成一个名为 `dist` 的文件夹,里面包含了已经优化过的静态资源文件以及 HTML 页面等必要组成部分。
#### 添加站点至宝塔面板
利用远程连接窗口所提供的“外网面板地址”登录到宝塔管理界面之后,选择左侧菜单栏里的【网站】选项卡,点击上方按钮新增加一个新的站点并将所拥有的合法域名填写进去确认无误后提交保存即可。
#### 上传并解压 dist 文件夹
回到本地计算机中找到刚才由 `npm run build` 命令所产生的 `dist` 文件夹将其压缩成 ZIP 或者其他形式的压缩包以便于传输;接着返回到宝塔面板内对应的站点目录位置处通过 FTP/SFTP 协议或者其他方式把刚刚准备好的压缩包传上去最后记得要对其进行解压缩处理使得其中的内容得以正确展示出来[^2]。
#### 设置伪静态规则
为了让前端路由模式(history mode)能正常使用,还需进一步设定 Nginx 下游转发规则即所谓的「伪静态」功能。具体做法是在该站点设置里边找到【伪静态】标签页然后粘贴下面这段代码片段[^1]:
```nginx
location / {
try_files $uri $uri/ /index.html;
}
```
至此整个流程就全部结束了,现在应该可以在浏览器当中顺利浏览到自己精心打造的应用程序啦!
阅读全文
相关推荐


















