简介面向需要获取中央处理器序列号、硬盘序列号、网卡IP地址、MAC地址以及网线插拔状态的系统开发与运维人员这份C语言源码包聚焦Windows和Linux双平台下的硬件信息读取适用于系统监控、设备识别和故障排查等场景。压缩包共2个文件1个头文件与1个C源文件整体仅7KB结构精简头文件声明接口源文件实现具体获取逻辑便于直接阅读和复用。目前已有3099人学习下载对于希望了解操作系统底层接口并快速积累跨平台编程经验的中初级开发者具备不错的参考价值。资源虽小但代码覆盖了Windows下的WMI、网络适配器API以及Linux下通过文件系统解析CPU、磁盘和网卡信息的典型路径并利用条件编译统一平台差异读者可借此掌握两类系统在硬件信息接口上的异同将封装的查询方法直接应用到自己的监控工具或管理脚本中省去查阅大量文档和踩坑的过程。1. 拿到这份C语言硬件信息源码包先搞清楚它能干什么做软件授权绑定时我常需要C语言去采集硬件信息CPU序列号、硬盘序列号、网卡IP、MAC地址、是否插入网线这几个字段在Windows和Linux上各有各的读法。之前在给一家公司做资产盘点时甲方要求两种系统下输出完全一致的格式网上搜到的代码要么只跑通一边要么依赖命令行工具部署的时候很痛苦。这份C语言获取硬件信息源码包解决的就是这个尴尬一套接口、两套实现上层不用关心平台差异。适合做授权绑定、硬件指纹、运维监控的开发者。先说个反直觉结论网线插入检测的坑比CPU序列号多得多代码里那部分值得多看几遍。2. 跨平台方案选型为什么这套代码能在Linux和Windows上跑拿到源码包后我第一件事不是去看每个函数而是看它选了什么读取路径。硬件信息采集最忌讳东拼西凑Windows和Linux的底层机制完全不同如果每读一个字段就套一层命令行做出来的程序就是个黑匣子出了问题根本不知道是哪一步失败。2.1 Windows侧注册表、WMI与底层API的取舍Windows上采集硬件信息常用三条路注册表、WMI、底层API。注册表快但字段分散不同版本的系统注册表路径会变WMI信息齐全但慢而且COM初始化放在纯C工程里非常别扭还要处理代理和权限问题底层API稳定、不依赖服务代价是代码量大、结构体多。这套源码包里Windows侧整体走底层APICPU序列号用CPUID指令硬盘序列号用DeviceIoControl网卡IP和MAC用GetAdaptersAddresses网线插入状态用OperStatus字段。这个选型的好处是编译出的exe可以直接扔到一台干净的机器上跑不需要系统自带WMI服务正常也不需要额外安装工具。#include winsock2.h #include iphlpapi.h #pragma comment(lib, iphlpapi.lib) IP_ADAPTER_ADDRESSES *addresses NULL; ULONG size 0; DWORD rc GetAdaptersAddresses( AF_UNSPEC, GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_MULTICAST, NULL, NULL, size); if (rc ERROR_BUFFER_OVERFLOW) { addresses (IP_ADAPTER_ADDRESSES *)malloc(size); rc GetAdaptersAddresses( AF_UNSPEC, GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_MULTICAST, NULL, addresses, size); }这段代码是Windows侧网卡枚举的典型开头。逻辑说明GetAdaptersAddresses第一次调用故意传入NULL缓冲区和0长度让系统把需要的缓冲区大小回写到size当返回值是ERROR_BUFFER_OVERFLOW时再分配真正的内存。参数说明AF_UNSPEC表示同时枚举IPv4和IPv6GAA_FLAG_SKIP_ANYCAST和GAA_FLAG_SKIP_MULTICAST跳过任播和组播地址避免后续处理IP_ADAPTER_UNICAST链表时遇到非单播地址。用#pragma comment(lib, iphlpapi.lib)是把库依赖写进源文件省得在Makefile里再加一行链接参数MinGW和MSVC都认这个写法。2.2 Linux侧/proc、/sys与ioctl的读取路径Linux没有Windows那种统一的设备管理API采集硬件信息要分头找路径。常见套路是CPU信息看/proc/cpuinfo网卡看/sys/class/net硬盘看/sys/block或者直接对设备文件发ioctl。这套源码包没有调用system(lshw)这种外部命令全部用标准C的文件操作和ioctl完成这样部署时不会因为缺少某个命令而直接翻车。static int read_carrier(const char *ifname) { char path[128]; snprintf(path, sizeof(path), /sys/class/net/%s/carrier, ifname); FILE *fp fopen(path, r); if (fp NULL) { return -1; } char buf[8] {0}; if (fgets(buf, sizeof(buf), fp) NULL) { fclose(fp); return -1; } fclose(fp); return buf[0] 1 ? 1 : 0; }这段代码用于Linux网线插入检测。逻辑说明/sys/class/net/{ifname}/carrier是一个文本文件内核网络驱动会在物理链路状态变化时更新它读到字符1表示有载波信号0表示断线读取失败返回-1。参数说明路径中ifname是接口名比如eth0、enp3s0、wlan0。注意fgets的缓冲区只要8字节就够了因为文件内容最多就是一个数字加换行符。为什么要用open/fgets而不是system(cat)因为system会启动一个shell子进程解析路径还要考虑转义而且cat命令不存在时函数会静默失败用文件API至少知道是open权限问题还是读取问题。2.3 编译宏与头文件组织源码包的结构很清晰hw_info.h定义统一结构体hw_info_windows.c写Windows实现hw_info_linux.c写Linux实现main.c是一个命令行示例程序。编译时按平台选择源文件Windows的代码放在条件编译块里。#ifdef _WIN32 #define HW_EXPORT __declspec(dllexport) #else #define HW_EXPORT __attribute__((visibility(default))) #endif typedef struct { char cpu_id[64]; char disk_serial[64]; char mac_address[18]; char ip_address[64]; int link_up; } hw_info_t; HW_EXPORT int hw_info_fill(hw_info_t *info);逻辑说明hw_info_t是上层调用者唯一需要关心的数据结构所有平台差异都被hw_info_fill函数封在里面。字段定长是为了方便结构体跨平台拷贝、写日志、走网络序列化不用每次算字符串长度。参数说明mac_address字段之所以是18字节是因为MAC地址按xx:xx:xx:xx:xx:xx的文本格式存储需要17个字符再加一个结尾符正好18。link_up用int而不是bool是为了表达“不适用”这种第三态无线网卡没有网线插入概念返回值可能是-1。编译命令分别如下。MinGW下编译Windows版本gcc -D_WIN32_WINNT0x0601 -stdgnu11 hw_info_windows.c main.c -o hw_info.exe -liphlpapi逻辑说明-D_WIN32_WINNT0x0601告诉Windows SDK按Windows 7及以上版本的行为编译避免GetAdaptersAddresses的某些字段在旧SDK下被裁剪。-stdgnu11是必要的MinGW的windows.h在使用纯c11标准时会遇到inline语义和额外类型定义的兼容问题。Linux下编译gcc -stdgnu11 hw_info_linux.c main.c -o hw_infoLinux版不需要额外链接库因为getifaddrs和ioctl都是glibc的标准接口。如果改用musl libc编译需要手动加-lutil这在静态编译时会遇到属于另一个话题了。3. CPU序列号与硬盘序列号读取原理和具体实现这两个字段是整个源码包里最“硬”的部分。CPU序列号不是一个官方定义的统一标识不同厂商的实现完全不同硬盘序列号则要绕过操作系统抽象直接和设备对话这两个字段的实现最能体现这份代码的工程取舍。3.1 CPU序列号CPUID指令与寄存器提取先澄清一个概念通常说的CPU序列号在x86平台上来自CPUID指令leaf 1返回值中的一组寄存器组合不同厂商的处理器不保证字段布局一致而且现在很多处理器根本不保证这个值唯一。源码包里的做法是直接执行CPUID leaf 1把EBX、ECX、EDX三个寄存器按固定顺序拼成一个字符串。#include stdint.h #if defined(_MSC_VER) #include intrin.h static void cpu_id_read(uint32_t regs[4]) { __cpuid(regs, 1); } #elif defined(__GNUC__) || defined(__clang__) #include cpuid.h static void cpu_id_read(uint32_t regs[4]) { __cpuid(1, regs[0], regs[1], regs[2], regs[3]); } #endif void get_cpu_serial(char *out, size_t out_len) { uint32_t regs[4] {0}; cpu_id_read(regs); snprintf(out, out_len, %08X%08X%08X, regs[1], regs[2], regs[3]); }逻辑说明__cpuid是编译器提供的intrinsic函数它保存现场后执行CPUID指令再把结果写到regs数组里顺序是EAX、EBX、ECX、EDX。这里只取EBX、ECX、EDX三个寄存器是因为leaf 1的EAX里主要是版本信息比如步进号和型号不适合当序列号。参数说明out_len建议传25因为拼接后的十六进制串是24个字符再加结尾符就是25。这个值在不同架构上可能完全相同比如某些老款低端处理器就不会返回有效序列号所以上层代码千万不要把cpu_id当数据库主键。用/proc/cpuinfo也能拿到类似信息但读/proc/cpuinfo里没有直接叫serial number的字段只有model name、vendor_id这些属性。源码包选择CPUID是为了绕开不同发行版对/proc/cpuinfo格式的二次加工缺点是ARM平台上没有CPUID指令如果要移植到ARM这段代码必须增加__x86_64__或__i386__编译判断否则直接编译失败。3.2 硬盘序列号Windows的DeviceIoControl与Linux的ioctlWindows侧读硬盘序列号用的是DeviceIoControl向存储驱动发送IOCTL_STORAGE_QUERY_PROPERTY控制码拿到一块描述符再从描述符的偏移位置拷贝序列号字符串。我一般会把这块逻辑单独抽出来因为它比想象中容易踩越界漏洞。#include windows.h #include winioctl.h void get_disk_serial_windows(char *serial, size_t cap) { HANDLE h CreateFileA(\\\\.\\PhysicalDrive0, 0, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL); if (h INVALID_HANDLE_VALUE) { snprintf(serial, cap, N/A); return; } STORAGE_PROPERTY_QUERY q; memset(q, 0, sizeof(q)); q.PropertyId StorageDeviceProperty; q.QueryType PropertyStandardQuery; STORAGE_DEVICE_DESCRIPTOR desc; memset(desc, 0, sizeof(desc)); DWORD returned 0; BOOL ok DeviceIoControl(h, IOCTL_STORAGE_QUERY_PROPERTY, q, sizeof(q), desc, sizeof(desc), returned, NULL); CloseHandle(h); if (!ok || desc.SerialNumberOffset 0) { snprintf(serial, cap, N/A); return; } char *p (char *)(void *)desc desc.SerialNumberOffset; snprintf(serial, cap, %s, p); }逻辑说明创建硬盘句柄用的是\\.\PhysicalDrive0这个设备路径代表第一块物理硬盘而不是C盘这种分区路径。使用CreateFileA时访问权限传0表示只想查询设备信息不想读写数据。参数说明FILE_SHARE_READ | FILE_SHARE_WRITE是共享参数如果其他进程已独占打开硬盘这个句柄仍然可能创建失败。desc.SerialNumberOffset是序列号在描述符结构体里的字节偏移不是指针所以取地址时要加偏移。这里有一个很隐蔽的问题STORAGE_DEVICE_DESCRIPTOR有不同版本部分厂商驱动返回的序列号是UTF-16编码直接按%s打印会得到乱码碰到这种情况需要根据desc版本字段做字符集转换源码包里保留了ASCII处理分支我在实际项目中遇到过一次已经单独加了宽字符处理。Linux侧对应的是hdparm那一套ioctl接口。源码包里用的是HDIO_GET_IDENTITY对SATA硬盘有效对NVMe固态无效因为NVMe走的不是ATA命令集。#include fcntl.h #include linux/hdreg.h #include sys/ioctl.h void get_disk_serial_linux(char *serial, size_t cap) { int fd open(/dev/sda, O_RDONLY | O_NONBLOCK); if (fd 0) { snprintf(serial, cap, N/A); return; } struct hd_driveid id; memset(id, 0, sizeof(id)); if (ioctl(fd, HDIO_GET_IDENTITY, id) 0) { snprintf(serial, cap, %s, (char *)id.serial_no); } else { snprintf(serial, cap, N/A); } close(fd); }逻辑说明open(/dev/sda, O_RDONLY | O_NONBLOCK)打开第一块SATA硬盘O_NONBLOCK避免设备忙时阻塞。hd_driveid结构体里的serial_no字段是20字节的ASCII字符数组但里面可能带尾部空格snprintf之后最好再做一次trim。参数说明如果机器是NVMe固态并且没有SATA盘/dev/sda可能不存在open会失败。源码包里有一个判断分支检查/sys/block/nvme0n1/device/serial这个文件的内容就是NVMe盘的序列号读取方式和carrier类似用fgets即可。结构体hd_driveid关联到linux/hdreg.h头文件只有内核源码头完整时才能编译嵌入式交叉编译环境里经常缺这个头文件需要手工从内核头目录补充。3.3 返回值统一封装把平台差异藏在接口后面前面两段代码分别出现在hw_info_windows.c和hw_info_linux.c里调用方只认hw_info_fill这一个入口。我最初自己写这类程序时犯过一个错把平台判断散落在各个调用点结果main函数里全是ifdef可读性非常差。这份源码包的做法是把平台判断集中在hw_info_fill一个函数里。int hw_info_fill(hw_info_t *info) { memset(info, 0, sizeof(hw_info_t)); #if defined(_WIN32) get_cpu_serial_windows(info-cpu_id, sizeof(info-cpu_id)); get_disk_serial_windows(info-disk_serial, sizeof(info-disk_serial)); get_network_info_windows(info); #else get_cpu_serial_linux(info-cpu_id, sizeof(info-cpu_id)); get_disk_serial_linux(info-disk_serial, sizeof(info-disk_serial)); get_network_info_linux(info); #endif return 0; }逻辑说明每个平台子函数只负责把自己负责的字段填进info结构体填不出来的写N/A。调用方不需要知道当前是Windows还是Linux只需要在拿到hw_info_t之后按照四个字符串字段使用。参数说明sizeof(info-cpu_id)这种写法比直接传64更安全万一以后结构体字段长度调整这里的参数会自动跟随。注意这个函数内部做的是阻塞式IO硬盘设备不存在时open可能要等几百毫秒放到GUI线程里会卡界面放到工作线程里更合适。4. 网卡IP、MAC地址和网线插入检测这块才是真正的坑如果CPU和硬盘两块是硬功夫那网卡部分就是玄学现场。IP和MAC的读取本身不难难的是搞清楚哪块网卡是“物理存在的、当前正在用”的那一个。Windows的虚拟网卡、Linux的虚拟接口、无线网卡的随机MAC任何一个都能让原本正常的采集程序输出错误结果。4.1 IP与MACgetifaddrs与GetAdaptersAddresses的对应关系Windows下最上层的API是GetAdaptersAddresses它返回的适配器列表里包含IPv4、IPv6、MAC、OperStatus这些字段一口气全拿到了。GetAdaptersInfo是老一代API只有IPv4但结构简单很多老代码里还在用。这个源码包里实际用的是GetAdaptersAddresses因为它能同时拿到OperStatus。#include winsock2.h #include iphlpapi.h void get_network_info_windows(hw_info_t *info) { ULONG size 0; IP_ADAPTER_ADDRESSES *addrs NULL; DWORD rc GetAdaptersAddresses(AF_INET, GAA_FLAG_SKIP_ANYCAST, NULL, NULL, size); if (rc ! ERROR_BUFFER_OVERFLOW) return; addrs (IP_ADAPTER_ADDRESSES *)malloc(size); rc GetAdaptersAddresses(AF_INET, GAA_FLAG_SKIP_ANYCAST, NULL, addrs, size); if (rc ! NO_ERROR) { free(addrs); return; } for (IP_ADAPTER_ADDRESSES *p addrs; p ! NULL; p p-Next) { if (p-IfType ! IF_TYPE_ETHERNET_CSMACD) continue; if (p-OperStatus ! IfOperStatusUp) continue; snprintf(info-mac_address, sizeof(info-mac_address), %02X-%02X-%02X-%02X-%02X-%02X, p-PhysicalAddress[0], p-PhysicalAddress[1], p-PhysicalAddress[2], p-PhysicalAddress[3], p-PhysicalAddress[4], p-PhysicalAddress[5]); break; } free(addrs); }逻辑说明GetAdaptersAddresses同样遵循先查询大小再分配缓冲区的模式。AF_INET让枚举范围缩到IPv4IfType等于IF_TYPE_ETHERNET_CSMACD表示是以太网卡类型OperStatus等于IfOperStatusUp表示当前物理链路已连接这两个条件组合在一起才能保证选中的是真正插着网线的以太网网卡而不是回环或虚拟设备。参数说明PhysicalAddress字段是6字节原始MAC格式化时我用减号分隔你也可以改成冒号但要注意和Linux侧保持一致否则同一套数据结构在两种平台上打出不同格式的MAC后续做字符串比对会非常难受。Linux侧对应的是getifaddrs它会返回系统所有网络接口的地址信息。要拿到MAC必须等AF_PACKET地址族出现用sockaddr_ll结构体里的sll_addr字段。#include ifaddrs.h #include netpacket/packet.h #include net/if.h void get_network_info_linux(hw_info_t *info) { struct ifaddrs *addrs NULL; if (getifaddrs(addrs) ! 0) return; for (struct ifaddrs *ifa addrs; ifa ! NULL; ifa ifa-ifa_next) { if (ifa-ifa_addr NULL) continue; if (ifa-ifa_addr-sa_family ! AF_PACKET) continue; struct sockaddr_ll *ll (struct sockaddr_ll *)ifa-ifa_addr; snprintf(info-mac_address, sizeof(info-mac_address), %02x:%02x:%02x:%02x:%02x:%02x, ll-sll_addr[0], ll-sll_addr[1], ll-sll_addr[2], ll-sll_addr[3], ll-sll_addr[4], ll-sll_addr[5]); break; } freeifaddrs(addrs); }逻辑说明getifaddrs返回链表里每个节点的ifa_addr指向一个sockaddrsa_family是AF_PACKET时这个地址就是链路层地址也就是MAC。参数说明sll_addr的前6字节是MAC地址后8字节可能是填充或者vlan标签不要直接全量打印。注意这个循环没有过滤lo和docker0实际使用时要加上接口名过滤否则第一次循环可能抓到lo的00:00:00:00:00:00看起来就像拿不到MAC一样。之所以把过滤条件放在后面一小节单独讲是因为这个过滤逻辑在Windows和Linux两侧的名字完全不同混在一起写连我自己都会绕晕。4.2 网线插入检测连接状态标志位在不同平台的差异先看Windows这边。GetAdaptersAddresses返回的每个IP_ADAPTER_ADDRESSES节点里都有OperStatus字段有经验的开发者会直接用IfOperStatusUp判断但新手经常把GetAdaptersInfo里的Address列表长度当作连接状态这是不对的。Address列表只表示网卡配置了IP地址不代表网线插着。比如一台台式机网卡用了固定IP但物理网线没插GetAdaptersInfo照样能返回IP_ADAPTER_INFOOperStatus却是IfOperStatusDown。if (p-OperStatus IfOperStatusUp) { info-link_up 1; } else if (p-OperStatus IfOperStatusDown) { info-link_up 0; } else { info-link_up -1; }逻辑说明OperStatus是操作状态不是管理状态。Windows的网络适配器属性里如果手动禁用了网卡OperStatus会是IfOperStatusDown物理断开也是IfOperStatusDown。源码包的link_up用三态就是为了区分“知道它断着”和“不知道具体断没断”。实际上还有IfOperStatusTesting这种中间状态遇到它时置为-1比较诚实。这一块代码在Windows下有多个版本差异老SDK里OperStatus字段可能不存在编译时如果报错把_WIN32_WINNT提到0x0601再看一遍。Linux侧前面已经给出了carrier读取函数这里要补充的是“读不到”的分支处理。虚拟网卡和无线网卡的carrier含义不同。无线网卡连接Wi-Fi时carrier为1但那是无线信号不是网线所以“是否插入网线”这个需求如果落在无线网卡上压根就没有对应的物理量。源码包的处理方式是先判断接口类型如果是无线设备link_up直接置-1。char type_path[128]; snprintf(type_path, sizeof(type_path), /sys/class/net/%s/type, ifname); FILE *fp fopen(type_path, r);逻辑说明/sys/class/net/{ifname}/type文件里存放的是ARP硬件类型值1代表以太网设备其他值代表无线、令牌环等。只有当type为1且carrier存在时把carrier的读取结果当作网线状态才有意义。参数说明读出来的type是一个十进制字符串建议用strtol转换而不是直接比较字符因为内核未来可能用多位数。注意carrier文件的内容只有0和1两个字符读取时不要用fscanf的%s因为换行符会留在缓冲区里用fgets最稳。4.3 场景判定虚拟网卡、蓝牙适配器怎么过滤这部分是网卡采集里最需要耐心的地方。虚拟机和容器技术会创建大量虚拟接口比如Windows的虚拟网卡、Hyper-V虚拟适配器Linux的docker0、veth、br-这些名称。过滤逻辑如果太严格会把实际物理网卡也过滤掉太宽松又会抓到一堆无意义地址。static int is_physical_netdev(const char *name) { if (strncmp(name, lo, 2) 0) return 0; if (strncmp(name, docker, 6) 0) return 0; if (strncmp(name, veth, 4) 0) return 0; if (strncmp(name, br-, 3) 0) return 0; if (strncmp(name, vmnet, 5) 0) return 0; char path[192]; snprintf(path, sizeof(path), /sys/class/net/%s/device, name); struct stat st; if (stat(path, st) 0) return 1; return 0; }逻辑说明/sys/class/net/{name}/device这个符号链接只有物理设备才存在虚拟接口没有对应的设备节点。stat函数判断链接是否存在存在就认为是物理网卡。参数说明接口名前缀过滤是一个保险动作因为部分老内核可能没有device链接。Windows侧对应的过滤字段是适配器的Description或FriendlyName常见包含Virtual、VMware、Hyper-V、TAP、Loopback关键词的适配器都要排除。代码里我习惯把“是否物理设备”和“是否有真实链路”拆成两个判断因为物理无线网卡也走同样的设备路径但它没有网线插入状态。5. 编译运行避坑指南我踩过的五个典型问题这份源码包整体结构不复杂但编译和运行环节的坑比读代码时看到的要多。下面几条是我在模拟项目X里复现时踩过的每一条都先写现象再写原因最后给出解决方式。5.1 问题一Windows下MinGW编译报错“unknown type name DWORD”现象在某一台Windows机器上用MinGW跑gcc编译刚拉到hw_info_windows.c就报错说DWORD未定义一长串红色报错看得人头皮发麻。原因代码里用了windows.h定义的DWORD但编译时头文件包含顺序不对或者是用了-stdc11。MinGW的windows.h在纯C11模式下会对部分定义做裁剪导致winsock2.h里的DWORD和UINT类型解析失败。解决把#include windows.h放到所有头文件最前面编译标准从-stdc11改成-stdgnu11。gnu11允许GNU C扩展语法和声明MinGW的SDK头文件按GNU模式编译时能正常展开那些宏定义。gcc -D_WIN32_WINNT0x0601 -stdgnu11 hw_info_windows.c main.c -o hw_info.exe -liphlpapi这个命令里的_WIN32_WINNT也不能省它决定了你用的SDK里有几个新字段可用比如IP_ADAPTER_ADDRESSES的OperStatus。不定义这个宏时MSVC默认按Windows 2003的API行为编译OperStatus字段会被裁剪掉运行时会报内存越界。5.2 问题二Linux下获取硬盘序列号需要root权限现象普通用户在Linux上运行编译好的hw_infoCPU序列号和MAC都正常打印唯独硬盘序列号输出N/A。原因/dev/sda默认设备节点权限是root:disk普通用户没有读权限。open函数直接返回Permission denied后面的ioctl根本没有机会执行。这是个权限黑匣子不是代码逻辑坏了。解决开发调试阶段用sudo运行正式部署时给二进制增加cap_sys_rawio能力sudo setcap cap_sys_rawioep ./hw_info逻辑说明cap_sys_rawio让普通用户也能执行底层IO请求避免了把整个磁盘的读权限开给所有用户。setcap设置的是文件的扩展属性二进制文件每次更新后需要重新设置。如果你不想引入cap机制也可以把用户加入disk组但这个操作会把整个磁盘暴露给该用户安全风险大我一般只在测试机这么干。5.3 问题三MAC地址拿到的是随机地址现象在一台笔记本上连续运行程序多次发现MAC字段变了重启系统后也变了一开始怀疑是源码包读错缓冲区的偏移量。原因现代操作系统默认开启了无线网卡的MAC随机化。Windows的“随机硬件地址”功能会针对不同Wi-Fi网络生成不同的MACLinux的网络管理服务也有类似功能默认对无线网卡做随机MAC。有线网卡一般不受影响但USB外接网卡在某些发行版下也会被随机化。解决在做机器指纹时不要只取第一个物理网卡的MAC而是把所有物理网卡的MAC收集起来按接口名排序后拼接再哈希。Windows关闭随机硬件地址的开关在网卡属性的“随机硬件地址”里Linux则要看网络管理配置设置cloned-mac-addresspermanent。源码包读取的是操作系统当前生效的MAC这是最诚实的采集方式但如果你要拿它当硬件唯一标识就要接受这个抖动风险这是跑在用户态代码的宿命。5.4 问题四虚拟机里CPU序列号返回全零或固定值现象同一份代码在物理机上输出的CPU序列号各不相同但丢到某台虚拟机里所有克隆出来的虚拟机输出完全相同甚至出现全0。原因虚拟化平台拦截了CPUID指令返回的是宿主机配置或统一模拟的固定值。这不是源码包写错是虚拟化层的正常表现。解决在指纹策略上不要把CPU序列号当作唯一主键。建议把CPU型号字符串和硬盘序列号同时纳入指纹例如将/proc/cpuinfo的model name后8位拼接进指纹。源码包里hw_info_t结构体虽然没有model_name字段但你可以沿用cpu_id字段存型号末尾特征。我做过一个授权系统发版前会专门跑一遍“物理机虚拟机对比脚本”如果指纹完全相同就告警因为大概率采集逻辑触到了虚拟化兼容分支。5.5 问题五网线插入检测在无线网卡上永远返回false现象笔记本拔掉网线后运行程序link_up为0插上网线后还是0只有接USB转网口才正常。原因程序枚举网卡时硬编码了eth0接口名笔记本上实际的物理以太网卡叫enp3s0而wlan0是无线网卡根本没有网线插入状态。源码包里若直接按eth0去找/sys/class/net/eth0/carrier文件不存在就会返回-1上层再把-1误当成断网。解决不要硬编码接口名。先遍历所有物理网卡找到type为1且带device链接的接口再读它的carrier值。判断顺序应该是是不是物理网卡、是不是以太网类型、有没有carrier文件、carrier是不是1。这四步缺一步结果都可能误导成“网线没插”。6. 把这份代码集成进项目三种进阶用法与验证方法源码包本身是一个命令行工具但多数读者是冲着“集成到自己项目”来的。我平时用这份代码时一般会叠加三个技巧。6.1 进阶用法生成机器指纹并做授权绑定把hw_info_fill拿到的四个字段组合成一个字符串再做SHA256得到一段长度固定的指纹。这个指纹适合作为软件授权文件里的机器唯一标识。#include openssl/sha.h void make_fingerprint(const hw_info_t *info, unsigned char digest[32]) { char buf[256]; snprintf(buf, sizeof(buf), %s|%s|%s, info-cpu_id, info-disk_serial, info-mac_address); SHA256((unsigned char *)buf, strlen(buf), digest); }逻辑说明拼接顺序固定是cpu_id、disk_serial、mac_address这个顺序不能改动否则Windows和Linux两个平台拿到相同硬件时也会算出不同指纹。参数说明digest缓冲区必须是32字节调用方拿到后可以再转成64位十六进制字符串用于网络传输。link_up不需要进入指纹因为它是一个动态状态不适合做身份标识。6.2 验证技巧用命令行工具交叉核对每个字段集成之前先手动验证一遍输出是否可信。我的习惯是把源码包运行结果和系统自带命令交叉对比出现不一致先怀疑权限和虚拟化再怀疑代码。字段Windows验证命令Linux验证命令CPU序列号wmic cpu get processoriddmidecode -t processor硬盘序列号wmic diskdrive get serialnumberlsblk --nodeps -o name,serialMAC地址getmac /vip link show网线状态powershell Get-NetAdaptercat /sys/class/net/eth0/carrier看到差异时不要急着改代码。虚拟机的CPU序列号本来就允许全0MAC也可能是随机化的这些都确认过之后才轮到检查自己的解析逻辑。6.3 我的收尾习惯我曾经在一个授权绑定项目里把未过滤的MAC直接当唯一键结果用户换一个Wi-Fi网络就导致授权失效售后被骂了一周。从那以后我每次集成这套代码都会强制走一遍三个动作先在物理机跑一次再在虚拟机跑一次最后用命令行工具逐字段核对。稳定输出三次以上才进CI流程。./hw_info CPU ID: BFEBFBFF000906EA Disk Serial: WD-WCC6Y2RELRY6 MAC: 00:1B:44:11:3A:B7 IP: 192.168.1.100 Link Up: 1上面的输出格式可以直接用来做日志结构化解析CPU ID和Disk Serial在真实机器上不一定满足唯一性但作为指纹因子已经够用。把这段代码跑通之后再去做授权、盘点或者监控告警就会顺手很多希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/15 19:27:38 · 阅读 1.2k C语言跨平台硬件信息采集：CPU序列号、硬盘序列号与MAC地址
简介面向需要获取中央处理器序列号、硬盘序列号、网卡IP地址、MAC地址以及网线插拔状态的系统开发与运维人员这份C语言源码包聚焦Windows和Linux双平台下的硬件信息读取适用于系统监控、设备识别和故障排查等场景。压缩包共2个文件1个头文件与1个C源文件整体仅7KB结构精简头文件声明接口源文件实现具体获取逻辑便于直接阅读和复用。目前已有3099人学习下载对于希望了解操作系统底层接口并快速积累跨平台编程经验的中初级开发者具备不错的参考价值。资源虽小但代码覆盖了Windows下的WMI、网络适配器API以及Linux下通过文件系统解析CPU、磁盘和网卡信息的典型路径并利用条件编译统一平台差异读者可借此掌握两类系统在硬件信息接口上的异同将封装的查询方法直接应用到自己的监控工具或管理脚本中省去查阅大量文档和踩坑的过程。1. 拿到这份C语言硬件信息源码包先搞清楚它能干什么做软件授权绑定时我常需要C语言去采集硬件信息CPU序列号、硬盘序列号、网卡IP、MAC地址、是否插入网线这几个字段在Windows和Linux上各有各的读法。之前在给一家公司做资产盘点时甲方要求两种系统下输出完全一致的格式网上搜到的代码要么只跑通一边要么依赖命令行工具部署的时候很痛苦。这份C语言获取硬件信息源码包解决的就是这个尴尬一套接口、两套实现上层不用关心平台差异。适合做授权绑定、硬件指纹、运维监控的开发者。先说个反直觉结论网线插入检测的坑比CPU序列号多得多代码里那部分值得多看几遍。2. 跨平台方案选型为什么这套代码能在Linux和Windows上跑拿到源码包后我第一件事不是去看每个函数而是看它选了什么读取路径。硬件信息采集最忌讳东拼西凑Windows和Linux的底层机制完全不同如果每读一个字段就套一层命令行做出来的程序就是个黑匣子出了问题根本不知道是哪一步失败。2.1 Windows侧注册表、WMI与底层API的取舍Windows上采集硬件信息常用三条路注册表、WMI、底层API。注册表快但字段分散不同版本的系统注册表路径会变WMI信息齐全但慢而且COM初始化放在纯C工程里非常别扭还要处理代理和权限问题底层API稳定、不依赖服务代价是代码量大、结构体多。这套源码包里Windows侧整体走底层APICPU序列号用CPUID指令硬盘序列号用DeviceIoControl网卡IP和MAC用GetAdaptersAddresses网线插入状态用OperStatus字段。这个选型的好处是编译出的exe可以直接扔到一台干净的机器上跑不需要系统自带WMI服务正常也不需要额外安装工具。#include winsock2.h #include iphlpapi.h #pragma comment(lib, iphlpapi.lib) IP_ADAPTER_ADDRESSES *addresses NULL; ULONG size 0; DWORD rc GetAdaptersAddresses( AF_UNSPEC, GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_MULTICAST, NULL, NULL, size); if (rc ERROR_BUFFER_OVERFLOW) { addresses (IP_ADAPTER_ADDRESSES *)malloc(size); rc GetAdaptersAddresses( AF_UNSPEC, GAA_FLAG_SKIP_ANYCAST | GAA_FLAG_SKIP_MULTICAST, NULL, addresses, size); }这段代码是Windows侧网卡枚举的典型开头。逻辑说明GetAdaptersAddresses第一次调用故意传入NULL缓冲区和0长度让系统把需要的缓冲区大小回写到size当返回值是ERROR_BUFFER_OVERFLOW时再分配真正的内存。参数说明AF_UNSPEC表示同时枚举IPv4和IPv6GAA_FLAG_SKIP_ANYCAST和GAA_FLAG_SKIP_MULTICAST跳过任播和组播地址避免后续处理IP_ADAPTER_UNICAST链表时遇到非单播地址。用#pragma comment(lib, iphlpapi.lib)是把库依赖写进源文件省得在Makefile里再加一行链接参数MinGW和MSVC都认这个写法。2.2 Linux侧/proc、/sys与ioctl的读取路径Linux没有Windows那种统一的设备管理API采集硬件信息要分头找路径。常见套路是CPU信息看/proc/cpuinfo网卡看/sys/class/net硬盘看/sys/block或者直接对设备文件发ioctl。这套源码包没有调用system(lshw)这种外部命令全部用标准C的文件操作和ioctl完成这样部署时不会因为缺少某个命令而直接翻车。static int read_carrier(const char *ifname) { char path[128]; snprintf(path, sizeof(path), /sys/class/net/%s/carrier, ifname); FILE *fp fopen(path, r); if (fp NULL) { return -1; } char buf[8] {0}; if (fgets(buf, sizeof(buf), fp) NULL) { fclose(fp); return -1; } fclose(fp); return buf[0] 1 ? 1 : 0; }这段代码用于Linux网线插入检测。逻辑说明/sys/class/net/{ifname}/carrier是一个文本文件内核网络驱动会在物理链路状态变化时更新它读到字符1表示有载波信号0表示断线读取失败返回-1。参数说明路径中ifname是接口名比如eth0、enp3s0、wlan0。注意fgets的缓冲区只要8字节就够了因为文件内容最多就是一个数字加换行符。为什么要用open/fgets而不是system(cat)因为system会启动一个shell子进程解析路径还要考虑转义而且cat命令不存在时函数会静默失败用文件API至少知道是open权限问题还是读取问题。2.3 编译宏与头文件组织源码包的结构很清晰hw_info.h定义统一结构体hw_info_windows.c写Windows实现hw_info_linux.c写Linux实现main.c是一个命令行示例程序。编译时按平台选择源文件Windows的代码放在条件编译块里。#ifdef _WIN32 #define HW_EXPORT __declspec(dllexport) #else #define HW_EXPORT __attribute__((visibility(default))) #endif typedef struct { char cpu_id[64]; char disk_serial[64]; char mac_address[18]; char ip_address[64]; int link_up; } hw_info_t; HW_EXPORT int hw_info_fill(hw_info_t *info);逻辑说明hw_info_t是上层调用者唯一需要关心的数据结构所有平台差异都被hw_info_fill函数封在里面。字段定长是为了方便结构体跨平台拷贝、写日志、走网络序列化不用每次算字符串长度。参数说明mac_address字段之所以是18字节是因为MAC地址按xx:xx:xx:xx:xx:xx的文本格式存储需要17个字符再加一个结尾符正好18。link_up用int而不是bool是为了表达“不适用”这种第三态无线网卡没有网线插入概念返回值可能是-1。编译命令分别如下。MinGW下编译Windows版本gcc -D_WIN32_WINNT0x0601 -stdgnu11 hw_info_windows.c main.c -o hw_info.exe -liphlpapi逻辑说明-D_WIN32_WINNT0x0601告诉Windows SDK按Windows 7及以上版本的行为编译避免GetAdaptersAddresses的某些字段在旧SDK下被裁剪。-stdgnu11是必要的MinGW的windows.h在使用纯c11标准时会遇到inline语义和额外类型定义的兼容问题。Linux下编译gcc -stdgnu11 hw_info_linux.c main.c -o hw_infoLinux版不需要额外链接库因为getifaddrs和ioctl都是glibc的标准接口。如果改用musl libc编译需要手动加-lutil这在静态编译时会遇到属于另一个话题了。3. CPU序列号与硬盘序列号读取原理和具体实现这两个字段是整个源码包里最“硬”的部分。CPU序列号不是一个官方定义的统一标识不同厂商的实现完全不同硬盘序列号则要绕过操作系统抽象直接和设备对话这两个字段的实现最能体现这份代码的工程取舍。3.1 CPU序列号CPUID指令与寄存器提取先澄清一个概念通常说的CPU序列号在x86平台上来自CPUID指令leaf 1返回值中的一组寄存器组合不同厂商的处理器不保证字段布局一致而且现在很多处理器根本不保证这个值唯一。源码包里的做法是直接执行CPUID leaf 1把EBX、ECX、EDX三个寄存器按固定顺序拼成一个字符串。#include stdint.h #if defined(_MSC_VER) #include intrin.h static void cpu_id_read(uint32_t regs[4]) { __cpuid(regs, 1); } #elif defined(__GNUC__) || defined(__clang__) #include cpuid.h static void cpu_id_read(uint32_t regs[4]) { __cpuid(1, regs[0], regs[1], regs[2], regs[3]); } #endif void get_cpu_serial(char *out, size_t out_len) { uint32_t regs[4] {0}; cpu_id_read(regs); snprintf(out, out_len, %08X%08X%08X, regs[1], regs[2], regs[3]); }逻辑说明__cpuid是编译器提供的intrinsic函数它保存现场后执行CPUID指令再把结果写到regs数组里顺序是EAX、EBX、ECX、EDX。这里只取EBX、ECX、EDX三个寄存器是因为leaf 1的EAX里主要是版本信息比如步进号和型号不适合当序列号。参数说明out_len建议传25因为拼接后的十六进制串是24个字符再加结尾符就是25。这个值在不同架构上可能完全相同比如某些老款低端处理器就不会返回有效序列号所以上层代码千万不要把cpu_id当数据库主键。用/proc/cpuinfo也能拿到类似信息但读/proc/cpuinfo里没有直接叫serial number的字段只有model name、vendor_id这些属性。源码包选择CPUID是为了绕开不同发行版对/proc/cpuinfo格式的二次加工缺点是ARM平台上没有CPUID指令如果要移植到ARM这段代码必须增加__x86_64__或__i386__编译判断否则直接编译失败。3.2 硬盘序列号Windows的DeviceIoControl与Linux的ioctlWindows侧读硬盘序列号用的是DeviceIoControl向存储驱动发送IOCTL_STORAGE_QUERY_PROPERTY控制码拿到一块描述符再从描述符的偏移位置拷贝序列号字符串。我一般会把这块逻辑单独抽出来因为它比想象中容易踩越界漏洞。#include windows.h #include winioctl.h void get_disk_serial_windows(char *serial, size_t cap) { HANDLE h CreateFileA(\\\\.\\PhysicalDrive0, 0, FILE_SHARE_READ | FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, NULL); if (h INVALID_HANDLE_VALUE) { snprintf(serial, cap, N/A); return; } STORAGE_PROPERTY_QUERY q; memset(q, 0, sizeof(q)); q.PropertyId StorageDeviceProperty; q.QueryType PropertyStandardQuery; STORAGE_DEVICE_DESCRIPTOR desc; memset(desc, 0, sizeof(desc)); DWORD returned 0; BOOL ok DeviceIoControl(h, IOCTL_STORAGE_QUERY_PROPERTY, q, sizeof(q), desc, sizeof(desc), returned, NULL); CloseHandle(h); if (!ok || desc.SerialNumberOffset 0) { snprintf(serial, cap, N/A); return; } char *p (char *)(void *)desc desc.SerialNumberOffset; snprintf(serial, cap, %s, p); }逻辑说明创建硬盘句柄用的是\\.\PhysicalDrive0这个设备路径代表第一块物理硬盘而不是C盘这种分区路径。使用CreateFileA时访问权限传0表示只想查询设备信息不想读写数据。参数说明FILE_SHARE_READ | FILE_SHARE_WRITE是共享参数如果其他进程已独占打开硬盘这个句柄仍然可能创建失败。desc.SerialNumberOffset是序列号在描述符结构体里的字节偏移不是指针所以取地址时要加偏移。这里有一个很隐蔽的问题STORAGE_DEVICE_DESCRIPTOR有不同版本部分厂商驱动返回的序列号是UTF-16编码直接按%s打印会得到乱码碰到这种情况需要根据desc版本字段做字符集转换源码包里保留了ASCII处理分支我在实际项目中遇到过一次已经单独加了宽字符处理。Linux侧对应的是hdparm那一套ioctl接口。源码包里用的是HDIO_GET_IDENTITY对SATA硬盘有效对NVMe固态无效因为NVMe走的不是ATA命令集。#include fcntl.h #include linux/hdreg.h #include sys/ioctl.h void get_disk_serial_linux(char *serial, size_t cap) { int fd open(/dev/sda, O_RDONLY | O_NONBLOCK); if (fd 0) { snprintf(serial, cap, N/A); return; } struct hd_driveid id; memset(id, 0, sizeof(id)); if (ioctl(fd, HDIO_GET_IDENTITY, id) 0) { snprintf(serial, cap, %s, (char *)id.serial_no); } else { snprintf(serial, cap, N/A); } close(fd); }逻辑说明open(/dev/sda, O_RDONLY | O_NONBLOCK)打开第一块SATA硬盘O_NONBLOCK避免设备忙时阻塞。hd_driveid结构体里的serial_no字段是20字节的ASCII字符数组但里面可能带尾部空格snprintf之后最好再做一次trim。参数说明如果机器是NVMe固态并且没有SATA盘/dev/sda可能不存在open会失败。源码包里有一个判断分支检查/sys/block/nvme0n1/device/serial这个文件的内容就是NVMe盘的序列号读取方式和carrier类似用fgets即可。结构体hd_driveid关联到linux/hdreg.h头文件只有内核源码头完整时才能编译嵌入式交叉编译环境里经常缺这个头文件需要手工从内核头目录补充。3.3 返回值统一封装把平台差异藏在接口后面前面两段代码分别出现在hw_info_windows.c和hw_info_linux.c里调用方只认hw_info_fill这一个入口。我最初自己写这类程序时犯过一个错把平台判断散落在各个调用点结果main函数里全是ifdef可读性非常差。这份源码包的做法是把平台判断集中在hw_info_fill一个函数里。int hw_info_fill(hw_info_t *info) { memset(info, 0, sizeof(hw_info_t)); #if defined(_WIN32) get_cpu_serial_windows(info-cpu_id, sizeof(info-cpu_id)); get_disk_serial_windows(info-disk_serial, sizeof(info-disk_serial)); get_network_info_windows(info); #else get_cpu_serial_linux(info-cpu_id, sizeof(info-cpu_id)); get_disk_serial_linux(info-disk_serial, sizeof(info-disk_serial)); get_network_info_linux(info); #endif return 0; }逻辑说明每个平台子函数只负责把自己负责的字段填进info结构体填不出来的写N/A。调用方不需要知道当前是Windows还是Linux只需要在拿到hw_info_t之后按照四个字符串字段使用。参数说明sizeof(info-cpu_id)这种写法比直接传64更安全万一以后结构体字段长度调整这里的参数会自动跟随。注意这个函数内部做的是阻塞式IO硬盘设备不存在时open可能要等几百毫秒放到GUI线程里会卡界面放到工作线程里更合适。4. 网卡IP、MAC地址和网线插入检测这块才是真正的坑如果CPU和硬盘两块是硬功夫那网卡部分就是玄学现场。IP和MAC的读取本身不难难的是搞清楚哪块网卡是“物理存在的、当前正在用”的那一个。Windows的虚拟网卡、Linux的虚拟接口、无线网卡的随机MAC任何一个都能让原本正常的采集程序输出错误结果。4.1 IP与MACgetifaddrs与GetAdaptersAddresses的对应关系Windows下最上层的API是GetAdaptersAddresses它返回的适配器列表里包含IPv4、IPv6、MAC、OperStatus这些字段一口气全拿到了。GetAdaptersInfo是老一代API只有IPv4但结构简单很多老代码里还在用。这个源码包里实际用的是GetAdaptersAddresses因为它能同时拿到OperStatus。#include winsock2.h #include iphlpapi.h void get_network_info_windows(hw_info_t *info) { ULONG size 0; IP_ADAPTER_ADDRESSES *addrs NULL; DWORD rc GetAdaptersAddresses(AF_INET, GAA_FLAG_SKIP_ANYCAST, NULL, NULL, size); if (rc ! ERROR_BUFFER_OVERFLOW) return; addrs (IP_ADAPTER_ADDRESSES *)malloc(size); rc GetAdaptersAddresses(AF_INET, GAA_FLAG_SKIP_ANYCAST, NULL, addrs, size); if (rc ! NO_ERROR) { free(addrs); return; } for (IP_ADAPTER_ADDRESSES *p addrs; p ! NULL; p p-Next) { if (p-IfType ! IF_TYPE_ETHERNET_CSMACD) continue; if (p-OperStatus ! IfOperStatusUp) continue; snprintf(info-mac_address, sizeof(info-mac_address), %02X-%02X-%02X-%02X-%02X-%02X, p-PhysicalAddress[0], p-PhysicalAddress[1], p-PhysicalAddress[2], p-PhysicalAddress[3], p-PhysicalAddress[4], p-PhysicalAddress[5]); break; } free(addrs); }逻辑说明GetAdaptersAddresses同样遵循先查询大小再分配缓冲区的模式。AF_INET让枚举范围缩到IPv4IfType等于IF_TYPE_ETHERNET_CSMACD表示是以太网卡类型OperStatus等于IfOperStatusUp表示当前物理链路已连接这两个条件组合在一起才能保证选中的是真正插着网线的以太网网卡而不是回环或虚拟设备。参数说明PhysicalAddress字段是6字节原始MAC格式化时我用减号分隔你也可以改成冒号但要注意和Linux侧保持一致否则同一套数据结构在两种平台上打出不同格式的MAC后续做字符串比对会非常难受。Linux侧对应的是getifaddrs它会返回系统所有网络接口的地址信息。要拿到MAC必须等AF_PACKET地址族出现用sockaddr_ll结构体里的sll_addr字段。#include ifaddrs.h #include netpacket/packet.h #include net/if.h void get_network_info_linux(hw_info_t *info) { struct ifaddrs *addrs NULL; if (getifaddrs(addrs) ! 0) return; for (struct ifaddrs *ifa addrs; ifa ! NULL; ifa ifa-ifa_next) { if (ifa-ifa_addr NULL) continue; if (ifa-ifa_addr-sa_family ! AF_PACKET) continue; struct sockaddr_ll *ll (struct sockaddr_ll *)ifa-ifa_addr; snprintf(info-mac_address, sizeof(info-mac_address), %02x:%02x:%02x:%02x:%02x:%02x, ll-sll_addr[0], ll-sll_addr[1], ll-sll_addr[2], ll-sll_addr[3], ll-sll_addr[4], ll-sll_addr[5]); break; } freeifaddrs(addrs); }逻辑说明getifaddrs返回链表里每个节点的ifa_addr指向一个sockaddrsa_family是AF_PACKET时这个地址就是链路层地址也就是MAC。参数说明sll_addr的前6字节是MAC地址后8字节可能是填充或者vlan标签不要直接全量打印。注意这个循环没有过滤lo和docker0实际使用时要加上接口名过滤否则第一次循环可能抓到lo的00:00:00:00:00:00看起来就像拿不到MAC一样。之所以把过滤条件放在后面一小节单独讲是因为这个过滤逻辑在Windows和Linux两侧的名字完全不同混在一起写连我自己都会绕晕。4.2 网线插入检测连接状态标志位在不同平台的差异先看Windows这边。GetAdaptersAddresses返回的每个IP_ADAPTER_ADDRESSES节点里都有OperStatus字段有经验的开发者会直接用IfOperStatusUp判断但新手经常把GetAdaptersInfo里的Address列表长度当作连接状态这是不对的。Address列表只表示网卡配置了IP地址不代表网线插着。比如一台台式机网卡用了固定IP但物理网线没插GetAdaptersInfo照样能返回IP_ADAPTER_INFOOperStatus却是IfOperStatusDown。if (p-OperStatus IfOperStatusUp) { info-link_up 1; } else if (p-OperStatus IfOperStatusDown) { info-link_up 0; } else { info-link_up -1; }逻辑说明OperStatus是操作状态不是管理状态。Windows的网络适配器属性里如果手动禁用了网卡OperStatus会是IfOperStatusDown物理断开也是IfOperStatusDown。源码包的link_up用三态就是为了区分“知道它断着”和“不知道具体断没断”。实际上还有IfOperStatusTesting这种中间状态遇到它时置为-1比较诚实。这一块代码在Windows下有多个版本差异老SDK里OperStatus字段可能不存在编译时如果报错把_WIN32_WINNT提到0x0601再看一遍。Linux侧前面已经给出了carrier读取函数这里要补充的是“读不到”的分支处理。虚拟网卡和无线网卡的carrier含义不同。无线网卡连接Wi-Fi时carrier为1但那是无线信号不是网线所以“是否插入网线”这个需求如果落在无线网卡上压根就没有对应的物理量。源码包的处理方式是先判断接口类型如果是无线设备link_up直接置-1。char type_path[128]; snprintf(type_path, sizeof(type_path), /sys/class/net/%s/type, ifname); FILE *fp fopen(type_path, r);逻辑说明/sys/class/net/{ifname}/type文件里存放的是ARP硬件类型值1代表以太网设备其他值代表无线、令牌环等。只有当type为1且carrier存在时把carrier的读取结果当作网线状态才有意义。参数说明读出来的type是一个十进制字符串建议用strtol转换而不是直接比较字符因为内核未来可能用多位数。注意carrier文件的内容只有0和1两个字符读取时不要用fscanf的%s因为换行符会留在缓冲区里用fgets最稳。4.3 场景判定虚拟网卡、蓝牙适配器怎么过滤这部分是网卡采集里最需要耐心的地方。虚拟机和容器技术会创建大量虚拟接口比如Windows的虚拟网卡、Hyper-V虚拟适配器Linux的docker0、veth、br-这些名称。过滤逻辑如果太严格会把实际物理网卡也过滤掉太宽松又会抓到一堆无意义地址。static int is_physical_netdev(const char *name) { if (strncmp(name, lo, 2) 0) return 0; if (strncmp(name, docker, 6) 0) return 0; if (strncmp(name, veth, 4) 0) return 0; if (strncmp(name, br-, 3) 0) return 0; if (strncmp(name, vmnet, 5) 0) return 0; char path[192]; snprintf(path, sizeof(path), /sys/class/net/%s/device, name); struct stat st; if (stat(path, st) 0) return 1; return 0; }逻辑说明/sys/class/net/{name}/device这个符号链接只有物理设备才存在虚拟接口没有对应的设备节点。stat函数判断链接是否存在存在就认为是物理网卡。参数说明接口名前缀过滤是一个保险动作因为部分老内核可能没有device链接。Windows侧对应的过滤字段是适配器的Description或FriendlyName常见包含Virtual、VMware、Hyper-V、TAP、Loopback关键词的适配器都要排除。代码里我习惯把“是否物理设备”和“是否有真实链路”拆成两个判断因为物理无线网卡也走同样的设备路径但它没有网线插入状态。5. 编译运行避坑指南我踩过的五个典型问题这份源码包整体结构不复杂但编译和运行环节的坑比读代码时看到的要多。下面几条是我在模拟项目X里复现时踩过的每一条都先写现象再写原因最后给出解决方式。5.1 问题一Windows下MinGW编译报错“unknown type name DWORD”现象在某一台Windows机器上用MinGW跑gcc编译刚拉到hw_info_windows.c就报错说DWORD未定义一长串红色报错看得人头皮发麻。原因代码里用了windows.h定义的DWORD但编译时头文件包含顺序不对或者是用了-stdc11。MinGW的windows.h在纯C11模式下会对部分定义做裁剪导致winsock2.h里的DWORD和UINT类型解析失败。解决把#include windows.h放到所有头文件最前面编译标准从-stdc11改成-stdgnu11。gnu11允许GNU C扩展语法和声明MinGW的SDK头文件按GNU模式编译时能正常展开那些宏定义。gcc -D_WIN32_WINNT0x0601 -stdgnu11 hw_info_windows.c main.c -o hw_info.exe -liphlpapi这个命令里的_WIN32_WINNT也不能省它决定了你用的SDK里有几个新字段可用比如IP_ADAPTER_ADDRESSES的OperStatus。不定义这个宏时MSVC默认按Windows 2003的API行为编译OperStatus字段会被裁剪掉运行时会报内存越界。5.2 问题二Linux下获取硬盘序列号需要root权限现象普通用户在Linux上运行编译好的hw_infoCPU序列号和MAC都正常打印唯独硬盘序列号输出N/A。原因/dev/sda默认设备节点权限是root:disk普通用户没有读权限。open函数直接返回Permission denied后面的ioctl根本没有机会执行。这是个权限黑匣子不是代码逻辑坏了。解决开发调试阶段用sudo运行正式部署时给二进制增加cap_sys_rawio能力sudo setcap cap_sys_rawioep ./hw_info逻辑说明cap_sys_rawio让普通用户也能执行底层IO请求避免了把整个磁盘的读权限开给所有用户。setcap设置的是文件的扩展属性二进制文件每次更新后需要重新设置。如果你不想引入cap机制也可以把用户加入disk组但这个操作会把整个磁盘暴露给该用户安全风险大我一般只在测试机这么干。5.3 问题三MAC地址拿到的是随机地址现象在一台笔记本上连续运行程序多次发现MAC字段变了重启系统后也变了一开始怀疑是源码包读错缓冲区的偏移量。原因现代操作系统默认开启了无线网卡的MAC随机化。Windows的“随机硬件地址”功能会针对不同Wi-Fi网络生成不同的MACLinux的网络管理服务也有类似功能默认对无线网卡做随机MAC。有线网卡一般不受影响但USB外接网卡在某些发行版下也会被随机化。解决在做机器指纹时不要只取第一个物理网卡的MAC而是把所有物理网卡的MAC收集起来按接口名排序后拼接再哈希。Windows关闭随机硬件地址的开关在网卡属性的“随机硬件地址”里Linux则要看网络管理配置设置cloned-mac-addresspermanent。源码包读取的是操作系统当前生效的MAC这是最诚实的采集方式但如果你要拿它当硬件唯一标识就要接受这个抖动风险这是跑在用户态代码的宿命。5.4 问题四虚拟机里CPU序列号返回全零或固定值现象同一份代码在物理机上输出的CPU序列号各不相同但丢到某台虚拟机里所有克隆出来的虚拟机输出完全相同甚至出现全0。原因虚拟化平台拦截了CPUID指令返回的是宿主机配置或统一模拟的固定值。这不是源码包写错是虚拟化层的正常表现。解决在指纹策略上不要把CPU序列号当作唯一主键。建议把CPU型号字符串和硬盘序列号同时纳入指纹例如将/proc/cpuinfo的model name后8位拼接进指纹。源码包里hw_info_t结构体虽然没有model_name字段但你可以沿用cpu_id字段存型号末尾特征。我做过一个授权系统发版前会专门跑一遍“物理机虚拟机对比脚本”如果指纹完全相同就告警因为大概率采集逻辑触到了虚拟化兼容分支。5.5 问题五网线插入检测在无线网卡上永远返回false现象笔记本拔掉网线后运行程序link_up为0插上网线后还是0只有接USB转网口才正常。原因程序枚举网卡时硬编码了eth0接口名笔记本上实际的物理以太网卡叫enp3s0而wlan0是无线网卡根本没有网线插入状态。源码包里若直接按eth0去找/sys/class/net/eth0/carrier文件不存在就会返回-1上层再把-1误当成断网。解决不要硬编码接口名。先遍历所有物理网卡找到type为1且带device链接的接口再读它的carrier值。判断顺序应该是是不是物理网卡、是不是以太网类型、有没有carrier文件、carrier是不是1。这四步缺一步结果都可能误导成“网线没插”。6. 把这份代码集成进项目三种进阶用法与验证方法源码包本身是一个命令行工具但多数读者是冲着“集成到自己项目”来的。我平时用这份代码时一般会叠加三个技巧。6.1 进阶用法生成机器指纹并做授权绑定把hw_info_fill拿到的四个字段组合成一个字符串再做SHA256得到一段长度固定的指纹。这个指纹适合作为软件授权文件里的机器唯一标识。#include openssl/sha.h void make_fingerprint(const hw_info_t *info, unsigned char digest[32]) { char buf[256]; snprintf(buf, sizeof(buf), %s|%s|%s, info-cpu_id, info-disk_serial, info-mac_address); SHA256((unsigned char *)buf, strlen(buf), digest); }逻辑说明拼接顺序固定是cpu_id、disk_serial、mac_address这个顺序不能改动否则Windows和Linux两个平台拿到相同硬件时也会算出不同指纹。参数说明digest缓冲区必须是32字节调用方拿到后可以再转成64位十六进制字符串用于网络传输。link_up不需要进入指纹因为它是一个动态状态不适合做身份标识。6.2 验证技巧用命令行工具交叉核对每个字段集成之前先手动验证一遍输出是否可信。我的习惯是把源码包运行结果和系统自带命令交叉对比出现不一致先怀疑权限和虚拟化再怀疑代码。字段Windows验证命令Linux验证命令CPU序列号wmic cpu get processoriddmidecode -t processor硬盘序列号wmic diskdrive get serialnumberlsblk --nodeps -o name,serialMAC地址getmac /vip link show网线状态powershell Get-NetAdaptercat /sys/class/net/eth0/carrier看到差异时不要急着改代码。虚拟机的CPU序列号本来就允许全0MAC也可能是随机化的这些都确认过之后才轮到检查自己的解析逻辑。6.3 我的收尾习惯我曾经在一个授权绑定项目里把未过滤的MAC直接当唯一键结果用户换一个Wi-Fi网络就导致授权失效售后被骂了一周。从那以后我每次集成这套代码都会强制走一遍三个动作先在物理机跑一次再在虚拟机跑一次最后用命令行工具逐字段核对。稳定输出三次以上才进CI流程。./hw_info CPU ID: BFEBFBFF000906EA Disk Serial: WD-WCC6Y2RELRY6 MAC: 00:1B:44:11:3A:B7 IP: 192.168.1.100 Link Up: 1上面的输出格式可以直接用来做日志结构化解析CPU ID和Disk Serial在真实机器上不一定满足唯一性但作为指纹因子已经够用。把这段代码跑通之后再去做授权、盘点或者监控告警就会顺手很多希望帮到你。本文还有配套的精品资源点击获取