Bump webpack from 5.92.1 to 5.94.0

Bumps [webpack](https://github.com/webpack/webpack) from 5.92.1 to 5.94.0.
- [Release notes](https://github.com/webpack/webpack/releases)
- [Commits](https://github.com/webpack/webpack/compare/v5.92.1...v5.94.0)

---
updated-dependencies:
- dependency-name: webpack
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

README.md

@@ -1,8 +1,30 @@
 # zsc网维开发组网站
 这里是开发组的网站源代码仓库，采用Docusaurus框架,欢迎issue和PR
+## 依赖
+`nodejs >= 18.0`
 ## 构建
-不同于传统的静态网页生成器，本项目不需要额外加装构建工具，生成器和内容本身加起来就是一个单独的react.js应用，所以理论上你只需要把这个repo pull到本地，再用npm构建即可，运行`npm run docusaurus`来运行框架本身提供的一些脚本
+不同于传统的静态网页生成器，本项目不需要额外加装构建工具，生成器和内容本身加起来就是一个单独的react.js应用，所以理论上你只需要把这个repo pull到本地，再用npm构建即可，运行`npm run docusaurus`来运行框架本身提供的一些脚本.
+要构建可以拿去部署的静态网站资源，运行：
+
+```
+
+git clone https://github.com/ZSCNetSupportDept/website
+
+npm install
+
+npm run docusaurus build
+
+```
+
+运行`npm run docusaurus deploy`可以自动构建静态网站，并且push到`build`上\
+https://zscdev-demo.pages.dev 是本仓库的一个demo网站，基于master构建而不是build
+## 部署
+参见 https://zscdev-demo.pages.dev/docs/devdocs/网站/开发组网站/开发组网站-部署
 ## 内容发布
 参见文档
+## 开发
+务必在本地测试好改动后再push
 ## 关于
 若有问题，可以联系开发组组长
+
+针对新手我们有一个教程帮助你快速入门：https://zscdev-demo.pages.dev/docs/devdocs/网站/开发组网站/快速上手

blog/2024-08-18-网维联系方式.md

@@ -0,0 +1,5 @@
+# 你可以在哪里找到开发组？
+目前，开发组成员可以通过如下的方式联系：
+- 开发组成员可以通过github上的[论坛](https://github.com/ZSCNetSupportDept/forum/discussions)交流(仅限内部访问)
+- 开发组有一个QQ群：961797864
+- 可以联系组长,QQ:2597760847

blog/2024-08-19-ComIntRep的使用教程.md

@@ -0,0 +1,28 @@
+# ComIntRep的使用教程
+
+## 介绍
+如果是操作系统本身的问题导致了用户没法上网的话，传统的办法是先确定故障出现在哪里，然后去修理对应的地方，在这个过程中，难免要接触到修改注册表，协议栈，hosts这类复杂的名词..
+<!--truncate-->
+而ComIntRep就是一款一键修复windows网络的神器，全称`"Complete Internet Repair"`,他的功能有：
+- 重置 Internet 协议（TCP/ IP 协议）
+- 修复 Winsock
+- 更新互联网连接
+- 刷新 DNS 解析器缓存
+- 刷新 ARP 缓存
+- 修复 Internet Explorer
+- 清除 Windows 更新历史记录
+- 修复 Windows 自动更新
+- 修复的 SSL / HTTPS 加密
+- 重置代理服务器配置
+- 重置 Windows 防火墙配置
+- 恢复默认的 hosts 文件
+- 修复查看工作组计算机\
+这款软件可以帮我们很大程度上节省修网的时间，非常推荐使用
+## 使用
+勾选你要修复的部分，然后点击`Go!`,就可以了，系统会自动重置你选择那部分的网络配置，修复完毕后，重启电脑即可\
+官方推荐在修复前备份操作系统，点击`Maintennace`->`System_Restore`,然后点击“配置”，“启用系统保护”，然后为C盘创建一个还原点，就可以修复了
+## 参考
+https://zhuanlan.zhihu.com/p/27196344 \
+<!-- https://rizonesoft.com/downloads/complete-internet-repair/ \ -->
+
+

docs/devdocs/01-首页.md

@@ -18,5 +18,11 @@ zsxyww.com,网维的官网
 我们的项目托管在github上，私聊组长来获得进入organization的权限
 ### 文档编写
 为了项目的持续维护，对于我们的每一个项目都应该留有详尽的文档，文档以markdown格式编写，可以自动构建成静态网页，详见**网站/如何修改开发组网站内容**
-
+### 培训 资料
+这里是一些资料，帮助你了解加入开发组工作的必要知识
+- SSH教程：https://wangdoc.com/ssh/basic
+- git教程:
+- WEB基础：https://developer.mozilla.org/zh-CN/docs/Learn/Getting_started_with_the_web
+- linux命令：
+- markdown教程：
 

docs/devdocs/02-网站/01-子站点.md

@@ -1,4 +1,5 @@
 # 子站点
+网站的子站点
 ## www.zsxyww.com
 www.zsxyww.com是网维的官网
 ## wiki.zsxyww.com

docs/devdocs/02-网站/02-开发组网站/02-开发组网站-概览.md

@@ -1,14 +1,19 @@
-# 开发组网站概览
+# 开发组网站-概览
 ## 技术
 网站基于Docusaurus开发,一个静态网页生成的框架，尤其对于生成技术文档来说，它提供了一个美观，现代的前端界面，这个项目本身是一个react.js应用，生成网页时只要输入：`npm run build`便可以在build目录里构建网站的所有资源，以进一步部署，关于详细的配置，可以去看官方的文档：[文档连接](https://www.docusaurus.cn/docs/category/guides)
 ## 工作流程
-基本上，我们需要把markdown文件放在目录里面，系统就会根据目录的结构自动生成网页，但是我们必须写好配置文件，如果我们想自定义网站的外观的话，也需要好好研究一下配置文件，有关文档还在编写中
+基本上，我们需要把markdown文件放在目录里面，系统就会根据目录的结构自动生成网页，但是我们必须写好配置文件，如果我们想自定义网站的外观的话，也需要好好研究一下配置文件，有关文档还在编写中 \
+开发组网站的开发流程基本如下：
+1. 将源代码仓库的最新版本拉取到本地，对仓库的内容进行修改，最终在本地的master分支上commit,
+2. 运行`npm start`在`https://localhost:3000`上运行基于改动构建的预览版本
+3. 测试改动，确保一切正常后push到github上
+4. demo网站会自动根据github上的msater分支构建网页，构成开发组网站的预览版本
+5. 积累几个改动后，在本地运行`npm run deploy`将网页构建好推送给github上的`build`分支，网站服务器自动获取并更新，构成开发组网站的正式版本
 ## 目录
 所有的文档文件都储存在docs文件夹下\
 所有的公告文件都储存在blog文件夹下\
 所有的静态页面都储存在src/pages文件夹下\
-所有的媒体文件都储存在static文件夹下\
-系统会根据这些文件，在build里生成网站的所有页面文件，以供我们部署
+所有的媒体文件都储存在static文件夹下，供用户下载的资源也储存在这里\
 
 docusaurus.config.js是项目的配置文件，配置格式请参照官方文档
 ## 部署

docs/devdocs/02-网站/02-开发组网站/03-开发组网站-内容.md

@@ -0,0 +1,43 @@
+# 开发组网站-内容
+**本篇文章将教你进行内容发布，维护开发组网站内容的方法**
+## 如何修改
+### Edit This Page
+页面最下面有一个Edit This Page的超链接，点击就可以进入github里这个页面的源代码，可以提交PR，有权限的也可以直接修改
+### git clone
+(该方法仅限有权限的开发组成员)\
+如果你要进行比较多的修改的话，你也可以将仓库拉取到本地，然后修改，新建文件夹，打开终端
+- 输入`git clone https://github.com/ZSCNetSupportDept/website.git`
+- 输入`git checkout master`
+- 此时你应该可以看见项目的源代码，修改你需要改动的内容，然后输入`git add *`
+- 输入`git commit`，将你的改动提交到本地
+- 输入`git push`，提交内容到仓库
+## 仓库的内容
+你可以看见三个文件夹，分别是src,docs,blog,其中：
+- src文件夹存放了独立于文档和blog的静态页面
+- docs文件夹存放了所有的文档（目前有wiki和开发组文档两个docs）
+- blog文件夹存放了可以显示在“公告”板块的文章
+
+所有的文档都以Markdown格式书写（其实也可以用MDX格式），
+### 前缀
+所有文件都有一个数字前缀，这是文章在成品网站中的顺序,文件请按照`order-filename.md`的格式命名
+
+btw,docusaurus不会将以"_"开头的文件加入完成的网页中,所以可以在暂时不想要展现在最终网站的里的的文章前面加上一个下划线
+### 栏目的概况
+我们可以在一个子文件夹中加入`index.md`或者`README.md`或者`{$文件夹的名称}.md`,其中的内容会在成品网站中显示为这个栏目的概况（点击这个栏目本身出现的内容）
+### Markdown 文档
+Markdown 是一个标记文本格式的语言，轻便简单快捷，markdown最基本的语法如下：[markdown语法](https://commonmark.org/) ，我们用Markdown来编写文档,需要注意的是，文档只能有一个h1，系统用它来产生sidebar条目
+
+另外docusaurus好像支持mdx格式的文档，可以把一些动态元素插入到文本中，
+### 媒体资源引用
+请将所有媒体资源放在static目录内，然后在文档中调用
+### 下载
+在`static`目录下面的内容会直接放到生成的网页里，我们在wiki和开发组文档里各设置了一个下载页面提供便捷访问的方式，在Markdown文本里链接这些文件，来提供下载的方式
+
+### 公告
+docusaurus自带一个blog插件，需要按照`yyyy-mm-dd-filename.md`的格式发布
+
+## 文档的维护
+如果发现了文档有错误的地方，请提交PR修改，或者告知开发组成员，
+
+## 进阶
+更详细的内容，还是建议看docusaurus的官方文档：[文档连接](https://www.docusaurus.cn/docs/category/guides)

docs/devdocs/02-网站/02-开发组网站/03-开发组网站-部署.md

@@ -0,0 +1,15 @@
+# 开发组网站-部署
+本篇文章是开发组网站的部署流程备忘录
+## 流程
+网站假设在我们的云服务器上，服务器会自动从仓库的build分支拉取内容，所以，网站的部署流程是这样的：
+1. 将website仓库clone到本地/pull拉取最新版本
+2. 运行`npm start`在localhost:3000上运行网站的测试版本
+3. 确认网站的最新版本没有问题后，运行`npm run docusaurus deploy`，npm会自动构建网页文件，推送到origin/build分支上(记得配置好你的ssh,联系组长来获取仓库的权限)
+4. 服务器获取build分支的最新版本，pull到`/var/www/developer`目录下
+5. 服务器采用nginx，提供对developer.zsxyww.com的访问
+
+## demo
+我在cloudflare pages上部署了一个网站的demo,这个网站会自动基于master分支构建，而不是获取构建好的build分支，可以在上面预览网站的效果，觉得没问题了再进行build,网址：https://zscdev-demo.pages.dev/
+
+## 服务端
+目前，网站服务器拉取build构建的方式是通过定时执行（5分钟1次）一个特定的更新脚本，位置在`/opt/developer-build.sh`，写在crontab里了，

docs/devdocs/02-网站/02-开发组网站/04-开发组网站-外观.md

@@ -1,2 +1,9 @@
-# 网站外观修改
+# 开发组网站-外观
 **本篇指南将教你如何修改开发组网站的外观**
+
+
+看官方文档
+
+
+
+

docs/devdocs/02-网站/02-开发组网站/快速上手.md

@@ -0,0 +1,249 @@
+# 快速上手
+修网的知识需要在实践中不断积累，网维的wiki做为每一个网维成员经验的总结，自然也需要不断的更新，但是，wiki本身大部分时间都是由开发组的仅仅几个人来维护，难以时刻更新到最新情况，所以，我们想让网维的每个人都能加入wiki的维护，这篇文章就是写给希望为wiki添砖加瓦，却不太了解相关方法的小伙伴的，希望这篇文章能够快速让你上手wiki的维护工作。
+
+在这篇文章里我们将教你：\
+将我们在github上的主仓库fork一份，然后将fork仓库clone到你的电脑;修改网站源代码;将你的修改传回fork仓库，提交pull request
+
+:::info 信息
+
+在正式开始编辑前，你可以看看我们的成品网站，每篇文章的下面会有一个`Edit This Page`的链接，是这篇文章的源代码，这里是网站的链接：[Click Me  ](https://zscdev-demo.pages.dev/)
+
+
+:::
+
+## 准备
+我们假设你所使用的是windows系统。
+
+首先，我们需要安装必要的开发工具：git 和 Node.js。
+
+访问如下链接：[git下载](https://git-scm.com/download/win) , [Node.js下载](https://nodejs.org/zh-cn/download/prebuilt-installer)。
+
+:::info 信息
+
+你也可以通过windows自带的WinGet包管理器下载,详见：[微软文档](https://learn.microsoft.com/zh-cn/windows/package-manager/winget/)。
+
+:::
+
+:::tip git是什么？
+
+git是一个版本控制工具，他会记录一个项目从创建之初任何人对任何文件的任何改动，大大方便了多人协作工程的管理，wiki的源代码托管在基于git设计的github上。
+
+:::
+
+:::tip Node.js是什么?
+
+Node.js是一个在后端运行javascript的运行时，我们使用基于这个平台设计的docusaurus框架来将wiki从一堆markdown文档变成一个网站。
+
+:::
+
+访问github,如果没有账号，就注册一个，然后，打开https://github.com/ZSCNetSupportDept/website。
+
+点击上面的fork,创建仓库的一个分支，点击create fork。
+
+进入你刚才fork的仓库，点击Code,选择HTTPS,复制下面的那一串内容。
+
+然后，请打开你的终端,你可以在“开始”菜单栏里搜索"PowerShell"来打开。
+
+如果你的系统没有安装PowerShell,你可以使用cmd，按`Win+R`,在弹出框里输入`cmd`打开。
+
+输入`git clone 你复制的内容`,这将在你的当前目录下创建一个名为`website`的文件夹，并将开发组网站的全部内容复制到这个文件夹里面。
+
+
+:::tip 提示
+
+你可能会需要科学上网的手段来访问github。
+
+:::
+
+
+然后，输入`cd website`。
+
+切换到我们的项目目录下后，运行`npm install`来安装项目的所有依赖。
+
+:::tip 提示
+
+为了加速下载，你可能会需要配置npm镜像，可以输入`npm config set registry https://registry.npmmirror.com`。
+
+:::
+
+现在，输入`npm start`，程序就会在你的电脑上构建并部署网站。
+
+然后在你的浏览器上输入`https://localhost:3000`
+
+如果没有出错的话，你会看到我们开发组网站的主页。
+
+:::tip 提示
+
+每次启动测试版网站，都需要在这里再输入一次`npm start`
+
+:::
+
+## 编辑
+打开`website`下的`docs`文件夹，再打开`wiki`文件夹,这里就是我们的wiki内容仓库了。
+
+仓库里的所有的文章都是以md结尾的markdown文件，你需要熟悉markdown的写法，才能对文章的内容修改和完善，markdown并不是特别复杂，你可以花一点时间去学会他。
+:::info 信息
+
+这里是一些学习markdown的资源：https://markdown.com.cn/   \
+https://github.highlight.ink/mastering-markdown/intro   \
+https://commonmark.org/ (英文)
+
+:::
+
+如果想要在文本中添加图片，视频，或者其他资源，请将这些素材放入static中，以方便管理。
+
+对代码的修改将会自动同步到刚才打开的网页里，你可以在那里确认修改的结果满意与否，注意，你需要保存文件才会同步更改。
+
+修改完毕后，输入`git add .`再输入`git commit`，并对你的修改做出一个简短的说明。
+
+### 改什么？
+你可以校对已有的条目，增加一些内容，或者加入一些图片之类的。
+
+你也可以添加新条目，撰写一些你觉得有价值的修网心得。
+
+或是帮助我们改善网站本身，比如改一改主题，写一个首页等（如果有相关能力，需要react基础）
+
+### 文件名
+你会发现，所有文件的名字前面都有一个数字，那就是文章在sidebar中出现的顺序，增添文件，请按照`order-filename.md`的格式修改名字。
+
+在文件名前加一个下划线，系统就不会将文章加入成品网站中。
+
+:::tip 提示
+
+关于如何修改wiki的更多提示,可以去看docusaurus的官方文档：[链接](https://docusaurus.cn)
+
+:::
+## 推送到仓库
+在修改完毕并且在本地检查完毕后，你需要将你的修改同步到你在github的远程fork仓库，然后再提交一个pull request请求主仓库合并你在fork仓库所做的修改。
+
+首先，你需要验证你的身份，让github允许你的电脑向它提交push
+:::tip 提示
+
+你可以使用github desktop或github cli来简化这个流程，不过我们想让你在这个过程中学习SSH的用法，如果你想方便一点，直接跳到“使用github-cli”。
+
+:::
+### 选项1:使用SSH
+
+首先，确保你安装了SSH,你可以看微软的这片文档：[链接](https://learn.microsoft.com/zh-cn/windows-server/administration/openssh/openssh_install_firstuse?tabs=gui)。
+
+打开终端，输入
+
+```PowerShell
+
+ssh-keygen -t ed25519
+
+```
+
+然后在接下来的选项中检查密钥的存放路径，以及使用一个密码来加密这个密钥，我们建议你设置一个密码。
+
+然后我们设置开机自动启动ssh-agent服务。
+
+确保你使用了管理员权限运行了下面的PowerShell代码：
+
+```PowerShell
+
+Get-Service ssh-agent | Set-Service -StartupType Automatic
+
+Start-Service ssh-agent
+
+Get-Service ssh-agent
+
+```
+
+最后一个命令应该会返回`Running`状态。
+
+然后，你就可以输入`ssh-add`来加载你的密钥。
+
+```PowerShell
+
+ssh-add 你的私钥位置
+
+```
+:::tip 提示
+
+每次重启电脑，你都要重新输入一遍`ssh-add`。
+
+:::
+
+:::info 信息
+
+关于SSH的配置，参考了这片[微软文档](https://learn.microsoft.com/zh-cn/windows-server/administration/openssh/openssh_keymanagement)。
+
+:::
+
+接下来，我们配置github的SSH访问。
+
+打开与私钥同目录下的公钥文件(以pub结尾)，然后复制他，注意要全部复制，不要多出或减少任何内容。
+
+点一下你的github头像，选择Settings,然后在侧边栏的Access板块找到SSH and GPG keys。
+
+点击 `New SSH key`。
+
+把密钥粘贴到下面，然后保存就行了。
+
+在终端里输入
+
+```PowerShell
+
+ssh git@github.com
+
+```
+
+如果返回的文本里出现了你的用户名，配置就大概成功了。
+
+现在就可以输入`git push`了
+
+```PowerShell
+
+git push
+
+```
+
+这个命令会向远端的仓库提交你在本地提交的commit,检查你的fork仓库，有没有更新到你本地的修改？
+
+:::info 信息
+
+参考了github的文档:[Click Me  ](https://docs.github.com/zh/authentication/connecting-to-github-with-ssh/about-ssh)
+
+:::
+
+### 选项2：使用github-cli
+访问https://github.com/cli/cli/releases ， 下载最新版本。
+
+输入`gh`以检查安装的成功状况。
+
+没问题的话，输入`gh auth login`,会弹出一个浏览器窗口，在弹出的窗口中完成登录。
+
+然后，你应该就可以直接使用`git push`了，输入`git push`,然后查看你在github中的fork仓库，有没有更新到你本地的修改。
+:::info 信息
+
+这里有更多关于github cli 的信息:[Click Me ](https://docs.github.com/zh/github-cli/github-cli/about-github-cli)
+
+:::
+
+### 提交pull request
+一个pull request 是一个请求，将修改建议发送给主仓库，并让主仓库合并这些修改。
+
+打开主仓库，选择上面的Pull Requests,然后选择New Pull Request,如果没有出现你的fork仓库，点击compare accross forks。
+
+然后就可以Create Pull Request了。
+
+提交后，开发组成员会校对你的修改，将你的修改应用到主仓库中，这就是我们的开发流程了。
+
+
+:::info wiki的分层更新模型
+
+按照我们的设计，wiki的内容从新到旧，一共分为三个版本：
+- 最新的版本是大家在自己的电脑上运行的测试版网站，这个版本包含了最新的想法和更改，等待完善后推送到主仓库。
+- 然后是我们的demo版本网站[zscdev-demo.pages.dev](zscdev-demo.pages.dev),这个版本立即反应了任何被合并进去主仓库master分支的更改，大家可以对这个网站上的内容随便提意见，任何修改都将很快被同步到网站里。
+- 当主仓库和demo网站的更新积累到一定程度的数量时，开发组成员会根据一个版本作为wiki的正式版，正式推送到我们的网站[developer.zsxyww.com](developer.zsxyww.com)里，这个版本通常要比demo要落后几次更新，但是那些在施工中的文章，和还在讨论的段落等不稳定的内容将不会被同步到这里，换句话说，这个版本是“稳定版”。
+
+这样网站的测试和正式使用的版本就分开了，保证了网站内容的严谨
+
+:::
+
+
+
+
+
+

docs/devdocs/02-网站/03-如何修改开发组网站内容.md

@@ -1,22 +0,0 @@
-# 开发组网站-内容发布
-**本篇文章将教你如何为开发组网站贡献内容，修改内容，以及内容的维护**
-## Edit This Page
-页面最下面有一个Edit This Page的超链接，点击就可以进入github里这个页面的源代码，可以提交PR，有权限的也可以直接修改
-## 增加内容
-docusaurus按照一定的文件层次将markdown文档转换成静态页面，在仓库里，docs文件夹下的是网站的文档，blog文件夹下的为公告，src/pages下的为独立页面（如首页），如果要增添新的内容，记得把内容放在正确的地方里
-### 前缀
-所有文件都要加入一个数字前缀，用来指示构建系统按照序号生成文章在sidebar中的顺序,按照`order-filename.md`的格式命名
-
-btw,docusaurus不会将以"_"开头的文件加入完成的网页中,所以可以在暂时不想要展现在最终网站的里的的文章前面加上一个下划线
-### Markdown 文档
-Markdown 是一个标记文本格式的语言，轻便简单快捷，markdown最基本的语法如下：[markdown语法](https://commonmark.org/) ，我们用Markdown来编写文档,需要注意的是，文档只能有一个h1，系统用它来产生sidebar条目
-
-另外docusaurus好像支持mdx格式的文档，可以把一些动态元素插入到文本中，
-### 媒体资源引用
-将所有媒体资源放在static目录内，然后在文档中调用
-
-## 公告
-docusaurus自带一个blog插件，需要按照`yyyy-mm-dd-filename.md`的格式发布
-
-## 文档的维护
-如果发现了文档有错误的地方，请提交PR修改，或者告知开发组成员，

docs/devdocs/02-网站/05-旧版wiki.md

@@ -1 +0,0 @@
-# 旧版wiki

docs/devdocs/02-网站/05-旧版wiki/05-旧版wiki-概览.md

@@ -0,0 +1,2 @@
+# 旧版wiki
+使用wiki.js开发的wiki

docs/devdocs/02-网站/06-主页面/06-主页面-概览.md

@@ -0,0 +1,2 @@
+# 主页面
+主页面就是www.zsxyww.com下的页面，这个页面好像很久没人维护了，文档正在编写。。。

docs/devdocs/05-基础设施/README.md

@@ -3,3 +3,4 @@
 我们目前拥有负责报修系统和网站的两台服务器，位于tx云上,联系组长以获得访问权限
 ## 域名
 我们拥有一个域名zsxyww.com
+

docs/devdocs/05-基础设施/zsxyww.com域名.md

@@ -1,2 +1,7 @@
 # zsxyww.com
 这个域名目前托管在west.cn上，腾讯云dns，关于域名的交接事项，请联系组长
+:::tip 提示
+
+记得续费域名
+
+:::

docs/devdocs/05-基础设施/报修服务器.md

@@ -1,2 +1,17 @@
 # 报修服务器
+## 概览
+ip: **192.112.117.67**\
 
+OS:**CentOS 7.6 64bit**\
+
+配置:CPU - 1核 内存 - 2GB\
+    系统盘 - SSD云硬盘 40GB\
+    流量包 - 1000GB/月（带宽：5Mbps）\
+
+服务：报修系统
+
+:::tip 提示
+
+记得续费网站
+
+:::

docs/devdocs/05-基础设施/网站服务器.md

@@ -11,3 +11,25 @@ OS:**Debian 10.2 64bit**
 服务：官网(通过docker部署，8090端口，nginx反代)\
      旧版wiki(docker，3000端口,nginx反代)\
      新网站(TODO:补充部署方式)
+
+## 服务
+### 官网
+运行在docker下
+### 旧版wiki
+运行在docker下
+### 开发组网站
+由nginx直接代理
+## Nginx
+
+网站服务器的服务基本上都是走nginx的，对于服务器nginx的配置，需要注意一些事项：
+1. 当初安装nginx的时候，用的是lnmp一键安装脚本，这个脚本的配置和普通安装好像有点不一样，nginx的主配置文件在`/usr/local/nginx/conf/nginx.conf`，我修改了配置，使其include了`/etc/nginx/sites-enabled`,如果要添加网站，请修改`sites-available`，并将需要启用的配置链接到`sites-enabled`下，不推荐使用脚本自带的`lnmp`脚本，
+2. 关于网站的ssl证书，要记得更新,配置文件中的证书和key的路径指向certbot默认存放的路径即可
+
+
+
+:::tip 提示
+
+记得续费网站
+
+:::
+

docs/devdocs/06-联系开发组.md

@@ -1,6 +1,9 @@
-# 加入开发组
-可以参照下面的联系方式和开发组进行联系
+# 联系开发组
+开发组成员可以通过以下方式联系：
 ## 联系方式
 QQ群：961797864
 QQ:2597760847(组长)
 
+论坛：https://github.com/orgs/ZSCNetSupportDept/discussions (内部)\
+github主页: https://github.com/ZSCNetSupportDept
+

docs/devdocs/07-下载.md

@@ -0,0 +1,2 @@
+# 下载
+可以把需要存放的文件链接放在这里以供下载

docs/wiki/01-首页.md

@@ -1,18 +1,35 @@
 # 网络维护科wiki首页
+:::tip 提示
+
+**至手机用户：点击页面左上角的三条杠打开导航栏，以浏览本站**\
+**推荐使用电脑端访问**
+
+:::
 ## 介绍
-这里是中山学院网络维护科wiki,记录了网络维护工作的相关知识，wik的内容都是历代网维的成员整理总结的，你也可以贡献自己的内容
+这里是中山学院网络维护科wiki,记录了网络维护工作的相关知识，wiki的内容都是历代网维的成员整理总结的，你也可以贡献自己的内容
+:::warning 注意
+
+本wiki还在大量开发中，许多条目可能会不完善或者缺失，仅供开发组组员和正式成员测试参考使用,如果你对wiki的编写和维护感兴趣，可以访问我们的[github源代码仓库](https://github.com/ZSCNetSupportDept/website)，具体的细节请联系开发组组长
+
+:::
 ## wiki的内容
 **wiki基本由以下部分组成：**
 ### 技能
-修网所要掌握的各种技能
+进行网络维修需要掌握的技能
 ### 基础知识
-修网的基础知识
+有关校园网络以及相关概念的基础知识
 ### 片区介绍
-我们需要维护的片区，以及在这些片区值班的注意事项
+记录了我们需要维护的片区的信息，以及在这些片区值班的注意事项
 ### 故障介绍
 当网络发生故障时，客户端通常会返回一个错误码，来提示可能发生的错误，这里，按照运营商分类，介绍常见的故障错误码,**如果你遇到的故障在这里没有收录，请转到旧版wiki**\
 提示：对于电信客户端，可以用客户端自带的修复软件来修复
-### MacOS修理指南
+### [MacOS修理指南](./MacOS修理指南)
 MacOS的修理事项
+### [资源](/docs/wiki/资源)
+我们在这个网站上存放了一些可能会有用的资源，以方便大家下载，如果你有资源想要上传的话，可以联系开发组
+### [杂项](/docs/wiki/杂项)
+这里是一些不便于归类的文章的收纳处，如果你的文章不太好归类，可以放在这里
 ## 旧wiki
 这里是新版wiki,但是旧版wiki依然可用，你可以通过[wiki.zsxyww.com](https://wiki.zsxyww.com) 来访问，上面还有没有迁移的许多旧文章，我们目前在逐步转移这些文章
+## 贡献
+如果你想为本wiki添砖加瓦，可以在仓库里PR:[wiki的github仓库](https://github.com/ZSCNetSupportDept/website)

docs/wiki/03-技能/01-查看ip.md

@@ -1,11 +0,0 @@
-# 查看ip
-许多情况下，检查故障的第一步就是查看用户在局域网中的ip,以进行进一步判断，本文将教会你如何查看ip,以及不同的ip地址意味着什么
-## 操作
-1. 打开cmd界面，你可以按win+r弹出运行框，输入cmd,然后回车
-2. 在cmd提示符后输入`ipconfig`命令，此时应该会输出结果
-3. 根据结果进行下一步操作
-## 结果
-### 无地址
-### 172.xx.xx.xx地址
-### 169.254.xx.xx地址
-### 192.168.xx.xx地址

docs/wiki/03-技能/01-电脑技能/01-查看ip.md

@@ -0,0 +1,20 @@
+# 查看ip
+许多情况下，检查故障的第一步就是查看用户在局域网中的ip,以进行进一步判断，本文将教会你如何查看ip,以及不同的ip地址意味着什么\
+我们的负责范围是以太网连接，所以这里的ip更多的是指以太网ip,关于F-Young的路由器ip,同理
+## 操作
+1. 打开cmd界面，你可以按win+r弹出运行框，输入cmd,然后回车
+2. 在cmd提示符后输入`ipconfig`命令，此时应该会输出结果
+3. 根据结果进行下一步操作
+## 结果
+### 无地址
+检查物理连接
+### 172.xx.xx.xx地址
+16是移动\
+17是联通\
+18是电信\
+如果出现问题，检查ip的运营商和用户注册的运营商是不是相同的，如果不同，那可能是线路接错了
+### 169.254.xx.xx地址
+这个地址是ip分配失败时的保留地址，如果DHCP服务运行失败，电脑就会默认分配了这个地址，好像这个现象一般不会影响正常网络连接，如果没问题就不需要管，\
+有人反馈说usb2.0的转接口也会导致这个问题，我在[这里](/docs/wiki/杂项/关于169.254.x.x的ip问题汇总)开了一个专题页，你们可以把遇到的情况记录在这里
+### 192.168.xx.xx地址
+学校有线网的ip是172的，如果出现了192.168地址，检查用户有没有连接wifi,如果用户和机房之间还有路由器的话，检查路由器工作模式

docs/wiki/03-技能/01-电脑技能/02-检查操作系统网络设备.md

@@ -0,0 +1,6 @@
+# 检查操作系统网络设备
+一台电脑可以有多个网络设备，这些设备可以是具体的也可以是虚拟的，例如，一个以太网口可能对应一个网络设备，一个Wi-Fi连接也是一个网络设备，一个VPN隧道也是一个网络设备，这片文章教你如何查看Windows操作系统中的网络接口设备
+## 操作
+1. 打开“控制面板”
+2. 选择“网络和Internet”
+3. 在右侧打开“网络和共享中心”选项,再点击“更改适配器设置”

docs/wiki/03-技能/01-电脑技能/03-拨号.md

@@ -0,0 +1,11 @@
+# 拨号
+本文章教你如何使用PPPoE 拨号上网\
+注意，如果用户运营商是电信，请使用电信专用client拨号，本教程只适用于联通和移动校园网宽带
+## 操作
+1. 在“开始”菜单中点击“设置”
+2. 点击"网络和Internet",在左侧点击“拨号”
+3. 点击“设置新连接”，点击"宽带(PPPoE)"
+4. 输入账号和密码
+5. 测试连通性
+## 用户的账户格式和默认密码
+取决于用户的运营商，具体信息看这里：[链接](/docs/wiki/基础知识/学校内的运营商)

docs/wiki/03-技能/02-网络相关/打水晶头.md

@@ -0,0 +1,58 @@
+# 做网线
+当网线损坏时，我们需要重新制作网线，通常是更换网线的水晶头，本篇文章就是教你如何打水晶头的
+## 工具
+
+- **网线（双绞线）**：通常是CAT5e或CAT6的网线。
+- **RJ45水晶头**：用于连接网线的标准接口。
+- **网线钳**：用于剥线、压线和剪线的多功能工具。
+- **剪刀或剥线工具**：用于切割和剥离网线外皮。
+- **寻线器**：用于测试制作好的网线是否正常工作。
+
+## 操作
+### 准备工作
+1. 测量并切割网线：根据实际需要的长度，使用网线钳或剪刀剪下适量的网线。留出一点余量以防止错误。
+
+2. 剥离网线外皮：用网线钳或专用剥线工具，剥离网线的一端外皮，剥离长度约为1-2厘米，露出内部的八根细线。注意，不要伤到内部的细线。
+### 整理网线内部的线对
+
+网线内部通常有四对不同颜色的线，每对线由一条实色线和一条相应颜色的白色线组成。
+按照**568B线序**,将网线从左向右排列好
+
+568B线序为：**橙白，橙，绿白，蓝，蓝白，绿，棕白，棕**
+
+将这些线按顺序排列整齐。可以轻轻拉直每根线，以减少弯曲，使它们更容易插入水晶头。
+
+### 修剪并插入到水晶头
+
+1. 修剪线头：将所有线头排列整齐，用剪刀或网线钳将线头剪齐，留下大约1厘米的线头。
+
+2. 插入水晶头：保持线的顺序，将八根线按顺序小心地插入RJ45水晶头中。插入时确保每根线都到达水晶头的顶端。**水晶头的金属触点应该朝上，锁扣朝下。**
+
+### 压接水晶头
+
+将水晶头放入网线钳：确保线头已经插到水晶头的最顶端，并且没有松动。将水晶头插入网线钳的压线口。
+
+压接水晶头：用力握紧网线钳，直到听到“咔哒”一声，确保水晶头内部的金属片刺入每根线芯，完成接线。
+### 测试网线（可选）
+打开寻线器，调整到对线模式，将制作好的网线插入测试仪的两端，检查是否有任何断线或错误连接。
+
+## 注意事项
+
+- 检查线序：在线插入水晶头之前，务必再三确认线序是否正确。
+- 剥线时小心：避免剥线时过度用力，损坏内部细线。
+- 保持线头整齐：确保线头整齐一致，以保证每根线都能够正确接触到水晶头的金属片。
+
+## 关于线序
+以太网连接的线序常见分为TIA/EIA-568A和TIA/EIA-568B两种，区别如下：
+
+568A:白绿，绿，白橙，蓝，白蓝，橙，白棕，棕
+
+568B:白橙，橙，白绿，蓝，白蓝，绿，白棕，棕
+
+以前网线会有交叉线，平行线的分别：
+
+网线一头做成568B,一头568A,就叫做交叉线，通常用于两台同级计算机的互联
+
+网线的两头都是568B,就叫平行线，通常用于计算机和交换机，路由器等上级设备的互联
+
+现在的网线都是做成平行线，计算机会自动识别网线的线序并处理，做成T568B就好

docs/wiki/03-技能/02-网络相关/重做端口.md

@@ -0,0 +1,2 @@
+# 重做端口
+端口的制作和网线的制作差不多，在整理线序是就不需要按照顺序排列了，端口上有对应的颜色，把网线按进去就行。

docs/wiki/03-技能/03-杂项/解绑端口，刷新数据.md

@@ -0,0 +1,13 @@
+# 解绑MAC地址
+学校的网络会绑定设备的MAC地址，来限制上网的设备，如果我们更换了转接头，或者电脑，设备的MAC地址就会变化，运营商就会返回691错误，就需要我们解除对MAC地址的绑定
+
+## 操作
+    - 用开通宽带的手机号码拨打运营商电话，转人工；
+    - 告诉客服，说：清除本机号码绑定的宽带的端口数据；
+    - 等待客服回复“已清除”；
+    - 告诉客服，说：解绑；
+    - 可能会需要服务密码，如果用户记得服务密码可以使用服务密码，否则交给用户报一下身份证号码；
+    - 等待客服回复“已解绑”
+    - 拔下网线，等待 20 ~ 30 秒后插上；
+    - 拨号，一般可以完美解决；
+    - 如果不行，可以重新拨打电话操作。

docs/wiki/03-技能/_index.md

@@ -0,0 +1 @@
+# 技能

docs/wiki/03-技能/打水晶头.md

@@ -1 +0,0 @@
-# 打水晶头

docs/wiki/03-技能/解绑端口，刷新数据.md

@@ -1 +0,0 @@
-# 解绑端口，刷新数据

docs/wiki/03-技能/重做端口.md

@@ -1 +0,0 @@
-# 重做端口

docs/wiki/04-片区介绍/_index.md

@@ -0,0 +1,2 @@
+# 片区介绍
+这里是学校宿舍网络的几个片区的有关信息

docs/wiki/04-片区介绍/index.md

@@ -1 +0,0 @@
-# 片区介绍

docs/wiki/04-片区介绍/东门.md

@@ -1,12 +1,15 @@
 # 东门片区信息
+范围：12-15 ， 20-22栋
 ## 集合点
 **12栋楼下**
 ## 网络结构
 ### 线路
 用户端口连接到宿舍的路由器，路由器主线连接到楼层机房（机房好像进不去）
+
+对于24新生的宿舍已采用了FTTR架构(10栋)
 ### 运营商
 电信
 ### 其它
 暂无
 ## 注意事项
-暂无
+部分房间可能会有AP,如果用户说网速很慢可以先看主线连接的是不是AP

docs/wiki/04-片区介绍/凤翔.md

@@ -1,10 +1,12 @@
 # 凤翔片区信息
+范围：1-6栋
 ## 集合点
 **值班室门口**
 ## 网络结构
 凤翔的网络设备比较古老
 ### 线路
-用户的端口连接到楼层的交换机，位于天花板上，要爬梯子
+用户的端口连接到楼层的交换机，位于天花板上，要爬梯子     \
+电信在这中间还会有一个小交换机
 ### 运营商
 电信，移动
 ### 其它
@@ -14,6 +16,8 @@
 记得带梯子去值班，不管有没有单，每天下班时都要拍一张梯子的照片给值班组长
 **记得拍梯子!!**
 
+电信机房并不是每一层都有的.\
+宿舍床位有两个端口，如果上面的标识难以辨别哪个是移动，哪个是电信的话，可以顺着电信小交换机的端口找到哪个是电信端口，剩下的就是移动端口了.
 
 
 

docs/wiki/04-片区介绍/北门.md

@@ -1,4 +1,5 @@
 # 北门片区信息
+范围：7-11栋
 ## 集合点
 **10栋门口**（？）
 ## 网络结构

docs/wiki/04-片区介绍/朝晖.md

@@ -1,9 +1,12 @@
 # 朝晖片区信息
+范围：朝晖苑
 ## 集合点
 **朝晖楼门口**
 ## 网络结构
 ### 线路
 用户端口直连配线架，配线架连接到交换机，没有床位表格，需要手动寻线
+
+对于24新生的宿舍已采用了FTTR架构
 ### 运营商
 电信，移动
 ### 其它

docs/wiki/04-片区介绍/歧头.md

@@ -1,9 +1,12 @@
 # 歧头片区信息
+范围：17-19栋
 ## 集合点
 **19栋门口**
 ## 网络结构
 ### 线路
 用户端口连接到宿舍的路由器，路由器主线连接到楼层机房（机房好像进不去）
+
+电信：对于24新生的宿舍已采用了FTTR架构
 ### 运营商
 电信
 ### 其它

docs/wiki/04-片区介绍/香晖.md

@@ -1,8 +1,12 @@
 # 香晖片区信息
+范围：香晖苑
 ##  集合点
 **香晖片区范围比较大，分为两个小组值班，AB组在AB栋闸机处集合,CD栋同理。**
 ## 网络结构
 ### 线路
+电信：用户连接宿舍路由器（如果路由器LAN口不够会连接旁路交换机），路由器WAN连接机房交换机\
+对于24新生的宿舍已采用了FTTR架构
+
 用户的端口直接连接到弱电室的配线架，再经配线架连接到交换机，交换机处有床位对应表格，
 ### 运营商
 三大运营商都有服务，在维修时注意交换机不要接错

docs/wiki/05-基础知识/01-学校的网络结构.md

@@ -17,10 +17,16 @@
 **对于教学区公共Wi-Fi:**\
 使用“掌上连峰”APP连接
 ## 拓扑
-校园网的拓扑结构
-## ip与运营商
-学校宿舍网络为每一个床位提供一个内网ip,其中：\
-172.17.x.x为移动\
-172.18.x.x为联通\
-172.19.x.x为电信
+<!-- 总的来说，学生宿舍网络为星型拓扑，运营商的光纤接入各个宿舍楼，在各个楼层的ONU处转换成电信号，接入交换机，再分散到各个宿舍的各个床位，中间可能还有配线架，宿舍路由器等设备\ -->
+<!-- 另外，电信还在部分片区提供了F-Young无线网络服务 -->
+### 电信
+电信是学校的主要运营商，在各个宿舍片区都有提供服务，目前，电信主要是光纤接入楼层，然后通过ONU和交换机变成电信号转到各个宿舍的路由器（启用了Wi-Fi功能），然后再接入床位的端口（有的路由器可能路由器LAN不够，还会再接一个交换机）
 
+电信有计划逐步升级到光纤入宿舍(FTTR)的模式，在这种模式下，将光路接到宿舍，接入一个集成有Wi-Fi路由功能的光猫，将双绞线接入各个端口，请在片区信息里查看电信架构的升级情况
+
+电信的路由器带有Wi-Fi功能，提供无线接入的途径，产品名称叫做"F-Young",SSID以`FY`开头，一般是`FY-楼栋-宿舍号`
+
+### 联通
+联通目前只在香晖有提供服务，架构是"宿舍-楼层配线架-交换机-ONU"
+### 移动
+移动的结构和联通差不多，也是宿舍直连交换机的结构

docs/wiki/05-基础知识/02-学校内的运营商.md

@@ -0,0 +1,31 @@
+# 学校内的运营商
+## 概览
+对于学生宿舍网络，三大运营商在学校内都有服务，但是不同的宿舍片区，可以选择的运营商会有限制：
+
+- 电信：所有宿舍片区
+- 联通：香晖
+- 移动：朝晖，香晖，凤翔\
+用户想要使用这些运营商的宽带网络服务，就需要办理宽带业务.\
+通常，运营商会给客户一张电话卡，这张电话卡的电话号组成了用户用来认证的账号的一部分.\
+根据套餐的不同，用户需要向里面充值话费作为宽带费用.\
+## 认证
+除了电信的宽带和F-Young需要使用专用的客户端进行拨号外，联通和电信只需要使用系统自带的PPPoE拨号认证即可,若认证失败，则会出现691错误
+### 账户和密码
+这里是三家运营商的账户格式和初始密码
+|       |**账号格式**                 |**初始密码**      |
+|-      |-                           |-                |
+|**电信**|`${用户手机号}`              |`A1234567`       |
+|**联通**|`ZSLAN${用户手机号}@16900.gd`|`900.gd`         |
+|**移动**|`${用户手机号}@139.gd`       |`手机号后六位`     |
+
+### 认证方式
+电信需要下载专用客户端下载地址为：`zsteduapp.10000.gd.cn`,联通和移动使用系统自带拨号渠道即可，可以去看`技能/电脑技能/拨号`
+## IP
+宿舍的有线网会为每一个用户分配端口绑定的ip,其中：
+- 电信为172.19.x.x号段
+- 联通为172.18.x.x号段
+- 移动为172.17.x.x号段\
+注意，这里的IP是交换机端口的IP,用户的电脑显示的是网线另一端对应的的端口IP。\
+如果显示IP对应的运营商和用户实际的运营商不符合，那么有可能是交换机接错了。\
+联通和移动在机房里都有自己的交换机和ONU,只有将用户的端口插到对应的运营商的交换机端口处，拨号才能成功。\
+电信是在宿舍处的路由器处接入网线或光缆，如果用户是电信需要把端口的另一端插到路由器上

docs/wiki/05-基础知识/09-科普/DNS.md

@@ -0,0 +1,60 @@
+# DNS
+## 背景知识
+
+因为计算机网络上的计算机彼此之间只能用 IP 地址才能相互识别，这就导致了一个问题，IP 地址很难被人们记住，举个例子，我们中山学院网络维护科的官网的 IP 地址是 `47.52.33.166` ，记住这个 IP 地址是困难的。
+
+于是互联网的前辈们想了一个方法，用域名来进行访问，例如访问 `www.zsxyww.com` 就可以访问到网维的官网，不需要去记住 IP 地址了，`www.zsxyww.com` 这个有意义的字段很容易记住（中山学院网维的拼音缩写嘛）。
+
+然后问题就来了：计算机之间只能用 IP 地址识别，我们使用域名，计算机没法识别怎么办？
+
+对于这个问题，互联网前辈们想了个法子，使用 DNS 服务器作为一个中介，我们使用浏览器访问 `www.zsxyww.com` 的时候，会先请求 DNS 服务器获取该域名对应的计算机的 IP 地址，然后与该 IP 地址对应的计算机（网维服务器）沟通。
+
+## 定义
+
+DNS 是进行域名和与之相对应的 IP 地址转换的服务器。DNS 中保存了一张域名和与之相对应的 IP 地址的表，以解析消息的域名。
+
+简单来说就是 DNS 是一个服务器，能够返回域名对应的服务器的 IP 地址。
+
+## 需要理解的简单的浏览器工作机制
+
+![工作流程](/img/wiki/dns.png)
+
+## 缓存机制
+
+为了节约资源及加快速度，互联网前辈还想了个 DNS 缓存机制。
+
+计算机会按照下列顺序方式进行查询
+1. 浏览器缓存
+2. 操作系统缓存
+3. 各级 DNS 服务器(这边也有缓存)
+
+## 日常工作相关
+
+- 怎么判断是否是 DNS 的问题？
+
+  特征就是使用 IP 地址能够正常访问（例如 QQ），而使用域名访问却没法访问。
+
+  一般来说遇到的会是所有域名都没法访问，不过偶尔也会遇到部分域名能访问，部分域名没法访问的情况。
+
+- 怎么查询本地 DNS 缓存？
+
+  - 查询浏览器缓存
+    - Chrome 浏览器访问 `chrome://net-internals/#dns`，可查询浏览器缓存
+    - 其他浏览器，网上找找方法吧
+  - 查询操作系统缓存
+    - Windows 系统 使用命令 `ipconfig /displaydns` 查询，可以使用 `ipconfig /flushdns` 清除操作系统缓存
+    - macOS 系统 呃，网上找找方法吧
+    - Linux 系统 同上
+
+- 怎么解决 DNS 的问题？
+
+  更换 DNS 服务器、使用神器清除本机 DNS 缓存即可。
+
+  常见的 DNS 服务器地址：
+
+  ```text
+  8.8.8.8  Google（不推荐作为主 DNS 服务器，可以作为次 DNS 服务器）
+  114.114.114.114   114
+  223.5.5.5  223.6.6.6  阿里
+  119.29.29.29  腾讯
+  ```

docs/wiki/05-基础知识/09-科普/网线是什么.md

@@ -0,0 +1,62 @@
+# 网线是什么
+## 介绍
+以太网（有线网）的连接离不开网线，但是，网线究竟是什么，它的内部原理是什么样呢？
+
+一般电脑所发送和接受的网络信息，本质上是变化的弱电流，所以，所有网线本质上都是一种电线。
+
+首先，今天我们所说的网线，是指双绞线，这种线内部有互相绝缘的一对电线互相缠绕（一般以顺时针缠绕），再绞合成螺旋状
+
+一对线通常有一根颜色线和对应的白线组成，这两根线组成一对差分信号（即信息的值不是哪根线的绝对数值，而是两根线数值之差，这样有利于减缓干扰）
+## RJ-45接口
+网线通常的连接器标准叫做8P8C(也叫RJ-45),指这种接口有8个位置（Position，指8个凹槽）、8个触点（Contact，指8个金属接点）。 适用于RJ-45的双绞线内部通常有4对线绞，按照TIA/EIA-568标准，这四对的颜色分别是：橙色，蓝色，绿色，棕色
+
+这种接头就是常说的“水晶头”，它的接口从左到右的功能如下：
+
+1. TX_D1+ （发送数据+）
+2. TX_D1- （发送数据-）
+3. RX_D2+ （接收数据+）
+4. BI_D3+ （双向数据+）
+5. BI_D3- （双向数据-）
+6. RX_D2- （接收数据-）
+7. BI_D4+ （双向数据+）
+8. BI_D4- （双向数据-）
+
+在百兆以太网（Fast Ethernet、10/100M Ethernet）中，仅使用1、2、3、6这四根线，以差分信号传输方式减少电磁干扰，其中1、2为TX(发送)（拧在一起），3、6为RX（接收）拧在一起。
+
+所以，只需要1,2,3,6这些线正常，就可以满足最基本的上网需求
+### TIA/EIA-568A和TIA/EIA-568B
+T568A或T568B标准规定了双绞线的8根线接入RJ-45接口时的线序。
+
+两个标准的区别是：发送信号的一对线与接收信号的一对线交换了位置。习惯上为10或100 Mbit/s 以太网缠绕线缆是依据T568A或T568B标准。
+
+线缆一端为TIA-568A标准缠绕而另一端以TIA-568B标准缠绕通常被称为交叉缆线。一根交叉线连接起来的两台设备，设备1的网卡的发送端连接到了设备2的网卡的接收端，同样设备1的网卡的接受端连接到了设备2的网卡的发送端。
+对于10M网与100M网，不同性质的设备相连（如计算机与交换机之间）要使用交叉线。对于千兆网，使用了全部8根线的交叉线相连。
+
+准确地来说：如果设备使用与接受数据不同的引脚发送数据，则使用直连线。如果设备使用相同的引脚发送数据，则使用交叉线。
+
+现在的交换机的各端口一般都能自动识别并自适应交叉线及平行线。因此，仅使用交叉线基本能适应各种情形。
+## PoE
+网线的本质就是电线，其实网线也可以用来传输电力，作为电源线使用，这种操作叫做以太网供电(PoE,Power Over Ethernet)
+
+这对于一些需要方便布线的设备有很大的帮助，以前，除了拉网线，还要拉一根电源线，有了PoE之后，就可以用网线解决所有事情
+
+标准化的PoE方案有三种：
+
+模式A:将电能全部加到数据传输线路上，用一根线同时传输数据和电力，这需要用于对连接速度有较高要求的网络上，这时需要用到全部4对线
+
+（由于数据传输使用的是差分信号，所以对数据传输没有太大的影响）
+
+模式B:用1,2,3,6传输数据，用4,5,7,8运送电力，这适合对网速要求不高的情况
+
+4PPoE:使用全部的4对线传输电力，通常需要用在高性能设备上
+## 参考
+
+https://zh.wikipedia.org/zh-cn/%E5%8F%8C%E7%BB%9E%E7%BA%BF
+
+https://zh.wikipedia.org/zh-cn/8P8C
+
+https://zh.wikipedia.org/zh-cn/%E4%BB%A5%E5%A4%AA%E7%BD%91%E4%BE%9B%E7%94%B5
+
+https://zh.wikipedia.org/zh-cn/TIA/EIA-568
+
+https://zh.wikipedia.org/zh-cn/%E5%8F%8C%E7%BB%9E%E7%BA%BF%E4%BB%A5%E5%A4%AA%E7%BD%91

docs/wiki/05-基础知识/DNS.md

@@ -1 +0,0 @@
-# DNS是什么和它的原理

docs/wiki/08-故障/_README.md

@@ -0,0 +1,2 @@
+# 故障
+这里列举了你可能遇到的一些故障

docs/wiki/09-MacOS修理指南.md

@@ -1 +1,31 @@
 # MacOS修理指南
+许多用户使用的是MacOS系统，操作起来和Windows系统不一样，而且也会遇到独有的问题，所以，我们需要单独写这个章节来总结MacOS网络修理的要点
+:::tip 提示
+
+这里的很多方法也适用于linux系统
+
+:::
+## 操作
+### 查看ip
+打开终端，输入`ip a`，或`ip -brief address`（这个的信息更加简略）
+### 拨号
+关于MacOS拨号的教程，建议看这个：https://wiki.zsxyww.com/article/popular/%E7%A7%91%E6%99%AE-macOS%E5%BB%BA%E7%AB%8BPPPoE%E6%8B%A8%E5%8F%B7%E8%BF%9E%E6%8E%A5%E6%95%99%E7%A8%8B
+
+1.点击左上角 苹果图标, 选择 系统偏好设置 | 网络 进入网络设置界面\
+2.确定适配器已经连接好，网线连接好\
+3.选中对应的适配器页面，在 配置IPv4 右边下拉框选择 创建PPPoE服务, 服务名称用默认的就行\
+4.左侧选中新建的 PPPoE 进入 PPPoE 设置页面，填写 帐户名称 和 密码, 选择 记住此密码\
+5.点击右下方的 应用 保存设置，然后点击 连接 即可建立拨号
+
+## 问题
+### 拨号问题
+#### 未能找到PPPoE服务器
+1.按照 Windows 系统拨号651错误处理流程处理，检查线路连接\
+2.注意 macOS 系统有的适配器也是需要安装驱动的(特别是绿联的某型号)，可以看看IP有没有正常获取得到，或者插拔网线有没有反应(不会判断驱动有没有安装的话不如换台电脑检测线路是否正常?)
+
+#### 提示: 鉴定失败
+1.按照 Windows 系统拨号691错误处理流程处理\
+2.检查账号密码有没有输错\
+3.是否接了正确的运营商线路\
+4.账号是否正常状态(欠费/异常断线导致挂死)\
+5.账号有没有被运营商绑定(解绑)

docs/wiki/10-资源.md

@@ -0,0 +1,17 @@
+# 资源
+这里汇集了一些可能需要用到的资源
+:::tip 提示
+
+内部资料不要外传哦！
+
+:::
+## 工具
+一些修网可能遇到的小工具
+
+**ComIntRep**  Complete Internet Repair:这个工具可以一键修复Windows的各种网络问题，如果在修网过程中遇到客户电脑设置问题的，可以在电脑上跑一遍这个程序，在公告里我写了一篇教程，可以参考：[Click Me](/downloads/tools/comintrep_2103（传说中的神器）.zip)
+## 文件
+一些文件，可以作wiki的补充说明
+
+**网络维护科规章制度**  我们的规章制度，从群文件里下载的：[Click Me](/downloads/documents/网络维护科规章制度.docx)
+
+**180328网维维修手册**  前辈写的手册，好像很久没有更新了：[Click Me](/downloads/documents/180328网维维修手册.docx)

docs/wiki/11-杂项/index.md

@@ -0,0 +1,2 @@
+# 杂项
+这里存放了一些不便于归类的文章

docs/wiki/11-杂项/关于169.254.x.x的ip问题汇总.md

@@ -0,0 +1,26 @@
+# 关于169.254.x.x的ip的问题汇总
+## 介绍
+有些用户在正常物理链接时并不会出现宿舍网络分配的172.x.x.x地址，而是出现了169.254.x.x的地址，有时候不需要管他也可以正常上网，但是有时候就不行，这里就汇集了关于这个问题的经验
+## 资料
+查阅资料可得知，这个是客户端开启了DHCP,但是服务端DHCP获取失败时，系统自动为本机分配的ip地址，不至于因为没有ip地址就无法内网通信了，应该是机房的DHCP服务器出现了问题，或者是用户的网络配置有问题，导致无法获取DHCP，于是就设置了这个fallback,技术好像叫APIPA
+
+总之，出现这种情况，应该是服务器和用户其中一个或者全部的DHCP出现了问题，如果只有用户一人出现了这种情况，那么应该是用户的问题，如果宿舍，一个楼层，都出现情况，那么应该是交换机或者路由器出现了问题
+
+参考：https://zhuanlan.zhihu.com/p/100732856
+
+## 实际情况
+
+**可以将你遇到的情况添加到这里：**
+
+---
+
+在旧版wiki有如下文章:[链接](https://wiki.zsxyww.com/article/fault/%E6%95%85%E9%9A%9C0-%E8%8E%B7%E5%8F%96%E5%88%B0169-254%E5%BC%80%E5%A4%B4%E7%9A%84%E9%94%99%E8%AF%AFip%E5%9C%B0%E5%9D%80),应该是以前的人写的文章
+
+21-安德：这种情况朝晖一般不用管，凤翔据说也可以连接，香晖cd的话，有时候在交换机换口可以解决这个问题，他曾遇到过一个情况，使用USB2.0的转接器就会出现这种情况并且连不上网，用USB3.0的就可以,拿了3个USB3.0的都可以上网，就是USB2.0的不能用
+
+
+
+
+
+
+

docusaurus.config.js

@@ -25,8 +25,9 @@ const config = {
   deploymentBranch: 'build',
   githubHost: 'github.com',
 
-  onBrokenLinks: 'throw',
+  onBrokenLinks: 'warn',
   onBrokenMarkdownLinks: 'warn',
+  //staticDirectories: ['static'],
 
   // Even if you don't use internationalization, you can use this field to set
   // useful metadata like html lang. For example, if your site is Chinese, you

package-lock.json

@@ -3525,26 +3525,6 @@
         "@types/ms": "*"
       }
     },
-    "node_modules/@types/eslint": {
-      "version": "8.56.10",
-      "resolved": "https://registry.npmjs.org/@types/eslint/-/eslint-8.56.10.tgz",
-      "integrity": "sha512-Shavhk87gCtY2fhXDctcfS3e6FdxWkCx1iUZ9eEUbh7rTqlZT0/IzOkCOVt0fCjcFuZ9FPYfuezTBImfHCDBGQ==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/estree": "*",
-        "@types/json-schema": "*"
-      }
-    },
-    "node_modules/@types/eslint-scope": {
-      "version": "3.7.7",
-      "resolved": "https://registry.npmjs.org/@types/eslint-scope/-/eslint-scope-3.7.7.tgz",
-      "integrity": "sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==",
-      "license": "MIT",
-      "dependencies": {
-        "@types/eslint": "*",
-        "@types/estree": "*"
-      }
-    },
     "node_modules/@types/estree": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.5.tgz",
@@ -6147,10 +6127,9 @@
       }
     },
     "node_modules/enhanced-resolve": {
-      "version": "5.17.0",
-      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.0.tgz",
-      "integrity": "sha512-dwDPwZL0dmye8Txp2gzFmA6sxALaSvdRDjPH0viLcKrtlOL3tw62nWWweVD1SdILDTJrbrL6tdWVN58Wo6U3eA==",
-      "license": "MIT",
+      "version": "5.17.1",
+      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.17.1.tgz",
+      "integrity": "sha512-LMHl3dXhTcfv8gM4kEzIUeTQ+7fpdA0l2tUf34BddXPkz2A5xJ5L/Pchd5BL6rdccM9QGvu0sWZzK1Z1t4wwyg==",
       "dependencies": {
         "graceful-fs": "^4.2.4",
         "tapable": "^2.2.0"
@@ -15181,12 +15160,10 @@
       }
     },
     "node_modules/webpack": {
-      "version": "5.92.1",
-      "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.92.1.tgz",
-      "integrity": "sha512-JECQ7IwJb+7fgUFBlrJzbyu3GEuNBcdqr1LD7IbSzwkSmIevTm8PF+wej3Oxuz/JFBUZ6O1o43zsPkwm1C4TmA==",
-      "license": "MIT",
+      "version": "5.94.0",
+      "resolved": "https://registry.npmjs.org/webpack/-/webpack-5.94.0.tgz",
+      "integrity": "sha512-KcsGn50VT+06JH/iunZJedYGUJS5FGjow8wb9c0v5n1Om8O1g4L6LjtfxwlXIATopoQu+vOXXa7gYisWxCoPyg==",
       "dependencies": {
-        "@types/eslint-scope": "^3.7.3",
         "@types/estree": "^1.0.5",
         "@webassemblyjs/ast": "^1.12.1",
         "@webassemblyjs/wasm-edit": "^1.12.1",
@@ -15195,7 +15172,7 @@
         "acorn-import-attributes": "^1.9.5",
         "browserslist": "^4.21.10",
         "chrome-trace-event": "^1.0.2",
-        "enhanced-resolve": "^5.17.0",
+        "enhanced-resolve": "^5.17.1",
         "es-module-lexer": "^1.2.1",
         "eslint-scope": "5.1.1",
         "events": "^3.2.0",

src/components/HomepageFeatures/index.js

@@ -11,6 +11,7 @@ const FeatureList = [
         网维的知识库
       </>
     ),
+    link: '/docs/wiki/首页',
   },
   {
     title: '开发组文档',
@@ -20,6 +21,7 @@ const FeatureList = [
         开发组的文档
       </>
     ),
+    link: "/docs/devdocs/首页",
   },
   {
     title: '公告',
@@ -29,6 +31,7 @@ const FeatureList = [
         公告和博客
       </>
     ),
+    link:"/blog",
   },
 ];
 
@@ -36,7 +39,9 @@ function Feature({Svg, title, description}) {
   return (
     <div className={clsx('col col--4')}>
       <div className="text--center">
+         <a href={FeatureList.link}>
           <Svg className={styles.featureSvg} role="img" />
+         </a>
       </div>
       <div className="text--center padding-horiz--md">
         <Heading as="h3">{title}</Heading>
@@ -59,3 +64,4 @@ export default function HomepageFeatures() {
     </section>
   );
 }
+

static/robots.txt

@@ -0,0 +1,2 @@
+User-agent: *
+Disallow: *

static/test/test.txt

@@ -0,0 +1 @@
+...

todolists.md

@@ -0,0 +1,3 @@
+# 备忘录
+**这里是网站开发备忘录，有什么想法，事情，都可以记在这里，善用Markdown功能**
+- 在正式成员中招募一些人来持续维护wiki