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

文章目录

- [1. 介绍](#1. 介绍)
- [2. 准备工作](#2. 准备工作)
- [3. 将 Docsify 项目上传至服务器](#3. 将 Docsify 项目上传至服务器)
- [4. 在服务器上安装 Node.js](#4. 在服务器上安装 Node.js)
- [5. 在服务器上运行 Docsify](#5. 在服务器上运行 Docsify)
- [6. 配置 Nginx 反向代理](#6. 配置 Nginx 反向代理)
- [7. 访问 Docsify 文档](#7. 访问 Docsify 文档)
- [8. 拓展](#8. 拓展)
- - [8.1 配置 HTTPS](#8.1 配置 HTTPS)
  - [8.2 定制 Docsify 主题](#8.2 定制 Docsify 主题)
  - [8.3 鉴权和访问控制](#8.3 鉴权和访问控制)

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

☆* o(≧▽≦)o *☆嗨~我是IT·陈寒🍹

✨博客主页：IT·陈寒的博客

🎈该系列文章专栏：Java学习路线

📜其他专栏：Java学习路线 Java面试技巧 Java实战项目 AIGC人工智能数据结构学习

🍹文章作者技术和水平有限，如果文中出现错误，希望大家能指正🙏

📜 欢迎大家关注！ ❤️

1. 介绍

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

2. 准备工作

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

bash 复制代码

sudo yum install nginx

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

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

bash 复制代码

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 版本。在服务器上执行以下命令：

bash 复制代码

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

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

bash 复制代码

source ~/.bashrc

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

bash 复制代码

nvm install node

5. 在服务器上运行 Docsify

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

bash 复制代码

cd /path/on/server
docsify serve

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

bash 复制代码

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

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

6. 配置 Nginx 反向代理

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

bash 复制代码

sudo nano /etc/nginx/nginx.conf

在 server 块中添加以下配置：

nginx 复制代码

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 以使配置生效：

bash 复制代码

sudo systemctl restart nginx

7. 访问 Docsify 文档

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

8. 拓展

8.1 配置 HTTPS

为了提高安全性，建议配置 HTTPS。你可以使用免费的 Let's Encrypt 证书来实现。

8.2 定制 Docsify 主题

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

8.3 鉴权和访问控制

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

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

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

📜您可能感兴趣的内容：

【Java面试技巧】Java面试八股文 - 掌握面试必备知识（目录篇）

【Java学习路线】2023年完整版Java学习路线图

【AIGC人工智能】Chat GPT是什么，初学者怎么使用Chat GPT，需要注意些什么

【Java实战项目】SpringBoot+SSM实战：打造高效便捷的企业级Java外卖订购系统

【数据结构学习】从零起步：学习数据结构的完整路径