使用轻量应用服务器部署Docsify在线文档平台

本文涉及的产品
云服务器 ECS,每月免费额度200元 3个月
云服务器ECS,u1 2核4GB 1个月
简介: 借助阿里云轻量应用服务器的快速部署特性,只需要不到半小时就可以完成快速建站。

编者按:本文来自轻量应用服务器征文活动用户投稿,已获得作者(昵称CS社)授权发布。


无论是出于兴趣爱好需要搭建个人博客,还是工作需要建设信息发布站点,都需要一个信息管理平台或者叫CMS。如果你的经费有限、重在呈现文字内容而不在乎界面,那么本文或许会对你有所帮助——使用阿里云的轻量应用服务器来部署Docsify在线文档平台实现快速建站


Docsify是完全的静态网站,无需费力配置和维护数据库和管理后台。与WordPress、织梦这样的类博客系统相比,Docsify真的很简单,它基于MarkDown文档,可以直接像写文章或说明文档一样写网页,可以说比写WORD都要轻松。用MD文档的形式来管理内容,方便内容的更新、迁移和备份;同时借助阿里云轻量应用服务器的快速部署特性,只需要不到半小时就可以完成快速建站


Docsify官网地址:https://docsify.js.org/#/网站本身就是用Docsify搭建的。作为一个开源项目,Docsify提供了丰富的API,并且具备全文搜索功能。


当然为了方便后期维护站点需要,我们可以先在阿里云轻量服务器上部署宝塔面板作为基础。通过宝塔面板来维护Docsify,非常便捷,解决了文件管理和必要的Web服务配置问题。


接下来看一下详细的部署过程吧~


01 购买服务器并完成初始化


1、创建服务器

选择阿里云的轻量应用服务器。由于我们只是一个信息发布系统,选最低配置就可以满足需求。

01-轻量应用产品规格.jpg


2、选择宝塔镜像

建议直接使用预装了宝塔面板镜像,这样可以节省我们搭建应用服务的时间。而且宝塔面板非常人性化,免去了配置Linux服务的繁琐步骤。

02-BTpanel.jpg


02 配置服务器基础信息


购买完服务器并完成初始化后,就可以设置绑定站点域名并做好ICP备案工作。

image.gifimage009.png


可直接在阿里云上申请并设置域名解析。主机名就是域名前缀,默认的主机名一般是www(万维网),而@就是无域名前缀。添加A记录指向你租用的阿里云轻量服务器的公网地址,IP填在记录值里。当然你也可以添加其他字母数字组合作为主机名,实现分站点。

image011.png


03  宝塔面板配置


1、安全设置

在点击应用部署首页进入宝塔面板后,可以非常方便的管理Linux服务器。由于可以通过Web直接从公网访问到,因此建议进行安全设置,指定端口号。这样可以降低服务器被黑客的自动扫描脚本检测到和被入侵的风险。同时设置安全入口相当于在用户密码前加了一道锁,进一步提高安全性。

image013.png


需要注意由于面板的访问端口发生改变,需要同时修改阿里云轻量防火墙的策略,否则页面无法访问。设置的端口号需与宝塔面板的端口号一致。

image015.png


2、WEB服务配置

启动网站服务前,需要先安装WEB服务,建议选择宝塔面板中软件商店里的Nginx 服务,相比Tomcat占用内存很少,性能更好,更适合轻量应用服务器。安装之后别忘了点击启动服务。

image017.png


之后就可以选择网站选项,添加网站站点,输入注册好的域名主机名。需要注意的是网站的根目录位置,稍后我们需要将内容网页上传到这个目录下

image019.png


我之前已经设置好了DNS域名解析,就可以直接在浏览器中输入配置好的域名网址进行访问。看到下图说明宝塔面板上的web网站配置已生效。

image021.png


3、通过宝塔面板上传项目

虽然FTP是常用的网站上传工具,但宝塔的文件功能非常适合作为网站管理工具。直接选择宝塔面板主菜单上的文件选项,点击上传,选择本地网站文件或目录上传即可。

image023-打码.png


04  通过Node.js在本地生成Docsify项目


完成服务器的配置后,我们需要先在本地生成Docsify项目。由于Docsify这个JavaScript前端开源项目本身托管在Node.js的NPM包管理器上,所以生成Docsify前需要先安装Node.js。


1、安装Node.js

首先确定你的电脑上安装了Node.js,建议安装LTS(长期支持稳定版)的16.13版。

image025.png


2、NPM镜像源切换

由于Node.js的NPM包管理器在境外下载速度偏慢,建议先安装好Node.js后,先切换NPM源到国内的镜像。比如淘宝的CNPM服务器。在命令行中完成切换:


npm install -g cnpm --registry=https://registry.npm.taobao.org


安装之后若看到下方截图说明安装CNPM成功:

image027.png


3、用CNPM工具安装docsify-cli

在命令行中输入下方指令:


cnpm i docsify-cli -g


安装之后若看到下方截图说明安装Docsify成功:

image029.png


4、切换到你需要的目录下,生成Docsify项目

在命令行中输入下方指令:


docsify init ./docs


如果初始化成功会弹出下面的提示:

image031.png


在你指定的目录下生成Docsify的初始页面文件。

image033.png


5、查看项目页面效果

在命令行中输入下方指令:


docsify serve ./docs


这时如果返回下面的提示,说明服务已启动可以查看效果了。

image035.png


打开浏览器就可以看到一个空白的初始Docsify文档站已经建成了。

image037.png


05  编辑和配置Docsify项目


我们的站点不能只有一行主题词,需要为站点添加内容。最简单的方法是直接编辑项目docs目录下的README文档,保存文档并刷新浏览器之后,你编辑的内容会直接呈现在网页中。MarkDown的段落和语法非常好理解,建议直接看官方文档:

https://www.markdownguide.org/basic-syntax/


当然Docsify的高级功能比如侧边栏、导航栏和搜索框等功能都需要在docs目录下的index.html中进行配置才会生效。


1、 配置侧边栏和导航栏

通过在index.html中的script的window.$docsify中插入以下代码可以开启相关功能。


name: '导航目录',
loadSidebar: true,//开启侧边栏
subMaxLevel: 3,   //目录最大级数
maxLevel: 4,      //可配置最大支持渲染的标题层级


开启之后会出现如下图所示的侧边栏,可以显示多级标题:

image039.png


2、 配置全文搜索栏目

需要先在index.html中添加引用Docsify搜索插件的代码:


<script src="//cdn.bootcss.com/docsify/4.5.9/plugins/search.min.js"></script>


然后再通过在index.html中script的window.$docsify中加入以下代码可以实现:


search: {//添加搜索功能,中文和英文文档同时搜索
paths: 'auto',
placeholder: {
'/':'🔍 搜索',
},},//增加搜索框


开启之后会出现如下图所示的搜索栏,实现全文搜索:

image041.jpg



3、 拓展资源推荐

由于Docsify是一个开源项目,所以在Github上可以搜索到大量的相关丰富的插件和样例。以下两个网址供读者自己去探索拓展(点击即可跳转):

项目展示

插件下载


总结:

很多大公司都在用Docsify去做一些企业级的应用,对于个人用户而言,它也是是一个“万金油”的宝藏,可以用来做个人博客、说明文档、程序或代码管理等很多事情。希望上面的教程能够抛砖引玉,期待大家解锁轻量应用服务器更多实用、好玩的功能。


点击参与体验,查看轻量应用服务器更多的产品及活动信息。

相关实践学习
从零搭建Spring Boot的Hello World
本教程将使用IntelliJ IDEA搭建一个简单SpringBoot项目,在项目中运行一个Hello World请求示例,并部署到阿里云服务器ECS上。
相关文章
|
1月前
|
定位技术
GPS北斗卫星同步时钟(时间同步服务器)建设施工部署方案
GPS北斗卫星同步时钟(时间同步服务器)建设施工部署方案
GPS北斗卫星同步时钟(时间同步服务器)建设施工部署方案
|
1月前
|
存储 边缘计算 监控
【MODBUS】Modbus主站云端服务器和边缘设备部署区别
【MODBUS】Modbus主站云端服务器和边缘设备部署区别
36 0
|
1月前
|
存储 资源调度 应用服务中间件
浅谈本地开发好的 Web 应用部署到 ABAP 应用服务器上的几种方式
浅谈本地开发好的 Web 应用部署到 ABAP 应用服务器上的几种方式
27 0
|
1月前
|
弹性计算 运维 安全
2024年阿里云一键搭建部署幻兽帕鲁服务器解决方案
幻兽帕鲁火了,为了确保畅快体验游戏,构建高效、稳定的游戏服务器至关重要。幸运的是,阿里云为您提供了快速、简便的服务器搭建解决方案,即使您对技术知识了解有限,也能在短短一分钟内轻松完成《幻兽帕鲁》游戏的联机服务器搭建!
1453 4
|
2天前
|
域名解析 网络协议 安全
服务器部署访问出错的原因和解决办法
部署到服务器后无法访问可能是由于配置错误、权限问题或网络设置不当。解决办法包括检查服务器配置文件、确保文件路径正确、调整权限设置以及检查防火墙和端口设置。
11 4
|
7天前
|
Java 应用服务中间件 Linux
在阿里云服务器上部署Tomcat详细图文详解
本文介绍了在阿里云服务器上安装和配置JDK和Tomcat的步骤。首先,需要注册阿里云账号并进行实名认证,然后购买并设置服务器。接着,通过File Zilla连接服务器,创建Java和Tomcat的安装目录,并将JDK和Tomcat的tar.gz文件上传到服务器,解压并重命名。之后,配置JDK的环境变量,将catalina.sh复制到/etc/init.d/目录下,并修改相关配置。最后,启动Tomcat并配置安全组规则,确保可以通过公网访问。
|
7天前
|
弹性计算 Java Linux
阿里云服务器搭建部署宝塔详细流程
该内容是一个阿里云服务器和域名的配置指南。首先,需注册阿里云账号并进行企业实名认证。接着,选购服务器如2核2G1兆的Linux系统,并购买域名。完成域名备案后,进行域名解析和ICP备案。然后,通过远程连接登录服务器,重置密码,安装宝塔面板。在安全组中开启宝塔面板随机生成的端口。最后,登录宝塔面板安装LNMP环境,配置数据库如MySQL和Redis,部署JDK、Tomcat,上传前端和后端项目以实现上线。
|
8天前
|
弹性计算 JavaScript Java
阿里云服务器搭建部署宝塔详细流程
以下是内容的摘要: 本文主要介绍了在阿里云上创建和配置服务器环境的步骤,包括注册阿里云账号、实名认证、购买和设置服务器、域名的获取与备案、以及使用宝塔面板安装和配置环境。首先,用户需要注册阿里云账号并进行实名认证,选择合适的服务器配置。接着,购买服务器后,要准备并备案域名,以便通过友好的网址访问网站。在服务器上安装宝塔面板,可以方便地管理和配置LAMP/LNMP/Tomcat/Node.js等应用环境。完成这些步骤后,用户还需要在宝塔面板中安装MySQL、Redis等数据库,部署Java或Vue项目,并配置相关端口。最后,将前端项目打包上传至服务器,并设置站点,即可实现网站的上线。
|
8天前
|
应用服务中间件 Linux 开发工具
如何在阿里云服务器快速搭建部署Nginx环境
以下是内容的摘要: 本文档主要介绍了在阿里云上购买和配置服务器的步骤,包括注册阿里云账号、实名认证、选择和购买云服务器、配置安全组、使用Xshell和Xftp进行远程连接和文件传输,以及安装和配置Nginx服务器的过程。在完成这些步骤后,你将能够在服务器上部署和运行自己的网站或应用。
|
10天前
|
NoSQL 关系型数据库 MySQL
阿里云服务器部署项目流程
本文主要讲解阿里云服务器的部署,如何选择配置等

相关产品

  • 云服务器 ECS
  • 轻量应用服务器