第四章：Proxmox集群文件系统（pmxcfs）

原文链接：https://pve.proxmox.com/pve-docs/chapter-pmxcfs.html 最后更新：2026-02-25

概述

Proxmox集群文件系统（pmxcfs）是Proxmox VE的核心组件之一。它是一个数据库驱动的文件系统，专门设计用于在集群环境中存储配置文件。

什么是pmxcfs

设计目标

* 高可用性 * 数据一致性 * 实时复制 * 容错能力

技术特点

* 基于Corosync * 使用SQLite数据库 * RAM磁盘支持 * 自动故障转移

文件系统结构

挂载点

/etc/pve/
</code

=== 目录结构 ===

<code>
/etc/pve/
├── qemu-server/     # 虚拟机配置
├── lxc/            # 容器配置
├── storage.cfg     # 存储配置
├── user.cfg        # 用户配置
├── radius.cfg      # RADIUS配置
├── datacenter.cfg  # 数据中心配置
└── nodes/          # 节点特定配置

数据复制

复制机制

* 实时复制到所有节点 * 基于Corosync * 异步复制 * 最终一致性

复制状态

查看复制状态：

pvesr status
</code

===== 数据库 =====

=== SQLite数据库 ===

pmxcfs使用SQLite存储数据：
* 配置文件数据库
* 用户数据库
* 权限数据库

=== 数据库文件 ===

<code>
/var/lib/pve-cluster/
├── pve.sqlite
├── pve-ssl.pem
└── authorized_keys

配置管理

配置文件格式

* .conf - 虚拟机/容器配置 * .cfg - 系统配置 * .json - API配置

配置版本控制

* 配置文件有版本号 * 支持回滚 * 审计跟踪

性能

内存限制

* 最大30MB数据 * RAM磁盘 * 快速访问

优化

* 写缓存 * 批量更新 * 压缩传输

高可用

故障转移

* 自动检测节点故障 * 配置文件自动切换 * 无需手动干预

Quorum

* 依赖Corosync Quorum * 确保数据一致性

备份

备份配置

备份/etc/pve目录：

tar -czf pve-config.tar.gz /etc/pve/
</code

=== 恢复 ===

从备份恢复：
<code>
tar -xzf pve-config.tar.gz -C /
</code

===== 故障排除 =====

=== 常见问题 ===

* 节点无法访问配置
* 复制延迟
* 数据库锁定

=== 诊断命令 ===

<code>
# 查看文件系统状态
mount | grep pve

# 查看复制状态
pvecm status

# 查看日志
tail -f /var/log/pve.log

手动修复

在紧急情况下： <code> pvecm expected 1 </code

安全

文件权限

* 仅root可写 * pve用户可读 * 集群节点共享

传输加密

* SSL/TLS加密 * 节点认证 * 数据完整性

与其他组件集成

API

通过REST API访问： <code> GET /api2/json/cluster/resources </code

CLI工具

使用pvesh： <code> pvesh get /cluster/resources </code

最佳实践

1. 保持节点网络稳定 2. 定期备份配置 3. 监控磁盘空间 4. 及时处理警告

目录