K8s Pod内创建TUN接口报错：ioctl(tunsetiff): 设备或资源忙

问题背景 #

我需要在Kubernetes Pod内创建TUN接口，实现两个Pod通过TUN接口通信（Pod内运行的UERANSIM应用依赖该通信方式）。具体配置如下：

• 使用包含UERANSIM编译环境的Dockerfile构建镜像
• 通过Helm部署Pod，Deployment已开启特权模式并添加NET_ADMIN权限
• 启动脚本entrypoint.sh负责创建TUN接口、配置IP及开启IP转发

Pod启动后日志出现以下报错，随后进入CrashLoopBackOff状态：

ioctl(TUNSETIFF): Device or resource busy
RTNETLINK answers: File exists

已尝试的排查操作 #

• 检查Worker节点，仅存在K8s默认配置的TUN设备
• 跳过启动阶段脚本，Pod创建后手动执行脚本，TUN接口仍无法正常创建
• 确认Worker节点资源充足，无其他占用资源的Pod

解决方案 #

1. 移除主机TUN设备的挂载配置 #

如果Deployment中误将主机的/dev/net/tun以hostPath方式挂载到Pod内，会导致多个Pod争抢同一个物理设备。检查你的Deployment YAML，删除类似以下的挂载配置：

volumes:
- name: tun-device
  hostPath:
    path: /dev/net/tun

特权模式下的Pod无需挂载主机TUN设备，可自行在容器内创建独立的TUN接口。

2. 修改启动脚本，避免重复操作 #

脚本未检查TUN接口是否已存在就重复创建，会触发资源占用报错。更新entrypoint.sh的逻辑：

#!/bin/bash
TUN_IF="tun0"
TUN_IP="10.0.0.1/24"

# 检查TUN接口是否已存在
if ! ip link show "$TUN_IF" > /dev/null 2>&1; then
    # 创建TUN接口
    ip tuntap add dev "$TUN_IF" mode tun
    if [ $? -ne 0 ]; then
        echo "Failed to create TUN interface $TUN_IF"
        exit 1
    fi
fi

# 检查IP是否已配置
if ! ip addr show "$TUN_IF" | grep -q "$TUN_IP"; then
    ip addr add "$TUN_IP" dev "$TUN_IF"
    ip link set "$TUN_IF" up
fi

# 开启IP转发
echo 1 > /proc/sys/net/ipv4/ip_forward

# 启动UERANSIM应用
exec your-ueransim-command-here

3. 确认Worker节点TUN模块状态 #

登录Worker节点执行以下命令，确保TUN模块正常加载且权限正确：

# 检查TUN模块是否加载
lsmod | grep tun
# 未加载则手动加载
modprobe tun
# 检查设备权限
ls -l /dev/net/tun

确保输出中tun模块存在，且/dev/net/tun的权限为crw-rw-rw-（所有者root:root）。

4. 关闭不必要的主机网络共享 #

如果Deployment中设置了hostNetwork: true，Pod会共享主机的网络命名空间，多个Pod创建TUN接口时会冲突。若无需主机网络，删除该配置：

# 移除以下配置
hostNetwork: true

5. 排查UERANSIM自身的TUN配置 #

UERANSIM部分组件自带自动创建TUN接口的逻辑，若你的脚本和程序重复创建同一接口会导致冲突。检查UERANSIM的配置文件（如gnb.conf或ue.conf），若存在自动创建TUN的配置项，注释掉脚本中对应的创建步骤。

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