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
home_server:home_server_setup:other_services:samba [2021-12-28 Tue wk52 11:01] – baumkphome_server:home_server_setup:other_services:samba [2023-04-30 Sun wk17 17:43] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +{{tag>linux samba}}
 ======samba====== ======samba======
 +I have not look at samba much since I first attempted to set up my home sever circa 2011 on Fedora before I moved to Ubuntu.  I stopped using Fedora as I had noob pain with Selinux, coupled with the short service life of Fedora, so I moved to Ubuntu, where I had a lot more success.\\
 +Samba seems to pretty much just work.  I was lazy and tended to just use Webmin to set this up.  However as I did not use Webmin for much else I have elected to to set it up now that I moved my server to Debian.  So now I need to learn about Samba again\\
 +Samba is pretty much mandatory, as a lot of services smb use it as default.\\
 +My main form of security it to limit external access to my lan, hence samba security is low. More focused on easy use.\\
 +====samba basic setup====
 +High level requirements:
 +  * To install: ''sudo apt install samba samba-client''
 +  * Adjust the smb.conf file: ''sudo vim /etc/samba/smb.conf''
 +  * Add and enable users: ''sudo smbpasswd -a USER'', ''​sudo smbpasswd -e USER''.  I use the same user name and passwords as main Linux log.
 +++++smb.conf|
 +<code>#
 +# Sample configuration file for the Samba suite for Debian GNU/Linux.
 +#
 +#
 +# This is the main Samba configuration file. You should read the
 +# smb.conf(5) manual page in order to understand the options listed
 +# here. Samba has a huge number of configurable options most of which 
 +# are not shown in this example
 +#
 +# Some options that are often worth tuning have been included as
 +# commented-out examples in this file.
 +#  - When such options are commented with ";", the proposed setting
 +#    differs from the default Samba behaviour
 +#  - When commented with "#", the proposed setting is the default
 +#    behaviour of Samba but the option is considered important
 +#    enough to be mentioned here
 +#
 +# NOTE: Whenever you modify this file you should run the command
 +# "testparm" to check that you have not made any basic syntactic 
 +# errors. 
  
-<- home_server:home_server_setup:other_services:apt|Prev ^ home_server:home_server_setup:other_services:index|Start page ^ home_server:home_server_setup:other_services:misc|Next ->+#======================= Global Settings ======================= 
 + 
 +[global] 
 + 
 +## Browsing/Identification ### 
 + 
 +# Change this to the workgroup/NT-domain name your Samba server will part of 
 +   workgroup = WORKGROUP 
 + 
 +# server string is the equivalent of the NT Description field 
 + server string = %h server (Samba, Debian) 
 +   netbios name = kpts 
 +# Windows Internet Name Serving Support Section: 
 +# WINS Support - Tells the NMBD component of Samba to enable its WINS Server 
 +#   wins support = no 
 + 
 +# WINS Server - Tells the NMBD components of Samba to be a WINS Client 
 +# Note: Samba can be either a WINS Server, or a WINS Client, but NOT both 
 +;   wins server = w.x.y.z 
 + 
 +# This will prevent nmbd to search for NetBIOS names through DNS. 
 +   dns proxy = no 
 + 
 +#### Networking #### 
 + 
 +# The specific set of interfaces / networks to bind to 
 +# This can be either the interface name or an IP address/netmask; 
 +# interface names are normally preferred 
 +;   interfaces = 127.0.0.0/8 eth0 
 + 
 +# Only bind to the named interfaces and/or networks; you must use the 
 +# 'interfaces' option above to use this. 
 +# It is recommended that you enable this feature if your Samba machine is 
 +# not protected by a firewall or is a firewall itself.  However, this 
 +# option cannot handle dynamic or non-broadcast interfaces correctly. 
 +;   bind interfaces only = yes 
 + 
 +#### Debugging/Accounting #### 
 + 
 +# This tells Samba to use a separate log file for each machine 
 +# that connects 
 +   log file = /var/log/samba/log.%m 
 + 
 +# Cap the size of the individual log files (in KiB). 
 +   max log size = 1000 
 + 
 +# If you want Samba to only log through syslog then set the following 
 +# parameter to 'yes'. 
 +#   syslog only = no 
 + 
 +# We want Samba to log a minimum amount of information to syslog. Everything 
 +# should go to /var/log/samba/log.{smbd,nmbd} instead. If you want to log 
 +# through syslog you should set the following parameter to something higher. 
 +   syslog = 0 
 + 
 +# Do something sensible when Samba crashes: mail the admin a backtrace 
 +   panic action = /usr/share/samba/panic-action %d 
 + 
 +####### Authentication ####### 
 + 
 +# Server role. Defines in which mode Samba will operate. Possible 
 +# values are "standalone server", "member server", "classic primary 
 +# domain controller", "classic backup domain controller", "active 
 +# directory domain controller".  
 +# 
 +# Most people will want "standalone sever" or "member server". 
 +# Running as "active directory domain controller" will require first 
 +# running "samba-tool domain provision" to wipe databases and create a 
 +# new domain. 
 +   server role = standalone server 
 + 
 +# If you are using encrypted passwords, Samba will need to know what 
 +# password database type you are using.   
 +   passdb backend = tdbsam 
 + 
 +   obey pam restrictions = yes 
 + 
 +# This boolean parameter controls whether Samba attempts to sync the Unix 
 +# password with the SMB password when the encrypted SMB password in the 
 +# passdb is changed. 
 +   unix password sync = yes 
 + 
 +# For Unix password sync to work on a Debian GNU/Linux system, the following 
 +# parameters must be set (thanks to Ian Kahan <<kahan@informatik.tu-muenchen.de> for 
 +# sending the correct chat script for the passwd program in Debian Sarge). 
 +   passwd program = /usr/bin/passwd %u 
 +   passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully* . 
 + 
 +# This boolean controls whether PAM will be used for password changes 
 +# when requested by an SMB client instead of the program listed in 
 +# 'passwd program'. The default is 'no'. 
 +   pam password change = yes 
 + 
 +# This option controls how unsuccessful authentication attempts are mapped 
 +# to anonymous connections 
 +   map to guest = bad user 
 + 
 +########## Domains ########### 
 + 
 +# 
 +# The following settings only takes effect if 'server role = primary 
 +# classic domain controller', 'server role = backup domain controller' 
 +# or 'domain logons' is set  
 +# 
 + 
 +# It specifies the location of the user's 
 +# profile directory from the client point of view) The following 
 +# required a [profiles] share to be setup on the samba server (see 
 +# below) 
 +;   logon path = \\%N\profiles\%U 
 +# Another common choice is storing the profile in the user's home directory 
 +# (this is Samba's default) 
 +#   logon path = \\%N\%U\profile 
 + 
 +# The following setting only takes effect if 'domain logons' is set 
 +# It specifies the location of a user's home directory (from the client 
 +# point of view) 
 +;   logon drive = H: 
 +#   logon home = \\%N\%U 
 + 
 +# The following setting only takes effect if 'domain logons' is set 
 +# It specifies the script to run during logon. The script must be stored 
 +# in the [netlogon] share 
 +# NOTE: Must be store in 'DOS' file format convention 
 +;   logon script = logon.cmd 
 + 
 +# This allows Unix users to be created on the domain controller via the SAMR 
 +# RPC pipe.  The example command creates a user account with a disabled Unix 
 +# password; please adapt to your needs 
 +; add user script = /usr/sbin/adduser --quiet --disabled-password --gecos "" %u 
 + 
 +# This allows machine accounts to be created on the domain controller via the  
 +# SAMR RPC pipe.   
 +# The following assumes a "machines" group exists on the system 
 +; add machine script  = /usr/sbin/useradd -g machines -c "%u machine account" -d /var/lib/samba -s /bin/false %u 
 + 
 +# This allows Unix groups to be created on the domain controller via the SAMR 
 +# RPC pipe.   
 +; add group script = /usr/sbin/addgroup --force-badname %g 
 + 
 +############ Misc ############ 
 + 
 +# Using the following line enables you to customise your configuration 
 +# on a per machine basis. The %m gets replaced with the netbios name 
 +# of the machine that is connecting 
 +;   include = /home/samba/etc/smb.conf.%m 
 + 
 +# Some defaults for winbind (make sure you're not using the ranges 
 +# for something else.) 
 +;   idmap uid = 10000-20000 
 +;   idmap gid = 10000-20000 
 +;   template shell = /bin/bash 
 + 
 +# Setup usershare options to enable non-root users to share folders 
 +# with the net usershare command. 
 + 
 +# Maximum number of usershare. 0 (default) means that usershare is disabled. 
 +;   usershare max shares = 100 
 + 
 +# Allow users who've been granted usershare privileges to create 
 +# public shares, not just authenticated ones 
 +   usershare allow guests = yes 
 + 
 +#======================= Share Definitions ======================= 
 + 
 +# Un-comment the following (and tweak the other settings below to suit) 
 +# to enable the default home directory shares. This will share each 
 +# user's home directory as \\server\username 
 +;[homes] 
 +;   comment = Home Directories 
 +;   browseable = no 
 + 
 +# By default, the home directories are exported read-only. Change the 
 +# next parameter to 'no' if you want to be able to write to them. 
 +;   read only = yes 
 + 
 +# File creation mask is set to 0700 for security reasons. If you want to 
 +# create files with group=rw permissions, set next parameter to 0775. 
 +;   create mask = 0700 
 + 
 +# Directory creation mask is set to 0700 for security reasons. If you want to 
 +# create dirs. with group=rw permissions, set next parameter to 0775. 
 +;   directory mask = 0700 
 + 
 +# By default, \\server\username shares can be connected to by anyone 
 +# with access to the samba server. 
 +# Un-comment the following parameter to make sure that only "username" 
 +# can connect to \\server\username 
 +# This might need tweaking when using external authentication schemes 
 +;   valid users = %S 
 + 
 +# Un-comment the following and create the netlogon directory for Domain Logons 
 +# (you need to configure Samba to act as a domain controller too.) 
 +;[netlogon] 
 +;   comment = Network Logon Service 
 +;   path = /home/samba/netlogon 
 +;   guest ok = yes 
 +;   read only = yes 
 + 
 +# Un-comment the following and create the profiles directory to store 
 +# users profiles (see the "logon path" option above) 
 +# (you need to configure Samba to act as a domain controller too.) 
 +# The path below should be writable by all users so that their 
 +# profile directory may be created the first time they log on 
 +;[profiles] 
 +;   comment = Users profiles 
 +;   path = /home/samba/profiles 
 +;   guest ok = no 
 +;   browseable = no 
 +;   create mask = 0600 
 +;   directory mask = 0700 
 + 
 +[printers] 
 +   comment = All Printers 
 +   browseable = no 
 +   path = /var/spool/samba 
 +   printable = yes 
 +   guest ok = no 
 +   read only = yes 
 +   create mask = 0700 
 + 
 +# Windows clients look for this share name as a source of downloadable 
 +# printer drivers 
 +[print$] 
 +   comment = Printer Drivers 
 +   path = /var/lib/samba/printers 
 +   browseable = yes 
 +   read only = yes 
 +   guest ok = no 
 +# Uncomment to allow remote administration of Windows print drivers. 
 +# You may need to replace 'lpadmin' with the name of the group your 
 +# admin users are members of. 
 +# Please note that you also need to set appropriate Unix permissions 
 +# to the drivers directory for these users to have write rights in it 
 +;   write list = root, @lpadmin 
 + 
 +[home] 
 + writeable = yes 
 + path = /home 
 + 
 +[shared] 
 + path = /home/shared 
 + writeable = yes 
 + 
 +[KarlData] 
 + writeable = yes 
 + path = /media/disk1/KarlData 
 + 
 +[media2] 
 + path = /media/disk1/Media 
 + writeable = yes 
 + 
 +[media1] 
 + path = /media/disk2/Media 
 + writeable = yes 
 + 
 +[deluge] 
 + path = /media/deluge/Downloads 
 +        writeable = yes 
 +</code> 
 +++++ 
 +====samba check commands==== 
 +Some samba check commands: 
 +  * ''smbclient -L 192.168.1.10'' list the available shares on the host IP 
 +  * ''pdbedit -w -L'' list the current users on the samba host 
 +  * ''sudo systemctl status smbd'' smdb.service is the systemd services name..... 
 +  * ''testparm'' will list the samba configuration parameters. 
 + 
 +====Links==== 
 +  * [[https://wiki.debian.org/Samba/ServerSimple|Samba Server Simple]] 
 +  * [[https://www.server-world.info/en/note?os=Debian_11&p=samba&f=2|Samba : Limited Shared Folder]] 
 + 
 +---- 
 + 
 +<- home_server:home_server_setup:other_services:apt|Prev ^ home_server:home_server_setup:other_services:index|Start page ^ home_server:home_server_setup:other_services:logrotate|Next ->