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

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

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

1. 介绍

Docsify 是一个轻量级的文档生成工具，可以帮助你快速搭建文档网站。在本教程中，我们将学习如何将 Docsify 项目部署到运行 Nginx 的 CentOS 系统上，以便通过互联网访问你的文档。

2. 准备工作

在开始之前，确保你已经在 CentOS 服务器上安装了 Nginx，并且已经有一个 Docsify 项目。如果你还没有安装 Nginx，请使用以下命令安装：

sudo yum install nginx

在这里插入图片描述

3. 将 Docsify 项目上传至服务器

将 Docsify 项目的所有文件上传至你的 CentOS 服务器。你可以使用 scp 命令或其他工具将文件传输到服务器上。假设你的 Docsify 项目位于本地的 /path/to/your/docsify 目录，使用以下命令上传：

scp -r /path/to/your/docsify user@your_server_ip:/path/on/server

4. 在服务器上安装 Node.js

由于 Docsify 是基于 Node.js 的，因此需要在服务器上安装 Node.js。你可以使用 NVM（Node Version Manager）来方便地安装和管理 Node.js 版本。在服务器上执行以下命令：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash

安装完成后，重新加载终端或运行以下命令使 NVM 生效：

source ~/.bashrc

然后，使用以下命令安装 Node.js：

nvm install node

5. 在服务器上运行 Docsify

进入 Docsify 项目的根目录，并使用以下命令在服务器上运行 Docsify：

cd /path/on/server
docsify serve

你将看到输出类似于以下信息：

Serving /path/on/server now.
Listening at http://localhost:3000

这表示 Docsify 服务器已经在服务器的 3000 端口上运行。

6. 配置 Nginx 反向代理

现在，我们需要配置 Nginx 作为反向代理，将外部请求转发到 Docsify 服务。编辑 Nginx 配置文件：

sudo nano /etc/nginx/nginx.conf

在 server 块中添加以下配置：

server {
    listen 80;
    server_name your_domain_or_ip;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

替换 your_domain_or_ip 为你的域名或服务器 IP 地址。保存并关闭文件。

重启 Nginx 以使配置生效：

sudo systemctl restart nginx

7. 访问 Docsify 文档

现在，你可以通过浏览器访问 http://your_domain_or_ip 来查看部署在 CentOS 上的 Docsify 项目。你的文档现在应该能够在互联网上访问了。

8. 拓展

8.1 配置 HTTPS

为了提高安全性，建议配置 HTTPS。

8.2 定制 Docsify 主题

Docsify 提供了许多主题和插件，你可以根据需求定制你的文档主题，使其更符合你的品牌或风格。

8.3 鉴权和访问控制

如果你希望对文档进行访问控制，可以考虑使用 Nginx 的基本身份验证或其他鉴权方式。

通过本教程，你学会了将 Docsify 项目部署到运行 Nginx 的 CentOS 服务器上，并通过互联网访问你的文档。这样，你的文档将更容易分享和传播。