SMB/CIFS-Speicher

Übersicht

Der SMB-Speicheranbieter ermöglicht Dateioperationen auf unternehmensintenen Netzwerkdateifreigaben. Unterstützt SMB 2.x und 3.x mit Windows-Domänenauthentifizierung.

Voraussetzungen

• SMB-Dateiserver (Windows Server, Samba oder NAS-Gerät)
• Netzwerkzugriff auf den SMB-Port (445)
• Gültige Anmeldeinformationen (Benutzername, Passwort, optionale Domäne)

Server-Setup

Windows Server

1. Öffnen Sie Server-Manager > File and Storage Services > Shares
2. Klicken Sie auf Tasks > New Share > SMB Share - Quick
3. Konfigurieren Sie Freigabename und -pfad
4. Legen Sie NTFS- und Freigabeberechtigungen fest
5. Klicken Sie auf Create

Samba (Linux)

sudo apt install samba
sudo mkdir -p /srv/samba/documents
sudo chown nobody:nogroup /srv/samba/documents

Bearbeiten Sie /etc/samba/smb.conf:

[documents]
   path = /srv/samba/documents
   browseable = yes
   read only = no
   create mask = 0644
   directory mask = 0755
   valid users = @users

sudo systemctl restart smbd nmbd

NAS-Gerät

Die meisten NAS-Geräte (Synology, QNAP) haben integrierte SMB-Unterstützung:

1. Öffnen Sie die NAS-Weboberfläche
2. Navigieren Sie zu Gemeinsame Ordner
3. Erstellen Sie einen neuen gemeinsamen Ordner
4. Aktivieren Sie das SMB/CIFS-Protokoll
5. Legen Sie Benutzerberechtigungen fest

Konfiguration

Parameter	Erforderlich	Beschreibung
type	Ja	Muss "smb" sein
host	Ja	Hostname oder IP des SMB-Servers
share	Ja	Freigabename
username	Nein	Benutzername für die Authentifizierung
password	Nein	Passwort für die Authentifizierung
domain	Nein	Windows-Domänenname
port	Nein	SMB-Port (Standard: 445)
basePath	Nein	Basis-Pfad innerhalb der Freigabe
timeout	Nein	Verbindungs-Timeout in ms (Standard: 30000)

Beispiele

// Basis
{
  "type": "smb",
  "host": "fileserver.corp.local",
  "share": "documents",
  "username": "serviceaccount",
  "password": "your-password"
}

// Windows-Domänenauthentifizierung
{
  "type": "smb",
  "host": "fileserver.corp.local",
  "share": "documents",
  "domain": "CONTOSO",
  "username": "serviceaccount",
  "password": "your-password",
  "basePath": "/projects/mcp"
}

Umgebungsvariablen

Variable	Beschreibung
STORAGE_TYPE	Auf smb setzen
SMB_HOST	Hostname des SMB-Servers
SMB_SHARE	Freigabename
SMB_USERNAME	Benutzername
SMB_PASSWORD	Passwort
SMB_DOMAIN	Windows-Domäne (optional)
SMB_PORT	Port (Standard: 445)

Achtung

SMB-Anmeldeinformationen werden in der JSON-Konfiguration im Klartext übertragen. Verwenden Sie in Produktion die Tools zur Verwaltung von Anmeldeinformationen, um Anmeldeinformationen mit AES-256-GCM-Verschlüsselung zu speichern.

Verwandte Themen

• Speicheranbieter-Übersicht – Alle 7 Anbieter
• Verwaltung von Anmeldeinformationen – Verschlüsselter Anmeldeinformation-Speicher