1.13. Configuring Samba for macOS clients
The fruit virtual file system (VFS) Samba module provides enhanced compatibility with Apple server message block (SMB) clients.
The fruit module provides enhanced compatibility of Samba with macOS clients. You can configure the module for all shares hosted on a Samba server to optimize the file shares for macOS clients. For more information, see the vfs_fruit(8) man page on your system.
Enable the fruit module globally. Clients using macOS negotiate the server message block version 2 (SMB2) Apple (AAPL) protocol extensions when the client establishes the first connection to the server. If the client first connects to a share without AAPL extensions enabled, the client does not use the extensions for any share of the server.
Prerequisites
- Samba is configured as a file server.
Procedure
Edit the
/etc/samba/smb.conffile, and enable thefruitandstreams_xattrVFS modules in the[global]section:vfs objects = fruit streams_xattr重要You must enable the
fruitmodule before enablingstreams_xattr. Thefruitmodule uses alternate data streams (ADS). For this reason, you must also enable thestreams_xattrmodule.Optional: To provide macOS Time Machine support on a share, add the following setting to the share configuration in the
/etc/samba/smb.conffile:fruit:time machine = yesVerify the
/etc/samba/smb.conffile:# testparmReload the Samba configuration:
# smbcontrol all reload-config