知识库
软重启后扩展卡从 PCI 总线彻底消失，只能冷启动才回来
一台自建服务器，装了若干张扩展卡。某次执行了 reboot 之后，其中一张卡连影子都没了——不是驱动没加载、不是设备名变了，而是它在总线上 根本不存在 。lspci 列表里找不到它，连它上游的那个 PCIe 根端口也无影无踪。反复重装驱动、…
清 CMOS 只抠纽扣电池不拔电源线，等于白抠
你在折腾一台自建服务器的启动问题，照着网上的教程清 CMOS：关机、打开侧盖、抠下主板上的纽扣电池、等一会儿、装回去、开机。结果开机一看，之前改乱的那些设置原封不动地还在，症状一点没变。于是你开始怀疑电池坏了、主板有问题，甚至怀疑教程是错的…
systemd 定时器配了却不触发：间隔式触发方式产生不了下一次时间
你写了一个 systemd 定时器，想让它每 15 分钟跑一次。你用了"开机后多久"加"上次激活后多久"这两种触发方式，语法检查通过，服务也 reload 过了。可时间表里"下一次触发时间"那一栏显示为一个 （空），任务就是不动。 现象 关…
直通显卡在客户机里被认成传统 PCI 设备：少了 pcie=1
你费了好大劲把一张显卡直通给虚拟机，宿主机层面一切正常，虚拟机也认到了这张卡。可客户机里的驱动就是不认它，报"这不是一个 PCIe 设备"。你翻驱动日志、换驱动版本，都无济于事——问题其实在直通配置本身。 现象 客户机里，显卡驱动探测失败，…
网卡名突然变了网络起不来：按 MAC 的重命名规则匹配不上了
一台本来运行好好的机器，某天整机网络起不来了。你去看网卡，发现接口名退回了默认名字，而网络配置里写的还是原来那个名字——两者对不上，网络自然起不来。更奇怪的是，硬件没动过。 现象 典型表现： 系统起不来网络，SSH 连不上； ip link…
卸载软件包后配置目录还在：非空目录不会被包管理器自动删除
你在一台机器上卸载了一批存储相关的软件包，以为"卸干净了"。结果去翻目录，那些软件留下的配置目录还赫然在目。你以为是卸载失败了，重新卸一遍，它们还是不走。 现象 执行卸载（apt remove、apt purge、dnf remove）后：…
往 root 的 authorized_keys 加公钥不生效：它是软链到平台管理的文件
你在一台由虚拟化平台托管的机器上配置 SSH，想把新机器的公钥加到 root 的授权列表里，好免密登录。你把公钥 cat /.ssh/authorized keys 追加上去，保存。然后去登录——还是让你输密码，公钥认证没用。 现象 表现是…
从备份里抽磁盘镜像文件写错地方：工具的默认输出位置太反直觉
你要从一份虚拟机备份里，单独抽出磁盘镜像文件做检查或迁移。你按记忆里的命令敲下去，等着文件出现在你指定的位置——结果要么找不到文件，要么转出来的内容不对，要么机器内存莫名其妙吃紧了。 现象 表现可能有几种，而且经常一起出现： 文件没出现在你…
存储命令报未知参数：参数在新版本被移除，还留下一个静默隐患
你照着一篇（可能有些年头的）教程，在虚拟化平台上配置存储，命令敲下去，平台回你一句"未知参数"。你以为是自己打错了，反复核对，发现教程里就是这么写的。这其实是 版本变了 。 现象 执行配置存储的命令时，报类似： 或"无效的参数 / unre…
虚拟机配置里开了 guest agent 却用不了：宿主机只管"允许"，客户机才管"可用"
你在虚拟机的配置里明明勾选了"启用 guest agent"，满心以为这下能看 IP、能优雅关机、能在线改密码了。可真去用的时候，平台提示 agent 没运行。你回头确认了开关确实开着，一头雾水。 现象 具体表现： 想查询虚拟机 IP，平台…
云镜像装好后网卡起不来：缺了 net.ifnames=0 内核参数
你用云镜像（cloud image）建了一台虚拟机，平台里网络配置写得清清楚楚，可机器起来后网卡就是不工作，网络配不上、SSH 连不上。你去看客户机里网卡的名字，发现它根本不叫平台配置里写的那个名字。 现象 典型表现是：虚拟机启动后， 平台…
检查 cloud-init 却看到默认模板：dump 命令根本不读你的自定义配置
你按上一篇文章的方法，用自定义 snippet 接管了 cloud init 配置，也确确实实写进了文件。可为了放心，你用平台的 dump 命令去看"虚拟机实际用的 cloud init 内容"，看到的却是那份 默认模板 ——你自定义的东西…
默认 cloud-init 模板的三个坑：登不进、首次启动卡死、用户语义含糊
你用虚拟化平台的 cloud init 功能批量建虚拟机，图的就是"一次配好、自动初始化"。可机器建出来后，要么 ping 得通却 SSH 密码登不进去，要么首次启动卡上十几分钟，要么根本起不来。问题不在你的操作，而在那份 平台默认生成的 …
虚拟机装完系统重启又进安装器：光驱没摘、启动项没改回硬盘
你在一台虚拟化平台（这里以 Proxmox VE 为例）上用 ISO 装好了操作系统，看到"安装完成，请重启"的提示，满心欢喜地重启，结果屏幕上又出现了那个熟悉的安装界面——它又进了安装器。 现象 装完第一次重启，虚拟机 又重新启动了安装介…
重启后下载任务全变「文件丢失」：服务比数据盘挂载先启动了
你在一台机器上跑一个下载工具，数据目录放在一块单独的数据盘上。平时一切正常。某天机器重启后，你打开 Web 面板，发现 所有已经下完的任务，全都变成了"文件丢失 + 进度 0%" 。你吓得去文件系统里翻，文件好端端地摆在那里，一个都没少。手…
容器连数据库被拒：自定义网络的实际子网和你预设的不一样
你给应用容器和数据库容器建了一个自定义网络，让它们通过内网互通。数据库那边配置了放行规则，只允许应用所在网段访问。可应用一连就被拒，日志说连接被拒绝或超时。你把放行规则改来改去，就是不通。 现象 现象是"连接被拒"或"认证/网络失败"，而且…
容器里 python -m 包名.入口 找不到模块：代码被铺在了根目录
你把一个 Python 项目打成镜像，本地 python m mypkg.main 跑得好好的，一进容器就报找不到模块。Dockerfile 里明明把代码 COPY 进去了，ls 也能看到文件，可 Python 就是"看不见"这个包。 现象…
改了 .env 后 docker compose restart 不生效：容器还在用旧环境变量
你修改了项目里的 .env 文件，把数据库连接串、某个开关或 API 地址更新成了新值，然后按肌肉记忆敲下 docker compose restart。容器转了一圈回来了，可程序里读到的还是那个旧值。你反复确认 .env 文件明明已经改了…
Compose 里把选项和它的值写成一行，参数名多出一个空格
你用 Docker Compose 起一个数据库容器，想在启动命令里加几个调优参数。参数是从一篇调优文章里抄的，看起来完全正确。可容器一起来就退出，日志里报的参数名，怎么看怎么眼熟——却又对不上。 现象 容器启动立即失败，日志里报类似： 细…
发行版定制版软件无视你的配置：网上的配置键在定制包里根本不存在
你按着一篇排版工整、步骤清晰的网上教程，给一台机器上的下载工具配置 Web 面板。教程里的每一个配置键你都一字不差地抄了下来，路径也对、缩进也对。可保存重启之后，配置项像是被人偷偷划掉了——一项都没生效。 现象 表现是启动即报错，提示类似：…