docsify在线文档部署保姆教程

发布于:2025-07-10 ⋅ 阅读:(26) ⋅ 点赞:(0)


首图

前言

博主介绍:✌目前全网粉丝4W+,csdn博客专家、Java领域优质创作者,博客之星、阿里云平台优质作者、专注于Java后端技术领域。

涵盖技术内容:Java后端、大数据、算法、分布式微服务、中间件、前端、运维等。

博主所有博客文件目录索引:博客目录索引(持续更新)

CSDN搜索:长路

视频平台:b站-Coder长路


详细部署

安装 nvm

  1. 打开终端,运行以下命令下载并安装 nvm:bash复制
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

注意:v0.39.5 是当前最新版本,可以访问 nvm GitHub 查看最新版本。

  1. 安装完成后,重新加载 Shell 配置文件:bash复制
source ~/.bashrc  # 如果你使用的是 Bash
source ~/.zshrc   # 如果你使用的是 Zsh
  1. 验证 nvm 是否安装成功:bash复制
nvm --version

如果显示版本号,说明安装成功。

选择node版本同时全局安装docsify启动服务

# 切换node版本
nvm install v12.22.3
nvm use v12.22.3

# 配置国内加速镜像
npm config set registry https://registry.npmmirror.com

# 安装
npm install -g docsify-cli

# 校验版本
docsify -v

null

测试部署

举个例子:https://github.com/Vonng/ddia

把项目拷贝下来,将整个工具书放到目录里

img

cd /opt/tools/books/ddia-main
docsify serve

服务启动:

image-20250708122201452

测试访问下:

image-20250708122214957

这种方式不太建议,临时运行方式,一旦连接关闭就断了,下面的也不太稳定。

# 后台方式运行
nohup docsify serve > docsify.log 2>&1 &

建议用screen方式


screen虚拟会话终端启动服务

安装screen工具:

# 安装screen工具  yum -y install screen
sudo apt install screen

使用screen工具来使用一个会话去分别运行docsify:

# 创建一个叫ddia-main-docsify的虚拟终端(同时也是切换命令)
screen -R ddia-main-docsify

# 进入到该目录
cd /opt/tools/books/ddia-main

# 运行hbbs
docsify serve

# Ctrl+a和d返回主终端

查看下当前的会话:

screen -ls

表示运行成功!

# 删除终端  示范:screen -S 8669.myHbbr -X quit
screen -XS 终端名称 quit

资料获取

大家点赞、收藏、关注、评论啦~

精彩专栏推荐订阅:在下方专栏👇🏻

更多博客与资料可查看👇🏻获取联系方式👇🏻,🍅文末获取开发资源及更多资源博客获取🍅


网站公告

今日签到

点亮在社区的每一天
去签到