记录一次课程实验环境下的 Kubernetes 单 master + 单 node 集群搭建：kubeadm 初始化、flannel 网络、Dashboard、Nginx NodePort 发布，以及一路上踩过的 Docker 版本、镜像格式、DNS 和时间同步的坑。

部署时间：2026-10-22

环境规划

实验指导书的原始规划是 master 192.168.100.60、node 192.168.100.61，实际环境与指导书不一致，本文按真实 IP 记录：

软件版本：

提示：如果你的环境 IP 不同，按同样思路替换即可，关键是两台机器的 /etc/hosts、kubeadm 的 --apiserver-advertise-address 和 join 命令里的地址保持一致。

1. 基础环境配置（master、node 均执行）

1.1 配置主机名解析

两台机器的 /etc/hosts 保持一致：

vi /etc/hosts

127.0.0.1   localhost localhost.localdomain localhost4 localhost4.localdomain4
::1         localhost localhost.localdomain localhost6 localhost6.localdomain6
192.168.100.233 master
192.168.100.144 node

设置主机名：

# master
hostnamectl set-hostname master

# node
hostnamectl set-hostname node

验证：

getent hosts master
getent hosts node
ping -c 2 master

这里踩过一个坑：/etc/hosts 里把 node 拼成了 ndoe，同时没写 master 的条目，导致后面 chrony 一个时间源都没有。hosts 是整套集群的基础，先确认再往下走。

1.2 关闭防火墙、SELinux、swap

systemctl stop firewalld
systemctl disable firewalld

setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config

swapoff -a
sed -i '/ swap / s/^/#/' /etc/fstab

1.3 内核参数

cat >> /etc/sysctl.conf << EOF
net.ipv4.ip_forward = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.bridge.bridge-nf-call-iptables = 1
EOF

modprobe br_netfilter
sysctl -p

br_netfilter 是 net.bridge.* 这些参数存在的前提；不加载模块直接 sysctl -p 会报 No such file or directory。

1.4 开启 IPVS 相关模块

vi /etc/sysconfig/modules/ipvs.modules

#!/bin/bash
modprobe -- ip_vs
modprobe -- ip_vs_rr
modprobe -- ip_vs_wrr
modprobe -- ip_vs_sh
modprobe -- nf_conntrack_ipv4

chmod 755 /etc/sysconfig/modules/ipvs.modules
bash /etc/sysconfig/modules/ipvs.modules
lsmod | grep -e ip_vs -e nf_conntrack_ipv4

1.5 时间同步（chrony）

master：

yum -y install chrony
vi /etc/chrony.conf

删除默认的 4 行 server *.centos.pool.ntp.org，加入：

local stratum 10
server master iburst
allow all

systemctl start chronyd
systemctl enable chronyd
chronyc sources -v

node：

yum -y install chrony
vi /etc/chrony.conf

删除默认 4 行 server，加入：

server master iburst

systemctl start chronyd
systemctl enable chronyd
chronyc sources

出现 ^* master 即同步成功。若显示 0 个源，先查 getent hosts master 和 journalctl -u chronyd。

2. 准备 YUM 源

课程实验是离线环境，源分两部分：

• CentOS 7 ISO：基础系统包（本文环境用的是 CentOS-7-x86_64-Minimal-2009.iso，包比 DVD 少，缺什么再补）
• K8S.tar.gz 解压出的 Kubernetes/ 目录：kubeadm/kubelet/kubectl、docker-ce 等 RPM

本实验 master 和 node 都使用本地 file:// 源，不使用 FTP。node 上原本没有 K8S 包，需要从 master 把 /opt/K8S 整个复制过去，保持路径一致。

2.1 上传安装介质

先把两个文件通过 SFTP 或 VMware 共享文件夹传到 master 的 /root：

• CentOS-7-x86_64-Minimal-2009.iso
• K8S.tar.gz（课程提供的离线包）

ls -lh /root/CentOS-7-x86_64-Minimal-2009.iso /root/K8S.tar.gz

K8S.tar.gz 解压后主要有：

• Kubernetes/：kubeadm/kubelet/kubectl、docker-ce 等 RPM
• images/：各组件镜像 tar
• yaml/：flannel、Dashboard 等清单
• kubernetes_base.sh：批量导入镜像的脚本

2.2 master 准备源

cd /root

# base 源：把 ISO 内容放到 /opt/centos
mkdir -p /opt/centos
mount /dev/cdrom /mnt
cp -r /mnt/* /opt/centos/

# 离线 RPM：解压 K8S 包
mkdir -p /opt/K8S
tar -zxf K8S.tar.gz -C /opt/K8S

配置 repo（master、node 完全相同）：

cd /etc/yum.repos.d/
rm -f *
vi local.repo

[centos]
name=centos
baseurl=file:///opt/centos
gpgcheck=0

[K8S]
name=K8S
baseurl=file:///opt/K8S/Kubernetes
gpgcheck=0

yum clean all
yum makecache

2.3 node 同步源目录

# master → node，保持 /opt/K8S 路径一致
scp -r /opt/K8S root@192.168.100.144:/opt/

# 基础源目录同样需要
scp -r /opt/centos root@192.168.100.144:/opt/

若 node 上已存在 /opt/K8S，先把旧目录移走，避免 scp 嵌套成 /opt/K8S/K8S。

然后在 node 上写一份和 master 完全相同的 local.repo：

cd /etc/yum.repos.d/
rm -f *
vi local.repo

[centos]
name=centos
baseurl=file:///opt/centos
gpgcheck=0

[K8S]
name=K8S
baseurl=file:///opt/K8S/Kubernetes
gpgcheck=0

yum clean all
yum makecache

不想把 ISO 内容复制到 node 时，才需要 master 开 FTP/HTTP 共享，让 node 的 [centos] 指向 ftp://192.168.100.233/centos；本实验两台机器都用本地源，最省事。

3. 安装 Docker 18.09.6

Docker 的 RPM 已经包含在上一节的 [K8S] 离线源里，不需要额外添加 Docker 官方源：

yum -y install docker-ce

yum 会自动解析依赖，装上 docker-ce、docker-ce-cli、containerd.io 三个包。离线源里只有 18.09.6，所以不会装到新版本。

为什么不装最新版？kubelet 1.14 官方验证的是 Docker 18.09，而且 flannel 等 2018 年的老镜像是 Docker schema1 格式，Docker 26 默认拒绝使用，会直接导致节点 NotReady。若额外启用了 Docker 官方源，yum install docker-ce 就会装到 26.x，务必避免。

配置 daemon.json：

mkdir -p /etc/docker
vi /etc/docker/daemon.json

{
  "exec-opts": ["native.cgroupdriver=systemd"]
}

Docker Hub 直连被 DNS 污染的环境，建议同时配置镜像加速器（按需保留）：

{
  "exec-opts": ["native.cgroupdriver=systemd"],
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}

systemctl daemon-reload
systemctl start docker
systemctl enable docker

docker info | grep -E "Server Version|Cgroup"

应看到 Server Version: 18.09.6、Cgroup Driver: systemd。kubelet 和 Docker 的 cgroup 驱动必须一致。

4. 安装 kubeadm、kubelet、kubectl（1.14.1）

master 和 node 都执行：

yum -y install kubelet-1.14.1 kubeadm-1.14.1 kubectl-1.14.1

systemctl enable kubelet
systemctl start kubelet

初始化完成前 kubelet 会反复重启，这是正常现象，不用管。

5. 加载离线镜像

第 2 节已经把 K8S 包解压到 /opt/K8S，1.14.1 所需的镜像都在 /opt/K8S/images。master 上：

cd /opt/K8S
./kubernetes_base.sh

脚本会批量 docker load 镜像目录中的 tar 包。确认：

docker images | grep -E "kube-|etcd|flannel|coredns|pause"

6. kubeadm 初始化 master

kubeadm init \
  --kubernetes-version="v1.14.1" \
  --image-repository=registry.aliyuncs.com/google_containers \
  --apiserver-advertise-address=192.168.100.233 \
  --pod-network-cidr=10.16.0.0/16

参数说明：

• --apiserver-advertise-address：必须是 master 的真实 IP（不是指导书里的 .60）
• --pod-network-cidr：必须与 flannel 的 Network 配置一致
• --image-repository：与离线镜像的名称前缀对应

初始化成功后按提示配置 kubectl：

mkdir -p $HOME/.kube
cp -i /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config

检查控制面：

kubectl get cs
kubectl get nodes

7. 部署 flannel 网络

cd /opt/K8S/yaml
kubectl apply -f kube-flannel.yaml

kubectl get pods -n kube-system -o wide

master 上的 kube-flannel-ds-amd64-xxx Running 后，控制面节点会先变为 Ready。

8. node 加入集群

8.1 在 node 上准备离线镜像

第 2 节已经把 /opt/K8S 同步到了 node，镜像就在 /opt/K8S/images，直接运行加载脚本：

cd /opt/K8S
./kubernetes_base.sh
docker images | grep -E "kube-|etcd|flannel|coredns|pause"

若镜像目录或脚本不完整，至少确保 pause、kube-proxy、flannel 镜像存在，可用 docker save / docker load 从 master 补齐。

8.2 执行加入命令

在 master 上生成 join 命令（token 默认 24 小时过期，过期可重新生成）：

kubeadm token create --print-join-command

在 node 上执行打印出的命令，例如：

kubeadm join 192.168.100.233:6443 --token xxxxxx.xxxxxxxxxxxxxxxx \
  --discovery-token-ca-cert-hash sha256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

成功标志：

This node has joined the cluster

8.3 踩坑：node 一直 NotReady，flannel 镜像 ImagePullBackOff

现象：

kube-flannel-ds-amd64-xxxxx   0/1   Init:ImagePullBackOff

查事件：

kubectl describe pod -n kube-system kube-flannel-ds-amd64-xxxxx | tail -20

如果看到：

Failed to pull image "quay.io/coreos/flannel:v0.11.0-amd64":
[DEPRECATION NOTICE] Docker Image Format v1 and Docker Image manifest version 2,
schema 1 support is disabled by default ...

原因就找到了：这个 flannel 镜像是 Docker schema1 格式，node 上的 Docker 26 拒绝使用。解法：

1. 把 node 的 Docker 降级到 18.09.6（与 master 一致）；
2. 在 node 上确保镜像存在；
3. 删掉 flannel Pod 触发重建。

按本实验离线源正常安装的话，node 的 Docker 本来就会是 18.09.6，不会出现这个问题；这里是环境中混入了外来的 Docker 26。

降级 Docker（node）：

systemctl stop kubelet
systemctl stop docker

yum remove -y docker-ce docker-ce-cli containerd.io docker-ce-rootless-extras \
  docker-buildx-plugin docker-compose-plugin

# containerd 1.6 的元数据 1.2 读不了，挪走旧状态
mv /var/lib/containerd /var/lib/containerd.bak

yum install -y docker-ce-18.09.6 docker-ce-cli-18.09.6 containerd.io-1.2.6-3.3.el7

daemon.json 保持 cgroup systemd，然后启动 Docker 和 kubelet：

systemctl daemon-reload
systemctl start docker
systemctl enable docker
docker info | grep -E "Server Version|Cgroup"

systemctl start kubelet
systemctl status kubelet --no-pager

加载 flannel 镜像（node）：

# 若 node 上没有镜像包，从 master 导出再传过去
# master:
docker save -o /root/flannel.tar quay.io/coreos/flannel:v0.11.0-amd64
scp /root/flannel.tar root@192.168.100.144:/root/

# node:
docker load -i /root/flannel.tar
docker images | grep flannel

触发重建：

kubectl delete pod -n kube-system kube-flannel-ds-amd64-xxxxx
kubectl get pods -n kube-system -o wide
kubectl get nodes

两个节点都 Ready 后：

NAME     STATUS   ROLES    AGE   VERSION
master   Ready    master   ...   v1.14.1
node     Ready    <none>   ...   v1.14.1

9. 部署 Dashboard

cd /opt/K8S/yaml
kubectl create -f kubernetes-dashboard.yaml
kubectl create -f dashboard-adminuser.yaml

检查：

kubectl get pods -n kube-system -o wide
kubectl get svc -n kube-system

服务类型为 NodePort：

kubernetes-dashboard   NodePort   10.102.208.171   <none>   443:30000/TCP

本次环境中 Dashboard Pod 调度到了 master，所以访问：

https://192.168.100.233:30000

不是 http://，也不要只认 node 的 IP（Pod 在哪个节点，用哪个节点 IP 最稳；NodePort 正常时任一节点 IP 都可以）。

浏览器提示证书不受信任，选择"高级 → 继续前往"。

获取登录 token：

kubectl -n kube-system get secret | grep admin
kubectl -n kube-system describe secret \
  $(kubectl -n kube-system get secret | grep admin | awk '{print $1}')

复制 token: 后的字符串登录。

10. 部署 Nginx 示例应用

node 上准备镜像（离线包或镜像加速器）：

docker load -i /root/nginx_latest.tar
docker images | grep nginx

# 或走加速器
docker pull docker.m.daocloud.io/library/nginx:latest
docker tag docker.m.daocloud.io/library/nginx:latest nginx:latest

master 上创建 Deployment：

kubectl create deployment nginx --image=nginx
kubectl get pods -o wide
kubectl get deployment

--image=nginx 等价于 nginx:latest，默认拉取策略是 Always，kubelet 仍会尝试拉镜像。离线环境如果拉取失败，把策略改成 IfNotPresent：

kubectl patch deployment nginx -p \
  '{"spec":{"template":{"spec":{"containers":[{"name":"nginx","image":"nginx","imagePullPolicy":"IfNotPresent"}]}}}}'

发布服务：

kubectl expose deployment nginx --port=80 --type=NodePort
kubectl get svc nginx

输出中的 80:3xxxx/TCP 即 NodePort：

NAME    TYPE       CLUSTER-IP       PORT(S)        AGE
nginx   NodePort   10.100.233.224   80:31507/TCP   19s

浏览器访问：

http://192.168.100.144:31507

看到 "Welcome to nginx!" 即成功。

扩容：

kubectl scale deployment nginx --replicas=3
kubectl get pods -o wide

清理：

kubectl delete deployment nginx
kubectl delete svc nginx

11. 踩坑速查表

结语

这套环境的核心难点不在 kubeadm 本身，而在老版本组件的兼容性和离线/受限网络：

• 版本组合要对：kubelet 1.14.1 + Docker 18.09.6；
• 老镜像格式要认：schema1 镜像在 Docker 26 上不可用；
• 网络细节要通：hosts、chrony、flannel、NodePort 任一环出问题都会表现为集群异常。

集群跑起来之后，先给两台虚拟机打快照，再继续后面的 OpenShift 等实验，能省掉大量返工。

一篇完整的落地记录：从两台 VMware 虚拟机起步，装好 oVirt Engine 4.5 和 oVirt Node NG 4.5，配上 NFS 存储域，最后用管理门户创建并装好一台 CentOS 7 虚拟机。

网上能搜到的教程大多还是 CentOS 7 + oVirt 4.3.8 那一套，仓库、安装包和认证方式都已经变了。本文按 Rocky Linux 9.5 + oVirt 4.5 重做了一遍，把真正卡住人的地方标成 【⚠️ 坑 N】（一共 8 个），其中 3.8 节那个坑会让主机永远加不进去，老教程里完全没有提到。

版本基线

环境规划

IP 按自己的环境改（老教程写的是 .41，以你的虚拟机为准），装好后不要再变。

目录

• 1 设置 oVirt 部署环境
• 2 创建 engine 节点虚拟机
• 3 部署 oVirt Engine（3.5 engine-setup 逐项问答，含【坑 1】~【坑 6】；3.8 是最坑的一步）
• 4 部署 oVirt Node（【坑 7】磁盘、【坑 8】坏源）
• 5 添加主机
• 6 配置存储（NFS 建在 node 上）
• 7 上传 ISO
• 8 安装 spice 客户端
• 9 创建虚拟机
• 附录 A 踩坑速查表 · B 常用命令 · C Keycloak 授权问题 · D 与老流程对照

和老流程（CentOS 7 + oVirt 4.3.8）不一样的地方，只有这 6 处

关于配图：文中截图取自 oVirt 4.3.8 的界面（图号沿用原图 3-47 ~ 3-78）。4.5 在登录页、主机页、新建虚拟机页的文案和默认值略有差别，操作路径完全一致，看图时注意版本号不同即可。

1. 设置 oVirt 部署环境

打开 VMware Workstation → 编辑 → 虚拟网络编辑器，确认 VMnet8（NAT） 已启用，并能看到 NAT 设置里的网关地址（一般为 192.168.100.2，就是两台虚拟机的网关和 DNS）。

验证：vmnet8 的"使用本地 DHCP 服务将 IP 地址分配给虚拟机"按需勾选；实验里两台机器建议直接配静态 IP。

2. 创建 engine 节点虚拟机

安装介质换成 Rocky Linux 9.5 minimal：

1. 新建虚拟机：4 vCPU / 8 GB 内存 / 100 GB 硬盘，CD/DVD 挂载 Rocky-9.5-x86_64-minimal.iso，软件选择 最小安装。

   

2. 安装过程中在"网络和主机名"里把网卡连上，主机名填 engine.lab.net，设置 root 密码。

   

   到“安装目的地”这步自动分区即可（图 3-49 是老流程里手动分区的样子：/boot、swap、/ 三块）：

   

3. 装完登录，配置 IP（192.168.100.130/24）、网关和 DNS（192.168.100.2）。

4. 用 SSH（如 Xshell / MobaXterm / Windows 自带 ssh）连上去做后续操作。

hostnamectl set-hostname engine.lab.net
hostname -f                     # 必须输出 engine.lab.net
ip -4 a                         # 确认 IP
systemctl enable --now chronyd  # 时间同步，oVirt 对时间敏感

3. 部署 oVirt Engine

3.1 配置 oVirt 4.5 软件源

老流程（CentOS 7）是"删掉原有源、换成 163 源、再装 ovirt-release43.rpm"。Rocky 上不需要动系统源，只要加一个 oVirt 的仓库文件：

cat > /etc/yum.repos.d/centos-ovirt45.repo <<'EOF'
[centos-ovirt45]
name=CentOS Stream 9 - oVirt 4.5
baseurl=https://mirrors.aliyun.com/centos-stream/SIGs/9-stream/virt/x86_64/ovirt-45/
enabled=1
gpgcheck=0
module_hotfixes=1
EOF

dnf clean all
dnf makecache

module_hotfixes=1 不能少：el9 的模块过滤会让部分 oVirt 包"看不见"，少了这行会出现"源配好了但装不上 ovirt-engine"。

备选：dnf -y install centos-release-ovirt45（会自动写好仓库文件），二选一即可。

验证：dnf repolist | grep ovirt 能看到 centos-ovirt45。

3.2 升级系统

dnf -y update
shutdown -r now

3.3 安装 ovirt-engine

dnf -y install ovirt-engine

会连带装 PostgreSQL、Keycloak、WildFly 等，视网速需要较长时间。验证：rpm -q ovirt-engine 输出 ovirt-engine-4.5.7-1.el9.noarch。

3.4 禁用防火墙

systemctl stop firewalld
systemctl disable firewalld

想保留防火墙也可以，那就在下一步 engine-setup 问"是否自动配置防火墙"时回答 Yes。但不要两边都不管。

3.5 部署 oVirt Engine（engine-setup）—— 坑最集中的一步

engine-setup

各问答大部分直接回车取默认值，需要留意的几处：

成功的样子：

[ INFO  ] Execution of setup completed successfully

【坑 1】FQDN 默认成了 localhost.localdomain

引擎的主机名必须是能被解析的全限定域名。安装前一定要：

hostnamectl set-hostname engine.lab.net
echo '192.168.100.130 engine.lab.net engine' >> /etc/hosts
hostname -f          # engine.lab.net

出现 [WARNING] Failed to resolve engine.lab.net using DNS, it can be resolved only locally 可以忽略（本机 hosts 能解析就行）。

【坑 2】Configure Engine on this host 的默认值变成 [No]

只要这台机器中途中断过一次 engine-setup，向导就会以为"引擎已存在"，把这一问的默认值改成 [No]；你顺手一回车，它就去配置"远程引擎"，最后失败。

处理：中断 → 清理 → 重来，并在这一问明确输入 Yes：

engine-cleanup      # 全部回答 Yes
engine-setup

规矩：每次中断 engine-setup 后，都要跑一次 engine-cleanup。

【坑 3】Database configuration was requested, however, postgresql service was not found

原因：机器上装的是 PGDG 的 PostgreSQL 18（只提供 postgresql-18.service），而 oVirt 找的是不带版本号的 postgresql.service。

rpm -qa | grep -i postgres           # 确认是不是装了 postgresql18-*

dnf -y remove postgresql18 postgresql18-server postgresql18-contrib postgresql18-libs
dnf -y install postgresql-server postgresql
postgresql-setup --initdb
systemctl enable --now postgresql

sudo -u postgres psql -c "select version();"    # PostgreSQL 13.23 ...

oVirt 4.5 只认系统源（appstream）的 PostgreSQL 13，别去装新版。

【坑 4】could not open extension control file ".../uuid-ossp.control" 和 ovirt-aaa-jdbc-tool failed to execute

两个都是缺包，一条命令解决：

dnf -y install postgresql-contrib ongres-scram-client

（第二个的根因是 /usr/share/ovirt-engine/modules/common/com/ongres/scram/client/main/client.jar 指向的文件不存在，ongres-scram-client 来自 centos-ovirt45 仓库。）

【坑 5】PKI 覆盖询问必须手打 Yes

Found existing PKI files, but /etc/pki/ovirt-engine/ca.pem is missing.
Do you want to Continue with Setup and overwrite existing PKI files? (Yes, No) [No]:

默认是 No，只按回车会被判为放弃，报 Failed to execute stage 'Environment customization': Aborted by user。

顺便记住：engine-setup --config-file=... 是无效选项（报 FATAL: Invalid option），要免交互得用 --answer-file。

【坑 6】admin 密码存在 Keycloak 里，忘了很麻烦

oVirt 4.5 的 admin 密码不在 ovirt-aaa-jdbc-tool 能改的地方，它在 Keycloak 里。所以：

• engine-setup 问 Engine admin password: 时输入的密码，当场记下来；
• 万一忘了，用第 3.7 节的方法重置（需要进 Keycloak 管理控制台）。

3.6 配置 hosts 解析

Windows 本机：编辑 C:\Windows\System32\drivers\etc\hosts，加一行（用管理员权限）：

192.168.100.130 engine.lab.net

engine 节点：

cat >> /etc/hosts <<'EOF'
192.168.100.130 engine.lab.net engine
192.168.100.42  node.lab.net   node
EOF

3.7 登录管理门户（以及登录不进去怎么办）

浏览器访问 https://engine.lab.net/，点"管理门户"。

用户名必须是小写 admin，不要写 admin@internal——4.5 的登录页是 Keycloak 提供的，用户名区分大小写，老文档那种写法会直接失败。

登录成功后就是管理门户（计算 / 存储 / 网络 / 管理四个入口）：

登录页反复弹回 / 报 decrypting JWE failed

Apache 的状态 Cookie 解不开，根因是 /etc/httpd/conf.d/internalsso-openidc.conf 里的 OIDCCryptoPassphrase 是动态随机生成的，每次重启 httpd 就换一把密钥，旧 Cookie 全作废。改成固定口令：

cp /etc/httpd/conf.d/internalsso-openidc.conf{,.bak.$(date +%Y%m%d%H%M)}
sed -i 's|^OIDCCryptoPassphrase.*|OIDCCryptoPassphrase "自己编一个32位随机串"|' \
    /etc/httpd/conf.d/internalsso-openidc.conf
httpd -t                # Syntax OK
systemctl restart httpd

改完请用无痕窗口重新登录（浏览器里残留的旧 Cookie 会继续捣乱）。

忘记 admin 密码：进 Keycloak 管理控制台重置

1. 浏览器打开 https://engine.lab.net/ovirt-engine-auth/admin/
2. 用 admin 登录（master realm 管理员，密码就是 engine-setup 时设的那个）
3. 左上角 realm 切到 ovirt-internal
4. Users → 选 admin → Credentials → Reset password → 输入新密码，Temporary 关掉 → Save

等价的命令行方式（实测可用）：

TOKEN=$(curl -sk -X POST \
  https://engine.lab.net/ovirt-engine-auth/realms/master/protocol/openid-connect/token \
  -d client_id=admin-cli -d grant_type=password \
  -d username=admin -d password='<master管理员密码>' \
  | sed -n 's/.*"access_token":"\([^"]*\)".*/\1/p')

# 查用户 id
curl -sk -H "Authorization: Bearer $TOKEN" \
  "https://engine.lab.net/ovirt-engine-auth/admin/realms/ovirt-internal/users?username=admin"

# 重置密码
curl -sk -X PUT -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  "https://engine.lab.net/ovirt-engine-auth/admin/realms/ovirt-internal/users/<用户id>/reset-password" \
  -d '{"type":"password","value":"新密码","temporary":false}'

3.8 ⚠️【最大的坑】把数据中心和集群的兼容版本改成 4.5

这一步老流程里没有、但 oVirt 4.5 上必做。不做，第 5 节添加主机时永远加不进去。

现象

主机添加进去、"安装"也跑完了，状态却一直是红色 NonOperational（无法工作），事件里能看到：

Host node is compatible with versions (4.2,4.3,4.4,4.5,4.6,4.7)
and cannot join Cluster Default which is set to version 4.8.

原因

而且图形界面里改不了：

• 数据中心版本只能升不能降 → 下拉框里只剩 4.8；
• 集群版本必须 ≥ 所属数据中心版本 → 数据中心是 4.8，集群也只能选 4.8。

→ 界面死锁。 解法只有两个：

方案 A（推荐，10 秒）

export PGPASSWORD=<引擎库口令>       # 见 /etc/ovirt-engine/engine.conf.d/ 下 engine-setup 生成的配置
psql -h 127.0.0.1 -U engine -d engine <<'SQL'
begin;
update storage_pool set compatibility_version='4.5' where name='Default';
update cluster      set compatibility_version='4.5' where name='Default';
commit;
SQL

systemctl restart ovirt-engine      # 引擎把兼容版本缓存在内存里，必须重启才生效

方案 B（纯界面）

删掉默认的 Default 数据中心和 Default 集群（此时还没建存储域，可以直接删），然后自己新建数据中心（兼容版本选 4.5）+ 新建集群（兼容版本选 4.5，CPU 类型选 qemu64）。

完成后的正常告警（忽略它）

Data Center Default compatibility version is 4.5, which is lower than latest available version 4.8.
Please upgrade your Data Center to latest version ...

这是引擎例行提醒"数据中心不是最新级别"。我们正是要它低于 4.8，因为 Node 只认到 4.7。

验证：

select name, compatibility_version from storage_pool;   -- 4.5
select name, compatibility_version from cluster;        -- 4.5

4. 部署 oVirt Node

4.1 下载镜像（4.5 用 el9 版）

官方下载地址（约 1.2 GB）：

ovirt-node-ng-installer-latest-el9.iso

4.2 新建虚拟机

2 vCPU / 4 GB 内存 / 100 GB 硬盘，CPU 启用虚拟化，挂 ovirt-node-ng-installer-latest-el9.iso。

【坑 7】磁盘必须 ≥ 100 GB

oVirt Node 的默认分区方案吃不下 50 GB，会报：

可用空间 50 GiB / 总空间 50 GiB
自动分区失败：not enough free space in volume group

解决：关机 → VMware 里把虚拟磁盘从 50 GB 扩到 100 GB（qcow2 稀疏文件，不会立刻占满物理盘）→ 重新引导安装。

4.3 安装与网络配置

oVirt Node NG 用的就是 CentOS 的 Anaconda 安装器，步骤和老流程一样，一步步往下走：

① 语言：

② 软件选择——保持默认的“最小安装”：

③ 安装目的地——点 “Click here to create them automatically”（自动创建分区）。图 3-57 是还没分区时的样子，图 3-58 是自动创建的入口，图 3-59 是自动分好的结果：

④ 网络和主机名——网卡连上，主机名填 node.lab.net，IP 192.168.100.42/24、网关和 DNS 192.168.100.2：

cat >> /etc/hosts <<'EOF'
192.168.100.130 engine.lab.net engine
192.168.100.42  node.lab.net   node
EOF
hostname -f

4.4 ⚠️【必做】关掉 oVirt Node 自带的坏源 onn-sap

每一台 oVirt Node NG 4.5 都带这个坏源（baseurl 指向一个根本不存在的 SAP 仓库），不关掉，第 5 节添加主机必然失败。

cat /etc/yum.repos.d/node-optional.repo          # 看一眼，[onn-sap] 那段的 baseurl 是死的

dnf config-manager --set-disabled onn-sap
# 更保险：全局禁掉，防止 oVirt Node 重启后被重新启用
grep -q '^disablerepo=onn-sap' /etc/dnf/dnf.conf || \
  sed -i '/^\[main\]/a disablerepo=onn-sap' /etc/dnf/dnf.conf

dnf makecache                                    # 无报错
dnf -y install python3 && python3 --version      # 3.9.18

5. 添加主机

计算 → 主机 → 新建：

提示“没有配置电源管理”点确定（实验环境不需要 fencing）：

之后引擎会自动跑 host-deploy，状态先变成“安装中”（图 3-64），跑完就是绿色 Up：

【坑 8】Host node installation failed. Task Ensure Python3 is installed for CentOS/RHEL8 hosts failed to execute.

界面上的报错**≠ 真实原因**，一定要去翻它给出的部署日志：

ls -lt /var/log/ovirt-engine/host-deploy/
grep -nE "fatal:|FAILED" /var/log/ovirt-engine/host-deploy/ovirt-host-deploy-ansible-*.log | tail

日志里真正的原因是 onn-sap 这个死源，跟 Python 毫无关系：

Failed to download metadata for repo 'onn-sap':
Cannot download repodata/repomd.xml: All mirrors were tried

回到 Node 上按 4.4 节 关掉 onn-sap，再回门户重试添加主机即可。

6. 配置存储（NFS 建在 node 节点上）

存储用 NFS，全部在 node 上操作：

# 1) 在 node 节点创建 NFS 共享目录
mkdir -p /data/ISO /data/vm          # /data 不存在就新建；空间不足可换到有空间的目录

# 2) 配置目录权限（36:36 是 vdsm/kvm 用户）
chown 36:36 /data/ISO && chmod 755 /data/ISO
chown 36:36 /data/vm  && chmod 755 /data/vm

# 3) 编辑 NFS 服务器配置文件
cat >> /etc/exports <<'EOF'
/data/ISO 192.168.100.0/24(rw,sync,no_subtree_check,all_squash,anonuid=36,anongid=36)
/data/vm  192.168.100.0/24(rw,sync,no_subtree_check,all_squash,anonuid=36,anongid=36)
EOF

# 4) 启动 NFS 服务
systemctl enable --now rpcbind nfs-server
setsebool -P virt_use_nfs 1

# 5) 查看 NFS 输出
showmount -e
# Export list for node.lab.net:
# /data/vm   192.168.100.0/24
# /data/ISO  192.168.100.0/24

若 engine 与 node 之间被防火墙隔开，记得放行 NFS： firewall-cmd --permanent --add-service=nfs --add-service=rpc-bind --add-service=mountd && firewall-cmd --reload

在门户里建两个存储域（存储 → 域 → 新建域）：

两个域的导出路径分别填成刚才 NFS 输出的两个目录：

数据域会自动挂到数据中心；ISO 域建好后要右键"附加"到数据中心。等两个域状态都变成 "活跃的"。

7. 上传 ISO

把系统 ISO 拷进 ISO 域里以"数据中心 ID"命名的目录：

# 在 node 上先查数据中心 ID（在 engine 上执行也可以）
DC_ID=$(PGPASSWORD=<引擎库口令> psql -h 127.0.0.1 -U engine -d engine -t -A \
        -c "select id from storage_pool where name='Default';")

ISO_DIR=/data/ISO/$DC_ID/images/11111111-1111-1111-1111-111111111111
mkdir -p $ISO_DIR
cp /root/CentOS-7-x86_64-Minimal-2009.iso $ISO_DIR/
chown 36:36 $ISO_DIR/*.iso && chmod 644 $ISO_DIR/*.iso
ls -lh $ISO_DIR

引擎会周期性扫描 ISO 域，等 1~2 分钟（或选中 ISO 域点一下"刷新"）。

验证：新建虚拟机时，在"运行一次"窗口的 CD 下拉框里能看到这个 ISO。

8. 安装 spice 客户端

下载并安装 virt-viewer-x64-11.0-1.0.msi（oVirt 官方的 Windows 控制台客户端），装完用它打开门户里下载的 console.vv。

不想装也行：门户里的虚拟机控制台可以直接用 noVNC（浏览器打开），前提是 engine-setup 时 Configure WebSocket Proxy 选了 Yes。 另外 TigerVNC 也能连（在虚拟机"控制台选项"里看 VNC 端口）。

9. 创建虚拟机

1. 计算 → 虚拟机 → 新建：操作系统 Red Hat Enterprise Linux 7.x x64 / CentOS 7，优化目标“服务器”，名称 CentOS7。

   

2. 实例镜像“创建”一块 10 GB 虚拟磁盘。

   

3. 网络接口选 ovirtmgmt。

   

4. 用 VMware Workstation 做实验时必做：勾选“显示高级选项 → 系统 → 高级参数 → 自定义仿真机”，选择 pc-i440fx-rhel7.2.0（或 pc-i440fx-rhel7.1.0），否则虚机装完系统起不来。

   

5. 选中虚拟机 → “只运行一次” → 勾选附加 CD、选刚上传的系统 ISO、引导顺序把 CD-ROM 放最前。

   

6. 启动后点 控制台，双击下载的 console.vv 打开 Remote Viewer（释放鼠标：Shift+F12）完成系统安装。

   

7. 装完把引导顺序改回硬盘；在虚机里 ip a 看到 IP 后，宿主机能 ping 通、能 SSH 上去，实验完成。

   

界面刷新不下来时，systemctl restart ovirt-engine 是最省事的"重启大法"。

附录 A：踩坑速查表（按报错信息检索）

附录 B：常用命令速查

# ---- engine 节点 ----
systemctl status ovirt-engine        # 引擎状态（Keycloak 是引擎内嵌子系统，没有独立的 keycloak.service）
engine-setup / engine-cleanup        # 配置 / 清理
engine-backup --mode=backup --file=/root/all.bk --log=/root/all.log

export PGPASSWORD=<引擎库口令>
psql -h 127.0.0.1 -U engine -d engine

select name, compatibility_version from storage_pool;      # 数据中心版本
select name, compatibility_version from cluster;           # 集群版本
select vds_name, status, non_operational_reason from vds;  # 主机状态（原因码在这里，比翻界面快）
select to_char(log_time,'MM-DD HH24:MI'), message
  from audit_log order by log_time desc limit 30;          # 最近事件

# ---- node 节点 ----
systemctl status vdsmd
tail -f /var/log/vdsm/vdsm.log
journalctl -u vdsmd -n 50
showmount -e

# ---- 主机部署排障（engine 上）----
ls -lt /var/log/ovirt-engine/host-deploy/
grep -nE "fatal:|FAILED" /var/log/ovirt-engine/host-deploy/ovirt-host-deploy-ansible-*.log

附录 C：特殊情况——Keycloak 过了仍提示 "not authorized to perform login"

The user admin@internalkeycloak-authz with profile [internalsso] is not authorized to perform login

说明认证成功、授权失败。链路是：

Keycloak 登录 → 引擎 SSO → internalkeycloak-authz 授权域 → 引擎按用户名找用户 → 查 permissions 表里的 SuperUser 授权

① Keycloak 的 ovirt-internal realm 里有没有 admin 这个用户？ 没有就在 Keycloak 管理控制台（realm 切到 ovirt-internal）→ Users → Add user 建一个 admin，再 Reset password（Temporary 关掉）。

② 引擎 permissions 表里有没有对该用户的 SuperUser 授权？

admin@internal、admin@ovirt、admin@internalkeycloak-authz 在引擎里是三条不同的用户记录，授权不能互相顶替：

select u.username, u.domain, p.role_id, p.ad_element_id
  from permissions p join users u on u.user_id = p.ad_element_id;

缺 internalkeycloak-authz 域下 admin 的 SuperUser 授权时补一条（SuperUser 角色 ID 固定为 00000000-0000-0000-0000-000000000001，系统级对象 ID aaa00000-0000-0000-0000-123456789aaa）：

insert into permissions (id, role_id, ad_element_id, object_id, object_type_id, creation_date)
select uuid_generate_v4(), '00000000-0000-0000-0000-000000000001', user_id,
       'aaa00000-0000-0000-0000-123456789aaa', 1,
       (extract(epoch from now())*1000)::bigint
  from users
 where domain = 'internalkeycloak-authz' and username = 'admin'
   and not exists (select 1 from permissions p
                    where p.ad_element_id = users.user_id
                      and p.role_id = '00000000-0000-0000-0000-000000000001');

权限是实时读取的，补完直接重登，不用重启引擎。 注意 users.user_and_domain 是生成列（不能直接 UPDATE），creation_date 是 bigint 毫秒。

附录 D：与老流程（CentOS 7 + oVirt 4.3.8）的对照

结语

按 1 → 9 走完，最终会得到：

• 一台 engine.lab.net（Rocky 9.5）跑着 oVirt Engine 4.5，浏览器打开 https://engine.lab.net/ 能进管理门户；
• 一台 node.lab.net（oVirt Node NG 4.5）作为虚拟化主机，状态是绿色的 Up；
• 数据中心 Default 里挂好 Data 和 ISO 两个 NFS 存储域，都显示"活跃的"；
• 一台 CentOS 7 虚拟机，从门户创建、装完系统，宿主机能 SSH 连上。

整个过程真正容易栽的其实只有三处：PostgreSQL 装成了 18（坑 3）、数据中心/集群的兼容版本被设成 4.8（3.8 节）、Node 自带的 onn-sap 死源（坑 8）。把这三个记住，剩下的照着点就行。

遇到报错建议直接翻 附录 A：那张表按"报错信息 → 真实原因 → 解决"排好了，可以直接按报错关键字搜。

<img src="https://cdn.jsdelivr.net/gh/azzlantern/blog-pic@main/blog/2026/50240AB7E0357254AF69BB5E6495DA41_2026-06-16_200034.webp" alt="zhu" width="150" height="150">

📑 快速导航

基础准备部分

一、虚拟机导入与网络配置（考试之前准备，对应 7.1）

在考试之前需要准备一个正常 能使用的系统，但是不能完全按照老师那个7.1来配置

自己安装Ubuntu也行 导入Ubuntu也可以 这里以导入为主 双击牢师给的Ubuntu_pure.ova之后，在虚拟电脑导入设置的 MAC地址设定选择 包含所有网卡的MAC地址 导入完成之后 不要忙着启动虚拟机 先去虚拟机设置里面 点击网络

使用 NAT + Host-Only +桥接 三网卡模式配置网络。

1.1 配置宿主机 Host-Only 网卡

打开 VirtualBox → 管理 → 网络管理器（Network Manager）：

旧版 新版

• 点击创建（或选中已有的 Host-Only 网络） 然后点击属性
• 勾选手动配置网卡，填写：
  • IPv4 地址：192.168.103.11（宿主机在此局域网的 IP）
  • 子网掩码：255.255.255.0
• 点击应用

1.2 给虚拟机分配三块网卡

关闭虚拟机，进入 设置 → 网络：

网卡3 桥接 enp0s9 备用（用于牢师非要要求你要连上路由器，然后要和路由器ping通什么的，可选 不知道到时候到底怎么考）

1.3 虚拟机内配置静态 IP

在搞这个之前再安装个vbox对虚拟机的增强功能，方便剪贴板共享 照着图片点那个安装增强功能。然后虚拟机会有个窗口，运行就行，看到终端最后有Press Return to close this Window。。。就是安装好了，重启虚拟机就行了

ok啊兄弟们，临时学个东西，nano编辑器

比vim方便多了，不用记一堆快捷键，改完之后Ctrl+O保存，回车确认，然后Ctrl+X退出，就完事了

那这个时候有人就要问了（你不许问）

改炸了怎么办😭

直接Ctrl+X，它会问你是否保存改动，按n就行，不保存直接跑路

然后我们回到正题 编辑 /etc/network/interfaces： 但是注意需要查看自己实际的网卡情况 在终端先输ip a或者ifconfig

sudo nano /etc/network/interfaces

写入以下内容：

auto lo
iface lo inet loopback

# NAT 网卡 - 上外网
auto enp0s3
iface enp0s3 inet dhcp

# Host-Only 网卡 - 与宿主机通信
auto enp0s8
iface enp0s8 inet static
address 192.168.103.128
netmask 255.255.255.0

# 桥接网卡 - 与教室路由器通信

#必要时取消注释

#auto enp0s9
#iface enp0s9 inet static
#address 192.168.103.28
#netmask 255.255.255.0
#gateway 192.168.103.1

这里仅主机网卡ip和桥接不能一样，可以桥接用学号后两位比如我的28 然后仅主机 128 就是加100 然后和宿主机通信优先用仅主机 牢师说要用教室网络连网关这些再搞，没必要搞那么麻烦，甚至桥接网卡这一部分都可以不配置

应用配置怎么搞呢 直接重启虚拟机。

1.4 验证网络连通性

# 虚拟机内测外网
ping -c 3 8.8.8.8

# 虚拟机 ping 宿主机
ping 192.168.103.11

如果 ifconfig 不可用，先安装工具：

sudo apt install net-tools

二、系统基础配置

2.1 更换 apt 镜像源

Ubuntu 默认官方源位于国外，下载速度较慢。这里我们更换为北京外国语大学（BFSU） 的国内镜像源，同时保留了安全更新源，确保系统漏洞补丁能正常安装。

操作步骤：

1. 打开终端（快捷键 Ctrl + Alt + T）。
2. 一次性复制下方整个代码块，在终端中鼠标右键点击（或按 Ctrl + Shift + V）粘贴，然后按 Enter 键运行。

sudo tee /etc/apt/sources.list <<'EOF'
deb http://mirrors.bfsu.edu.cn/ubuntu/ bionic main restricted universe multiverse
# deb-src http://mirrors.bfsu.edu.cn/ubuntu/ bionic main restricted universe multiverse

deb http://mirrors.bfsu.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse
# deb-src http://mirrors.bfsu.edu.cn/ubuntu/ bionic-updates main restricted universe multiverse

deb http://mirrors.bfsu.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse
# deb-src http://mirrors.bfsu.edu.cn/ubuntu/ bionic-backports main restricted universe multiverse

deb http://mirrors.bfsu.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
# deb-src http://mirrors.bfsu.edu.cn/ubuntu/ bionic-security main restricted universe multiverse
EOF

💡 这条命令做了什么？
它会直接用上面的内容覆盖掉系统原有的 /etc/apt/sources.list 文件。你不需要手动打开编辑器，也不需要纠结如何保存退出，一条命令全自动完成。

2.2 更新系统

sudo apt update
sudo apt upgrade

完成后重启虚拟机。

2.3 更改主机名

sudo hostnamectl set-hostname 你想改的主机名

然后 sudo nano /etc/hosts 把127.0.0.1这一行后面的改成你的 我这边改的mukutobi 保存 然后刷新一下终端 exec bash

这里也建议重启虚拟机

2.4 安装配置 Openssh

sudo apt install openssh-server

修改ssh配置

sudo nano /etc/ssh/sshd_config

找到PermitRootLogin prohibit-password 删掉前面的# 取消注释 保存退出

建议检查ssh服务是否正常 先重启服务

systemctl restart ssh

再检查

systemctl status ssh

确认有无报错

使用ssh工具连接虚拟机

这边还是用mobaxterm吧，如果想用美观好用的可以下载Tabby 照着图片配置就行 传文件添加sftp

什么叫你不知道用户名和密码？

<img src="https://cdn.jsdelivr.net/gh/azzlantern/blog-pic@main/blog/2026/2A3F2EC7354C72B1D188E11316436FAC_2026-06-15_212728.webp" alt="zhu" width="150" height="150">

用户名 nle 密码 a12345678

添加完主界面左边列表就有添加好的虚拟机了，双击连接ssh，看到图片这个就成功了

！！！注意，在这一步搞完之后可以复制一份虚拟机备用，防止7.4牢师考试真让本地安装docker

7.2 Docker + Nginx + MySQL 环境搭建 （可以暂时不看）

主要是看情况到时候到底怎么办的 这段就先不看了吧

三、安装 Docker

使用轩辕镜像的一键安装脚本：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

#没反应的话这么搞
wget https://xuanyuan.cloud/docker.sh -O docker-install.sh
chmod 777 docker-install.sh
bash docker-install.sh

执行之后是这样的：

root@074b1042fc62:/# bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
⚠️  未检测到 sudo 命令，将直接使用 root 权限执行命令
==========================================
🐳 欢迎使用轩辕镜像 Docker 一键安装配置脚本
==========================================
官方网站: https://xuanyuan.cloud/

请选择操作模式：
1) 一键安装配置（推荐）
2) 修改轩辕镜像专属域名
3) 恢复 Docker 镜像相关配置

请输入选择 [1/2/3]: 1

>>> 模式：一键安装配置

选1回车，等它一键配置。 后面可能有 是否继续将 xxx 添加到 docker 组？[Y/n] 这个按 y，以后输docker相关不用su和sudo。

安装完成后验证：

docker --version

然后这里也建议重启一遍虚拟机

！！！注意，在这一步搞完之后也可以复制一份虚拟机备用，后续可以不用再折腾安装docker浪费时间

四、拉取 Docker 镜像

docker pull docker.m.daocloud.io/library/nginx:latest
docker pull docker.m.daocloud.io/library/mysql:latest

实在拉取不了镜像怎么办呢 把命令里面的docker.m.daocloud.io改成docker.xuanyuan.me或者docker.1ms.run 因为镜像站用的人太多可能也会导致拉不下来

拉取完成后查看镜像：

docker images

五、编写 docker-compose.yml

Docker Compose 的配置文件，用于同时定义和管理多个容器。简单来说，它让你可以用一个文件启动 Nginx 和 MySQL 两个服务，而不需要分别写两条 docker run 命令。

nano docker-compose.yml

填入以下内容：

version: '3'

services:
  nginx:
    image: nginx:latest
    ports:
      - "9110:80"

  mysql:
    image: mysql:latest
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: 123456

保存退出：Ctrl + O → 回车（保存），Ctrl + X（退出）。

🔍 各字段详解

六、一键启动容器

docker compose up -d

以后每次启动只需执行这一条命令。容器名通常为 <当前目录>-mysql-1 和 <当前目录>-nginx-1，可用 docker ps 查看。

七、配置 Nginx

7.1 进入 Nginx 容器

# 先查看容器名
docker ps
# 找到 Nginx 容器的 NAME 列，应该是nle-nginx-1
# 然后用下面的命令进入（把 容器名 替换成实际看到的）
docker exec -it 容器名 /bin/bash

7.2 修改默认网页

echo "Hello Docker" > /usr/share/nginx/html/index.html

7.3 测试访问

浏览器打开 虚拟机IP:9110（例如 http://192.168.103.128:9110），看到修改后的页面即成功。

八、配置 MySQL

8.1 进入 MySQL 容器

docker exec -it <mysql容器名> /bin/bash

8.2 登录 MySQL

mysql -uroot -p

输入密码 123456（docker-compose 中设置的）。

8.3 创建数据库

CREATE DATABASE test;
USE test;

九、客户端连接数据库

推荐使用 DBeaver（免费开源）连接：

Download | DBeaver Community

解决报错：Public Key Retrieval is not allowed

在 DBeaver 中编辑当前 MySQL 连接，切换到驱动属性标签页，修改以下参数：

保存后再次测试连接即可成功。

7.3 搭建 MySQL 服务器（搭建数据服务器）

直接看我之前写的：搭建 MySQL 服务器 - 槿鸢茶屋

7.4 离线部署边缘服务器 （可以暂时不看）

主要是看情况到时候到底怎么办的 这段就先不看了吧

不要看她那个破烂教程了，还要本地安装docker，，，劳神费力，前面本来不是已经装了docker吗，现在再按照她的本地安装的话就得把之前装好的删掉，很麻烦，如果真的要这么搞，，，，，那我没招了 怎么这么烦啊

如果说到时候非要什么本地安装docker的截图，，，那就先照着这个做 这个时候就需要准备我在前面提过的，安装docker之前让复制的虚拟机

去学习通下载好应用部署文件夹里面的边缘服务.rar 打开压缩包，把里面的docker&docker-compose.zip和NLE_EdgeServer.1.1.3.zip都解压成文件夹，然后用mobaxterm给虚拟机传过去

第一步：在Windows上准备文件

在学习通下载的边缘服务.rar，解压后应该包含两个压缩包。这里的关键是解压方式：

1. 解压 边缘服务.rar：用WinRAR或7-Zip解压，得到docker&docker-compose.zip和NLE_EdgeServer.1.1.3.zip。

2. 关键一步：解压这两个zip文件，而不是直接传压缩包。

   • 分别右键解压docker&docker-compose.zip和NLE_EdgeServer.1.1.3.zip，得到两个文件夹。文件夹名大概率就是docker&docker-compose和NLE_EdgeServer.1.1.3。

3. 记住文件位置：记住这两个文件夹在Windows上的路径（比如在桌面或下载文件夹里），下一步要用到。

为什么要解压成文件夹再传？ 因为你的虚拟机上可能没有安装unzip命令。传文件夹可以确保文件直接可用，避免了在虚拟机里解压失败的风险。

📡 第二步：用MobaXterm传输文件夹（关键操作步骤）

你的思路是对的，但新手容易在MobaXterm的操作上疑惑。以下是具体步骤：

1. 打开MobaXterm并连接到虚拟机。

   • 启动MobaXterm，点击顶部工具栏的 Session。
   • 在弹出的窗口中选择 SSH。
   • 在 Remote host 输入你虚拟机的IP地址（比如192.168.103.128）。
   • 勾选 Specify username，输入你的用户名（比如nle）。
   • 点击 OK，然后输入密码登录。

2. 传输文件夹（两种方式均可）：

   • 方法一：直接拖拽（最推荐）

     • 登录后，你会看到MobaXterm的界面分成左右两栏。左侧是你虚拟机的文件浏览器，右侧是虚拟机的ssh终端。
     • 在右侧找到你刚才解压好的两个文件夹（docker&docker-compose和NLE_EdgeServer.1.1.3）。
     • 直接用鼠标左键按住文件夹，拖拽到左侧的虚拟机文件列表区域（比如/home/nle/目录下，最好在这里）。MobaXterm会自动开始传输。

   • 方法二：使用SFTP面板

     • 如果拖拽不习惯，在MobaXterm的侧边栏中，找到并点击 SFTP 标签页（通常在左侧边栏下方）。
     • 这会打开一个专门的文件传输面板。在SFTP面板的本地区域，导航到你的文件夹，右键选择 Upload 上传到虚拟机当前目录。

3. 验证文件是否传输成功： 传输完成后，在MobaXterm的右侧（虚拟机终端）输入：

   ls -l
   

   你应该能看到docker&docker-compose和NLE_EdgeServer.1.1.3这两个文件夹的列表。

第三步：确认文件位置

# 查看 home 目录下的文件
ls /home/nle/
# 应该能看到这两个文件夹：
# docker&docker-compose/  和  NLE_EdgeServer.1.1.3/

🚀 第二部分：安装 Docker CE（安装包在 docker&docker-compose 里）

1. 进入安装包所在路径

cd "docker&docker-compose/docker&docker-compose/"

2. 确认 .deb 文件存在

ls -l *.deb

应该能看到三个 .deb 文件。

3. 按顺序安装三个 deb 包（顺序不能错！）

# ① 先安装 containerd（容器运行时）
sudo dpkg -i containerd.io_1.2.6-3_amd64.deb
# ② 再安装 Docker CLI（命令行工具）
sudo dpkg -i docker-ce-cli_19.03.8_3-0_ubuntu-bionic_amd64.deb
# ③ 最后安装 Docker CE（核心引擎）
sudo dpkg -i docker-ce_19.03.8_3-0_ubuntu-bionic_amd64.deb

⚠️ 注意：如果文件名和上面的不完全一样，以实际文件名为准。输入时可以按 Tab 键自动补全。

4. 查看 Docker 版本

docker -v

看到 Docker version 19.03.8 就说明安装成功。

5. 启动 Docker 服务

sudo systemctl enable docker
sudo systemctl start docker

6. 配置镜像加速器

如果你有老师给的 daemon.json 文件，用 MobaXterm 拖到 /home/nle/ 目录，然后执行：

sudo cp /home/nle/daemon.json /etc/docker/

如果没有这个文件，手动创建一个：

sudo nano /etc/docker/daemon.json

粘贴以下内容：

{
  "registry-mirrors": ["https://docker.m.daocloud.io"]
}

按 Ctrl+O 保存，Ctrl+X 退出。

7. 重启 Docker 使配置生效

sudo systemctl daemon-reload
sudo systemctl restart docker

🐳 第三部分：安装 Docker Compose（文件也在 docker&docker-compose 里）

1. 确认 docker-compose 文件存在

ls -l /home/nle/docker&docker-compose/docker&docker-compose/docker-compose

2. 复制文件到系统路径

sudo cp /home/nle/docker&docker-compose/docker&docker-compose/docker-compose /usr/local/bin/
sudo chmod +x /usr/local/bin/docker-compose

3. 验证安装

docker-compose --version

看到版本号就说明安装成功。

🧩 第四部分：部署 EdgeServer 应用（在 NLE_EdgeServer.1.1.3 里）

1. 进入 EdgeServer 目录

cd /home/nle/NLE_EdgeServer.1.1.3/NLE_EdgeServer/

然后看情况原文档的14 15 16需不需要改

17 启动边缘服务容器

sudo docker-compose up -d

💡 注意：这里用的是 docker-compose（带横杠），因为 7.4 离线安装的 Docker 版本较低（19.03），Compose 是单独安装的旧版二进制文件。而 7.2 中用的 docker compose（不带横杠）是新版 Docker 自带的子命令。两种写法对应不同版本，不要搞混。

然后会这样，不过不影响，继续 按照她的说法改网关和云平台 应该17之后就不用操作了，那么多人都操作没那么多网关，真这么搞那她真神了 到此7.4的离线部署边缘服务器就完事了

7.5 Web 服务构架搭建

十、Tomcat 9 安装配置教程 🐱

Tomcat 是一个 Application Server（应用服务器），主要用于运行 Java Web 应用程序。下面是在 Ubuntu 系统上安装配置 Tomcat 9 的完整步骤。

📥 第一部分：安装 Tomcat 9

1. 更新软件包列表

sudo apt update

这一步会刷新本地的软件包索引，确保能安装到最新版本的软件。

2. 安装 Tomcat 9 和管理界面

sudo apt install tomcat9 tomcat9-admin -y

• tomcat9：Tomcat 核心程序
• tomcat9-admin：Tomcat 的管理界面（用于部署和管理应用）
• -y：自动确认安装，不用手动输入 Y

3. 查看 Tomcat 监听的端口

ss -ltn

Tomcat 默认监听 8080 端口。ss -ltn 命令会列出所有监听的 TCP 端口，你可以看到 :8080 在列表中。

4. 设置 Tomcat 开机自启

sudo systemctl enable tomcat9

这样虚拟机重启后 Tomcat 会自动启动，不用每次手动开启。

5. 开放防火墙 8080 端口

sudo ufw allow from any to any port 8080 proto tcp

6. 启动 Tomcat 服务

sudo systemctl start tomcat9

7. 验证 Tomcat 是否正常运行

sudo systemctl status tomcat9

看到 active (running) 就说明启动成功。

8. 浏览器访问测试

在宿主机的浏览器打开（首选）

http://虚拟机ip:8080

也可以在虚拟机内的浏览器地址栏输入：

http://本机IP:8080

或者

http://127.0.0.1:8080

如果能看到 Tomcat 的默认欢迎页面，说明安装成功了。

⚙️ 第二部分：配置 Tomcat 管理员用户

默认情况下，Tomcat 的管理界面需要用户名和密码才能登录。需要手动配置一个管理员账号。

1. 查看当前配置文件（可选）

sudo cat /etc/tomcat9/tomcat-users.xml

可以先看一下默认配置长什么样。

2. 编辑配置文件

sudo nano /etc/tomcat9/tomcat-users.xml

3. 在最下面修改以下内容： 就是修改我图片框好的这一部分，可以全删了然后粘贴下面那个代码块

  <role rolename="tomcat"/>
  <role rolename="role1"/>
  <role rolename="admin-gui"/>
  <role rolename="manager-gui"/>

  <user username="tomcat" password="tomcat" roles="admin-gui,manager-gui"/>
  <user username="both" password="both123" roles="tomcat,role1"/>
  <user username="role1" password="role1123" roles="role1"/>
</tomcat-users>

添加后的效果大概是这样的：

4. 重启 Tomcat 使配置生效

sudo systemctl restart tomcat9

5. 访问管理界面

在宿主机的浏览器打开（首选）

http://虚拟机ip:8080/manager/html

也可以在虚拟机内的浏览器地址栏输入：

http://本机IP:8080/manager/html

登录账号：

• 用户名：tomcat
• 密码：tomcat

成功登录后，就可以在 Web 界面上传和管理Tomcat了。

🔍 第三部分：查看 Tomcat 版本信息

1. 查找 Tomcat 进程

ps aux | grep tomcat

输出中会显示 Tomcat 的安装路径，例如 /usr/share/tomcat9/。

2. 切换到 Tomcat 的 bin 目录

cd /usr/share/tomcat9/bin

💡 路径说明：用 ps aux | grep tomcat 查到的路径可能不完全一样，也可能是 /usr/lib/tomcat9/bin。以实际输出为准。

3. 执行版本查看脚本

./version.sh

输出中的 Server number 就是 Tomcat 的版本号，例如 9.0.xx。

十一、Nginx 安装配置教程 🌐

下面包含两种安装方式（apt 安装和 Docker 安装），根据考试要求选择对应的方式操作。

Nginx 是一款高性能的 HTTP 和反向代理 Web 服务器，支持高并发和负载均衡，以稳定性、丰富的功能集和低系统资源消耗而闻名。

📦 第一部分：通过 apt 方式安装 Nginx（传统安装）

1. 安装 Nginx

sudo apt update
sudo apt install nginx -y

2. 查看 Nginx 进程

ps -ef | grep nginx

会看到 master process 和 worker process，说明 Nginx 正在运行。

3. 查看 Nginx 服务状态

sudo systemctl status nginx

4. 浏览器访问测试

在浏览器中输入：

http://虚拟机IP

看到 Nginx 默认欢迎页面就说明安装成功。

✏️ 第二部分：自定义 Nginx 默认首页（apt 安装方式）

Nginx 的默认站点根目录是 /var/www/html/。

第一步：将默认首页文件重命名为标准名称

sudo mv /var/www/html/index.nginx-debian.html /var/www/html/index.html

第二步：编辑首页文件

sudo nano /var/www/html/index.html

第三步：粘贴以下 HTML 内容（根据个人信息修改）

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>IOT Server - 考生姓名拼音</title>
    <style>
        body { background: #1a1a2e; color: #eee; text-align: center; padding: 50px; font-family: Arial; }
        h1 { color: #00d4ff; font-size: 36px; }
        .box { background: #16213e; padding: 30px; border-radius: 15px; margin: 20px auto; width: 500px; }
        .info { text-align: left; font-size: 16px; line-height: 1.8; }
        .pass { color: #4CAF50; font-size: 20px; margin-top: 20px; }
    </style>
</head>
<body>
    <div class="box">
        <h1>🌍 Welcome The World of IOT !</h1>
        <h2>🏆 考生姓名拼音 IOT Test 🏆</h2>
        <div class="info">
            <p>📌 姓名：张三<br>
            📌 学号：202402952<br>
            📌 主机名：zhangsan-vm<br>
            📌 IP地址：192.168.103.128<br>
            📌 服务端口：80<br>
            📌 测试时间：2026-06-16</p>
        </div>
        <div class="pass">✅ Nginx 配置成功 | IOT 边缘服务已部署</div>
    </div>
</body>
</html>

⚠️ 需要修改的内容：

• 姓名
• 学号
• 主机名（用 hostname 命令查看）
• IP地址（用 ip a 命令查看）
• 测试时间

第四步：保存退出

• Ctrl+O → 回车（保存）
• Ctrl+X（退出）

第五步：刷新浏览器验证 修改完成后刷新浏览器页面即可看到变化，无需重启 Nginx。

🐳 第三部分：Docker 安装与 Nginx 部署

本部分将带你从零开始安装 Docker，然后通过 Docker 部署一个 Nginx 容器，并暴露端口供外部访问。

1. 安装 Docker

使用轩辕镜像提供的一键安装脚本：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

如果上面的命令没反应，可以分步执行：

wget https://xuanyuan.cloud/docker.sh -O docker-install.sh
chmod 777 docker-install.sh
bash docker-install.sh

执行后会看到如下交互界面：

root@074b1042fc62:/# bash <(wget -qO- https://xuanyuan.cloud/docker.sh)
⚠️  未检测到 sudo 命令，将直接使用 root 权限执行命令
==========================================
🐳 欢迎使用轩辕镜像 Docker 一键安装配置脚本
==========================================
官方网站: https://xuanyuan.cloud/

请选择操作模式：
1) 一键安装配置（推荐）
2) 修改轩辕镜像专属域名
3) 恢复 Docker 镜像相关配置

请输入选择 [1/2/3]: 1

>>> 模式：一键安装配置

输入 1 然后回车，等待脚本自动完成安装。

安装过程中可能会出现提示：

是否继续将 xxx 添加到 docker 组？[Y/n]

这里输入 y 并回车。添加后，以后执行 Docker 命令就不需要每次都加 sudo 了。

2. 验证 Docker 安装

docker --version

如果正常显示版本号（如 Docker version 24.x.x），说明安装成功。

3. 重启虚拟机（建议）

安装完 Docker 后，建议重启一次虚拟机以确保所有配置生效：

sudo reboot

重启后重新登录，继续后续操作。

4. 拉取 Nginx 镜像

docker pull docker.m.daocloud.io/library/nginx:latest

⚠️ 如果拉取失败：把命令中的 docker.m.daocloud.io 换成 docker.xuanyuan.me 或 docker.1ms.run（镜像站用的人太多可能会限流）。

拉取完成后查看镜像确认：

docker images

应该能看到 nginx 镜像出现在列表中。

5. 运行 Nginx 容器

# 运行 Nginx 容器，映射宿主机 9110 端口到容器 80 端口
docker run -d -p 9110:80 --name nle-nginx-1 nginx:latest

参数说明：

💡 端口说明：如果 9110 端口被占用，可以改成其他端口，如 8080、8888 等，相应地访问时也使用对应的端口号。

6. 验证容器是否正常运行

# 查看运行中的容器
docker ps

如果看到 nle-nginx-1 的状态是 Up，说明启动成功。

测试访问： 在浏览器中输入 http://你的服务器IP:9110，如果看到 Nginx 欢迎页面，就说明一切正常 🎉

✏️ 第四部分：自定义 Nginx 首页（Docker 方式）

1. 在宿主机创建 HTML 文件

在宿主机创建一个 HTML 文件，比如 /home/nle/mypage.html：

nano /home/nle/mypage.html

内容如下（根据个人信息修改）：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>IOT Server - 考生姓名拼音</title>
    <style>
        body { background: #1a1a2e; color: #eee; text-align: center; padding: 50px; font-family: Arial; }
        h1 { color: #00d4ff; font-size: 36px; }
        .box { background: #16213e; padding: 30px; border-radius: 15px; margin: 20px auto; width: 500px; }
        .info { text-align: left; font-size: 16px; line-height: 1.8; }
        .pass { color: #4CAF50; font-size: 20px; margin-top: 20px; }
    </style>
</head>
<body>
    <div class="box">
        <h1>🌍 Welcome The World of IOT !</h1>
        <h2>🏆 考生姓名拼音 IOT Test 🏆</h2>
        <div class="info">
            <p>📌 姓名：张三<br>
            📌 学号：202402952<br>
            📌 主机名：zhangsan-vm<br>
            📌 IP地址：192.168.103.128<br>
            📌 服务端口：9110<br>
            📌 容器名称：nle-nginx-1<br>
            📌 测试时间：2026-06-16</p>
        </div>
        <div class="pass">✅ Nginx 配置成功 | Docker 运行正常 | IOT 边缘服务已部署</div>
    </div>
</body>
</html>

⚠️ 需要修改的内容：

• 姓名
• 学号
• 主机名
• IP地址（改为虚拟机的实际 IP）
• 服务端口（改为实际映射的端口）
• 测试时间

2. 将 HTML 文件复制到容器内

docker cp /home/nle/mypage.html nle-nginx-1:/usr/share/nginx/html/index.html

3. 验证文件是否复制成功

docker exec nle-nginx-1 cat /usr/share/nginx/html/index.html | head -5

能看到 HTML 文件的前 5 行就说明复制成功了。 4. 宿主机浏览器访问

在这之前先重启一下容器,防止网页虽然改了但是没反应

docker restart nle-nginx-1

在宿主机或虚拟机浏览器的地址栏输入：

http://虚拟机IP:9110

例如：

http://192.168.103.128:9110

🔧 第五部分：常用管理命令

Nginx 服务管理（apt 安装方式）

# 启动 Nginx
sudo systemctl start nginx

# 停止 Nginx
sudo systemctl stop nginx

# 重启 Nginx
sudo systemctl restart nginx

# 重新加载配置（不中断服务）
sudo systemctl reload nginx

# 查看 Nginx 状态
sudo systemctl status nginx

Docker 容器管理（Docker 安装方式）

# 查看容器
docker ps

# 停止容器
docker stop nle-nginx-1

# 启动容器
docker start nle-nginx-1

# 重启容器
docker restart nle-nginx-1

# 删除容器
docker rm -f nle-nginx-1

到此就结束了，希望大家都能考试顺利

设备配置通用套路

配置设备基本上都要单独设置电脑的ip，比如网关可以设置ip 192.168.1.10，子网掩码 255.255.255.0，默认网关 192.168.1.1，dns可以顺手也设置 192.168.1.1，主要是同网段。

各设备基本信息

路由器：192.168.0.1，不需要登录，要密码就是 12345678，重置按复位键15秒。备注说要配静态IP，这个应该是要手动改IP的。

PC机：密码 a12345678，没别的特殊配置。

物联网网关：192.168.1.100，用户名密码都是 newland。重置方法比较特殊，要短接DIO和GND。首用需要鉴权，这个要注意。

串口服务器：192.168.14.200，用户名 root，密码两个可能 002396 或 000997。端口 8400。重置按RST键15到20秒。

无线采集器4012：192.168.1.1，密码8个0。端口 502。重置要拨码开关。

4012配置流程

插上无线网卡

1. 把拨码开关P1拨到off，重新上电，进入初始配置模式
2. 电脑连上设备的热点 WISE-4012E_xxxxx
3. 浏览器打开 192.168.1.1，用户名 root，密码8个0
4. 进 Configuration - Wireless：
   • WLAN Mode选 Infrastructure Mode
   • SSID填你要连的WiFi名字
   • Security Type选 WPA/WPA2
   • Security Key填WiFi密码
5. IP设置：
   • IP Mode选 Static
   • IP填你要分配的地址，比如 192.168.2.6
   • 子网掩码 255.255.255.0
   • 网关填路由器地址，比如 192.168.2.1
6. 点Submit保存
7. 把拨码开关P1拨回on，再重新上电设备重启生效

Zigbee配置流程

Zigbee是无线通信模块，要保证通道和网络ID一致才能通信。

简单说就是：

1. 打开桌面上的 ZigBeeConfigTool
2. 打开软件，选串口号，点打开串口
3. 设备类型选 Coordinator 或 Router
4. PAN ID和通道两边要设成一样的，比如PAN ID都填 C002，通道 1x（x是你的工位）
5. 设备ID协调器填 0000，路由器填 0001
6. 点设置保存

传感器地址汇总

温湿度传感器地址（01）、光照传感器地址（02）、CO2传感器地址（03）、RGB控制器地址（04）。ADAM4150地址为1(hex)

一、局域网配置

截图1：路由器配置

先重置路由器

1. 打开浏览器，输入 192.168.0.1
2. 输入路由器账号密码登录
3. 找到 LAN口设置 或 网络参数 → LAN口设置
4. 确认/修改IP地址为 192.168.X.1（X为你的工位号，如第8组就是192.168.8.1）
5. 截图保存为 截图1

截图2：PC机配置

1. 按 Win + R，输入 ncpa.cpl，回车（就是打开网络适配器）
2. 右键 以太网 → 属性
3. 双击 Internet协议版本4 (TCP/IPv4)
4. 选择 使用下面的IP地址
5. 配置：
   • IP地址：192.168.X.2
   • 子网掩码：255.255.255.0
   • 默认网关：192.168.X.1
6. 截图保存为 截图2

截图3：物联网中心网关配置

先重置，手动改好ip设置

1. 浏览器输入 192.168.1.100（打不开就直连网线）
2. 登录网关配置页面
3. 找到 网络设置 或 网关信息
4. 修改IP为 192.168.X.3
5. 截图保存为 截图3

截图4：串口服务器配置

先重置，手动改好ip设置

1. 浏览器输入 192.168.14.200:8400
2. 登录串口服务器（NEWPorter）
3. 进入 Network Configuration 页面
4. 修改IP为 192.168.X.4
5. 截图保存为 截图4

截图5：4012配置截图

1. 把拨码开关P1拨到off，重新上电
2. 电脑连上设备的热点 WISE-4012E_xxxxx
3. 浏览器打开 192.168.1.1，用户名 root，密码8个0
4. 进 Configuration - Wireless：
   • WLAN Mode选 Infrastructure Mode
   • SSID填你要连的WiFi名字（比如八号工位WiFi名字就是"第八组"）
   • Security Type选 WPA/WPA2
   • Security Key填WiFi密码
5. 确认IP为 192.168.X.5
6. 截图保存为 截图5

二、连接器配置

截图6：物联网网关连接器配置截图

进入网关配置页面：

1. 浏览器输入 192.168.X.3（物联网网关地址）
2. 登录后点击 连接器 菜单

截图6.1：光照变送器配置

1. 点击左侧 light 连接器
2. 确认配置：
   • 连接器名称：light
   • 连接器设备类型：Modbus over Serial
   • 设备接入方式：串口接入
   • 波特率：9600
   • 串口名称：/dev/ttySUSB4（一定要看看实际USB串口）
3. 展开下方 光照 设备配置：
   • 设备名称：light
   • 设备类型：光照度传感器（485型）
   • 设备地址：2
4. 截图保存为 截图6.1

截图6.2：RGB控制器配置

1. 点击左侧 RGB 连接器
2. 确认配置：
   • 连接器名称：RGB
   • 连接器设备类型：NLE SERIAL-BUS
   • 设备接入方式：串口接入
   • 波特率：9600
   • 串口名称：/dev/ttyS3
3. 点增按钮
4. 填写设备信息：
   • 设备名称：RGBLight
   • 设备类型：选 RGB控制盒
   • 设备地址：填 4（就是你之前改的那个地址）
   • 标识名称：RGBLight
   • 传感类型：选 RGB灯带
5. 点确定保存
6. 截图保存为 截图6.2

截图6.3：串口服务器-ADAM4150配置

1. 点击左侧 4150 连接器
2. 确认配置：
   • 连接器名称：4150
   • 连接器设备类型：Modbus over Serial
   • 设备接入方式：串口服务器接入
   • 串口服务器IP：192.168.X.4（串口服务器地址）
   • 串口服务器端口：6005
3. 展开下方设备配置：
   • weidong（微动开关）：传感器类型 微动开关，通道号 DI0
   • diandong（电动推杆）：传感器类型 电动推杆，前进 DO0，后退 DO1
4. 截图保存为 截图6.3

截图6.4：串口服务器-Zigbee配置

1. 点击左侧 zigbee 连接器
2. 确认配置：
   • 连接器名称：zigbee
   • 连接器设备类型：Modbus over Serial
   • 设备接入方式：串口服务器接入
   • 串口服务器IP：192.168.X.4
   • 串口服务器端口：6006
3. 展开下方设备配置：
   • co2（二氧化碳传感器）：设备类型 二氧化碳传感器（485型），设备地址 3
4. 截图保存为 截图6.4

截图6.5：4012E配置

1. 点击左侧 4012 连接器
2. 确认配置：
   • 网络设备连接器名称：4012
   • 网络设备连接器类型：Modbus over TCP
   • Modbus类型：Modbus over TCP
3. 展开下方设备配置：
   • wd（温度）：传感器类型 温度，通道号 V0
   • sd（湿度）：传感器类型 湿度，通道号 V1
   • fs（风扇）：传感器类型 风扇，通道号 DO0

碎碎念：八号工位的温湿度可能会抽风emmm，实在没数据就用海克斯科技吧（把4012电拔了，然后f12改数据（懂你意思））

1. 截图保存为 截图6.5

截图7：网关数据监控截图

进入数据监控页面： 在网关配置页面点击左侧 数据监控 菜单

截图7.1：光照变送器监控

1. 找到 light 连接器下的 light 设备
2. 确认显示当前光照值（如 357 Lux）
3. 截图保存为 截图7.1

截图7.2：RGB控制器监控

1. 找到 RGB 连接器
2. 改个颜色然后截图
3. 截图保存为 截图7.2

截图7.3：串口服务器-ADAM4150监控

1. 找到 4150 连接器下的 diandong 和 weidong
2. 确认显示当前状态
3. 截图保存为 截图7.3

截图7.4：串口服务器-Zigbee监控

1. 找到 zigbee 连接器下的 co2 设备
2. 确认显示当前CO2值（如 895 ppm）
3. 截图保存为 截图7.4

截图7.5：4012E监控

1. 找到 4012 连接器下的 wd、sd、fs
2. 确认显示：
   • 温度（如 30.7 ℃）
   • 湿度（如 45.7 %）
   • 风扇状态（如 运行中/停止）
3. 截图保存为 截图7.5

三、串口服务器配置

截图8：NEWPorter的端口配置

进入串口服务器：

1. 浏览器输入 192.168.X.4
2. 登录NEWPorter串口服务器

截图8.1：COM5口配置（Adam4150）

1. 进入 串口设置 或 端口配置
2. 选择 COM5
3. 修改波特率为 9600
4. 数据位：8，停止位：1，校验：None
5. 截图保存为 截图8.1

截图8.2：COM6口配置（Zigbee）

1. 选择 COM6
2. 修改波特率为 9600
3. 数据位：8，停止位：1，校验：None
4. 截图保存为 截图8.2

四、采集器配置

这里先打开初级文件夹，里面有串口线的驱动，得先安装，忘记名字了，反正是什么cp210还是啥来着相信你找得到

这里每配置一个设备都要接好串口线哦

截图9：ADAM4150配置

1. 打开 ADAMNET 工具（在桌面上的中级文件夹来着，里面有个研华采集模块什么的）
2. 点击 搜索 或 Scan，找到ADAM4150设备
3. 双击设备进入配置：
   • 地址（Address）：设置为 1（hex）
   • 协议（Protocol）：选择 Modbus
   • 波特率（Baud Rate）：设置为 9600
4. 点击 Apply 或 设置 保存
5. 截图保存为 截图9

五、RS485型传感器调试

这里每配置一个设备都要接好串口线哦

截图10：温湿度传感器调试

串口助手设置：

打开串口助手（在桌面初级文件里面）后先设置好：

• 串口号选对
• 波特率 9600，数据位 8，停止位 1，校验 None
• 发送和接收都要是hex
• 勾选自动发送校验位，算法选 CRC16 Modbus

这样你发送数据的时候串口助手会自动把CRC校验码拼在后面

查不到数据就用下面的那个温湿度变送器试试

一、读取温湿度数据

发送指令

[设备地址] 03 00 00 00 02

说明：

• FE：广播地址（不知道设备地址时用）
• 03：功能码（读保持寄存器）
• 00 00：起始地址
• 00 02：读取2个寄存器（温度+湿度）
• CRC校验：串口助手会自动添加

接收数据格式

[地址] 03 04 [湿度高] [湿度低] [温度高] [温度低] [CRC低] [CRC高]

示例： 02 03 04 01 92 00 D1 A9 7E

数据解析

1. 湿度：01 92 → 十六进制0x0192 → 十进制402 → 乘以0.1 → 40.2%RH
2. 温度：00 D1 → 十六进制0x00D1 → 十进制209 → 乘以0.1 → 20.9°C
3. 负温度：若温度值 > 32767（如FF 9B），则用补码计算：
   • FF9B → 十进制65435 → 65435 - 65536 = -101 → 乘以0.1 → -10.1°C

二、修改设备地址

1. 打开"温湿度上位机"软件
2. 进入"通信设置"
3. 将地址修改为考核要求的 1
4. 保存设置

截图11：光照传感器调试

1. 串口助手保持连接
2. 发送查询指令查看当前地址：FE 03 00 00 00 02
3. 发送修改指令将地址改为 02：旧地址 06 00 00 00 02
4. 发送查询指令查看修改后地址：FE 03 00 00 00 02
5. 截图保存为 截图11

截图12：CO2传感器调试

1. 串口助手保持连接
2. 发送查询指令查看当前地址：FE 03 00 00 00 01
3. 发送修改指令将地址改为 03：旧地址 06 00 00 00 03
4. 发送查询指令查看修改后地址：FE 03 00 00 00 01
5. 截图保存为 截图12

截图13：RGB控制器调试

1. 串口助手保持连接
2. 查询当前地址（这个时候就要把自动发送校验位关掉注意）：
   • 发送：A5 03 FF B1 B3 5A
3. 设置地址为04：
   • 格式：A5 04 旧地址 B0 新地址 校验和 5A
   • 校验和怎么算：串口助手左上角，工具，有个校验计算打开，选 checksum8，然后输入 04 旧地址 B0 新地址，算出来的数据就是校验位，填进去就行
4. 发送查询指令验证：A5 03 FF B1 B3 5A
5. 截图保存为 截图13

截图14：RGB灯条设置效果

1. 串口助手保持连接
2. 绿灯呼吸效果：发送指令 A5 06 FF A1 01 02 10 EE 5A
3. 红灯呼吸效果：发送指令 A5 06 FF A1 01 01 10 EE 5A
4. 截图保存为 截图14

六、Zigbee配置

截图15：Zigbee模块配置

截图15.1：Zigbee协调器配置

1. 打开 ZigBeeConfigTool
2. 选串口号，点打开串口
3. 设备类型选 Coordinator
4. PAN ID填 C00X，通道填 1x（x是你的工位）
5. 设备ID填 0000
6. 点设置保存
7. 截图保存为 截图15.1

截图15.2：Zigbee路由器配置

1. 设备类型选 Router
2. PAN ID填 C00X，通道填 1x（和协调器一样）
3. 设备ID填 0001
4. 点设置保存
5. 截图保存为 截图15.2

七、云平台配置

在这里先确认，进入网关，有个设置连接方式，编辑一下 cloudclient：

• IP：ndp.nlecloud.com
• 端口：8600

截图16：云平台网关状态配置截图

一、云平台添加设备

1. 登录新大陆物联网云平台 nlecloud.com，进入开发者中心
2. 点新增项目，填写信息：
   • 联网方案：WiFi
   • 点确定
3. 进入项目详情页，点添加设备
4. 填写设备信息：
   • 设备名称：边缘网关
   • 通讯协议：TCP
   • 设备标识码：进入网关，有个设置连接方式 cloudclient，编辑，里面有设备id
   • 注意：如果说设备被占用，就去进入网关，设置连接方式，把 cloudclient 停止，添加即可
   • 数据保密性选 公开
   • 数据上报状态选 马上启用
   • 点确定添加

二、网关连接云平台

1. 浏览器打开网关管理页面
2. 左边导航栏点配置，选设置连接方式
3. 填写TCP连接参数：
   • 云平台IP：ndp.nlecloud.com
   • 端口：8600
   • 点确定
4. 回到云平台点数据流获取，确认网关状态是运行中
5. 截图保存为 截图16

截图17：云平台当前采集数据值截图

1. 进入云平台 - 开发者中心 - 项目名称 - 设备管理 - 设备传感器
2. 先点下发设备，然后点数据流获取，再点下发设备右边的箭头，把里面的实时数据开关打开
3. 查看当前采集的数据：温度、湿度、光照、CO2、RGB、风扇状态、电动推杆状态、微动开关状态
4. 截图保存为 截图17

截图18：云平台控制执行状态截图

1. 就在当前页面
2. 操作：
   • 控制RGB灯条，输入 124,252,0,1 控制灯条颜色为绿色
   • 按下微动开关（或模拟触发）
   • 打开电动推杆
3. 确认状态显示正确
4. 截图保存为 截图18

截图19：云平台策略控制启用截图

1. 进入 策略管理 页面
2. 创建策略1：
   • 条件：光照值 ≤ 200
   • 动作：开启RGB
3. 创建策略2：
   • 条件：光照值 > 200
   • 动作：关闭RGB
4. 创建策略3：
   • 条件：CO2 ≤ 300
   • 动作：风扇关闭（风扇=0）
5. 创建策略4：
   • 条件：CO2 > 300
   • 动作：风扇开启（风扇=1）
6. 确认策略状态为 启用
7. 截图保存为 截图19

截图20：项目生成器设计效果截图

1. 进入 项目生成器 或 可视化设计 页面
2. 新建项目，配置：

① 背景色设置

• 页面背景色：rgba(125, 122, 129, 1)

② 日期时间控件

• 拖入 时间显示 控件
• 格式：显示日期、时间、PM/AM
• 字号：24
• 字体颜色：rgba(51, 51, 51, 1)
• 加粗、斜体

③ 地图控件

• 拖入 地图 控件
• 设置显示当前位置

④ 数据展示控件

• 拖入以下控件并绑定数据源：
  • 光照传感器
  • CO2传感器
  • RGB控制器
  • 温度
  • 湿度
  • 风扇
  • 电动推杆
  • 微动开关

⑤ 折线图

• 拖入 折线图 控件
• 数据源：光照传感器、CO2传感器
• 统计范围：考试前一天至考试后一天（如6月15日考试，则范围为6月14日-6月16日）
• 标题：物联网应用系统
• 标题字号：18

1. 点击 发布
2. 截图保存为 截图20

附录

截图命名汇总

设备IP分配表

RGB控制器指令参考

地址查询指令

地址设置指令

灯条控制指令

云平台策略控制要求

项目生成器设计要求

最后更新：2026-06-12

sudo apt install mysql-server

二、查看 MySQL 服务状态

apt policy mysql-server
systemctl status mysql

如果有报错，可能是之前用 Docker 部署过 MySQL，关掉容器即可：

# 查看所有容器
docker ps -a

# 找到 MySQL 容器的名字，停止它
docker stop <容器名字>

# 启动 MySQL
systemctl start mysql

# 再次查看状态
systemctl status mysql

三、登录 MySQL 并修改 root 密码

sudo mysql

进入后修改 root 的密码认证方式。改之前直接用 mysql -uroot -p 是登不进去的：

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
FLUSH PRIVILEGES;

改完之后就能用密码登录了：

mysql -uroot -p

四、允许 root 用户远程登录

use mysql;
update user set host='%' where user='root';
FLUSH PRIVILEGES;

这样 root 用户就能从任何 IP 连接了。

五、配置远程连接

修改 MySQL 配置文件，bind-address 不能是 127.0.0.1：

sudo vi /etc/mysql/mysql.conf.d/mysqld.cnf

• 找到 bind-address 那行，改成 0.0.0.0
• 如果有 mysqlx-bind-address，也改成 0.0.0.0

改完保存，重启 MySQL：

sudo systemctl restart mysql

六、防火墙开放 3306 端口

sudo ufw allow 3306/tcp
sudo ufw reload

七、用 DBeaver 连接数据库

DBeaver 是一款免费开源的通用数据库管理工具，支持 MySQL、PostgreSQL、Oracle 等多种数据库，界面友好，适合新手使用。

7.1 下载安装 DBeaver

1. 下载 DBeaver

打开浏览器，访问 DBeaver 官网下载页面：

👉 https://dbeaver.io/download/

💡 如果不确定选哪个，Windows 用户直接下载 Community 版本的 .exe 安装包即可，它是免费的。

2. 安装 DBeaver

• Windows：双击下载好的 .exe 文件，按照安装向导提示一路点 Next（下一步）即可完成安装。

安装完成后，在桌面或开始菜单中找到 DBeaver 图标，双击启动。

7.2 创建 MySQL 连接

1. 启动 DBeaver

打开 DBeaver，首次启动可能会弹出“是否创建示例数据库”的提示，直接点击 Cancel 或 No 跳过即可。

2. 新建连接

• 点击左上角的 新建连接 图标（一个带加号的数据库图标 📁+），或者依次点击菜单栏 数据库 → 新建连接。

• 在弹出的窗口中，选择 MySQL，然后点击 Next（下一步）。

3. 填写连接参数

在 主要 标签页中，填写以下信息：

⚠️ 注意：Host 不要填 localhost 或 127.0.0.1，因为 DBeaver 是运行在宿主机上的，要填虚拟机的 IP 地址。

填写完成后，可以点击 测试连接 按钮，检查参数是否正确。

7.3 解决连接报错（关键步骤）

如果点击 测试连接 后出现如下报错：

Public Key Retrieval is not allowed

这是 MySQL 8.0 的一个安全机制，解决方法如下：

1. 在同一个连接配置窗口中，切换到 驱动属性 标签页。

2. 修改以下两个参数：

💡 提示：如果参数列表里没有这两个选项，可以直接在下方的 属性名 输入框中手动输入，然后填写对应的值。

3. 再次点击测试连接

此时应该能看到 连接已成功 的提示。

7.4 保存连接并开始使用

1. 点击 完成 保存连接配置。

2. 在 DBeaver 左侧的 数据库导航 面板中，会出现你刚创建的 MySQL 连接。

3. 双击连接名称（或点击连接名称左侧的 ▶ 展开箭头），DBeaver 会连接到数据库并显示其中的数据库列表。

4. 右键点击连接名称 → 新建 SQL 编辑器 → 新建 SQL 编辑器，就可以执行 SQL 语句了。

然后输入以下命令：

show databases;
create database test;
use test;
create table test(nid int, nname varchar(10));
insert into test values(1, 'zhangsan'), (2, 'lisi');
select * from test;

然后点执行按钮运行 SQL 脚本（左边从上到下第三个图标执行sql脚本），看到查询结果即搭建成功。

按照课件 PDF 导入虚拟机后，使用 NAT + Host-Only 双网卡模式配置网络。

1.1 配置宿主机 Host-Only 网卡

打开 VirtualBox → 管理 → 主机网络管理器：

• 点击创建（或选中已有的 Host-Only 网络）
• 勾选手动配置网卡，填写：
  • IPv4 地址：192.168.103.11（宿主机在此局域网的 IP）
  • 子网掩码：255.255.255.0
• DHCP 服务器选项卡 → 关闭 DHCP
• 点击应用

1.2 给虚拟机分配两块网卡

关闭虚拟机，进入 设置 → 网络：

1.3 虚拟机内配置静态 IP

编辑 /etc/network/interfaces：

sudo nano /etc/network/interfaces

写入以下内容：

auto lo
iface lo inet loopback

# NAT 网卡 - 上外网
auto enp0s3
iface enp0s3 inet dhcp

# Host-Only 网卡 - 与宿主机通信（不写 gateway！）
auto enp0s8
iface enp0s8 inet static
    address 192.168.103.128
    netmask 255.255.255.0

应用配置：

sudo ifdown enp0s8 && sudo ifup enp0s8

或者直接重启虚拟机。

1.4 验证网络连通性

# 虚拟机内测外网
ping -c 3 8.8.8.8

# 虚拟机 ping 宿主机
ping 192.168.103.11

# 宿主机 PowerShell ping 虚拟机
ping 192.168.103.128

# SSH 进虚拟机
ssh nle@192.168.103.128

如果 ifconfig 不可用，先安装工具：

sudo apt install net-tools

二、更换镜像源并更新系统

2.1 更换 apt 镜像源

sudo nano /etc/apt/sources.list

按 Ctrl + \ 全局替换，将 archives.ubuntu.com 替换为 mirrors.bfsu.edu.cn（北外镜像源）。

2.2 更新系统

sudo apt update
sudo apt upgrade

完成后重启虚拟机。

三、安装 Docker

使用轩辕镜像的一键安装脚本：

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

安装完成后验证：

docker --version

四、拉取 Docker 镜像

docker pull nginx:latest
docker pull mysql:latest

拉取完成后查看镜像：

docker images

五、清理旧容器（可选）

如果之前运行过同名容器，先删掉避免冲突：

docker ps -a              # 查看所有容器
docker rm mysql-test      # 删除旧的 mysql 容器
docker rm nginx-test      # 删除旧的 nginx 容器

六、编写 docker-compose.yml

nano docker-compose.yml

填入以下内容：

version: '3'
services:
  nginx:
    image: nginx:latest
    ports:
      - "9110:80"
  mysql:
    image: mysql:latest
    ports:
      - "3306:3306"
    environment:
      MYSQL_ROOT_PASSWORD: 123456

保存退出：Ctrl + O → 回车（保存），Ctrl + X（退出）。

七、一键启动容器

docker compose up -d

以后每次启动只需执行这一条命令。容器名通常为 <当前目录>-mysql-1 和 <当前目录>-nginx-1，可用 docker ps 查看。

八、配置 Nginx

8.1 进入 Nginx 容器

docker exec -it <nginx容器名> /bin/bash

8.2 修改默认网页

echo "Hello Docker" > /usr/share/nginx/html/index.html

8.3 测试访问

浏览器打开 虚拟机IP:9110（例如 http://192.168.103.128:9110），看到修改后的页面即成功。

九、配置 MySQL

9.1 进入 MySQL 容器

docker exec -it <mysql容器名> /bin/bash

9.2 登录 MySQL

mysql -uroot -p

输入密码 123456（docker-compose 中设置的）。

9.3 创建数据库

CREATE DATABASE test;
USE test;

十、客户端连接数据库

推荐使用 DBeaver（免费开源）连接：

解决报错：Public Key Retrieval is not allowed

在 DBeaver 中编辑当前 MySQL 连接，切换到驱动属性标签页，修改以下参数：

保存后再次测试连接即可成功。

原本以为这次折腾在了解了不懂的知识之后会容易一些,结果一折腾就花了好多时间,期间遇到各种问题,最终才把整个拓扑和配置理顺。这里把最终的配置笔记整理出来,方便参考😭。

刚开始把拓扑图做出来拿去喂AI,然后它让我把聚合接口弄成三层口,结果折腾了好久,就是卡在PC能ping通VLAN网关,但跨VLAN不通。后来才发现是AI给的建议不对,聚合口必须是二层Trunk口才能透传VLAN。后来又遇到各种问题,下面总结一下常见问题和解决方法,方便参考。都是血的教训,我熬到半夜两点都想不通为什么,得亏第二天我问朋友和老师都说应该把聚合口也弄成Trunk模式😭😭😭。

需要了解的核心知识点

1. VLAN与交换机基础

• VLAN划分:不同PC划归不同VLAN,提升安全性、隔离广播域
• 二层交换机端口分配与Trunk口配置
• VLAN SVI(Switch Virtual Interface)技术,实现三层网关

2. 多层交换与主干聚合

• 三层交换机的ip routing启用,以及三层接口、SVI网关分配
• 主干链路聚合(EtherChannel/LACP),实现高可用、多链路带宽叠加
• 聚合组成员口参数一致性配置

3. Trunk链路/VLAN透传

• Trunk接口dot1q封装
• 多VLAN允许与active在Trunk接口的配置
• 接入交换机与汇聚交换机Trunk连接

4. OSPF动态路由

• OSPF区域零配置
• 多交换机/路由器动态互联与路由自动学习
• OSPF邻居关系、路由表收敛

5. 静态路由

• R0、R1之间静态路由互通
• 边界和核心路由器回程、缺省路由设置

6. 全网三层互通与跨VLAN路由

• VLAN间路由和主干园区数据跨VLAN流通实验
• 交换/路由混合环境下端到端包转发和路径管理

常见问题与解决方法

1. Trunk口/VLAN未active导致跨VLAN不通

问题现象: Trunk口允许VLAN10/20,但另一端交换机没创建VLAN10,导致Port-channel和Trunk口未active对应VLAN,流量首跳丢包。

解决方法:

• 两端都必须创建并激活所有要透传的VLAN
• 一步步用 show interfaces trunk 查VLAN active状态

2. 主干聚合端口(Port-channel)down/down或suspended

问题现象: Port-channel始终down,或口组"参数不兼容"报错。

主要原因: 聚合成员口和Port-channel属性不一致,有no switchport或access/trunk混用遗留。

解决方法:

• 用 default interface 清空所有Port-channel及成员口,重新统一配置
• 聚合成员口与Port-channel全部参数(Trunk、allowed VLAN、封装)必须一致

3. VLAN网关、PC地址/掩码/网关配置错误

问题现象: PC能ping通本地网关,但不能跨VLAN互通。

常见原因: PC网关 or 子网掩码填错。

解决方法: 查PC设置,确保网关是正确VLAN SVI地址,子网掩码标准。

4. OSPF中发布了没有IP的主干聚合网段

问题现象: OSPF发布了Port-channel的网段,但Port-channel已无IP,引起OSPF收敛警告/冗余。

解决方法: 删除无IP接口的network声明,只发布实际IP三层口。

5. Packet Tracer收敛/ARP/MAC表未及时刷新

问题现象: 明明配置都对,但包还是不通。

解决方法: 多次Fast Forward/重启模拟器,清空ARP和MAC表,等仿真器收敛。

6. 聚合组L2/L3属性不匹配,命令拒绝

问题现象: channel-group操作报"L2与L3不一致"。

解决方法: 用 default interface port-channel 1 和 default interface fa0/x 把所有成员口属性清空,再一步步重新配置为Trunk、channel-group。

7. OSPF邻居关系/路由收敛问题

问题现象: OSPF邻居不FULL或路由表不互通。

解决方法: 检查是否只发布有IP接口网段,确保接口up/up、OSPF Router ID无冲突。

拓扑结构概览

<img src="https://img.103028.xyz/blog/net1/tuopu.png" alt="拓扑图" />

        +--------+          +--------+
        |   S1   |----------|   S2   |
        |(三层汇聚)|          |(三层汇聚)|
        +--------+          +--------+
           |  |                 |  |
          Fa0/2 Fa0/4         Fa0/2 Fa0/4
           |  |                 |  |
        +--------+          +--------+
        |   S3   |          |   S4   |
        |(接入交换)|          |(接入交换)|
        +--------+          +--------+
         |  |  |             |  |  |
       PC1 PC2 PC3        PC4 PC5 PC6
       
       S1 Fa0/1 <--> R0 Gi0/0
       S2 Fa0/1 <--> R0 Gi0/1
       
       R0 Se0/1/0 <--> R1 Se0/1/0
       R1 Gi0/0 (外网)

需要的设备

• 2台三层交换机(S1、S2)可以用3560或3750
• 2台二层交换机(S3、S4)
• 2台路由器(R0、R1)
• 多台PC(PC1-PC6,外网PC0)

VLAN划分

• VLAN10: PC1-PC3
• VLAN20: PC4-PC6

IP地址分配

VLAN10网段

• S1 Vlan10网关:192.168.1.1
• PC1:192.168.1.10
• PC2:192.168.1.11
• PC3:192.168.1.12

VLAN20网段

• S2 Vlan20网关:192.168.2.1
• PC4:192.168.2.10
• PC5:192.168.2.11
• PC6:192.168.2.12

S1-S2互联网段

• S1 Fa0/1:192.168.6.1
• S2 Fa0/1:192.168.7.1
• R0 Gi0/0:192.168.6.2
• R0 Gi0/1:192.168.7.2

R0-R1串口网段

• R0 Se0/1/0:192.168.8.1
• R1 Se0/1/0:192.168.8.2

R1 Gi0/0(外网)

• R1 Gi0/0:192.168.9.1
• 外网PC0:192.168.9.2

各设备配置代码

S1(三层汇聚/分布交换机)

功能:

• 启用三层交换
• 主干聚合/下联Trunk配置
• VLAN10网关
• OSPF只发布互联、VLAN10网段

ip routing                                      ! 启用三层路由功能

interface Port-channel1                         ! 配置聚合接口
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式

interface FastEthernet0/1                       ! 配置上联到R0的三层口
 no switchport                                  ! 关闭二层功能,变为三层路由口
 ip address 192.168.6.1 255.255.255.252        ! 配置IP地址

interface range FastEthernet0/2, FastEthernet0/4  ! 批量配置Fa0/2和Fa0/4
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式
 channel-group 1 mode active                    ! 加入聚合组1,LACP主动模式

interface FastEthernet0/3                       ! 配置下联到S3的Trunk口
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式

interface Vlan10                                ! 配置VLAN10的SVI网关
 ip address 192.168.1.1 255.255.255.0          ! VLAN10网关IP

router ospf 1                                   ! 启用OSPF进程1
 log-adjacency-changes                          ! 记录邻居状态变化
 network 192.168.6.0 0.0.0.3 area 0            ! 发布S1到R0的互联网段
 network 192.168.1.0 0.0.0.255 area 0          ! 发布VLAN10网段

S2(三层汇聚/分布交换机)

功能:

• 与S1结构镜像相似,互联Fa0/1
• VLAN20网关
• 主干聚合/Trunk口

ip routing                                      ! 启用三层路由功能

interface Port-channel1                         ! 配置聚合接口
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式

interface FastEthernet0/1                       ! 配置上联到R0的三层口
 no switchport                                  ! 关闭二层功能,变为三层路由口
 ip address 192.168.7.1 255.255.255.252        ! 配置IP地址

interface range FastEthernet0/2, FastEthernet0/4  ! 批量配置Fa0/2和Fa0/4
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式
 channel-group 1 mode active                    ! 加入聚合组1,LACP主动模式

interface FastEthernet0/3                       ! 配置下联到S4的Trunk口
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式

interface Vlan20                                ! 配置VLAN20的SVI网关
 ip address 192.168.2.1 255.255.255.0          ! VLAN20网关IP

router ospf 1                                   ! 启用OSPF进程1
 log-adjacency-changes                          ! 记录邻居状态变化
 network 192.168.7.0 0.0.0.3 area 0            ! 发布S2到R0的互联网段
 network 192.168.2.0 0.0.0.255 area 0          ! 发布VLAN20网段

S3(接入交换机)

功能:

• Trunk上联
• 3个PC口接VLAN10

interface FastEthernet0/1                       ! 配置上联到S1的Trunk口
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式

interface range FastEthernet0/2, FastEthernet0/3, FastEthernet0/4  ! 批量配置接入口
 switchport access vlan 10                      ! 将端口划入VLAN10
 switchport mode access                         ! 设置为Access模式

S4(接入交换机)

功能:

• Trunk上联
• 3个PC口接VLAN20

interface FastEthernet0/1                       ! 配置上联到S2的Trunk口
 switchport trunk allowed vlan 10,20           ! 允许VLAN10和20通过
 switchport trunk encapsulation dot1q          ! 使用802.1Q封装
 switchport mode trunk                          ! 设置为Trunk模式

interface range FastEthernet0/2, FastEthernet0/3, FastEthernet0/4  ! 批量配置接入口
 switchport access vlan 20                      ! 将端口划入VLAN20
 switchport mode access                         ! 设置为Access模式

R0（核心路由器）

功能:

• 与 S1/S2 汇聚交换机互联三层口（主干动态路由）
• 串口与 R1 互联，实现园区与外网的数据交互
• 运行 OSPF 动态路由，同时静态路由转发外网访问

! S1/S2 主干三层互联接口
interface GigabitEthernet0/0
 ip address 192.168.6.2 255.255.255.252

interface GigabitEthernet0/1
 ip address 192.168.7.2 255.255.255.252

! 串口对接 R1（外部路由器）
interface Serial0/1/0
 ip address 192.168.8.1 255.255.255.252
 clock rate 64000

! 启用 OSPF 动态路由，并注入静态路由
router ospf 1
 log-adjacency-changes
 redistribute static subnets
 network 192.168.6.0 0.0.0.3 area 0
 network 192.168.7.0 0.0.0.3 area 0

! 指向外网（PC0）的静态路由
ip route 192.168.9.0 255.255.255.0 192.168.8.2

R1（外部路由器）

功能:

• 串口与 R0 对接，实现与园区互通
• 外网（PC0）的网关接口
• 静态路由回程（简化建议：可只配置一条默认静态路由）

! 外网接口（连接 PC0 等外部终端）
interface GigabitEthernet0/0
 ip address 192.168.9.1 255.255.255.0

! 串口对接 R0
interface Serial0/1/0
 ip address 192.168.8.2 255.255.255.252

! 静态路由回程（每个内部网段分别配置，或可简化为一条默认路由）
ip route 192.168.6.0 255.255.255.252 192.168.8.1
ip route 192.168.7.0 255.255.255.252 192.168.8.1
ip route 192.168.1.0 255.255.255.0 192.168.8.1
ip route 192.168.2.0 255.255.255.0 192.168.8.1

! —— 简化写法（推荐，等效于上面多条静态路由）:
! ip route 0.0.0.0 0.0.0.0 192.168.8.1

使用说明 & 核心结构

关键配置要点:

1. 主干聚合、下联、Trunk口参数必须两端完全一致,所有透传VLAN都需本地创建
2. 汇聚层三层交换机负责网关(SVI),OSPF向核心路由器发布VLAN网段和互联网段
3. 核心路由与外部路由器间静态路由互通,适配企业外网、分区园区网络
4. 接入层交换机为标准二层结构,只负责VLAN端口分配和Trunk搬帧,网关留给汇聚层

总结

通过这次Packet Tracer企业级VLAN/OSPF/静态路由主干互通的折腾,深入理解了VLAN划分、三层交换机配置、主干聚合、Trunk链路、OSPF动态路由和静态路由等核心网络技术。遇到的问题和解决方法也让我积累了宝贵的实战经验。

希望这份笔记能帮助到正在学习网络配置的朋友们(想这门课平时分满分的同学们),避免踩坑。配置确实很复杂很折磨,但只要理清思路,逐步排查问题,就能实现网络互通。

核心经验总结:

• ✅ 聚合口必须配置为二层Trunk模式才能透传VLAN
• ✅ 两端交换机必须都创建相同的VLAN
• ✅ 使用 show interfaces trunk 检查VLAN状态
• ✅ 遇到问题时使用 default interface 清空配置重来
• ✅ 耐心等待Packet Tracer收敛,必要时重启模拟器

实验环境

• 一台虚拟机作为服务端（CentOS 7）
• 一台虚拟机作为客户端（CentOS 7 或 Windows）
• 服务端 IP: 192.241.42.3

1. 安装 vsftpd 软件包

使用 yum 安装：

yum install vsftpd -y

<img src="https://img.103028.xyz/blog/ftp/p1.png" alt="p1" />

2. 配置匿名用户访问

(1) 修改配置文件 /etc/vsftpd/vsftpd.conf

vi /etc/vsftpd/vsftpd.conf

确保以下参数设置正确：

anonymous_enable=YES
anon_upload_enable=YES
anon_mkdir_write_enable=YES
anon_other_write_enable=YES

<img src="https://img.103028.xyz/blog/ftp/p2.png" alt="p2" />

(2) 设置目录权限

匿名用户的根目录默认是 /var/ftp/pub。

chmod 777 /var/ftp/pub

(3) 关闭防火墙与 SELinux

setenforce 0
systemctl stop firewalld

(4) 启动服务

systemctl start vsftpd
systemctl enable vsftpd

<img src="https://img.103028.xyz/blog/ftp/p3.png" alt="p3" />

3. 测试匿名访问

(1) 浏览器测试

在客户端浏览器输入 ftp://192.241.42.3。

<img src="https://img.103028.xyz/blog/ftp/p4.png" alt="p4" />

(2) 命令行测试

yum install ftp -y
ftp 192.241.42.3

用户名输入 anonymous，密码为空。

<img src="https://img.103028.xyz/blog/ftp/p5.png" alt="p5" />

4. 配置本地用户访问

(1) 创建测试用户

useradd reading
passwd reading

(2) 修改配置文件

vi /etc/vsftpd/vsftpd.conf

确保：

local_enable=YES
write_enable=YES
local_umask=022

<img src="https://img.103028.xyz/blog/ftp/p6.png" alt="p6" />

(3) 限制用户在自己家目录

取消注释：

chroot_local_user=YES
allow_writeable_chroot=YES

5. 常见问题排查

• 500 OOPS: vsftpd: refusing to run with writable root inside chroot(): 需要在配置中加入 allow_writeable_chroot=YES。
• 530 Login incorrect: 检查密码是否正确，或 /etc/pam.d/vsftpd 配置。
• 无法上传文件: 检查 /var/ftp/pub 的目录权限以及 SELinux 状态。

<img src="https://img.103028.xyz/blog/ftp/p7.png" alt="p7" />

1. 配置网络

服务器启动DHCP服务器，为客户机分配IP地址：

setenforce 0
systemctl stop firewalld
systemctl start dhcpd

（客户机）

<img src="https://img.103028.xyz/blog/apac/p1.png" alt="p1" />

2. 安装Apache软件包（需要先配置yum本地源）

yum install httpd -y

3. 服务器本机测试

打开firefox浏览器（没有的话自己用 yum 安装）：

yum install firefox
systemctl start httpd

然后打开firefox浏览器：

<img src="https://img.103028.xyz/blog/apac/p2.png" alt="p2" />

在地址栏输入服务器的IP地址进行测试，比如 192.241.42.3：

<img src="https://img.103028.xyz/blog/apac/p4.webp" alt="p4" />

出现Apache的默认页面，说明安装成功。

4. 客户机测试

在客户机（Windows 或 Linux）中打开浏览器，输入服务器的IP地址 192.241.42.3。

<img src="https://img.103028.xyz/blog/apac/p5.png" alt="p5" />

步骤二：管理Apache服务器

1. 建立虚拟目录

在 /var/www/html 目录下创建 reading 文件夹，并创建 index.html：

mkdir /var/www/html/reading
echo "hello reading!" > /var/www/html/reading/index.html

在服务器浏览器输入 http://192.241.42.3/reading 进行测试：

<img src="https://img.103028.xyz/blog/apac/p6.png" alt="p6" />

2. 建立虚拟主机

(1) 基于IP地址的虚拟主机

在 /etc/httpd/conf.d 目录下创建 vhost.conf：

vi /etc/httpd/conf.d/vhost.conf

输入以下内容：

<VirtualHost 192.241.42.3:80>
    DocumentRoot /var/www/html/ip3
</VirtualHost>

<VirtualHost 192.241.42.4:80>
    DocumentRoot /var/www/html/ip4
</VirtualHost>

创建对应目录和文件：

mkdir /var/www/html/ip3
mkdir /var/www/html/ip4
echo "IP 192.241.42.3" > /var/www/html/ip3/index.html
echo "IP 192.241.42.4" > /var/www/html/ip4/index.html

注意： 服务器需要有两个IP地址。可以使用 ifconfig 或 ip addr 添加子接口：

ifconfig ens33:1 192.241.42.4 netmask 255.255.255.0

重启服务测试：

systemctl restart httpd

<img src="https://img.103028.xyz/blog/apac/p7.png" alt="p7" />

(2) 基于主机名的虚拟主机

修改 /etc/httpd/conf.d/vhost.conf：

<VirtualHost 192.241.42.3:80>
    ServerName www.mypt.com
    DocumentRoot /var/www/html/mypt
</VirtualHost>

<VirtualHost 192.241.42.3:80>
    ServerName www.reading.com
    DocumentRoot /var/www/html/reading
</VirtualHost>

创建目录和文件，并配置 /etc/hosts（或 DNS 服务）：

echo "192.241.42.3 www.mypt.com" >> /etc/hosts
echo "192.241.42.3 www.reading.com" >> /etc/hosts

测试：

<img src="https://img.103028.xyz/blog/apac/p8.png" alt="p8" /> <img src="https://img.103028.xyz/blog/apac/p9.png" alt="p9" />

本实验记录了在 Linux 虚拟机上安装与配置 DNS 服务（BIND）的全过程，包括正向与反向解析的设置及常见错误排查。

一、实验目的

• 了解 DNS 的基本概念和作用
• 掌握 DNS 域名解析过程与查询模式
• 熟悉 BIND 服务器主要配置文件与参数
• 学会使用 named-checkconf、nslookup 等命令进行测试与调试

二、实验环境

• 一台虚拟机作为服务器端
• 一台虚拟机作为客户端
• 软件环境：BIND + BIND-chroot
• 网络要求：两台主机在同一网段可互相 ping 通

三、安装与配置 BIND

1️⃣ 安装 DNS 服务

yum install bind bind-chroot -y

<img src="https://img.103028.xyz/blog/dns/pic1.png" alt="pic1" />

2️⃣ 修改主配置文件 /etc/named.conf

打开文件：

vim /etc/named.conf

按照以下步骤修改（带行号的是文件中对应位置）：

• 13 行：listen-on port 53 { }; → 在 { } 中改为 any;
• 21 行：allow-query { }; → 在 { } 中改为 any;
• 33 行：recursion yes;
• 35 行：dnssec-enable yes;
• 36 行：dnssec-validation no;
• 59 行：添加 include "/etc/named.rfc1912.zones";
• 60 行：添加 include "/etc/named.root.key";

修改后效果示例：

listen-on port 53 { any; };
allow-query { any; };
recursion yes;
dnssec-enable yes;
dnssec-validation no;

include "/etc/named.rfc1912.zones";
include "/etc/named.root.key";

<img src="https://img.103028.xyz/blog/dns/pic2.png" alt="pic2" /> <img src="https://img.103028.xyz/blog/dns/pic3.png" alt="pic3" /> <img src="https://img.103028.xyz/blog/dns/pic4.png" alt="pic4" />

四、配置区域文件

1️⃣ 编辑 /etc/named.rfc1912.zones

备份原配置：

cp /etc/named.rfc1912.zones /etc/named.rfc1912.zones.bak

然后编辑：

vim /etc/named.rfc1912.zones

在 42 行 添加如下内容：

zone "mypt.edu.cn" IN {
    type master;
    file "mypt.edu.cn.zone";
    allow-update { none; };
};

zone "42.241.192.in-addr.arpa" IN {  // 这里网段地址是反向的 192.241.42
    type master;
    file "3.42.241.192.zone";
    allow-update { none; };
};

<img src="https://img.103028.xyz/blog/dns/pic5.png" alt="pic5" />

五、正向解析文件

cd /var/named
cp -p named.localhost mypt.edu.cn.zone   # cp -p 保留源文件权限
vim mypt.edu.cn.zone

内容如下：

$TTL 1D
@       IN SOA  @ name.mypt.edu.cn. (
                            0       ; serial
                            1D      ; refresh
                            1H      ; retry
                            1W      ; expire
                            3H )    ; minimum

        IN  NS  name.mypt.edu.cn.
        IN  MX  10 mail.mypt.edu.cn.

name    IN  A   192.241.42.3
mail    IN  A   192.241.42.20
www     IN  A   192.241.42.10
ftp     IN  A   192.241.42.30
gw      IN  A   192.241.42.254
web     IN  CNAME   www.mypt.edu.cn.

<img src="https://img.103028.xyz/blog/dns/pic6.png" alt="pic6" />

六、反向解析文件

cp -p named.loopback 3.42.241.192.zone
vim /var/named/3.42.241.192.zone

内容如下：

$TTL 1D
@       IN SOA  @ name.mypt.edu.cn. (
                            0       ; serial
                            1D      ; refresh
                            1H      ; retry
                            1W      ; expire
                            3H )    ; minimum

    IN  NS  name.mypt.edu.cn.
    IN  MX  10 mail.mypt.edu.cn.

3   IN  PTR name.mypt.edu.cn.
10  IN  PTR www.mypt.edu.cn.
20  IN  PTR mail.mypt.edu.cn.
30  IN  PTR ftp.mypt.edu.cn.

<img src="https://img.103028.xyz/blog/dns/pic7.png" alt="pic7" />

七、关闭防火墙与 SELinux（实验用）

setenforce 0
systemctl stop firewalld

八、启动与测试

1️⃣ 检查配置文件是否正确

named-checkconf -z

出现以下输出表示通过：

zone localhost.localdomain/IN: loaded serial 0
zone localhost/IN: loaded serial 0
zone mypt.edu.cn/IN: loaded serial 0
zone 42.241.192.in-addr.arpa/IN: loaded serial 0

2️⃣ 启动 DNS 服务

systemctl restart named
systemctl enable named
systemctl status named

出现：

Active: active (running)

表示启动成功 ✅

九、客户端测试

• 在客户端网络设置中将 DNS 地址改为服务器地址： 192.241.42.3

<img src="https://img.103028.xyz/blog/dns/pic8.png" alt="pic8" />

• 使用 nslookup 测试：

nslookup 192.241.42.3

输出：

3.42.241.192.in-addr.arpa   name = name.mypt.edu.cn.

<img src="https://img.103028.xyz/blog/dns/pic9.png" alt="pic9" />

正反向解析均成功 ✅

十、踩坑记录与排查经验

在调试过程中，我遇到了几种典型错误：

❶ named 服务启动失败

查看状态：

systemctl status named

<img src="https://img.103028.xyz/blog/dns/pic10.png" alt="pic10" />

发现报错：

/etc/named.rfc1912.zones:49: missing ';' before 'zone'

解决方法：上一个 zone 块忘记写分号结尾，加上 }; 即可。

❷ 反向区域加载失败

执行：

named-checkconf -z

<img src="https://img.103028.xyz/blog/dns/pic11.png" alt="pic11" />

输出：

zone 42.241.192.in-addr.arpa/IN: loading from master file failed: file not found

→ 原因：文件名写错了，改为 3.42.241.192.zone 即可。

❸ has no NS records

zone 42.241.192.in-addr.arpa/IN: has no NS records

→ 原因：反向区文件缺少 NS 记录。 → 解决：添加

IN NS name.mypt.edu.cn.

❹ connection timed out

客户端使用 nslookup 时：

connection timed out; no servers could be reached

→ 解决：

• 确认防火墙已关闭；

• 确认 /etc/named.conf 中 listen-on port 53 { any; };；

• 重启服务：

  systemctl restart named
  

✅ 最后验证

named-checkconf -z
systemctl restart named
systemctl status named

<img src="https://img.103028.xyz/blog/dns/pic12.png" alt="pic12" />

出现：

Active: active (running)

即表示 DNS 服务器配置成功！

一、配置两台虚拟机的网络

1.1 设置网络连接模式

将两台虚拟机的网络连接模式均设置为"仅主机模式（Host-Only）"。

<img src="https://img.103028.xyz/blog/dhcp/图片1.png" alt="网络连接模式设置" />

1.2 配置服务端静态 IP 地址

在服务端虚拟机中手动配置静态 IP 地址：

• IP 地址：192.241.编号.3
• 网关地址：192.241.254.1
• 子网掩码：255.255.255.0

<img src="https://img.103028.xyz/blog/dhcp/图片2.png" alt="静态IP配置" />

二、配置 DHCP 服务器

2.1 安装 DHCP 服务

使用系统包管理工具安装 DHCP 服务：

yum install dhcp

<img src="https://img.103028.xyz/blog/dhcp/图片3.png" alt="安装DHCP服务" />

2.2 复制配置模板文件

将 DHCP 配置模板文件复制到 /etc/dhcp 目录下：

cp /usr/share/doc/dhcp*/dhcpd.conf.example /etc/dhcp/dhcpd.conf

<img src="https://img.103028.xyz/blog/dhcp/图片4.png" alt="复制配置文件" />

2.3 修改 DHCP 主配置文件

编辑配置文件：

vim /etc/dhcp/dhcpd.conf

修改以下内容：

subnet 192.241.编号.0 netmask 255.255.255.0 {
    range 192.241.编号.10 192.241.编号.100;   # 指定 DHCP 分配的 IP 地址范围
    option routers 192.241.编号.3;            # 指定客户端的默认网关地址
}

<img src="https://img.103028.xyz/blog/dhcp/图片5.png" alt="配置DHCP文件" />

2.4 启动 DHCP 服务并设置开机自启

systemctl restart dhcpd
systemctl enable dhcpd

同时关闭 SELinux 和防火墙以避免网络阻断：

setenforce 0
systemctl stop firewalld

<img src="https://img.103028.xyz/blog/dhcp/图片6.png" alt="启动DHCP服务" />

三、客户端配置

3.1 编辑虚拟网络编辑器

在 VMware 虚拟网络编辑器中，关闭 VMnet1 和 VMnet2 的 DHCP 服务。

<img src="https://img.103028.xyz/blog/dhcp/图片7.png" alt="关闭VMware DHCP" />

3.2 验证客户端自动获取 IP

启动客户端虚拟机后，查看是否自动获取到 IP 地址。

<img src="https://img.103028.xyz/blog/dhcp/图片8.png" alt="客户端获取IP" />

3.3 测试网络连通性

ping 192.241.编号.3

<img src="https://img.103028.xyz/blog/dhcp/图片9.png" alt="测试网络连通性" />

实验环境

• 两台 CentOS 7 虚拟机(一台服务端,一台客户端)
• 服务端 IP: 192.241.42.3
• 客户端 IP: 192.241.42.101

什么是 Samba 服务

Samba 是一个在 Linux 和 UNIX 系统上实现 SMB(Server Message Block)协议的免费软件。

安装 Samba 包

配置本地源

检查虚拟机是否挂载了 CentOS 系统镜像

<img src="https://img.103028.xyz/blog/samba/image73f4d30238a7dd5c.webp" alt="挂载光盘1" /> <img src="https://img.103028.xyz/blog/samba/imageedbc9988b26d68ee.webp" alt="挂载光盘2" /> <img src="https://img.103028.xyz/blog/samba/image93d41717b46e536e.webp" alt="挂载光盘3" />

创建挂载 CentOS 系统镜像的文件夹

su
cd /etc/yum.repos.d
mkdir bak
mv CentOS-*.repo bak
cp bak/CentOS-Media.repo ./

<img src="https://img.103028.xyz/blog/samba/image2916a3fa816af4fb.webp" alt="创建挂载文件夹" />

编辑源配置

vi CentOS-Media.repo

<img src="https://img.103028.xyz/blog/samba/imagea2afcd29729c11bd.webp" alt="编辑源配置" />

挂载安装盘

mkdir /mnt/cdrom
mount /dev/sr0 /mnt/cdrom

<img src="https://img.103028.xyz/blog/samba/imagec5218a51e3132205.webp" alt="挂载安装盘" />

清除缓存

yum clean all
yum makecache

<img src="https://img.103028.xyz/blog/samba/image8d939730e064e56e.webp" alt="清除缓存" />

安装 Samba

yum install samba -y

<img src="https://img.103028.xyz/blog/samba/imagee2ed3edb6945b8f2.webp" alt="安装samba" />

启动 Samba 并设置开机启动

systemctl start smb;systemctl enable smb

<img src="https://img.103028.xyz/blog/samba/image74a7fb44be66b6c3.webp" alt="启动samba" />

建立 share 共享文件夹

useradd reading
passwd reading
mkdir /home/reading/share
chmod 777 /home/reading/share

<img src="https://img.103028.xyz/blog/samba/imagee5e8109a7d560970.webp" alt="创建用户" />

备份和修改 Samba 配置

cd /etc/samba
cp smb.conf smb.conf.bak
vi /etc/samba/smb.conf

在最下面添加:

[share]
        comment = share
        path = /home/reading/share
        read only = No

<img src="https://img.103028.xyz/blog/samba/-2025-10-29-205819d9cac5a91bfbf576.png" alt="修改配置" />

设置 Samba 账号

smbpasswd -a reading

<img src="https://img.103028.xyz/blog/samba/imageb6c562d7bdfc6041.webp" alt="设置samba账号" />

配置防火墙,关闭 SELinux

firewall-cmd --add-service samba --permanent
firewall-cmd --reload
setenforce 0

<img src="https://img.103028.xyz/blog/samba/imaged81f8e5f3d758238.webp" alt="配置防火墙" />

测试文件共享

1. 查看共享目录列表

smbclient -L 192.241.42.3 -U reading%123456

<img src="https://img.103028.xyz/blog/samba/imagefce4e11a819aa38a.webp" alt="查看共享目录" />

2. 访问 SMB 服务器

smbclient //192.241.42.3/share -U reading%123456
mkdir 1

<img src="https://img.103028.xyz/blog/samba/image8ff615aaf59a2e1e.webp" alt="访问smb服务器" />

验证是否成功创建

ll /home/reading/share

<img src="https://img.103028.xyz/blog/samba/imagef50b111a70c4bbd7.webp" alt="验证创建" />

注意:

• 先备份 Windows 和重要文件！
• 操作有风险，请注意。
• 设备名可能不同， 比如硬盘分区名 (/dev/nvme0n1pX, /dev/sdaX)，根据你自己的 fdisk -l 结果替换。

1. 准备镜像

1. 下载 ISO:
   • 去官方或者镜像站 (我用清华源: https://mirrors.tuna.tsinghua.edu.cn/archlinux/iso/latest/) 下载最新的 Arch Linux ISO 文件。
2. 写入 U 盘:
   • 把 ISO 文件弄到 U 盘里。
   • 我用的 Ventoy，直接拷进去就行。也可以用 Rufus 或 BalenaEtcher 刻录。

2. 分区 (Windows 环境下)

1. 打开磁盘管理:
   • Windows 里右键开始菜单 -> "磁盘管理"。
2. 压缩卷:
   • 找个盘，右键 -> "压缩卷"，腾出空间给 Arch。
3. 创建分区 (不格式化):
   • 在"未分配"空间上右键 -> "新建简单卷"。
   • 建 Boot 分区: 大小给 1G (1024 MB)。不分配盘符，不格式化。
   • 建 Root 分区: 把剩下空间都给它 (比如我给了 200G)。不分配盘符，不格式化。
   • EFI 分区: Windows 自带的那个，不用动。

3. 安装 Arch (基础部分)

1. U 盘启动:
   • 重启进 BIOS (按 F2, F12, DEL 等)，关掉 Secure Boot，设置 U 盘启动优先。
2. 识别分区:
   • 进 Arch 安装环境后，执行:

     fdisk -l
     # 或者 lsblk
     

   • 记下你的 EFI 分区、Boot 分区、Root 分区的名字 (比如我的是 /dev/nvme0n1p1, /dev/nvme0n1p5, /dev/nvme0n1p6)。后面命令要用。
3. 格式化分区:
   • 把下面的设备名换成你自己的!!!

     # Boot 分区格式化成 ext4
     mkfs.ext4 /dev/nvme0n1p5
     
     # Root 分区格式化成 Btrfs (-f 是强制)
     mkfs.btrfs -f /dev/nvme0n1p6
     

4. 挂载分区:
   • 按顺序挂载。

     # 挂载 Root 分区 (Btrfs) 到 /mnt，开了 zstd 压缩
     mount -t btrfs -o compress=zstd:5 /dev/nvme0n1p6 /mnt
     
     # 创建挂载点
     mkdir -p /mnt/boot/efi
     
     # 挂载 Boot 分区 (ext4) 到 /mnt/boot
     mount -t ext4 /dev/nvme0n1p5 /mnt/boot
     
     # 挂载 EFI 分区到 /mnt/boot/efi
     mount /dev/nvme0n1p1 /mnt/boot/efi
     

5. 装基本系统:
   • 注意: 这一步需要基础网络连接才能下载包。

     # 只安装最基础的包、内核和固件
     pacstrap /mnt base base-devel linux linux-firmware
     

6. 生成 fstab:
   • 生成分区挂载配置文件。

     # -U 用 UUID 识别分区，>> 追加到新系统 fstab 文件
     genfstab -U /mnt >> /mnt/etc/fstab
     # 可以 cat /mnt/etc/fstab 检查下
     

7. Chroot 进去:
   • 切换到新安装的系统环境进行配置。

     arch-chroot /mnt
     

4. 配置 Arch (Chroot 环境里)

现在在新系统环境里操作。

1. 联网:

   • Chroot 进来后，需要在这里配置网络才能继续装包和更新。
   • 可以使用 iwctl 或其他工具连接 WiFi，或者手机USB网络共享也可以用。
   • 确保网络通畅才能进行下一步。

2. 换源:

   • 建议换国内源， 提升后续下载速度。

     # 用自带的 vi 编辑器 (此时可能还没装 nano)
     vi /etc/pacman.d/mirrorlist
     # 在文件最顶上，加一行清华源 (或者其他国内源)
     # Server = https://mirrors.tuna.tsinghua.edu.cn/archlinux/$repo/os/$arch
     # 保存退出 (:wq 保存退出 vi)
     
     # 刷新一下软件包数据库，让新源生效
     pacman -Syy
     

3. 安装常用工具:

   • 安装 nano/vim 编辑器、NetworkManager 网络管理器、btrfs-progs 工具（如果根分区是 btrfs）

     pacman -S nano vim networkmanager btrfs-progs
     

4. 设置时区:

   # 让硬件时钟用本地时间，避免 Windows 时间错乱
   timedatectl set-local-rtc 1 --adjust-system-clock
   # 我装完之后发现Windows和linux时间不一致，所以装好之后才搞了这个，记得进系统在日期和时间那打开自动设置日期和时间，然后应该就没问题了
   

5. 设置 Locale (语言):

   # 编辑 locale.gen 
   vi /etc/locale.gen
   # 把需要的语言 (如 en_US.UTF-8, zh_CN.UTF-8) 前面的 # 去掉
   # 保存退出后执行:
   locale-gen
   # 设置系统默认语言
   echo "LANG=zh_CN.UTF-8" > /etc/locale.conf
   

6. 设置主机名:

   hostnamectl set-hostname 主机名
   # (可选) 编辑 hosts 文件，添加主机名映射
   # nano /etc/hosts
   # 加上 127.0.1.1   你的主机名.localdomain  你的主机名
   

7. 启用网络服务:

   • 让 NetworkManager 开机自动运行。

     systemctl enable NetworkManager
     

8. 配置 Initramfs (Btrfs 需要):

   • 如果 Root 分区是 Btrfs，需要这步。

     # 编辑 mkinitcpio.conf
     nano /etc/mkinitcpio.conf
     # 在 HOOKS=(...) 行的 filesystems 后面加上 btrfs
     # 保存退出后执行:
     mkinitcpio -P
     

   • Ext4 Root 分区跳过此步。

9. 设置 Root 密码 (可选):

   passwd
   

10. 安装 GRUB (启动引导):

    # 装 GRUB 相关包
    pacman -S grub efibootmgr os-prober
    # 安装 GRUB 到 EFI 分区
    grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id="Arch Linux"
    # 配置 GRUB 检测其他系统 (如 Windows)
    vi /etc/default/grub
    # 找到 #GRUB_DISABLE_OS_PROBER=false，去掉 #
    # 保存退出后生成 GRUB 配置
    grub-mkconfig -o /boot/grub/grub.cfg
    

11. 创建普通用户:

    # 把 "用户名" 换成你的
    useradd -m -G wheel 用户名
    # 给用户设置密码
    passwd 用户名
    # 允许 wheel 组用户使用 sudo
    vi /etc/sudoers
    # 找到 # %wheel ALL=(ALL:ALL) ALL，去掉 #
    # 保存退出
    

12. 安装桌面环境和软件 (我的选择):

    # 装 KDE Plasma 和常用应用、SDDM 登录器
    pacman -S plasma kde-applications sddm
    # 装 中日韩字体
    pacman -S noto-fonts-cjk
    # (可选) 装蓝牙工具并启用服务
    pacman -S bluez bluez-utils
    systemctl enable bluetooth
    

13. 启用登录界面:

    # 让 SDDM 开机启动
    systemctl enable sddm
    

14. 配置 DNS (可选):

    • 如果想手动指定 DNS。

      # 编辑 systemd-resolved 配置
      sudo nano /etc/systemd/resolved.conf
      # 在 [Resolve] 下面取消注释并修改 DNS= 和 FallbackDNS=
      # DNS=8.8.8.8 1.1.1.1
      # FallbackDNS=9.9.9.9
      # 保存退出 (可能需要 systemctl restart systemd-resolved 生效)
      

5. 完成与重启

1. 退出 Chroot:

   exit
   

2. 卸载分区:

   umount -R /mnt
   

3. 重启:

   reboot
   

6. 重启之后

• 进 GRUB 菜单选 "Arch Linux" 启动。
• 用你创建的用户名和密码登录。
• 进系统后先联网，更新系统： sudo pacman -Syu。
• 之后就是装软件、配置输入法等等。
• 后续配置就可以参考(https://blog.archlinux.tech)。
• 如果进系统有些地方不是中文，可能需要 sudo nano /etc/locale.gen 把所有中文相关项取消注释，然后 sudo locale-gen 再重启试试。也检查下 KDE 自己的区域语言设置。

sudo apt install nodejs redis chromium

安装Napcat

这里用debian进行安装，下面这个脚本支持Ubuntu 20+/Debian 10+/Centos9

curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh --docker n --cli n

安装TRSS_Yunzai

安装好NapCat之后，我们就来安装Yunzai，因为是在Debian上安装，所以只能手动安装了

Git Clone 项目

请根据网络情况选择使用 GitHub 或 Gitee 安装

git clone --depth 1 https://github.com/TimeRainStarSky/Yunzai
git clone --depth 1 https://gitee.com/TimeRainStarSky/Yunzai

cd Yunzai

安装 pnpm 和依赖

npm i -g pnpm
pnpm i

前台运行

使用 pm2 后台运行

开机自启

pnpm start
pnpm pm2 save
pnpm pm2 startup

NapCat和Yunzai安装好之后，我们就可以启动了

启动Yunzai

进入Yunzai安装目录

cd /root/Yunzai

启动Yunzai

node .

启动好之后留意日志里面带有[websocket]的一排 比如[WebSocket ]连接地址 <：ws://localhost:2536/[ComWeChat,GSUIDCore,OPQBot,OneBotv11,go-cqhttp] 虽然说其实只用记住端口是2536就是了（）

启动NapCat

xvfb-run -a qq --no-sandbox -q [机器人QQ]

这一步其实就是登上机器人qq

通过 WebUI 配置，连接到Yunzai

这里引用官方文档里面的说明：

如果你已经启动了 NapCat, 并且有多于 1 个开放端口，则可以通过 WebUI 进行配置.

默认地址为 0.0.0.0, 即监听所有地址. 当配置了不可用的地址时 WebUI 将被禁用.

默认端口为 6099.

当端口被设置为 0 时将禁用 WebUI.

当端口被占用时, 会自动对端口 +1, 直到找到可用端口 (最多尝试 100 次, 失败则会禁用 WebUI), 端口号会在启动日志中显示.

启动后可在启动日志中看到形如 [WebUi] WebUi Local Panel Url: http://127.0.0.1:6099/webui?token=xxxx 的 token 信息.

也可打开 webui.json 文件，在其中找到token。(使用 NapCat.Installer - Linux 一键脚本安装时, 该文件位于 /opt/QQ/resources/app/app_launcher/napcat/config/webui.json)

webui.json

{
    "host": "0.0.0.0", // WebUI 监听地址
    "port": 6099, // WebUI 端口
    "token": "xxxx", // 登录密钥, 默认是自动生成的随机登录密码
    "loginRate": 3, // 每分钟登录次数限制
}

访问 http://ip:port/webui/，然后进行以下操作:

1. 进入 QQ 登录, 点击 QRCode 进行二维码登录.
2. 登录成功后, 即可进入网络配置, 点击 "新建" 创建对应的服务器或客户端.(如果是公网部署, 请务必启用 Token)
3. 请在创建时勾选保存时启用, 或者创建完成后手动启用.
4. 访问 http://ip:port 检查端口是否正常. (此处的 port 指 2 中配置的端口, 请不要与 WebUI 端口混淆)"

进去之后，网络配置>新建>websocket客户端，名称随意，url改成ws://localhost:2536/OneBotv11，然后启用并保存

<img src="https://img.picgo.net/2025/02/12/image7c64ed7c39454800.png" alt="Image of image7c64ed7c39454800" />

安装插件

1. 设置主人QQ

   打开你的QQ,给机器人私聊发送 #设置主人 然后会提醒你输入验证码，这个时候你就需要去看Yunzai的控制台了，里面会有一串验证码，找到发给它之后就完成了

2. 安装锅巴插件

   锅巴插件能方便你安装和管理插件，对机器人私聊发送 #安装Guoba-Plugin 执行之后机器人会自动安装插件并重启，重启成功后会发送消息

   重启成功后，发送 #锅巴登录 机器人会发送webui的地址 本机用 localhost 那个地址打开 ，局域网设备打开机器人发的内网地址的第一个链接即可

3. 安装并配置ChatGPT插件

   进入webui之后，打开 插件管理>未安装 搜索 ChatGPT-Plugin 并安装 机器人重启成功后，刷新网页打开 插件配置>ChatGPT-Plugin 找到Gemini配置的位置，填入你申请的Gemini Api (没申请去Gemini API 申请地址) 模型名称填最新的2.0 Flash模型： gemini-2.0-flash-thinking-exp-01-21 然后可以去插件的文档(Yunzai 插件文档)那看看还有什么有意思的也能改改

4. 和机器人对话

   和机器人私聊发送 #chatgpt切换gemini