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

文章目录

    • 第一步:准备 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 进行访问。
如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中_第1张图片

第一步:准备 CentOS 服务器

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

第二步:安装 Node.js 和 Docsify

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

# 更新系统
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外卖订购系统
  • 【数据结构学习】从零起步:学习数据结构的完整路径

在这里插入图片描述

你可能感兴趣的:(Java学习路线,微服务架构设计,0基础搭建服务器,centos,nginx,linux)