Site Tools


nas-samba

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
nas-samba [2023/04/26 18:10] – [Additional Share List] -clarity, condense hogwildnas-samba [2024/11/27 17:15] (current) – [Samba File Sharing] -Formatting hogwild
Line 1: Line 1:
 ====== File sharing ====== ====== File sharing ======
  
-The File sharing menu allows you to enable and configure Samba filesharing. Samba is a Linux clone/replica of Microsoft's SMB (Server Message Block) filesharing protocol. Samba allows FreshTomato to "speak" the same language as Windows so files can be exchanged between Windows and Linux-based systems (such as FreshTomato). This allows you to use your FreshTomato router as a NAS drive, if you connect USB storage, such as an external hard drive or flash drive.+In the File sharing menu you can enable and configure Samba filesharing. Samba is a Linux clone of Microsoft's SMB (Server Message Block) filesharing protocol. Samba allows FreshTomato to "speak" the same language as Windows for file sharing between Windows and Linux-based systems (such as FreshTomato). This allows you to use your FreshTomato router as a NAS drive, if you connect USB like a an external hard drive or flash drive
 + 
 +Microsoft's SMB protocol was recently upgraded to v3. FreshTomato's implementation supports only v1/v2. However, these are fine for basic operations.
  
-Microsoft's SMB protocol has recently been upgraded to v3. FreshTomato's implementation supports v1 and v2 only. However, these versions are more than adequate for basic filesharing operations. 
  
 ===== Samba File Sharing ===== ===== Samba File Sharing =====
Line 17: Line 18:
   * Yes Authentication Required   * Yes Authentication Required
  
-For a basic setup, select //Yes no authentication. //If additional security is needed, it's recommended you select the //Yes, Authentication required// . Doing so will display two additional fields where a single username and password can be entered.+ \\
  
- \\ \\  {{:pasted:20220110-125127.png}}\\  \\+For a basic setup, select //Yes no authentication. //If you need additional security, it's recommended you select //Yes, Authentication required//. Doing so will display additional fields to set a single username and password. 
 + 
 + \\ {{:pasted:20220110-125127.png}}\\  \\
  
 **Samba protocol version**: **Samba protocol version**:
Line 27: Line 30:
   * SMBv1 + SMBv2   * SMBv1 + SMBv2
  
-This allows you to select the maximum SMB version that will be supported. It is good practice to enable both SMB1 and SMB2. Imposing a specific version could lead to situations in which client devices aren'running a compatible version and therefore aren't supported. This may generate unwanted log errors, such as the one seen below:+ \\ 
 + 
 +This lets you select the highest SMB version supported. It'good practice to enable both SMB1 and SMB2. Imposing a specific version can cause client devices running an incompatible version to be unsupported. This may generate log errors, such as the one seen below:
  
  \\ \\ {{:pasted:20220111-092133.png}}\\  \\  \\ \\ {{:pasted:20220111-092133.png}}\\  \\
  
-**Disable GRO**: GRO (Generic Receive Offload) essentially combines together small packets to then be sent as a single large packet. This optimizes network utilization, but involves extra (sometimes unwanted) reassembly functions. The default, (Enabled) disables this feature. This is the recommended setting unless you have other, specific requirements.+**Disable GRO:** Generic Receive Offload combines small packets to be sent as a one large one.
  
-**Workgroup Name**: Herespecify the WORKGROUP name (logical grouping) of PCs for devices to be displayed/organized (for Windows peer-to-peer network browsing)Note that the Windows 10 April 2018 (ver. 1803update eliminated the use of Windows 10 HomegroupsHowever, workgroups, still exist in Windows 10 and Windows 11.+This optimizes network utilizationbut involves extra reassemblyThe default, (Enableddisables GROEnabled is advised unless you have other requirements.
  
-**Client Codepage**: DOS and Windows clients use Code pages to determine rules for mapping lowercase letters to uppercase letters. Undefined by default can be set in scenarios where case sensitivity is an issue. To check what Codepage your systems are on (in Windowsrun ''cmd.exe'' and type ''chcp'' to see the current code page.+ \\ 
 + 
 +**Workgroup Name:** here, enter the Windows WORKGROUP name for PCs to be displayed/organized (for peer-to-peer network browsing). 
 + 
 +Note that the Windows 10 April 2018 (v.1803) update eliminated Windows Homegroups. However, workgroups still exist in Windows 10/11. 
 + 
 + \\ 
 + 
 +**Client Codepage:** sets the Windows code page. 
 + 
 +Windows clients use code pages to determine rules for mapping lowercase letters to uppercase ones. Undefinedby defaultcan be set in cases where case sensitivity is an issue. To check your Windows Codepage, run ''cmd.exe'' and type ''chcp'' to see the current code page. 
 + 
 + \\
  
-**Network Interfaces**: Defines to which local interface the samba service should be bound. (Default: br0).\\+**Network Interfaces:** here, define to which local interface samba will be bound. (Default: br0).\\  \\
  
 {{:pasted:20220110-130832.png}} {{:pasted:20220110-130832.png}}
Line 43: Line 60:
  \\  \\
  
-**Samba Custom Configuration**: Hereyou can specify user-defined parameters for the samba process (configured in the smb.conf file). Please consult the samba documentation prior to entering options in this field: [[https://www.samba.org|https://www.samba.org]]/+**Samba Custom Configuration:** here, specify user-defined settings for samba (written to "smb.conf").
  
-**Auto-share all USB Partitions**:+Consult samba documentation before using this field[[https://www.samba.org|https://www.samba.org]]/
  
-This allows you to configure automatic sharing. As soon as a storage medium is connected to the USB port, its contents will be shared. The storage medium must use a compatible filesystem.+ \\
  
-  Disabled +**Auto-share all USB Partitions: **lets you configure automatic sharing.
-  Read Only: Users can only open files and browse the storage content +
-  * Read-WriteUsers have full control on visible content. +
-  Hidden Read-Write. This is similar to Read-Write, but allows access to hidden content (for example, files starting with a dot (.) .+
  
-**Options**: Configures your Samba server to perform additional network roles:+As soon compatible USB filesystem storage is connected, its contents are shared.
  
-  * Master Browser: If enabled, participate in the Master Browser election (when WINS is not available/defined). +  * Disabled - automatic sharing will be disabled. 
-  * WINS Server: When enabled, act as WINS server on the network. DHCP clients will receive this info via DHCP. Static clients can be configured with the FreshTomato's LAN IP address as their WINS server setting.\\+  * Read Only - users can only open files and browse \\ the storage content. 
 +  * Read-Write - users have full control of visible content. 
 +  * Hidden Read-Write - Read-Write privileges plus access to \\ hidden content (such as files starting with a period). 
 + 
 + \\ 
 + 
 +**Options:** configures Samba server to perform additional network roles: 
 + 
 +  * Master Browser - if enabled, participate in the Master Browser \\ election (when WINS is not available/defined). 
 +  * WINS Server - if enabled, act as WINS server. DHCP clients will \\ receive the data via DHCP. Static clients can be set with FreshTomato'\\ LAN address as their WINS server setting.\\
  
  
 ===== Additional Share List ===== ===== Additional Share List =====
  
-In this table, you can define custom network shares that map to physical filesystems. These may overlap, or possibly conflict with the //Auto-share all Partition //function described above.+In this table, you can define custom network shares that map to physical filesystems. These may overlap, or even conflict with the //Auto-share all Partition //function described above.
  
-**Share name**: This is the share name which appears under the [[\\WORKGROUP\$routerhostname]].+ \\
  
-**Directory**: This defines where the share map to in the actual filesystem.+**Share name:**  The share name that appears under the %%[[\\WORKGROUP\$routerhostname]]%%.
  
-**Description**: This is for description only, and appears when browsing the network. It has no functional role other than naming the share.+ \\
  
-**Access Level**: Hereyou can choose the network-level access rights:+**Directory:**  This defines where the share maps in the real filesystem. 
 + 
 + \\ 
 + 
 +**Description:** A descriptor onlythat appears when browsing the network. It has no function except as a name.\\  \\ 
 + 
 +**Access Level:**  Specifies the network-level access rights
  
   * Read Only   * Read Only
   * Read-Write   * Read-Write
  
-Do not confuse this setting with the filesystem rights. Total security is determined by executing a logical AND operator on the Access Level rights and the filesystem rights.+ \\
  
-**Hidden**A hidden share is not visible when browsing the network. Howeverit will still be available if called directly (such as by the "net use" command in Windows).+Don't confuse this with filesystem rights. Total security is calculated by executing a logical AND operation on the Access Level rights and filesystem rights. 
 + 
 + \\ 
 + 
 +**Hidden:**  A hidden share isn'visible when network browsingbut is available if called directly (say, by Windows'  "net use" command). 
 + 
 +\\ 
 + 
 + \\
  
  
nas-samba.1682529007.txt.gz · Last modified: 2023/04/26 18:10 by hogwild