Änderungen an News einreichen

Titel

Intro

Hauptteil

<h1>Proxmox + TrueNAS Plugin im Praxistest</h1>

<p>Mit dem neuen <strong>TrueNAS over iSCSI Plugin&nbsp;</strong>von <a href="https://github.com/boomshankerx/proxmox-truenas" rel="noopener" tabindex="-1" target="_new">BoomshankerX</a> werden diese beiden Systeme nun <strong>nativ miteinander verbunden</strong>.<br />
Keine SSH-Schlüssel, keine manuelle Freigaben – stattdessen eine saubere, API-basierte Integration über die TrueNAS WebSocket API.</p>

<p>Als <strong>offizieller TrueNAS-Partner</strong> war <strong>DATAZONE</strong> einer der ersten Beta-Tester des Plugins.<br />
Unser Fazit:</p>

<blockquote>
<p>Das Plugin hat unsere Erwartungen <strong>weit übertroffen</strong> – in Stabilität, Leistung und Benutzerfreundlichkeit.</p>
</blockquote>

<h2>Überblick: Was das Plugin leistet</h2>

<p>Das TrueNAS over iSCSI Plugin ersetzt ältere Integrationen (z. B. <em>freenas-proxmox</em>) und nutzt nun die moderne <strong>TrueNAS WebSocket API</strong>.<br />
Ziel ist es, die <strong>iSCSI-Speicherverwaltung</strong> direkt in Proxmox zu integrieren – vollständig automatisiert, API-basiert und Multi-Server-fähig.</p>

<h3>Die wichtigsten Features</h3>

<ul>
	<li>
	<p>API-basierte Verbindung zwischen Proxmox und TrueNAS (keine SSH-Konfiguration nötig)</p>
	</li>
	<li>
	<p>Automatische Erkennung von ZFS-Pools, Datasets und Volumes</p>
	</li>
	<li>
	<p>Snapshot-Verwaltung direkt in Proxmox</p>
	</li>
	<li>
	<p>Native Unterstützung mehrerer TrueNAS-Server</p>
	</li>
	<li>
	<p>Volle Kompatibilität mit <strong>TrueNAS SCALE</strong> und <strong>TrueNAS CORE</strong></p>
	</li>
	<li>
	<p>Zwei Betriebsmodi: <strong>Native (RC1)</strong> und <strong>Patch (Legacy)</strong></p>
	</li>
</ul>

<h2>DATAZONE-Testumgebung und Ergebnisse</h2>

<p><strong>Hardware / Setup</strong></p>

<ul>
	<li>
	<p>Proxmox VE 9.0&nbsp;Cluster mit drei Nodes</p>
	</li>
	<li>
	<p>TrueNAS SCALE 25.10 RC1</p>
	</li>
	<li>
	<p>10 Gbit VLAN für iSCSI-Storage</p>
	</li>
	<li>
	<p>ZFS Mirror mit NVMe Cache (L2ARC/SLOG)</p>
	</li>
</ul>

<p><strong>Ergebnisse</strong></p>

<ul>
	<li>
	<p>Einrichtung in weniger als 10 Minuten</p>
	</li>
	<li>
	<p>TrueNAS-Pools automatisch erkannt</p>
	</li>
	<li>
	<p>API-Verbindung stabil (Antwortzeiten &lt; 300 ms)</p>
	</li>
	<li>
	<p>Snapshots und Replikation funktionierten sofort</p>
	</li>
	<li>
	<p>Keine manuelle SSH- oder Freigabekonfiguration notwendig</p>
	</li>
</ul>

<p><strong>Besonders positiv:</strong><br />
Die Integration ist komplett API-basiert, was Sicherheit und Automatisierung deutlich verbessert.<br />
Für Enterprise- und KMU-Umgebungen ist das ein echter Fortschritt.</p>

<h2>Native vs. Patch-Version: Unterschiede</h2>

<table border="1">
	<thead>
		<tr>
			<th>Version</th>
			<th>Einsatzgebiet</th>
			<th>TrueNAS-Version</th>
			<th>Installation</th>
			<th>Integration</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td><strong>Native (RC1)</strong></td>
			<td>Neueste Generation</td>
			<td>25.10+</td>
			<td>apt install proxmox-truenas-native</td>
			<td>Vollständig API-basiert</td>
		</tr>
		<tr>
			<td><strong>Patch (Legacy)</strong></td>
			<td>Kompatibilität</td>
			<td>24.04–25.04</td>
			<td>apt install proxmox-truenas</td>
			<td>Teilweise per Perl-Modul</td>
		</tr>
	</tbody>
</table>

<blockquote>
<p>Beide Versionen dürfen <strong>nicht gleichzeitig</strong> installiert werden.</p>
</blockquote>

<h2>Schritt-für-Schritt: Installation und Konfiguration</h2>

<h3>1. APT Repository hinzufügen</h3>

<pre>
curl -fsSL https://boomshankerx.github.io/proxmox-truenas-apt/gpg.key \ | gpg --dearmor -o /etc/apt/keyrings/proxmox-truenas.gpg
echo "deb [signed-by=/etc/apt/keyrings/proxmox-truenas.gpg] \ https://boomshankerx.github.io/proxmox-truenas-apt bookworm main" \ | tee /etc/apt/sources.list.d/proxmox-truenas.list</pre>

<h3>2. Plugin installieren</h3>

<pre>
apt update apt install proxmox-truenas-native</pre>

<h3>3. TrueNAS vorbereiten (laut Configuration Guide)</h3>

<p>Für die Einrichtung des Plugins müssen auf TrueNAS einige Komponenten vorbereitet werden.</p>

<h4>a) TrueNAS iSCSI konfigurieren</h4>

<ul>
	<li>
	<p>Navigiere zu <strong>System → Shares → iSCSI</strong></p>
	</li>
	<li>
	<p>Erstelle ein neues <strong>iSCSI-Ziel</strong> und weise ihm einen ZFS-Pool zu (z. B. tank/proxmox)</p>
	</li>
	<li>
	<p>Beachte, dass das Plugin diese Konfiguration nutzt, um virtuelle Disks über die API bereitzustellen</p>
	</li>
</ul>

<p>Detaillierte Anleitung:<br />
👉 <a href="https://github.com/boomshankerx/proxmox-truenas/wiki/Configuration-Guide" rel="noopener" tabindex="-1" target="_new">TrueNAS iSCSI Setup Guide</a></p>

<h3>1. Dataset erstellen</h3>

<p>Als erstes erstellen wir ein dataset für proxmox.</p>

<h3>2. iSCSI aktivieren</h3>

<p>Danach müssen wir noch ISCSI aktivieren.</p>

<h3>3. iSCSI konfigurieren</h3>

<p>Bevor Sie versuchen, ein Ziel zu konfigurieren, müssen zuerst Portale und Initiatoren konfiguriert werden.</p>

<h4>Global Config</h4>

<p>&nbsp;Base Name (IQN target)</p>

<h4>Portal</h4>

<p>Konfigurieren Sie eine Portal Gruppe die auf 0.0.0.0:3260 hört.</p>

<h4>Initiator</h4>

<p>Konfigurieren Sie eine Initiatorgruppe, um alle Initiatoren zuzulassen</p>

<h4>Targets</h4>

<p>Erstellen Sie nun ein Ziel. Fügen Sie unbedingt eine iSCSI-Gruppe hinzu. Verwenden Sie die Portalgruppe und die Initiatorgruppe, die Sie in den vorherigen Schritten erstellt haben. Hier können Sie autorisierte Netzwerke festlegen. Keine Einstellung erlaubt alle Netzwerke.</p>

<h3>4. TrueNAS API Key</h3>

<p>API Key erstellen und sicher aufbewahren. Der API Key kann nachträglich nicht mehr angezeigt werden.</p>

<h4>b) API-Key erstellen</h4>

<ul>
	<li>
	<p>In der TrueNAS Suche API eingeben&nbsp;&nbsp;<strong>Credentials&nbsp;→&nbsp;Users&nbsp;→&nbsp;API Keys</strong></p>
	</li>
	<li>
	<p>Erstelle einen neuen Key mit dem Benutzerkonto, das API-Zugriff auf Storage, Pools und iSCSI-Services hat</p>
	</li>
	<li>
	<p>Kopiere den Key – er wird in Proxmox benötigt</p>
	</li>
</ul>

<h3>4. Proxmox konfigurieren</h3>

<h4>Variante A: CLI über pvesm</h4>

<pre>
pvesm add truenas truenas \ 
--blocksize 16k \ 
--pool tank/proxmox \ 
--portal 10.0.0.1 \ 
--target iqn.2005-10.org.freenas.ctl:proxmox \ 
--shared 1 \ --sparse 1 \ 
--truenas_apikey &lt;APIKEY&gt; \ 
--truenas_apiv4_host 10.0.0.1 \ 
--truenas_use_ssl 1</pre>

<blockquote>
<p>Hinweis: Die Fehlermeldung 400 Result verification failed kann ignoriert werden.<br />
Das Storage wird korrekt hinzugefügt und funktioniert.</p>
</blockquote>

<h4>Variante B: Manuelle Konfiguration über storage.cfg</h4>

<pre>
truenas: truenas blocksize 16k 
   pool tank/proxmox 
   portal 10.0.0.1 
   shared 1 
   sparse 1 
   target iqn.2005-10.org.freenas.ctl:proxmox 
   truenas_apikey &lt;APIKEY&gt; 
   truenas_apiv4_host 10.0.0.1 
   truenas_use_ssl 1
</pre>

<h3>5. Bekannte Einschränkungen</h3>

<p>TPM Storage</p>

<p>Proxmox unterstützt derzeit kein Speichern von TPM-Disks auf iSCSI-LUNs.<br />
<strong>Workaround:</strong></p>

<ul>
	<li>
	<p>Lege ein zusätzliches NFS/SMB-Share auf deinem TrueNAS an</p>
	</li>
	<li>
	<p>Speichere TPM-Daten dort</p>
	</li>
</ul>

<p>Das Problem ist aktuell schon bei Proxmox bekannt (https://bugzilla.proxmox.com/show_bug.cgi?id=4693).&nbsp; Eventuell gibt es in absehbarer Zeit eine Lösung. Solange kann mit dem Workaroung gearbeitet werden.</p>

<p>Die native Integration in die Proxmox-Oberfläche ist in Version 9.1 geplant.<br />
Bis dahin erfolgt die Konfiguration über CLI oder Datei.</p>

<h3>6. Migration von freenas-proxmox</h3>

<p>Falls du das alte Plugin nutzt:</p>

<pre>
sed -i 's/freenas/truenas/g' /etc/pve/storage.cfg 
apt purge freenas-proxmox 
apt reinstall pve-manager libpve-storage-perl</pre>

<p>Danach das neue Repository hinzufügen und proxmox-truenas-native installieren.</p>

<h2>DATAZONE-Erfahrungen in der Beta</h2>

<p>Während unserer Tests mit verschiedenen TrueNAS-Systemen (SCALE, CORE, Enterprise) zeigte das Plugin in jeder Umgebung:</p>

<ul>
	<li>
	<p>Stabile API-Verbindung und zuverlässige Pool-Erkennung</p>
	</li>
	<li>
	<p>Reibungslose Snapshot-Verwaltung über Proxmox</p>
	</li>
	<li>
	<p>Replizierbare Performance, auch bei HA-Setups</p>
	</li>
	<li>
	<p>Signifikant vereinfachte Integration für neue Cluster</p>
	</li>
</ul>

<p>Für Administratoren bedeutet das:<br />
<strong>Weniger Aufwand, mehr Kontrolle, mehr Automatisierung.</strong></p>

<h2>Fazit</h2>

<p>Das neue <strong>TrueNAS over iSCSI Plugin</strong>&nbsp;hebt die Zusammenarbeit zwischen Proxmox und TrueNAS auf Enterprise-Niveau.<br />
Durch die native API-Integration entfällt komplexes SSH-Handling, und TrueNAS kann als vollwertiges Storage-Backend für Proxmox genutzt werden – effizient, sicher und performant.</p>

<blockquote>
<p>DATAZONE empfiehlt das Plugin für alle, die Proxmox und TrueNAS produktiv einsetzen – egal ob im Rechenzentrum, Mittelstand oder Lab.</p>
</blockquote>

<p>🚀 <strong>Proxmox + TrueNAS – Zukunftssichere Integration mit DATAZONE!</strong><br />
Erleben Sie, wie einfach und sicher Storage-Integration heute ist.</p>

<p>👉 Integration mit uns planen<br />
👉 TrueNAS-Demo testen<br />
👉 Individuelle Beratung anfragen</p>

<p><a href="mailto:info@datazone.de?subject=TrueNAS%20Proxmox%20Plugin" tabindex="-1"><strong>Jetzt Kontakt aufnehmen</strong></a></p>

Veröffentlichungsdatum

Kurzbeschreibung

Obertitel

Untertitel

Kurztitel

Bilder

Sie können hier Dateien ablegen
Erlaubte Dateitypen:

Captcha

* Pflichtfeld

OPNsense

Änderungen an News einreichen

IT-Service

Telefonie

Hardware

Änderungen an News einreichen