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

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

===== 概述 =====

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

===== 什么是pmxcfs =====

=== 设计目标 ===

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

=== 技术特点 ===

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

===== 文件系统结构 =====

=== 挂载点 ===

<code>
/etc/pve/
</code

=== 目录结构 ===

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

===== 数据复制 =====

=== 复制机制 ===

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

=== 复制状态 ===

查看复制状态：
<code>
pvesr status
</code

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

=== SQLite数据库 ===

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

=== 数据库文件 ===

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

===== 配置管理 =====

=== 配置文件格式 ===

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

=== 配置版本控制 ===

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

===== 性能 =====

=== 内存限制 ===

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

=== 优化 ===

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

===== 高可用 =====

=== 故障转移 ===

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

=== Quorum ===

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

===== 备份 =====

=== 备份配置 ===

备份/etc/pve目录：
<code>
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>

=== 手动修复 ===

在紧急情况下：
<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. 及时处理警告

===== 限制 =====

=== 大小限制 ===

* 最大30MB数据
* 适合配置文件
* 不适合大文件

=== 文件类型 ===

仅存储：
* 配置文件
* 小型数据库
* 证书