FileZilla Server utilizes mount points. to create virtual access points. These map specific directories (folders) within your server’s storage to locations accessible by FTP users.
A mount point includes a virtual path and a native path. The native path is a local file path, the virtual path is the path that the FTP users will see and it is mapped to the native path by FileZilla Server.
To add a mount point click on the Add button and enter a virtual path (eg. \) and a native path (eg, C:\ftproot\sample
).
Virtual path format
The format of the virtual path is the same one used by UNIX-like operating systems: files and directories are separated by the slash ‘/’ character and all files and directories belong to a unique root, whose name is exactly ‘/’. Virtual paths are normalized by resolving ‘.’ and ‘..’directories and removing any trailing ‘/’ character.
Native path format
The format of the native path is the same used by the operating system. On Windows UNC paths are supported too, and both the slash ‘/’ and backslash ‘\’ characters are valid separators. Native paths are normalized just like virtual paths. In addition, on Windows the slash ‘/’ is normalized to become a backslash ‘\’, path segments are not allowed to terminate with dots and they cannot contain the colon ‘:’ character, except for the device name.
Note: While setting up native paths, make sure they exist or ask the server to create them for you by selecting the checkbox Create native directory if it doesn’t exist.
Placeholders
Placeholders can be used to define native paths, and are replaced with their values when the native path is resolved. There are two placeholders available:
- %<home> – gets replaced with the absolute path of the home directory of the logged-in user. As it is substituted with an absolute path, it should be the sole element of the native path when
utilized. - %<user> – gets substituted with the name of the currently logged-in user.
Further limitations (Windows only)
Virtual paths cannot contain the backslash ‘\’ character and they cannot contain the colon ‘:’ as well.
Both the virtual and native paths must be in their absolute form, meaning they must begin with the root directory. Native path on Windows must either be in the UNC path form or begin with a drive device letter followed by a colon followed by a backslash (or a slash).
Permissions
Sharing a directory through a mount point also shares all the files and directories contained therein, unless otherwise specified by the permissions associated with the mount point itself.
Permissions can be set as Read only, Read + Write or Disabled.
If you choose Read, neither files nor the directory structure will be modifiable.
If you choose Read + Write any kind of modification will be allowed, unless the flag Writable directory structure is deselected, in which case it won’t be possible to create, delete or rename subdirectories.
Choosing Disabled allows you to block access to a directory, even if its parent directory is accessible through a mount point. In the example below, the /home/user/Documents/disabled directory is made inaccessible, while /home/user/Documents/ remains accessible:
First mount point:
-
Virtual path: /Documents
Native path: /home/user/Documents/ [enabled]
Second mount point:
-
Virtual path: /Documents//disabled [disabled]
Native path: empty.
The native path of a disabled mount point can be non-empty but is disregarded. This feature is handy
for temporarily disabling an existing mount point.
It’s important to note that if any enabled mount points exist with a virtual path whose parent corresponds to the virtual path of a disabled mount point, they will remain accessible as usual.
Note: Once you choose Disabled, you can’t change the native path.
By default, permissions are applied to all subdirectories. If you want to avoid that, deselect the
checkbox Apply permissions to subdirectories. By doing that all subdirectories of a mount point will implicitly have permissions set to Disabled.
Note that permissions are further restricted by the ones set on the underlying native file system. For
example, if a file is set as read-only at file system level and at the same time it’s visible through a mount point whose permissions are read+write, the file will not be writable.
The video tutorial below shows how to configure FileZilla Server’s user types and how to use placeholders to define native paths.
Video tutorial: FileZilla Server Users Types and Placeholders
Related Topics: