iiabc
iiabc
发布于 2024-09-28 / 61 阅读
0
0

1Panel 部署 Fumadocs 文档

预览文档

https://iplugin.hiusers.com/docs/plugins

前提需要

  • Node.js 1.18+

  • 推荐 pnpm

  • 已安装的 1Panel

创建文档项目

https://fumadocs.vercel.app/docs/ui

根据官方文档安装方法来完成即可

它会询问您以下问题,基本选择 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 的标准端口。

外部端口可以根据具体需求进行自定义配置,值得注意的是,通常不需要使用 808080 端口,因为后续会进行反向代理设置。

在包管理器选项中,选择 pnpm,确保依赖管理高效便捷。

最后,容器名称同样可以自定义,以便于日后的管理和识别。

反向代理

依次点击网站 > 网站 > 创建网站 选项

选择 一键部署,在“已装应用”中选择刚刚创建的运行环境,然后填写域名即可轻松完成反向代理设置。


评论