docsify搭建文档系统（小白向）

预览

OMSEAR WIKI

安装nodejs(如果通过宝塔pm2安装，此步骤可以省略)

1. 下载nodejs

wget https://nodejs.org/dist/v16.14.2/node-v16.14.2-linux-x64.tar.xz

2. 解压安装

mv node-v16.14.2-linux-x64.tar.xz /usr/local/
cd /usr/local/
xz -d node-v16.14.2-linux-x64.tar.xz
tar -xvf node-v16.14.2-linux-x64.tar
ln -s node-v16.14.2-linux-x64 nodejs
rm -fr node-v16.14.2-linux-x64.tar
ln -s /usr/local/nodejs/bin/npm /usr/local/bin/
ln -s /usr/local/nodejs/bin/node /usr/local/bin/

3. 检查

node -v

---

安装docsify

1. 安装客户端

npm i docsify-cli -g

2. 建立软链接

 ln -s /usr/local/nodejs/bin/docsify /usr/local/bin/

安装宝塔面板

注意，如果安装了宝塔面板，除了阿里云vps端口外，宝塔面板也必须设置端口放行

https://www.bt.cn/new/download.html

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh ed8484bec

同步GitHub

通过 ls -al ~/.ssh 命令检查 SSH 密钥是否存在

ls -al ~/.ssh

image.png

生成新 SSH 密钥

执行以下命令，注意替换成你的邮箱：

ssh-keygen -t ed25519 -C "[email protected]"

然后一路回车：

image.png

复制密钥，在 id_ed25519.pub 文件中：

cat ./.ssh/id_ed25519.pub

image.png

添加 SSH 密钥到 GitHub 帐户

在个人账户的 settings 菜单下找到 SSH and GPG keys，将刚刚复制的密钥添加到 key 这一栏中，点击「add SSH key」提交。

image.png

Title 可不填写，提交成功后会列出对应的密钥：

image.png

pm2 守护执行

#创建启动脚本
vim script.sh
#设置启动方式
docsify serve xxxx

宝塔执行定时同步拉取

image.png

Nginx 部署

1. 宝塔安装nginx 服务器
2. 修改配置

image.png