🚀 Importação em massa de usuários no Nextcloud via CSV + atribuição de grupos (edição shell)

Ilustração: um homem sorridente acenando para avatares que descem de paraquedas em direção a um logo do Nextcloud

🌐 Também em: English · Deutsch · Français · Español · Italiano · Nederlands · Polski

Então você roda uma instância do Nextcloud e quer criar usuários em lote como um sysadmin de verdade? Aqui está uma solução puramente em shell para criar usuários a partir de um arquivo CSV, atribuí-los a grupos (até a vários) e se sentir o chefe enquanto faz isso.

📦 Pré-requisitos

  • Acesso SSH ao seu servidor Nextcloud
  • Acesso via linha de comando ao occ (fica na raiz da sua instalação do Nextcloud, p. ex. /var/www/html/nextcloud)
  • Seu arquivo CSV pronto para usar

📄 Formato do arquivo CSV

Sem cabeçalhos, só dados puros. Formato:

username,password,Display Name,Group1;Group2;Group3

Exemplo:

next001,secret123,Max Mustermann,Vorstand;Mitglieder
next002,test456,Lisa Beispiel,Trainer
next003,pass789,Peter Test,Trainer;Mitglieder

🛠️ O script Bash: create_users_with_groups.sh

<#!/bin/bash

CSV_FILE="benutzer.csv"  # Path to your CSV file

cd /var/www/html/nextcloud || exit 1

# Read file line by line
while IFS=',' read -r username password displayname groups_raw; do

    # Skip empty or malformed lines
    if [[ -z "$username" || -z "$password" || -z "$displayname" ]]; then
        echo "⚠️  Skipping invalid or empty line: $username, $displayname"
        continue
    fi

    echo "▶️ Creating user: $username ($displayname)"

    # Export password into environment
    export OC_PASS="$password"

    # Use -E to preserve environment for www-data
    sudo -E -u www-data php occ user:add --password-from-env "$username" --display-name "$displayname"
    USER_EXISTS=$?

    if [ $USER_EXISTS -ne 0 ]; then
        echo "❌ Failed to create user '$username'. Skipping group assignment."
        continue
    fi

    # Split group list on semicolon (;) and trim whitespace
    IFS=';' read -ra groups <<< "$groups_raw" for group in "${groups[@]}"; do group=$(echo "$group" | xargs) # Trim spaces if [ -n "$group" ]; then echo " ➕ Adding $username to group '$group'" # Create group if not already existing (ignore stderr) sudo -u www-data php occ group:add "$group" 2>/dev/null

            # Add user to group
            sudo -u www-data php occ group:adduser "$group" "$username"
        fi
    done

done < "$CSV_FILE"/code>

⚙️ Uso

chmod +x create_users_with_groups.sh
./create_users_with_groups.sh

Garanta que o seu arquivo benutzer.csv esteja no mesmo diretório ou ajuste o caminho.

🔐 Observações

  • As senhas são passadas com segurança por variáveis de ambiente – não pela linha de comando nem pelo stdin
  • Os grupos são criados automaticamente se ainda não existirem
  • O ponto e vírgula (;) separa vários grupos por usuário

🧠 Dica bônus

Quer partir para o modo automação total? Integre isso a scripts de onboarding de usuários, ou provisione seus usuários via LDAP e use isto só para contas personalizadas ou temporárias.

🫡 Glória de sysadmin desbloqueada

É isso – seus usuários agora estão ativos, agrupados e prontos para usar o Nextcloud como profissionais. Quer configurar Group Folders e aplicar regras de permissão? Me chama – eu nerdo isso também.

Alguns textos e imagens deste site foram criados com a ajuda de IA ou gerados por IA. Detalhes