跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.js大前端

基于 Docsify 本地搭建博客并实现公网访问

在 Windows 环境下利用 Docsify 构建本地 Markdown 博客的方法,并通过 cpolar 内网穿透工具将本地服务映射至公网。无需购买云服务器或配置路由器,即可实现文档的远程访问与编辑。流程涵盖环境准备、项目初始化、配置文件修改及公网隧道设置,支持随机域名与固定二级子域名的配置,适合技术人员快速搭建公开的技术文档站点。

邪神洛基发布于 2026/2/9更新于 2026/10/25106 浏览
基于 Docsify 本地搭建博客并实现公网访问

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 -->
![logo](_media/icon.svg)
# 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 搭建好的本地博客网站。

目录

  1. 1. 本地部署 Docsify
  2. 2. 使用 Docsify 搭建个人博客
  3. docsify <small>3.5</small>
  4. 3. 安装 Cpolar 内网穿透工具
  5. 4. 配置公网地址
  6. 5. 配置固定公网地址

更多推荐文章

查看全部
  • OpenClaw 漏洞预警:AI 代理日志审计与风险追溯
  • LLaMA-Factory 项目介绍与安装部署
  • Ollama Windows 安装与使用指南:本地运行 Llama 等模型
  • OpenClaw 与 Ollama 本地部署指南
  • Python 字典核心知识点与实战技巧
  • Python 并发编程:多线程、多进程与协程详解
  • 2026 春晚 AI 技术解析:具身智能、应用趋势与普通人机遇
  • Linux TCP 协议详解与 Socket 编程实战
  • 基于 Python 与 Stable Diffusion 的企业营销素材生成方案
  • Alpine Linux + JDK 兼容性指南:jstack 在容器中为何不可用及解法
  • FPGA 入门实战:基于 Quartus 与 Verilog 实现 LED 点亮
  • C++ 函数进阶:递归与尾递归优化
  • 计算机科学与技术专业核心课程与学习路线指南
  • C++ STL 容器适配器详解:Stack、Queue 与 Priority Queue
  • Eino Embedding 组件核心解析:文本向量化与语义检索
  • OpenClaw(原 Moltbot)底层架构解析
  • llama-cpp-python 本地部署与实战指南
  • 模拟算法实战:核心概念与经典案例解析
  • RKNN 8 位量化全解析:算法差异与粒度选择实战指南
  • Naiz AI:从语义到像素的全球视频本地化方案

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online