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

文章目录


在这里插入图片描述

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

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。你可以使用免费的 Let’s Encrypt 证书来实现。

8.2 定制 Docsify 主题

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

8.3 鉴权和访问控制

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

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

🧸结尾 ❤️ 感谢您的支持和鼓励！ 😊🙏
📜您可能感兴趣的内容：

在这里插入图片描述

posted @ 2023-11-17 09:13  IT·陈寒  阅读(48)  评论(0)  编辑  收藏  举报  来源