Markdown文档网站生成器新标杆：+Docsify的零构建模式与cpolar公网访问方案

admin管理员组

文章数量:1130349

文章目录

• • 前言
  • 1. 本地部署Docsify
  • 2. 使用Docsify搭建个人博客
  • • • • 封面配置文件（_coverpage.md）
  • 3. 安装Cpolar内网穿透工具
  • 4. 配置公网地址
  • 5. 配置固定公网地址

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家 点击跳转到网站

前言

作为一款以轻量化著称的文档管理系统，Docsify重新定义了静态内容开发流程。其核心机制在于动态解析Markdown文件——无需预编译生成HTML页面（区别于Hexo等工具），所有转换工作在用户浏览器端实时完成。这种“运行时渲染”特性使得开发者只需维护纯文本文件即可管理整个站点：创建index.html后，文档保存即刻生效，内容自动更新到网页界面，特别适合需要快速迭代的团队协作场景。

技术架构层面展现了多重优势：

• 轻量级设计（压缩包仅21KB）确保极低资源占用，兼容IE11等老旧浏览器环境；
• 服务端渲染支持为SEO优化提供保障，同时智能搜索功能可实现全文快速检索；
• 丰富API接口允许深度定制页面逻辑，例如集成版本控制系统或添加自定义组件。

结合cpolar内网穿透服务后，文档分享效率获得显著提升。当需要将本地开发的教程或知识库对外发布时（如展示项目技术文档），无需申请公网IP或配置NAT转发——只需通过加密隧道映射本地端口即可生成安全访问链接，所有交互均遵循HTTPS协议保障数据隐私。

本文主要介绍如何在Windows环境本地部署 Docsify 这款以 markdown 为中心的文档编辑器，并即时生成您的文档博客网站，结合cpolar内网穿透还能将博客一键发布至公网允许所有人访问，无需公网IP，也不用设置路由器那么麻烦。

接下来，讲解如何在本地部署Docsify。

1. 本地部署Docsify

本篇文章安装环境：Windows10

Docsify 项目github地址：GitHub - docsifyjs/docsify: 🃏 A magical documentation site generator.

Docsify官方文档教程：https://docsify.js/#/zh-cn/

准备工具： node.js、Typora、cpolar内网穿透

Node.js （官网）：https://nodejs/zh-cn

Typora（官网）：https://typoraio

首先查看node.js是否已安装

node -v

查看npm是否已安装

npm -v

如未安装，进入到node.js官网下载安装

安装完后，接下来需要安装Docsify本地全局工具

npm i docsify-cli -g

初始化Docsify本地项目

docsify init ./docs

启用本地网页预览

docsify serve docs

2. 使用Docsify搭建个人博客

打开 此电脑——C盘——用户——文档——docs文件夹

初始化成功后，可以看到 ./docs 目录下创建的几个文件

• index.html 入口文件
• README.md 会做为主页内容渲染
• .nojekyll 用于阻止 GitHub Pages 忽略掉下划线开头的文件

直接编辑 docs/README.md 就能更新文档内容，当然也可以[添加更多页面。

打开 README文档，做为主页内容渲染

在这个文档中进行修改，设计自己的个人博客，修改标题，添加文章内容，并保存

制作一个个人文档，我们只需要配置以下这几个基本文件就可以：

文件作用	文件
基础配置项（入口文件）	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/npm/docsify/lib/docsify.min.js"></script>
<!-- _coverpage.md -->

![logo](_media/icon.svg)

# docsify <small>3.5</small>

> 一个神奇的文档网站生成器。

- 简单、轻便 (压缩后 ~21kB)
- 无需生成 html 文件
- 众多主题

[开始使用 Let Go](/README.md)

继续回到我们刚才搭建的页面，打开一个新的浏览器，输入localhost:3000，或者本机IP地址:3000

这样我们就在本地搭建了一个简单的个人文档博客，博客排版风格也可以自己随意设计，但是目前我们已经在本地搭建好了博客网站，如果没有公网IP的话，只能在本地局域网环境使用，有一定的局限性。如果出门在外想远程访问使用的话，可以结合cpolar内网穿透生成公网地址，免去了本地重新部署过程，只需要使用公网地址直接进就可以访问本地部署的Docsify，随时管理网站。

3. 安装Cpolar内网穿透工具

下面是安装cpolar步骤：

Cpolar官网地址: https://www.cpolar

点击进入cpolar官网，点击免费使用注册一个账号，并下载最新版本的Cpolar

登录成功后，点击下载Cpolar到本地并安装（一路默认安装即可）本教程选择下载Windows版本。

Cpolar安装成功后，在浏览器上访问http://localhost:9200，使用cpolar账号登录,登录后即可看到Cpolar web 配置界面,结下来在web 管理界面配置即可。

4. 配置公网地址

接下来配置一下本地 Docsify 的公网地址，

登录后，点击左侧仪表盘的隧道管理——创建隧道，

创建一个 个人博客网站 的公网http地址隧道：

• 隧道名称：可自定义命名，注意不要与已有的隧道名称重复

• 协议：选择 http

• 本地地址：3000

• 域名类型：免费选择随机域名

• 地区：选择China VIP

点击创建

隧道创建成功后，点击左侧的状态——在线隧道列表,查看所生成的公网访问地址，有两种访问方式,分别是http和https。

使用任意一个上面Cpolar生成的公网地址,在电脑或任意设备在浏览器进行登录访问,即可成功看到 本地博客网站 界面,这样一个可以远程访问的公网地址就创建好了,使用了Cpolar的公网域名,无需自己购买云服务器,即可在公网访问本地部署的服务了！

5. 配置固定公网地址

我们接下来为其配置固定的HTTP端口地址，该地址不会变化，方便分享给别人长期查看你的本地服务，而无需每天重复修改服务器地址。

配置固定http端口地址需要将cpolar升级到专业版套餐或以上。

登录cpolar官网，点击左侧的预留，选择保留二级子域名，设置一个二级子域名名称，点击保留,保留成功后复制保留的二级子域名名称。本教程中我创建的是二级子域名是 myhugo1，大家可以自定义创建。

返回登录Cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道 myblog ，点击右侧的编辑：

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名

• Sub Domain：填写保留成功的二级子域名

点击更新(注意,点击一次更新即可,不需要重复提交)

更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名：

最后，我们使用固定的公网地址在任何浏览器打开访问，可以看到成功访问使用Docsify搭建好的本地博客网站，这样一个固定且永久不变的二级子域名公网地址就设置好了。

以上就是如何在Windows系统电脑本地使用Docsify搭建一个博客网站，并结合cpolar内网穿透工具实现一键发布公网随时随地远程访问的全部流程。感谢您的观看，有任何问题欢迎留言交流。

结尾： 这种组合的价值在于将动态渲染技术与可靠穿透方案结合，在保证实时性的同时消除网络限制。当轻量级架构遇上灵活的公网暴露能力时，Docsify不仅成为GitBook替代选择，更可能重新定义快速文档建设的技术实现路径。

文章目录

• • 前言
  • 1. 本地部署Docsify
  • 2. 使用Docsify搭建个人博客
  • • • • 封面配置文件（_coverpage.md）
  • 3. 安装Cpolar内网穿透工具
  • 4. 配置公网地址
  • 5. 配置固定公网地址

前些天发现了一个巨牛的人工智能学习网站，通俗易懂，风趣幽默，忍不住分享一下给大家 点击跳转到网站

前言

作为一款以轻量化著称的文档管理系统，Docsify重新定义了静态内容开发流程。其核心机制在于动态解析Markdown文件——无需预编译生成HTML页面（区别于Hexo等工具），所有转换工作在用户浏览器端实时完成。这种“运行时渲染”特性使得开发者只需维护纯文本文件即可管理整个站点：创建index.html后，文档保存即刻生效，内容自动更新到网页界面，特别适合需要快速迭代的团队协作场景。

技术架构层面展现了多重优势：

• 轻量级设计（压缩包仅21KB）确保极低资源占用，兼容IE11等老旧浏览器环境；
• 服务端渲染支持为SEO优化提供保障，同时智能搜索功能可实现全文快速检索；
• 丰富API接口允许深度定制页面逻辑，例如集成版本控制系统或添加自定义组件。

结合cpolar内网穿透服务后，文档分享效率获得显著提升。当需要将本地开发的教程或知识库对外发布时（如展示项目技术文档），无需申请公网IP或配置NAT转发——只需通过加密隧道映射本地端口即可生成安全访问链接，所有交互均遵循HTTPS协议保障数据隐私。

本文主要介绍如何在Windows环境本地部署 Docsify 这款以 markdown 为中心的文档编辑器，并即时生成您的文档博客网站，结合cpolar内网穿透还能将博客一键发布至公网允许所有人访问，无需公网IP，也不用设置路由器那么麻烦。

接下来，讲解如何在本地部署Docsify。

1. 本地部署Docsify

本篇文章安装环境：Windows10

Docsify 项目github地址：GitHub - docsifyjs/docsify: 🃏 A magical documentation site generator.

Docsify官方文档教程：https://docsify.js/#/zh-cn/

准备工具： node.js、Typora、cpolar内网穿透

Node.js （官网）：https://nodejs/zh-cn

Typora（官网）：https://typoraio

首先查看node.js是否已安装

node -v

查看npm是否已安装

npm -v

如未安装，进入到node.js官网下载安装

安装完后，接下来需要安装Docsify本地全局工具

npm i docsify-cli -g

初始化Docsify本地项目

docsify init ./docs

启用本地网页预览

docsify serve docs

2. 使用Docsify搭建个人博客

打开 此电脑——C盘——用户——文档——docs文件夹

初始化成功后，可以看到 ./docs 目录下创建的几个文件

• index.html 入口文件
• README.md 会做为主页内容渲染
• .nojekyll 用于阻止 GitHub Pages 忽略掉下划线开头的文件

直接编辑 docs/README.md 就能更新文档内容，当然也可以[添加更多页面。

打开 README文档，做为主页内容渲染

在这个文档中进行修改，设计自己的个人博客，修改标题，添加文章内容，并保存

制作一个个人文档，我们只需要配置以下这几个基本文件就可以：

文件作用	文件
基础配置项（入口文件）	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/npm/docsify/lib/docsify.min.js"></script>
<!-- _coverpage.md -->

![logo](_media/icon.svg)

# docsify <small>3.5</small>

> 一个神奇的文档网站生成器。

- 简单、轻便 (压缩后 ~21kB)
- 无需生成 html 文件
- 众多主题

[开始使用 Let Go](/README.md)

继续回到我们刚才搭建的页面，打开一个新的浏览器，输入localhost:3000，或者本机IP地址:3000

这样我们就在本地搭建了一个简单的个人文档博客，博客排版风格也可以自己随意设计，但是目前我们已经在本地搭建好了博客网站，如果没有公网IP的话，只能在本地局域网环境使用，有一定的局限性。如果出门在外想远程访问使用的话，可以结合cpolar内网穿透生成公网地址，免去了本地重新部署过程，只需要使用公网地址直接进就可以访问本地部署的Docsify，随时管理网站。

3. 安装Cpolar内网穿透工具

下面是安装cpolar步骤：

Cpolar官网地址: https://www.cpolar

点击进入cpolar官网，点击免费使用注册一个账号，并下载最新版本的Cpolar

登录成功后，点击下载Cpolar到本地并安装（一路默认安装即可）本教程选择下载Windows版本。

Cpolar安装成功后，在浏览器上访问http://localhost:9200，使用cpolar账号登录,登录后即可看到Cpolar web 配置界面,结下来在web 管理界面配置即可。

4. 配置公网地址

接下来配置一下本地 Docsify 的公网地址，

登录后，点击左侧仪表盘的隧道管理——创建隧道，

创建一个 个人博客网站 的公网http地址隧道：

• 隧道名称：可自定义命名，注意不要与已有的隧道名称重复

• 协议：选择 http

• 本地地址：3000

• 域名类型：免费选择随机域名

• 地区：选择China VIP

点击创建

隧道创建成功后，点击左侧的状态——在线隧道列表,查看所生成的公网访问地址，有两种访问方式,分别是http和https。

使用任意一个上面Cpolar生成的公网地址,在电脑或任意设备在浏览器进行登录访问,即可成功看到 本地博客网站 界面,这样一个可以远程访问的公网地址就创建好了,使用了Cpolar的公网域名,无需自己购买云服务器,即可在公网访问本地部署的服务了！

5. 配置固定公网地址

我们接下来为其配置固定的HTTP端口地址，该地址不会变化，方便分享给别人长期查看你的本地服务，而无需每天重复修改服务器地址。

配置固定http端口地址需要将cpolar升级到专业版套餐或以上。

登录cpolar官网，点击左侧的预留，选择保留二级子域名，设置一个二级子域名名称，点击保留,保留成功后复制保留的二级子域名名称。本教程中我创建的是二级子域名是 myhugo1，大家可以自定义创建。

返回登录Cpolar web UI管理界面，点击左侧仪表盘的隧道管理——隧道列表，找到所要配置的隧道 myblog ，点击右侧的编辑：

修改隧道信息，将保留成功的二级子域名配置到隧道中

• 域名类型：选择二级子域名

• Sub Domain：填写保留成功的二级子域名

点击更新(注意,点击一次更新即可,不需要重复提交)

更新完成后,打开在线隧道列表,此时可以看到公网地址已经发生变化,地址名称也变成了固定的二级子域名名称的域名：

最后，我们使用固定的公网地址在任何浏览器打开访问，可以看到成功访问使用Docsify搭建好的本地博客网站，这样一个固定且永久不变的二级子域名公网地址就设置好了。

以上就是如何在Windows系统电脑本地使用Docsify搭建一个博客网站，并结合cpolar内网穿透工具实现一键发布公网随时随地远程访问的全部流程。感谢您的观看，有任何问题欢迎留言交流。

结尾： 这种组合的价值在于将动态渲染技术与可靠穿透方案结合，在保证实时性的同时消除网络限制。当轻量级架构遇上灵活的公网暴露能力时，Docsify不仅成为GitBook替代选择，更可能重新定义快速文档建设的技术实现路径。

本文标签： 公网生成器模式文档方案