预览文档
前提需要
Node.js 1.18+
推荐 pnpm
已安装的 1Panel
创建文档项目
根据官方文档安装方法来完成即可
它会询问您以下问题,基本选择 Yes:
使用哪个内容源?(推荐:Fumadocs MDX)
配置 Tailwind CSS 吗?
安装依赖项吗?
上传项目
在进行部署之前,需要将项目上传到服务器。可以选择以下两种方法:
Git 克隆和拉取:这种方法可以方便地将项目代码从 GitHub 等平台直接克隆、拉取更新到服务器上。
手动上传文件夹:可以通过文件传输工具(推荐Xterminal)将项目文件夹手动上传至服务器。
本笔记将以 Git 和 GitHub 为例进行说明
Git 克隆
首先,在 GitHub 项目仓库中复制克隆地址。
接下来,登录到服务器,并在希望存放该项目的目录下(cd ~/xxx
)输入以下命令,以将项目克隆到服务器上:
git clone 克隆地址
请确保在正确的目录中执行此操作,以便项目能够顺利克隆。
安装项目依赖
在服务器上,进入项目目录后,使用相应的命令安装项目依赖。
确保使用与项目创建时相同的工具进行安装。
例如,如果是使用 pnpm
创建的项目,就要用 pnpm
来安装依赖:
pnpm install
构建项目
在项目准备就绪后,可以通过以下命令构建项目:
pnpm run build
执行此命令将根据项目的配置生成可供生产环境使用的构建文件,该项目输出到 .next
目录。
这个过程会对代码进行优化和压缩,以确保项目在部署时具有最佳性能。
1Panel 创建运行环境
依次点击网站 > 运行环境 > Node.js 选项,选择 创建运行环境。在此步骤中,可以为运行环境自定义一个易于识别的名称。
接下来,选择 Node.js 版本,这里我选择使用 22.2.0。
将启动命令设为 pnpm run start
,确保项目能够启动。
应用的端口默认设置为 3000,这是 Next.js Fumadocs 的标准端口。
外部端口可以根据具体需求进行自定义配置,值得注意的是,通常不需要使用 80 或 8080 端口,因为后续会进行反向代理设置。
在包管理器选项中,选择 pnpm,确保依赖管理高效便捷。
最后,容器名称同样可以自定义,以便于日后的管理和识别。
反向代理
依次点击网站 > 网站 > 创建网站 选项
选择 一键部署,在“已装应用”中选择刚刚创建的运行环境,然后填写域名即可轻松完成反向代理设置。