🚀 Masowy import użytkowników do Nextclouda z CSV + przypisanie do grup (wersja shellowa)

Ilustracja: uśmiechnięty mężczyzna macha do awatarów spadających na spadochronach w stronę logo Nextclouda

🌐 Także w: English · Deutsch · Français · Español · Italiano · Português · Nederlands

Masz więc instancję Nextclouda i chcesz tworzyć użytkowników hurtowo jak prawdziwy sysadmin? Oto rozwiązanie oparte wyłącznie na shellu, które tworzy użytkowników z pliku CSV, przypisuje ich do grup (nawet do kilku naraz) i pozwala ci przy tym poczuć się jak szef.

📦 Wymagania

  • Dostęp SSH do twojego serwera Nextcloud
  • Dostęp z wiersza poleceń do occ (znajduje się w katalogu głównym instalacji Nextclouda, np. /var/www/html/nextcloud)
  • Gotowy plik CSV

📄 Format pliku CSV

Bez nagłówków, same dane. Format:

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

Przykład:

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

🛠️ Skrypt 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>

⚙️ Użycie

chmod +x create_users_with_groups.sh
./create_users_with_groups.sh

Upewnij się, że plik benutzer.csv leży w tym samym katalogu, albo odpowiednio zmień ścieżkę.

🔐 Uwagi

  • Hasła są przekazywane bezpiecznie przez zmienne środowiskowe – nie przez wiersz poleceń ani stdin
  • Grupy są tworzone automatycznie, jeśli jeszcze nie istnieją
  • Średnik (;) oddziela kilka grup jednego użytkownika

🧠 Dodatkowa wskazówka

Chcesz wejść w tryb pełnej automatyzacji? Zintegruj to ze skryptami onboardingu użytkowników albo zakładaj użytkowników przez LDAP, a tego używaj tylko do kont niestandardowych lub tymczasowych.

🫡 Odblokowano chwałę sysadmina

To wszystko – twoi użytkownicy są już aktywni, pogrupowani i gotowi korzystać z Nextclouda jak zawodowcy. Chcesz skonfigurować Group Folders i zastosować reguły uprawnień? Daj znać – w to też chętnie się wgryzę.

Część tekstów i obrazów na tej stronie powstała z pomocą AI lub została wygenerowana przez AI. Szczegóły