订阅SDK

在使用SDK之前，用户需要采集自己的服务器Mac地址，并订阅对应产品的SDK套餐。

服务器Mac地址采集

1. Linux系统查找Mac地址

执行以下命令：

ip link show

在输出中，你会看到类似如下的行：

2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP mode DEFAULT group default qlen 1000
    link/ether 08:00:27:3f:7c:56 brd ff:ff:ff:ff:ff:ff

其中 link/ether 08:00:27:3f:7c:56 就是 MAC 地址。

2. Windows Server系统查找Mac地址

在CMD命令界面中执行执行以下命令：

ipconfig /all

在输出结果中，找到网络适配器部分（例如，以太网适配器或无线局域网适配器），MAC 地址通常标为“物理地址”。

3. Mac地址注意事项

由于一台服务器有多个Mac地址，所以匹配到其中一个即验证成功，但不包括以下三种情况的Mac地址：

1. 不支持回环地址的Mac地址，即00:00:00:00:00:00，linux会显示回环地址，通常windows不会显示

2. 不支持网卡状态为DOWN的Mac地址，需要是UP状态；windows的ipconfig /all命令不显示禁用的网卡

3. 不支持虚拟网卡的Mac地址，如：Docker、VMware等，在容器中使用SDK请参考“容器中使用SDK”。

4. 容器中使用SDK

在容器环境（Docker、Kubernetes 等）中，默认无法获取宿主机的真实 MAC 地址，需要设置让容器共享宿主机的网络命名空间

Docker 示例：

docker run --net=host your-app-image

Kubernetes Pod 示例：

apiVersion: v1 
kind: Pod metadata:
   name: your-app spec:
   hostNetwork: true # 共享宿主机的网络命名空间
   containers:
   - name: app
     image: your-app-image

在 Kubernetes 集群中，Pod 可能被调度到任意节点运行，而每个节点的 MAC 地址不同，导致基于 MAC 地址的 SDK 授权验证失败。可通过 节点亲和性（Node Affinity） 或 污点容忍（Tolerations），确保 Pod 始终调度到同一台物理机。