How to set up Proxmox VE shared storage on a QNAP NAS?


Datum poslední úpravy: 2025-08-28

Applicable Products

  • QTS 5.2.3.3006 or later
  • Proxmox Virtual Environment 8.2.2 or later

Introduction

Proxmox Virtual Environment (Proxmox VE) is an open-source enterprise virtualization platform for deploying and managing virtual machines (VMs), containers, high-availability clusters, and disaster recovery. For the storage backend, Proxmox VE can use local storage or shared storage on remote devices such as NAS devices. 

This tutorial shows several ways you can set up storage space on your QNAP NAS device for use as shared storage in Proxmox VE.


Instructions

There are three main ways to set up storage space on your QNAP NAS device for use by Proxmox VE—through SMB, NFS, and iSCSI.

  • For SMB and NFS storage in Proxmox VE, you can use shared folders on your NAS.
  • For iSCSI storage in Proxmox VE, you can use block-based LUNs on your NAS.

Setting Up a NAS Shared Folder as SMB Storage in Proxmox VE

You can create a new shared folder to use exclusively as shared storage in Proxmox VE. Before you can connect the shared folder to Proxmox VE, you must configure the folder's SMB permission settings and enable SMB service on the NAS.

  1. Create a shared folder on your QNAP NAS to be used by Proxmox VE.
    1. Log in to your NAS as an administrator.
    2. Open File Station.
    3. Click > Shared Folder.
    4. Specify the folder name, and then click Next.
      Note
      For illustration purposes, we'll name it "Penguin".
    5. Select RW (read/write access) for your administrator account, and then click Next.
    6. Click Finish.
      The system creates the shared folder.
  2. Enable SMB service on your NAS.
    1. Go to Control Panel > Network & File Services > Win/Mac/NFS/WebDAV > Microsoft Networking (SMB).
    2. Select Enable file services for Microsoft Networking (SMB).
    3. Click Apply.
  3. Connect the shared folder on your NAS to Proxmox VE.
    1. Log in to your Proxmox VE platform.
    2. Go to Datacenter > Storage.
    3. Click Add > SMB/CIFS.
      The Add: SMB/CIFS window opens.
    4. Next to ID, specify a name for the SMB storage.
      Note
      For illustration purposes, we'll name it "Penguin-SMB".
    5. Next to Server, enter the IP address of your NAS.
    6. Next to Username and Password, enter the credentials of your NAS administrator account.
    7. Next to Share, select the shared folder you created.
    8. Next to Content, select a content type.
      Note
      Not all storage devices support all content types.
    9. Click Add.

You can now use the NAS shared folder as SMB storage in Proxmox VE.

Setting Up a NAS Shared Folder as NSF Storage in Proxmox VE

You can create a new shared folder to use exclusively as shared storage in Proxmox VE. Before you can connect the shared folder to Proxmox VE, you must configure the folder's NFS permission settings and enable NFS service on the NAS.

  1. Create a shared folder on your QNAP NAS to be used by Proxmox VE.
    1. Log in to your NAS as an administrator.
    2. Open File Station.
    3. Click > Shared Folder.
    4. Specify the folder name, and then click Next.
      Note
      For illustration purposes, we'll name it "Penguin-NFS".
    5. Select RW (read/write access) for your administrator account, and then click Next.
    6. Click Finish.
      The system creates the shared folder.
  2. Configure the shared folder's NFS permission settings.
    1. Open Control Panel.
    2. Go to Privilege > Shared Folders > Shared Folder.
    3. Identify the newly created shared folder.
    4. Under Action, click .
      The Edit Shared Folder Permission window opens.
    5. Next to Select permission type, select NFS host access.
    6. Select Access right.
    7. In the Allowed IP Address or Domain Name table, enter the IP address of your Proxmox VE platform.
    8. Select the read/write permission.
    9. Click Apply.
  3. Enable NFS service on your QNAP NAS.
    1. Go to Control Panel > Network & File Services > Win/Mac/NFS/WebDAV > NFS Service.
    2. Select Enable Network File System (NFS) service.
    3. Select all applicable NFS versions.
    4. Click Apply.
  4. Connect the shared folder on your NAS to Proxmox VE.
    1. Log in to your Proxmox VE platform.
    2. Go to Datacenter > Storage.
    3. Click Add > NFS.
      The Add: NFS window opens.
    4. Next to ID, specify a name for the NFS storage.
      Note
      For illustration purposes, we'll name it "Penguin-NFS" (same as the shared folder's name).
    5. Next to Server, enter the IP address of your NAS.
    6. Next to Export, select the shared folder you created.
    7. Next to Content, select a content type.
      Note
      Not all devices support all content types.
    8. Click Add.

You can now use the NAS shared folder as NFS storage in Proxmox VE.

Setting Up a NAS LUN as iSCSI Storage in Proxmox VE

To create a LUN on your QNAP NAS for use as iSCSI storage in Proxmox VE, you can first create an iSCSI target. Once you finish creating the iSCSI target, the system will prompt you to create a new LUN, which will be automatically mapped to the new iSCSI target. The iSCSI target allows Proxmox VE to connect to the LUN and use it as a storage space.

  1. Create an iSCSI target on your QNAP NAS.
    1. Log in to your NAS as an administrator.
    2. Open iSCSI & Fibre Channel.
    3. Ensure iSCSI & Fibre Channel service is enabled.
    4. Go to iSCSI Storage, and then click Create > New iSCSI Target.
      The iSCSI Target Creation Wizard opens.
    5. Click Next.
    6. Specify a target alias.
      Note
      For illustration purposes, we'll name it "Penguin-iSCSI".
    7. Select Allow clustered access to this target, and then click Next.
    8. Optional: Configure CHAP authentication.
      For details, see Creating an iSCSI target.
    9. Click Next.
    10. Select a connected network interface to bind to the iSCSI target, and then click Next.
    11. Review the summary, and then click Apply.
      iSCSI & Fibre Channel creates the iSCSI target and opens the Block-Based LUN Creation Wizard.
  2. Create a block-based LUN to be mapped to the newly created iSCSI target.
    1. Select the parent storage pool, and then click Next.
    2. Specify the LUN name and capacity, and then click Next.
    3. Review the summary, and then click Finish.
      The system creates the block-based LUN and automatically maps it to the new iSCSI target.
      You can view the created iSCSI target and mapped LUN in iSCSI Storage.
  3. Connect the LUN on your NAS to Proxmox VE.
    1. Log in to your Proxmox VE platform.
    2. Go to Datacenter > Storage.
    3. Click Add > iSCSI.
      The Add: iSCSI window opens.
    4. Next to ID, enter the iSCSI target alias.
      Note
      In our example, the target alias is "Penguin-iSCSI".
    5. Next to Portal, enter the IP address of your NAS.
    6. Next to Target, select your iSCSI target by its IQN.
      Note
      You can find your iSCSI target's IQN listed in parentheses next to the target alias in iSCSI & Fibre Channel > iSCSI Storage on your NAS.
    7. Click Add.

You can now use the LUN on the NAS as iSCSI storage in Proxmox VE.


Troubleshooting Failed Creation Errors

This section covers a few common error messages users may encounter when trying to set up shared storage in Proxmox VE, along with suggested solutions.

Note that the solutions may vary depending on your operational environment. If an error persists, please contact the technical support team.

Directory does not exist or is unreachable

This error message may occur in the following situations:

  • The target shared folder no longer exists.
    For example, you selected the shared folder in Proxmox VE, but then the shared folder was deleted on the NAS before you started creating the shared storage.
    Please ensure the shared folder exists on the NAS.
  • The storage pool on the NAS could not use the network protocol.
    In this case, we suggest creating a new storage pool to use for Proxmox VE and then follow the instructions in this article again.

Storage is not online

This error message may occur in the following situations:

  • The target shared folder no longer exists.
    For example, you selected the shared folder in Proxmox VE, but then the shared folder was deleted on the NAS before you started creating the shared storage.
    Please ensure the shared folder exists on the NAS.
  • Access permissions for the shared folder were revoked on the NAS before you started creating the shared storage.
    Please check again and ensure you have granted Proxmox VE access permission to the shared folder.

System permission error

This kind of error message usually appears due to incorrect shared folder permission settings.
Please ensure that the access permission to the shared folder is set to read/write.


Further Reading and Resources

Byl tento článek užitečný?

100% lidí si myslí, že to pomáhá.
Děkujeme vám za vaši zpětnou vazbu.

Sdělte nám prosím, jak lze tento článek vylepšit:

Pokud chcete poskytnout další zpětnou vazbu, uveďte ji níže.

Zvolte specifikaci

      Zobrazit více Zobrazit méně

      Tato stránka v jiných zemích / oblastech:

      open menu
      back to top