1. 本地部署 Docsify
安装环境:Windows 10
准备工具: Node.js、Markdown 编辑器、cpolar 内网穿透工具
首先检查 Node.js 是否已安装。
node -v
查看 npm 是否已安装。
npm -v
如未安装,请前往 Node.js 官网下载安装。
安装完成后,安装 Docsify 本地全局工具。
npm i docsify-cli -g
初始化 Docsify 本地项目。
docsify init ./docs
启用本地网页预览。
docsify serve docs
2. 使用 Docsify 搭建个人博客
打开 ./docs 目录,可以看到初始化成功后创建的几个文件:
index.html:入口文件README.md:主页内容渲染.nojekyll:阻止 GitHub Pages 忽略下划线开头的文件
直接编辑 docs/README.md 即可更新文档内容。也可以添加更多页面。
制作个人文档需要配置以下基本文件:
| 文件作用 | 文件 |
|---|---|
| 基础配置项(入口文件) | index.html |
| 封面配置文件 | _coverpage.md |
| 侧边栏配置文件 | _sidebar.md |
| 导航栏配置文件 | _navbar.md |
| 主页内容渲染文件 | README.md |
| 浏览器图标 | favicon.ico |
参考 Docsify 文档中的定制化配置项进行设置。建议采用默认的文件渲染以简化维护。
封面配置文件示例(_coverpage.md)
封面的生成是从 Markdown 文件渲染来的。开启渲染封面功能后在文档根目录创建 _coverpage.md 文件。
index.html
<!-- index.html -->
<script>
window.$docsify = {
coverpage: true
}
</script>
<script src="//cdn.jsdelivr.net/npm/docsify/lib/docsify.min.js"></script>
<!-- _coverpage.md -->

# docsify <small>3.5</small>
> 一个神奇的文档网站生成器。
- 简单、轻便 (压缩后 ~21kB)
- 无需生成 html 文件
- 众多主题 [开始使用](/README.md)
打开新的浏览器,输入 localhost:3000 或本机 IP 地址:3000 即可查看本地搭建的文档博客。
目前博客已在本地搭建完成,如果没有公网 IP,只能在局域网环境使用。若需远程访问,可结合 cpolar 内网穿透生成公网地址,免去了本地重新部署过程,只需使用公网地址即可访问本地部署的 Docsify,随时管理网站。
3. 安装 Cpolar 内网穿透工具
下载并安装最新版本的 Cpolar 客户端。安装完成后,在浏览器上访问 http://localhost:9200,使用账号登录,进入 Web 配置界面。
4. 配置公网地址
登录后,点击左侧仪表盘的隧道管理——创建隧道。
创建一个个人博客网站的公网 HTTP 地址隧道:
- 隧道名称:自定义命名
- 协议:选择 http
- 本地地址:3000
- 域名类型:免费选择随机域名
- 地区:选择 China VIP
点击创建。
隧道创建成功后,点击左侧的状态——在线隧道列表,查看生成的公网访问地址,支持 HTTP 和 HTTPS 两种访问方式。
使用任意生成的公网地址,在电脑或任意设备的浏览器中登录访问,即可看到本地博客网站界面。
5. 配置固定公网地址
为配置固定的 HTTP 端口地址,该地址不会变化,方便长期分享。
在预留区域选择保留二级子域名,设置一个二级子域名名称,点击保留。保留成功后复制该名称。
返回 Cpolar Web UI 管理界面,点击左侧仪表盘的隧道管理——隧道列表,找到所要配置的隧道,点击右侧的编辑。
修改隧道信息,将保留成功的二级子域名配置到隧道中:
- 域名类型:选择二级子域名
- Sub Domain:填写保留成功的二级子域名
点击更新。
更新完成后,打开在线隧道列表,此时可以看到公网地址已变为固定的二级子域名名称。
最后,使用固定的公网地址在任何浏览器打开访问,即可成功访问使用 Docsify 搭建好的本地博客网站。

