相关推荐recommended
如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中
作者:mmseoamin日期:2023-12-11

文章目录

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

      如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中,在这里插入图片描述,第1张

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


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

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

      如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中,在这里插入图片描述,第2张

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

        如何将 Docsify 项目部署到 CentOS 系统的 Nginx 中,在这里插入图片描述,第3张