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

文章目录

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

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



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

第一步:准备 CentOS 服务器

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

第二步:安装 Node.js 和 Docsify

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

bash 复制代码
# 更新系统
sudo yum update

# 安装 Node.js 和 npm
sudo yum install -y nodejs

# 安装 Docsify
npm install -g docsify-cli

第三步:初始化 Docsify 项目

在你的项目目录中,执行以下命令初始化 Docsify 项目:

bash 复制代码
docsify init ./docs

这将在项目目录下创建一个名为 docs 的文件夹,并包含 Docsify 的默认文件结构。你可以将你的文档内容放置在 docs 文件夹中。

第四步:本地预览 Docsify 项目

在项目根目录运行以下命令:

bash 复制代码
docsify serve docs

这将启动一个本地服务器,并在终端中显示访问链接,通常是 http://localhost:3000。打开浏览器访问这个链接,你将看到 Docsify 文档站点。

第五步:配置 Nginx 服务器

在部署到生产环境之前,我们需要配置 Nginx 以便正确地服务 Docsify 项目。首先,确保你的服务器上已经安装了 Nginx:

bash 复制代码
sudo yum install -y nginx

然后,编辑 Nginx 配置文件:

bash 复制代码
sudo nano /etc/nginx/nginx.conf

http 块内添加一个新的 server 配置:

nginx 复制代码
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 以使更改生效:

bash 复制代码
sudo systemctl restart nginx

现在,你的 Docsify 项目已经通过 Nginx 部署在你的 CentOS 服务器上。通过访问你的域名或服务器 IP,你应该可以在浏览器中看到 Docsify 生成的漂亮文档站点。

拓展:使用 HTTPS 部署

如果你希望为你的 Docsify 项目启用 HTTPS,可以考虑使用 Let's Encrypt 免费 SSL 证书。具体步骤包括安装 Certbot 工具,获取证书,以及配置 Nginx 使用 SSL。这样,你的文档站点将在加密的连接上运行,提高安全性。

以上是在 CentOS 系统中将 Docsify 项目部署到 Nginx 的基本步骤。希望这个简单的指南能够帮助你成功搭建文档站点,并让你的文档更加专业和易于访问。


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

📜您可能感兴趣的内容:

相关推荐
静渊谋15 分钟前
应急响应整理
linux·windows
CODE_RabbitV24 分钟前
Linux 文件与目录操作命令宝典
linux·运维·服务器
gnawkhhkwang25 分钟前
io_submit系统调用及示例
linux·c语言
caz2826 分钟前
麒麟服务器版操作系统添加VNC
linux·服务器·centos·vnc
gnawkhhkwang28 分钟前
io_cancel系统调用及示例
linux·c语言
melody_of_Canon33 分钟前
uv 常用指令
linux·windows·uv
IT小辉同学1 小时前
CentOS 7 编译 Redis 6.x 完整教程(解决 GCC 版本不支持 C11)
linux·redis·centos
牛牛木有坏心眼(大数据进阶)1 小时前
linux系统离线环境安装clickhouse客户端
linux·clickhouse
草堂春睡足1 小时前
【数据迁移】Windows11 下将 Ubuntu 从 C 盘迁移到 D 盘
linux·windows·ubuntu·docker
zlpzlpzyd1 小时前
Zookeeper符合cap中的AP还是CP
linux·分布式·zookeeper