|
|
@@ -1,7 +1,7 @@
|
|
|
# CLAUDE.md — 家庭网络部署与运维手册
|
|
|
|
|
|
> **权威声明**：本文档是家庭网络的**唯一权威**（2026-09-12 用户确认）。Obsidian 旧笔记若与本文冲突，以本文为准；冲突清单见 [§11](#11-已知风险待补项与旧笔记纠错)。
|
|
|
-> **生成方式**：2026-09-12 由 DSH agent 实测（SSH/端口扫描/容器与配置读取）+ 用户答题卡确认生成，版本 v1.0。
|
|
|
+> **生成方式**：2026-09-12 由 DSH agent 实测（SSH/端口扫描/容器与配置读取）+ 用户答题卡确认生成，版本 v1.1（2026-09-22 更新 §3.3 核显防护固化）。
|
|
|
> **维护约定**：用户口径是「**遇见就更新**」——每次改动后同步更新对应表格，并在 [§12 变更记录](#12-变更记录) 追加一行。
|
|
|
> **状态标记**：✅ 实测确认 📌 来自用户答复 ⚠️ 待确认（我未证实，不要当事实用）
|
|
|
|
|
|
@@ -71,7 +71,7 @@
|
|
|
|
|
|
| 项 | 实测 |
|
|
|
|---|---|
|
|
|
-| 版本 | `pve-manager 9.2.11`（Debian 13），内核 7.0.14，主机名 **VUModule** |
|
|
|
+| 版本 | `pve-manager 9.2.20`（Debian 13），内核 `7.0.14-19-pve`，主机名 **VUModule**（2026-09-22 升级） |
|
|
|
| 硬件 | **倍控 N355**，16G DDR5，**Kingston SNV2S500G 单条 NVMe 465.8G** |
|
|
|
| 存储 | LVM-thin 无，`local`(dir) 457G 用 52%（224G/457G），**单盘、无 RAID** |
|
|
|
| 网桥 | `vmbr0` = `enp1s0`，`address 10.10.10.254/24`，网关 `10.10.10.253` |
|
|
|
@@ -95,6 +95,27 @@
|
|
|
2. 单盘 NVMe：**VM 和备份在同一块盘上**，磁盘挂 = 全丢。异地备份未做（§11 建议）。
|
|
|
3. 改 `/etc/network/interfaces` 前先 `cp` 备份；改完用 `ifreload -a`。
|
|
|
|
|
|
+### 3.3 核显死机防护（一长三短）与升级后必查 ⚠️
|
|
|
+
|
|
|
+倍控 N355 的 i915 核显 DC 省电特性会触发**整机瞬死**：先运行期突然死机，再冷启动时 BIOS **一长三短**报警 + 硬盘灯不亮 + 只能拔市电恢复。**每次 PVE 内核/GRUB 升级都会把内核参数冲掉**（2026-08-05、2026-09-22 各丢一次——`apt full-upgrade` 重生成 `/etc/default/grub` 就丢）。
|
|
|
+
|
|
|
+| 项 | 值 |
|
|
|
+|---|---|
|
|
|
+| 固化文件 | `/etc/default/grub.d/99-i915-enable-dc.cfg`（内容为追加 `i915.enable_dc=0`；`grub-mkconfig` 会自动 source `grub.d/*.cfg`） |
|
|
|
+| 生效判据 | `/proc/cmdline` 含 `i915.enable_dc=0`，且 `/sys/module/i915/parameters/enable_dc` = `0` |
|
|
|
+| 配套改动 | **KSM 禁用**（`/sys/kernel/mm/ksm/run` 应为 `0`，该内核写 KSM sysfs 会宕机）；VM 内存 102=1024MB、104=6144MB |
|
|
|
+| 重建命令 | 改完**必须** `update-grub`，否则文件写了也进不了 grub.cfg |
|
|
|
+
|
|
|
+**内核/GRUB 升级后必查三条**（2026-09-22 升级到 `9.2.20` / 内核 `7.0.14-19-pve` 时就是丢的）：
|
|
|
+
|
|
|
+```bash
|
|
|
+grep enable_dc /proc/cmdline # 应看到 i915.enable_dc=0
|
|
|
+cat /sys/module/i915/parameters/enable_dc # 应为 0；若为 -1 说明防护已失效
|
|
|
+cat /sys/kernel/mm/ksm/run # 应为 0
|
|
|
+```
|
|
|
+
|
|
|
+丢失时的恢复：确认固化文件在位 → `update-grub` → **重启宿主**才生效。⚠️ 重启会短暂全家断网（iKuai 主路由本身是 VM100），先跟家人打招呼。
|
|
|
+
|
|
|
---
|
|
|
|
|
|
## 4. 家庭服务主力：CentOS VM104 `10.10.10.14`
|
|
|
@@ -123,6 +144,7 @@
|
|
|
- 其他 compose 位置：`/opt/searxng/docker-compose.yml`、`/home/wechat-selkies/docker-compose.yml`、`/opt/alist`、`/home/CloudNas`、`/home/www`
|
|
|
- 登录：`ssh centos`（专用密钥 `~/.ssh/10.10.10.14_id_ed25519`）
|
|
|
- 注意：这是 **KVM 虚拟机**，Docker 另有 `br-*` 网段（172.21/172.31/192.168.48）
|
|
|
+- ⚠️ **ping 不通是正常的**：内核参数 `net.ipv4.icmp_echo_ignore_all = 1`（有意禁 ICMP）。判断连通性别用 ping，改用 `ssh centos`、`curl -m3 http://10.10.10.14`、`nc -z 10.10.10.14 22 53 80`（实测 22/53/80 都通）
|
|
|
|
|
|
---
|
|
|
|
|
|
@@ -271,7 +293,7 @@
|
|
|
### 11.3 旧笔记纠错（Obsidian `02-家庭实验室`）
|
|
|
| 旧笔记说法 | 实测事实 |
|
|
|
|---|---|
|
|
|
-| `ESXI: 10.10.10.254` | 已是 **PVE 9.2.11**（ESXi 时代结束） |
|
|
|
+| `ESXI: 10.10.10.254` | 已是 **PVE 9.2.20**（ESXi 时代结束） |
|
|
|
| `VUM-HOME: 10.10.10.1` | `10.10.10.1` **不存在**；网关是 `.253` iKuai |
|
|
|
| `mini = 10.10.10.9`（服务器清单）、`ssh mini` 指向 `10.10.10.21` | `.9` 不通；`.21` 可 ping 但 22 拒绝 —— **`ssh mini` 当前不可用**，需重新确认 Mac mini 的真实 IP |
|
|
|
| 「除群晖/PVE 外无其它 Docker 主机」 | VM104 `10.10.10.14` 是 **14 容器的 Docker 主力** |
|
|
|
@@ -285,3 +307,4 @@
|
|
|
| 日期 | 版本 | 变更 | 执行人 |
|
|
|
|---|---|---|---|
|
|
|
| 2026-09-12 | v1.0 | 首版：实测生成主机/服务/组网全景，用户答题卡确认关键口径 | DSH agent |
|
|
|
+| 2026-09-22 | v1.1 | 内核升级（9.2.20 / 7.0.14-19）冲掉了 `i915.enable_dc=0` → 新增 §3.3 核显防护固化与「升级后必查三条」；补 §4 VM104 禁 ICMP 说明；更新 PVE 版本行 | DSH agent |
|
