关于通过SSH获取远程系统HDD空闲空间的方案及数据差异咨询

首先咱们先搞定最核心的statvfs和df输出不一致的问题，这是你当前最直接的困惑：

为什么statvfs和df输出不一样？ #

原因有三个关键差异点：

1. 空闲块的定义：
   • statvfs的f_bfree是磁盘上所有空闲块（包括root用户预留的应急块，默认是总容量的5%左右）；而df显示的Avail对应的是f_bavail——普通用户实际能使用的空闲块数量。
   • 你最初的代码用了f_bfree，所以Available数值比df的大，后来编辑后应该是换成了f_bavail，这才和df的Avail对齐。
2. 块大小的选择：
   • statvfs的f_bsize是文件系统的逻辑块大小，而df实际使用的是f_frsize（文件系统的实际物理块大小），有些文件系统中两者会有差异，这也是数值偏差的原因之一。
3. 使用率的计算逻辑：
   • df的Use%是用已使用空间 / (已使用空间 + 可用空间)计算的，而不是已使用空间 / 总容量——因为总容量里包含了root预留的不可用空间。

修正后的statvfs代码（完全对齐df输出） #

我调整了代码逻辑，确保和df的计算完全一致：

#include <stdio.h>
#include <sys/statvfs.h>

int main(int argc, const char *argv[]) {
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <mountpoint>\n", argv[0]);
        return 1;
    }

    const unsigned long long GB = 1024ULL * 1024ULL * 1024ULL;
    struct statvfs buffer;
    int ret = statvfs(argv[1], &buffer);
    
    if (!ret) {
        // 用f_frsize对齐df的块大小计算
        const unsigned long long total_bytes = (unsigned long long)buffer.f_blocks * buffer.f_frsize;
        // 已使用空间 = 总容量 - 所有空闲块（包括root预留）
        const unsigned long long used_bytes = total_bytes - (unsigned long long)buffer.f_bfree * buffer.f_frsize;
        // 普通用户可用空间 = f_bavail * 实际块大小
        const unsigned long long avail_bytes = (unsigned long long)buffer.f_bavail * buffer.f_frsize;
        // 对齐df的使用率计算逻辑
        const double used_percent = (double)used_bytes / (used_bytes + avail_bytes) * 100.0;

        // 转换为GB单位
        const double total_gb = (double)total_bytes / GB;
        const double used_gb = (double)used_bytes / GB;
        const double avail_gb = (double)avail_bytes / GB;

        printf("Total: %.1fG\n", total_gb);
        printf("Used: %.1fG\n", used_gb);
        printf("Available: %.1fG\n", avail_gb);
        printf("Used Percentage: %.0f%%\n", used_percent);
    } else {
        perror("Failed to get filesystem info");
    }
    return ret;
}

编译运行后，输出会和df -H的结果完全匹配。

解决两种方案的固有问题 #

方案1：命令行方式的缺陷修复 #

你提到的三个问题，可以这样逐个解决：

1. 简化命令行实现，避免类型转换：
   用df -P（POSIX标准化输出）配合awk直接提取计算好的数值，完全不需要手动处理字符串转浮点数：

   # 远程获取指定挂载点的信息
   ssh user@remote-host "df -P /path/to/mountpoint" | awk 'NR==2 {print "Total:" $2 " Used:" $3 " Avail:" $4 " Use%:" $5}'
   

   如果需要更结构化的输出（比如JSON），可以用jq配合df的输出格式化。
2. 获取未挂载分区的空闲空间：
   未挂载的分区无法通过文件系统接口获取空闲空间，需要直接读取文件系统元数据：
   • 针对ext4/ext3分区：用dumpe2fs读取块信息（需要root权限）：

     ssh user@remote-host "sudo dumpe2fs /dev/sda1 | grep -E 'Block count|Free blocks'"
     

     然后用总块数 - 空闲块数计算已使用块，再乘以块大小得到空间数值。
   • 针对其他文件系统（如NTFS）：用对应工具（比如ntfsinfo）读取元数据。
3. 处理HDD本身未挂载的情况：
   未挂载的整块磁盘没有文件系统，不存在“空闲空间”的概念——只有总磁盘容量。可以用lsblk获取总容量：

   ssh user@remote-host "lsblk -b -d -o SIZE /dev/sda"
   

   如果磁盘上有未挂载的分区，还是需要用上面的文件系统工具读取分区的空闲空间。

方案2：statvfs的局限（仅支持已挂载分区） #

statvfs本质是读取已挂载文件系统的虚拟文件系统信息，所以无法直接获取未挂载分区的数据。解决思路：

• 临时挂载未挂载的分区到远程机器的临时目录（比如/mnt/temp），然后用statvfs获取信息，之后再卸载。
• 或者直接用方案1里的文件系统专用工具读取元数据，不需要挂载。

远程SSH场景的最优实践 #

结合你的Qt开发场景，推荐两种方式：

1. 轻量方案：远程执行df命令解析输出
   用Qt的QProcess执行SSH命令，调用远程的df -P，然后解析输出字符串。这种方式不需要在远程机器部署额外程序，简单可靠。
2. 精确方案：远程运行编译好的statvfs程序
   把修正后的C程序编译成可执行文件，上传到远程机器，通过SSH执行并获取标准化输出。这种方式适合需要高精度数值、避免解析命令行输出歧义的场景。

内容的提问来源于stack exchange，提问作者fa7eme