首页编程正文内容

腾讯云服务器Linux系统配置mkdocs教程（一名小白的记录）

编程

更新时间：2026-05-08 21:46:49 62

admin 管理员组

文章数量: 1184232

环境：

服务器系统：CentOS 7.9.2009 x86_64(Py3.7.9)

第一步：远程连接服务器

连接服务器这种基本操作，每个人都得会吧

远程连接服务器后，我们就进入到了服务器的终端，在这里我们可以输入命令，操控服务器

打开xshell（一款远程连接服务器的软件，自己去网上下）（或者也可使用宝塔面板自带终端，还有腾讯云的远程连接服务器）
输入ip，使用root用户登录（避免权限不够，具体步骤：Linux系统如何以root身份登入_以root账户登录-CSDN博客）

第二步：pip下载mkdocs

pip是一个专门用于安装python程序的命令，分为pip（for python2+）和pip3（for python3+），我们统一使用python3进行搭建，于是使用pip3命令

进入终端后，使用shell指令进行安装

使用pip3命令下载mkdocs包
```
pip3 install mkdocs
```
验证是否下载成功（看mkdocs命令能不能用）
```
mkdocs --version
```
如果弹出版本信息，则安装成功

第三步：创建mkdocs网站项目

选择一个存放网站代码的路径（这里我就选系统默认安装网站的目录吧）：
```
cd /www
```
创建mkdocs项目：
```
mkdocs new wzyxs_doc
cd wzyxs_doc
ll
```
编辑mkdocs.yml：
```
vim mkdocs.yml
```
在最后一行添加如下配置，保存并退出

使用vim添加，不会vim的用法自己去搜，很重要

我这里参考了两篇文章：

xshell使用 vim编辑器文件：打开、编辑、保存并退出文件 -（含运行截图）_退出vim编辑截图-CSDN博客

VIM中的保存和退出、VIM退出命令、如何退出vim编辑、VIM命令大全_vim保存退出命令-CSDN博客
```
pages:#pages现在弃用了，改成nav
- Home: index.md
- About: about.md
```
手动创建一些网站目录：
```
cd docs/
touch about.md
cd ../
```
生成静态站点：
```
mkdocs build
```

启动对外的服务

mkdocs serve -a 你的ip:8000 #补：内网IP

显示：

  INFO     -  Building documentation...
  INFO     -  Cleaning site directory
  INFO     -  Documentation built in 0.15 seconds
  INFO     -  [16:24:00] Watching paths for changes: 'docs', 'mkdocs.yml'
  INFO     -  [16:24:00] Serving on http://你的ip:8000/

第四步：打开防火墙的8000端口

开启服务按理来说访问ip+8000端口就能访问网站了，但在此之前我们还有一步必要的工作，就是打开防火墙的8000端口

因为刚才的shell正在运行我们的网站，我们无法输入命令，所以让我们重新开一个shell，之前的shell挂着就行

开启防火墙
```
systemctl start firewalld
```
查看服务器防火墙规则
```
firewall-cmd --list-all
```
添加8000端口到默认区域
```
firewall-cmd --zone=public --add-port=8000/tcp --permanent
```
使用--permanent标志可以使规则永久生效，不加这个标志则是临时添加的规则，重启服务或系统后失效
重载防火墙，应用规则
```
firewall-cmd --reload
```

第五步：搭建成功

打开浏览器，输入相应ip+端口（补：外网IP），只要能访问到首页就算搭建成功了

搭建完成后，就能对它进行配置，例如新增栏目，修改主题之类的，但那都是后话了

第六步：文件挂载

mkdocs网站本身都是静态页面，也就是说，我们可以直接访问这些文件，而不依赖php，mysql等网站环境，所以我们可以将site目录里面所有文件，全部挂载到服务器的网站上去

mkdir -p /www/wwwroot/你的站点名/docs

将site目录里面的所有东西都复制过去

cp -rf site/* /www/wwwroot/你的站点名/docs/

接下来直接访问原来网站的该目录就好：http://你的ip/docs

补：site目录：在之前“生成静态站点”所在位置

这里用的相对路径

本文标签：一名腾讯服务器教程系统配置

版权声明：本文标题：腾讯云服务器Linux系统配置mkdocs教程（一名小白的记录）内容由网友自发贡献，该文观点仅代表作者本人，转载请联系作者并注明出处：http://roclinux.cn/b/1763365016a3232165.html，本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。