getent 命令详解：为什么部署脚本都爱用它做幂等检查

1
2
3

if ! getent group docker &>/dev/null; then
    groupadd docker
fi

1
2
3
4

# /etc/nsswitch.conf 示例
passwd: files sss ldap
group:  files sss ldap
hosts:  files dns

1
2
3
4

# ❌ 危险写法
if ! grep -q "^appuser:" /etc/passwd; then
    useradd appuser
fi

1
2
3
4

# ✅ 安全写法
if ! getent passwd appuser &>/dev/null; then
    useradd appuser
fi

1

getent database key [key ...]

1
2
3
4
5
6
7
8

$ getent passwd root
root:x:0:0:root:/root:/bin/bash

$ getent group docker
docker:x:998:

$ getent services ssh
ssh               22/tcp

1
2
3
4
5
6

if ! getent passwd appuser &>/dev/null; then
    useradd -r -s /sbin/nologin -d /var/lib/app appuser
    echo "[FIX] appuser 已创建"
else
    echo "[PASS] appuser 已存在"
fi

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

if ! getent group appgroup &>/dev/null; then
    groupadd -r appgroup
    echo "[FIX] appgroup 已创建"
else
    echo "[PASS] appgroup 已存在"
fi

# 添加成员（idempotent：已在组中则静默跳过）
usermod -aG appgroup appuser
echo "[PASS] appuser 已加入 appgroup"

1
2
3
4
5
6

if ! getent services myservice &>/dev/null; then
    echo "9090/tcp    myservice" >> /etc/services
    echo "[FIX] myservice 端口已注册"
else
    echo "[PASS] myservice 端口已注册"
fi

1
2
3
4
5
6

REQUIRED_USERS=(nginx postgres redis)
for user in "${REQUIRED_USERS[@]}"; do
    if ! getent passwd "$user" &>/dev/null; then
        echo "[WARN] 缺少用户: $user"
    fi
done

1
2
3

$ getent shadow root
# 普通用户执行无输出，退出码为 1
# 必须 sudo 或 root 身份执行

1
2
3
4
5

# 不带 key 参数 = 枚举整个数据库
getent passwd    # 列出所有用户

# ⚠️ 在 LDAP/AD 环境中可能返回数万条记录
# 生产脚本中永远不要无条件枚举

1
2

# 如果存在同名用户（不同数据源），只返回优先级最高的那条
# 这与 nsswitch.conf 中的配置顺序一致

1
2
3
4
5
6
7

# ❌ 性能差：每次 fork 一个进程
for uid in $(seq 1000 2000); do
    getent passwd "$uid" &>/dev/null && echo "$uid exists"
done

# ✅ 一次性枚举 + 内存过滤
getent passwd | awk -F: '$3 >= 1000 && $3 <= 2000 {print $3}'