# Network101

**Repository Path**: rabbitTang_admin/network101

## Basic Information

- **Project Name**: Network101
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-30
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Network101 - 网络课程笔记与实践

> 所以，向前迈进吧。

一个基于 VitePress 构建的现代化网络技术学习平台，涵盖 HCIA 网络认证、RHCSA Linux 系统管理、Markdown 教程以及 AI 伴学等核心模块。

## 📚 项目特色

- **体系化学习路径** - 从网络基础到高级协议，从 Linux 管理到 AI 辅助学习
- **华为 VRP 实战导向** - 以华为设备命令为主，结合真实网络场景
- **AI 智能伴学** - 集成 AI 助手，提供概念解释、命令学习、排错辅助
- **交互式演示** - 包含动态拓扑、报文可视化等交互内容
- **统一写作规范** - 遵循严格的文档标准，确保内容质量一致性

## 🎯 核心模块

### 网络技术 (HCIA 核心)

| 模块 | 章节数 | 内容概览 |
|------|--------|----------|
| 📡 网络基础 | 11 | OSI/TCP-IP 模型、IPv4 编址、子网掩码、ARP/Ping |
| 🔧 设备管理 | 7 | VRP 系统、Telnet/SSH、FTP/TFTP 文件传输 |
| 🔄 DHCP 配置 | 5 | 静态/动态 IP、有状态/无状态、DHCP 中继 |
| 🌉 广域网 PPP | 4 | HDLC/PPP、LCP 协商、PAP/CHAP 认证、NCP |
| 🔀 二层交换 | 6 | 广播/冲突域、VLAN、Trunk、Hybrid 端口 |
| 🌳 生成树 STP | 5 | STP 选举、状态收敛、RSTP/MSTP |
| 🧭 路由 OSPF | 7 | VLAN 间路由、静态路由、OSPF、ACL、NAT |

### Linux 系统管理 (RHCSA)

- Linux 入门与环境准备
- 文件系统与常用命令
- 用户、权限与 sudo
- 进程、服务与日志
- 网络、存储与综合练习

### AI 伴学专题

- AI 基础入门与工具介绍
- 提示词工程 (Prompt Engineering)
- AI 辅助网络学习
- 实战任务与练习

### Markdown 教程

从基础语法到高级技巧，全面掌握文档编写。

## 🚀 快速开始

### 环境要求

- Node.js >= 18
- pnpm (推荐) 或 npm

### 安装依赖

```bash
pnpm install
```

### 开发模式

```bash
pnpm run docs:dev
```

访问 `http://localhost:5173` 查看文档站点。

### 构建生产版本

```bash
pnpm run docs:build
```

构建产物位于 `.vitepress/dist` 目录。

### 预览构建结果

```bash
pnpm run docs:preview
```

## 📁 项目结构

```
Network101/
├── .vitepress/          # VitePress 配置
│   ├── config.mjs      # 站点配置
│   └── theme/          # 自定义主题组件
├── docs/               # 文档内容
│   ├── 01-basics/      # 网络基础
│   ├── 02-management/  # 设备管理
│   ├── 03-dhcp/        # DHCP 配置
│   ├── 04-ppp/         # 广域网 PPP
│   ├── 05-switching/   # 二层交换
│   ├── 06-stp/         # 生成树 STP
│   ├── 07-routing/     # 路由 OSPF
│   ├── 02-hcip/        # HCIP 进阶
│   ├── 08-ai-companion/# AI 伴学
│   ├── 11-linux-basics/# Linux 基础
│   ├── 13-markdown-tutorials/ # Markdown 教程
│   └── files/          # 图片与资源文件
├── scripts/            # 构建脚本
│   └── generate-sitemap.js
├── index.md            # 站点首页
├── package.json        # 项目依赖
└── README.md           # 项目说明
```

## 📝 写作规范

本项目采用统一的写作规范，确保文档风格一致。新增章节请参考 [INFO.md](INFO.md) 文档。

### 核心原则

1. **先让新手看懂** - 用类比降低理解门槛
2. **再让他知道命令怎么敲** - 提供华为 VRP 命令示例
3. **最后告诉他考试/实战里为什么重要** - 强调关键细节

### 文章结构（推荐）

```markdown
---
title: 章节标题 (English Title)
order: 序号
---

# 章节标题

1. 为什么需要这个技术？
2. 核心定义
3. 工作原理 / 流程拆解
4. 配置示例 / 命令详解
5. 常见故障排查
6. 最佳实践 / 专家视角
7. AI伴学提示
```

### 术语规范

- 首次出现：中文 + 英文/缩写，如 `地址解析协议 (ARP)`
- 后文可直接使用缩写
- 命令、协议名、字段名用反引号包裹：`display arp`

## 🛠️ 技术栈

- **框架**: [VitePress](https://vitepress.dev/) ^1.6.4
- **UI**: Vue 3 ^3.5.27
- **构建工具**: Vite
- **包管理**: pnpm (推荐)

## 📦 可用脚本

| 命令 | 说明 |
|------|------|
| `pnpm run docs:dev` | 启动开发服务器 |
| `pnpm run docs:build` | 构建静态站点 |
| `pnpm run docs:preview` | 预览构建结果 |
| `pnpm run sitemap` | 生成 sitemap.xml |
| `pnpm run sitemap:build` | 构建时自动生成 sitemap |

## 🌐 部署

构建完成后，将 `.vitepress/dist` 目录部署到任意静态托管服务：

- Vercel / Netlify
- GitHub Pages
- Cloudflare Pages
- 自建 Nginx / Apache

### 自定义域名

在 `scripts/generate-sitemap.js` 中修改域名，然后运行：

```bash
pnpm run sitemap:build
```

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request 来完善文档。

### 新增章节流程

1. 确定章节归属的模块目录 (如 `docs/HCIA/01-basics/`)
2. 创建 Markdown 文件，遵循 [INFO.md](INFO.md) 规范
3. 在对应模块的 `index.md` 中添加导航链接
4. 本地预览确认格式正确
5. 提交 PR

### 内容要求

- 技术准确，符合华为 VRP 命令规范
- 面向初学者，解释清晰
- 包含配置示例和排错命令
- 适当添加表格、示意图、交互内容
- 链接到相关前置知识和 AI 伴学页面

## 📄 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件（如有）。

## 🙏 致谢

- [VitePress](https://vitepress.dev/) - 优秀的 Vue 静态站点生成器
- 华为技术有限公司 - VRP 系统参考
- 所有贡献者和学习者

## 📮 联系方式

- 项目主页: https://github.com/your-username/Network101
- 问题反馈: https://github.com/your-username/Network101/issues

---

**开始学习**: [/docs/HCIA/01-basics/01-what-is-network](/docs/HCIA/01-basics/01-what-is-network)

**查看完整目录**: [/docs/HCIA/01-basics/](/docs/HCIA/01-basics/)