XZ

Xiao Z's blog

Learn, build, share

How to Install Zdir Directory Listing on QNAP via Docker

QNAP DockerZdir directory listingxiaoz Docker imageNAS file browserContainer Station setup
Published·Modified·

Zdir is a directory listing program developed in PHP that requires no database, features simple installation, and is easy to use. It also supports deployment via Docker.

Installing Docker on QNAP

If your QNAP NAS does not have Docker installed yet, please refer to the previous article: Installing Docker Containers and Setting Docker Image Sources on QNAP (QTS).

Creating the Container

Open the Container Station suite (Docker) in QTS, click the Create button, and search for Zdir. Find and install the Docker image provided by the xiaoz official account. Note: You must use the Docker image provided by xiaoz official; otherwise, the latest version of Zdir will not be supported.

Select the latest version, then click Next.

Since this is not an official Docker image, a warning will appear. Click "I understand" to confirm.

Create Container

Next, you will see the steps to create the Container. Fill in the information as follows:

  • Name: zdir (or define your own)
  • Command: /usr/sbin/run.sh
  • CPU and Memory: Set according to your own situation

Network Settings

Open Advanced Settings - Network, and configure as shown in the image below.

  • The host port 1080 is the access port used later; you can set your own access port as needed.
  • The Container port must be 80.
  • Communication protocol should be selected as TCP.

Shared Folders

Open Advanced Settings - Shared Folders - Mount Local Shared Folders - Add New.

  • Local Shared Folder: Select a folder on your NAS; Zdir will read files from this folder later.
  • Mount Path: Enter /data/wwwroot/default. Note that this must be /data/wwwroot/default and should not be changed.

Once the network and shared folder settings are complete, click "Create".

Access and Test

Wait about 1 minute (depending on your network conditions), then access http://NAS_IP:1080 to open Zdir, as shown below.

Note: The default username is zdir and the password is xiaoz.me. You can modify these in the config.php file.

Obtaining the Donor Version

Scan the QR code below. Donating more than 30 yuan will grant you the Donor Version, which includes first-time technical support and ad removal. After donating, please contact my QQ: 337003006 to obtain it.

Final Thoughts

For more usage instructions, please refer to the Zdir Help Document: https://www.yuque.com/helloz/zdir. If you have any questions, feel free to leave a message.