Lazy loaded image
技术分享
在宝塔面板上部署 Notion-Next 项目详细教程
Words 1037Read Time 3 min
2025-7-10
2025-7-10
type
status
date
slug
summary
tags
category
icon
password
本教程将指导您如何使用宝塔面板(BT Panel)轻松部署和上线 Notion-Next 项目。

准备工作

在开始之前,请确保您已经拥有:
  • 一台安装了宝塔面板的服务器。
  • 一个域名,并已将其解析到您的服务器 IP。
  • 一个 Notion 账号和 Notion Integration Token。
  • 一个准备公开展示的 Notion 页面。

步骤一:环境准备

首先,我们需要在宝塔面板中安装必要的软件并确认环境配置。
  1. 安装 PM2 管理器:
图片 (2316x960)
图片 (2316x960)
  • 登录您的宝塔面板。
  • 进入左侧菜单的 “软件商店”。
  • 在搜索框中输入 PM2,找到 “PM2管理器” 并点击 “安装”。
  1. 确认 Node.js 版本:
  • Notion-Next 需要 Node.js v16 或更高版本。
  • 在 “PM2管理器” 的设置界面,您可以查看和切换 Node.js 版本。如果版本过低,请在此处选择一个合适的版本进行安装。

步骤二:获取项目代码

接下来,我们将项目代码克隆到服务器上。
  1. 创建网站目录:
进入宝塔面板的 “网站” 菜单。
图片 (2145x1063)
图片 (2145x1063)
  • 点击 “添加站点”,输入您的域名,其他保持默认即可。这会自动在 /www/wwwroot 目录下创建一个与您域名同名的文件夹。
  1. 克隆代码:
  • 进入 “文件” 菜单,导航到刚刚创建的网站目录(例如 /www/wwwroot/yourdomain.com)。
  • 点击上方的 “终端” 按钮,打开命令行窗口。
图片 (1849x328)
图片 (1849x328)
  • 执行以下命令克隆 Notion-Next 项目:
  • 注意: 命令最后的 . 表示将代码克隆到当前目录。

步骤三:项目配置与构建

代码拉取后,我们需要安装依赖、配置项目并进行构建。
  1. 安装 pnpm:
  • 在终端中执行以下命令安装 pnpm
  1. 安装项目依赖:
  • 在项目根目录(终端当前路径)下,执行安装命令:
  1. 配置环境变量:
  • 将项目根目录下的 .env.example 文件复制一份并重命名为 .env
  • 双击打开 .env 文件,填入您的 NOTION_PAGE_IDNOTION_TOKEN
  1. 构建项目:
  • 执行构建命令,将项目编译为可运行的静态文件:

步骤四:项目上线

现在,我们使用 PM2 管理器来启动和管理项目。
  1. 添加 Node 项目:
  • 回到宝塔面板主界面,进入 “网站” 菜单。
  • 在网站列表中找到您的站点,点击右侧的 “设置”。
  • 在弹出的窗口中,选择 “Node项目” 选项卡。
  • 点击 “添加Node项目”。
  1. 配置项目信息:
  • 项目目录: 选择您之前创建的网站目录。
  • 启动文件/命令: 选择 “命令” 方式,并输入 pnpm start
  • 端口: 会自动分配一个未被占用的端口,保持默认即可。
  • 运行用户: 建议使用 www 用户。
  • 点击 “保存”。
  1. 设置反向代理:
  • 项目添加并启动成功后,宝塔会自动为您配置反向代理。
  • 您可以点击 “外网映射” 来确认域名是否已正确指向项目运行的端口。

步骤五:配置域名与 SSL

最后一步是为您的网站启用 HTTPS。
  1. 申请 SSL 证书:
  • 在站点的 “设置” 窗口中,选择 “SSL” 选项卡。
  • 选择 “宝塔/Let's Encrypt”,勾选您的域名,然后点击 “申请”。
  1. 强制 HTTPS:
  • 证书申请成功后,建议开启右上角的 “强制HTTPS” 开关,以确保所有访问都通过加密连接。
至此,您的 Notion-Next 项目已成功部署在宝塔面板上。您现在可以通过您的域名访问了!
上一篇
windows如何安装WSL
下一篇
教你在cursor中无限使用Claude3.7模型,手慢无!