如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中

IT·陈寒 2024-07-19 09:37:01 阅读 73

文章目录

第一步:准备 CentOS 服务器第二步:安装 Node.js 和 Docsify第三步:初始化 Docsify 项目第四步:本地预览 Docsify 项目第五步:配置 Nginx 服务器第六步:重启 Nginx 服务器拓展:使用 HTTPS 部署

在这里插入图片描述

🎉如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中


☆* o(≧▽≦)o *☆嗨~我是IT·陈寒🍹✨博客主页:IT·陈寒的博客🎈该系列文章专栏:AIGC人工智能📜其他专栏:Java学习路线 Java面试技巧 Java实战项目 AIGC人工智能 数据结构学习🍹文章作者技术和水平有限,如果文中出现错误,希望大家能指正🙏📜 欢迎大家关注! ❤️


在现代开发中,文档的重要性不言而喻。而 Docsify 是一个轻量级的文档生成工具,使得创建漂亮的文档网站变得非常简单。本文将引导你如何将 Docsify 项目成功部署到运行 CentOS 操作系统的服务器,并通过 Nginx 进行访问。

在这里插入图片描述

第一步:准备 CentOS 服务器

首先,确保你已经有一个运行 CentOS 操作系统的服务器,并且可以通过 SSH 连接。如果没有,你可以在云服务提供商(如阿里云、腾讯云)上创建一个 CentOS 服务器实例。

第二步:安装 Node.js 和 Docsify

在 CentOS 中,你需要安装 Node.js 和 npm(Node.js 包管理器)来运行 Docsify。使用以下命令安装:

<code># 更新系统

sudo yum update

# 安装 Node.js 和 npm

sudo yum install -y nodejs

# 安装 Docsify

npm install -g docsify-cli

第三步:初始化 Docsify 项目

在你的项目目录中,执行以下命令初始化 Docsify 项目:

docsify init ./docs

这将在项目目录下创建一个名为 docs 的文件夹,并包含 Docsify 的默认文件结构。你可以将你的文档内容放置在 docs 文件夹中。

第四步:本地预览 Docsify 项目

在项目根目录运行以下命令:

docsify serve docs

这将启动一个本地服务器,并在终端中显示访问链接,通常是 http://localhost:3000。打开浏览器访问这个链接,你将看到 Docsify 文档站点。

第五步:配置 Nginx 服务器

在部署到生产环境之前,我们需要配置 Nginx 以便正确地服务 Docsify 项目。首先,确保你的服务器上已经安装了 Nginx:

sudo yum install -y nginx

然后,编辑 Nginx 配置文件:

sudo nano /etc/nginx/nginx.conf

http 块内添加一个新的 server 配置:

server {

listen 80;

server_name your_domain.com; # 修改为你的域名或服务器 IP

location / {

root /path/to/your/docs; # 修改为你的 Docsify 项目绝对路径

index index.html;

try_files $uri $uri/ /index.html;

}

error_page 500 502 503 504 /50x.html;

location = /50x.html {

root /usr/share/nginx/html;

}

}

保存并退出。替换 your_domain.com 为你的域名或服务器 IP,/path/to/your/docs 为你的 Docsify 项目的绝对路径。

第六步:重启 Nginx 服务器

配置完成后,重启 Nginx 以使更改生效:

sudo systemctl restart nginx

现在,你的 Docsify 项目已经通过 Nginx 部署在你的 CentOS 服务器上。通过访问你的域名或服务器 IP,你应该可以在浏览器中看到 Docsify 生成的漂亮文档站点。

拓展:使用 HTTPS 部署

如果你希望为你的 Docsify 项目启用 HTTPS,可以考虑使用 Let’s Encrypt 免费 SSL 证书。具体步骤包括安装 Certbot 工具,获取证书,以及配置 Nginx 使用 SSL。这样,你的文档站点将在加密的连接上运行,提高安全性。

以上是在 CentOS 系统中将 Docsify 项目部署到 Nginx 的基本步骤。希望这个简单的指南能够帮助你成功搭建文档站点,并让你的文档更加专业和易于访问。


🧸结尾 ❤️ 感谢您的支持和鼓励! 😊🙏

📜您可能感兴趣的内容:

【Java面试技巧】Java面试八股文 - 掌握面试必备知识(目录篇)【Java学习路线】2023年完整版Java学习路线图【AIGC人工智能】Chat GPT是什么,初学者怎么使用Chat GPT,需要注意些什么【Java实战项目】SpringBoot+SSM实战:打造高效便捷的企业级Java外卖订购系统【数据结构学习】从零起步:学习数据结构的完整路径

在这里插入图片描述



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。