usermod 是修改現有用戶帳號屬性的核心命令,支援修改 UID、GID、家目錄、Shell、帳號名、有效期、鎖定/解鎖等操作。本文整理完整參數表與常用場景實例。
usermod [選項] 登入名
| 參數 | 長選項 | 說明 |
|---|---|---|
-c | --comment | 修改備註(通常為真實姓名) |
-d | --home | 修改家目錄(需配合 -m 遷移現有文件) |
-e | --expiredate | 帳號過期日期(YYYY-MM-DD) |
-f | --inactive | 密碼過期後幾天鎖定帳號(-1=永不鎖定) |
-g | --gid | 修改主群組(GID 或群組名) |
-G | --groups | 修改附加群組(逗號分隔,覆蓋原有) |
-a | --append | 配合 -G 使用,將群組追加而非覆蓋 |
-l | --login | 修改登入名(用戶必須離線) |
-L | --lock | 鎖定密碼(在 /etc/shadow 密碼前加 !) |
-U | --unlock | 解除密碼鎖定 |
-s | --shell | 修改登入 Shell(如 /bin/bash, /sbin/nologin) |
-u | --uid | 修改 UID(用戶必須無運行進程) |
-m | --move-home | 配合 -d 將舊家目錄內容移至新目錄 |
-p | --password | 直接設定加密後密碼(極不推薦,明文風險) |
usermod -aG docker,wheel developer
關鍵:必須加 -a,否則 -G 會覆蓋原有附加群組。
usermod -l newname oldname
前提:用戶無任何運行進程(含 cron、screen、ssh session)。
usermod -L hacker # 禁止密碼登入
usermod -U hacker # 恢復登入
鎖定僅影響密碼認證,SSH 金鑰登入仍可能生效,建議同時 usermod -s /sbin/nologin。
usermod -d /home/newdir -m username
# 1. 確認無進程
pgrep -u olduser
# 2. 修改 UID
usermod -u 2000 olduser
# 3. 同步文件所有權
find / -user 1000 -exec chown -h 2000 {} \;
# (1000 為舊 UID,2000 為新 UID)
chown 文件系統殘留舊 ID 的文件crontab、at 作業、ssh authorized_keys 權限/etc/passwd:用戶基本資訊/etc/shadow:加密密碼與過期策略/etc/group、/etc/gshadow:群組資訊/etc/login.defs:創建用戶預設值