Skip to content

如何使用宝塔部署 VitePress

VitePress 是一个基于 Vue.js 的静态网站生成器,适用于文档和博客等场景。使用宝塔面板可以方便地部署 VitePress 项目。以下是详细的步骤:

前提条件

  1. 安装宝塔面板:确保你的服务器上已经安装了宝塔面板,并且可以通过浏览器访问。
  2. 安装 Node.js:在宝塔面板中安装 Node.js 环境。
  1. 安装Nginx:确保你的服务器上已经安装了 Nginx 作为 Web 服务器。
  2. 打包 VitePress:确保你已经在本地开发环境中完成了 VitePress 项目的开发,并且可以通过 npm run build 命令生成静态文件。

步骤一:创建网站

  1. 登录宝塔面板。
  2. 在左侧菜单中选择“网站”,点击“添加站点(HTML项目)”。
  3. 填写站点信息,包括域名、根目录等,点击“提交”。
  4. 在站点列表中找到刚创建的网站,点击“设置”,进入站点设置页面。

image5.png

步骤二:上传 VitePress 项目

  1. 在本地开发环境中,使用以下命令构建 VitePress 项
    bash
    npm run build
  2. 将生成的 dist 目录中的内容上传到宝塔面板中创建的网站根目录下。
    • 可以使用宝塔面板的文件管理器直接上传,或者使用 FTP 工具上传。
  3. 确保上传的文件结构正确,通常 index.html 文件应该位于网站根目录下。

步骤三:访问网站

  1. 打开浏览器,输入你在宝塔面板中设置的域名或 IP 地址。
  2. 如果一切配置正确,你应该能够看到 VitePress 生成的静态网站。

常见问题

1. 网站无法访问

如果网站无法访问,请检查以下几点:

  • 确保 Nginx 服务已重启。
  • 检查域名解析是否正确,确保域名指向了你的服务器 IP。
  • 查看宝塔面板的错误日志,检查是否有相关错误信息。

参考资料