Git Product home page Git Product logo

kongkrit / samba Goto Github PK

View Code? Open in Web Editor NEW

This project forked from deftwork/samba

0.0 0.0 0.0 44 KB

A Dockerfile to build images for AMD & ARM devices with a installation of Samba that is the standard Windows interoperability suite of programs for Linux and Unix. This is my personal Multi-architecture docker recipe.

License: MIT License

Dockerfile 9.28% Makefile 25.73% Shell 64.99%

samba's Introduction

Samba

A Docker file to build images for many platforms (linux/amd64, linux/arm64, linux/ppc64le, linux/s390x, linux/386, linux/arm/v7, linux/arm/v6) with a installation of Samba that is the standard Windows interoperability suite of programs for Linux and Unix. This is my own Multi-architecture docker recipe.

Be aware! You should read carefully the usage documentation of every tool!

Thanks to

Details

Docker Hub Docker Pulls Docker Stars Size/Layers
samba

Build Instructions

Build for amd64, armv7l, aarch64 architecture (thanks to its Multi-Arch base image)

docker build -t elswork/samba .

Usage

I use it to share files between Linux and Windows, but Samba has many other capabilities.

ATTENTION: This is a recipe highly adapted to my needs, it might not fit yours. Deal with local filesystem permissions, container permissions and Samba permissions is a Hell, so I've made a workarround to keep things as simple as possible. I want avoid that the usage of this conainer would affect current file permisions of my local system, so, I've "synchronized" the owner of the path to be shared with Samba user. This mean that some commitments and limitations must be assumed.

Container will be configured as samba sharing server and it just needs:

  • host directories to be mounted,
  • users (one or more uid:gid:username:usergroup:password tuples) provided,
  • shares defined (name, path, users).

-u uid:gid:username:usergroup:password

  • uid from user p.e. 1000
  • gid from group that user belong p.e. 1000
  • username p.e. alice
  • usergroup (wich user must belong) p.e. alice
  • password (The password may be different from the user's actual password from your host filesystem)

-s name:path:show:rw:user1[,user2[,userN]]

  • add a share that is accessible as 'name', exposing contents of 'path' directory. 'show' or 'hidden' controls whether this 'name' is browsable or not. this share also has read+write (rw) or read-only (ro)access control for specified logins user1, user2, .., userN

Environmental Variable(s)

  • DISABLE_SOCKET_OPTIONS, by default, the [global] section of the container's smb.conf will contain the line:
    socket options = TCP_NODELAY SO_RCVBUF=8192 SO_SNDBUF=8192
    
    This may cause slow transfer for some use cases. In order to disable this line, add -e DISABLE_SOCKET_OPTIONS=yes to docker run.

Serve

Start a samba fileshare.

docker run -d -p 139:139 -p 445:445 \
  -- hostname any-host-name \ # Optional
  -e TZ=Europe/Madrid \ # Optional
  -v /any/path:/share/data \ # Replace /any/path with some path in your system owned by a real user from your host filesystem
  elswork/samba \
  -u "1000:1000:alice:alice:put-any-password-here" \ # At least the first user must match (password can be different) with a real user from your host filesystem
  -u "1001:1001:bob:bob:secret" \
  -u "1002:1002:guest:guest:guest" \
  -s "Backup directory:/share/backups:show:rw:alice,bob" \ 
  -s "Alice (private):/share/data/alice:show:rw:alice" \
  -s "Bob (private):/share/data/bob:hidden:rw:bob" \ # Bob's private share does not show up when user is browsing the shares
  -s "Documents (readonly):/share/data/documents:show:ro:guest,alice,bob"

This is my real usage command:

docker run -d -p 445:445 -e TZ=Europe/Madrid \
    -v /home/pirate/docker/makefile:/share/folder elswork/samba \
    -u "1000:1000:pirate:pirate:put-any-password-here" \
    -s "SmbShare:/share/folder:show:rw:pirate"

or this if the user that owns the path to be shared match with the user that raise up the container:

docker run -d -p 445:445 --hostname $HOSTNAME -e TZ=Europe/Madrid \
    -v /home/pirate/docker/makefile:/share/folder elswork/samba \
    -u "$(id -u):$(id -g):$(id -un):$(id -gn):put-any-password-here" \
    -s "SmbShare:/share/folder:show:rw:$(id -un)"

On Windows point your filebrowser to \\host-ip\ to preview site.


Sponsor me! Together we will be unstoppable.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.