diff --git a/README.md b/README.md index 9a0c0cc..520fe73 100644 --- a/README.md +++ b/README.md @@ -11,17 +11,32 @@ This is an automated build linked with the [debian](https://hub.docker.com/_/deb # Usage - Define users as command arguments, STDIN or mounted in `/etc/sftp-users.conf` - (syntax: `user:pass[:e][:uid[:gid]]...`). - - You must set custom UID for your users if you want them to make changes to + (syntax: `user:pass[:e][:uid[:gid[:dir1[,dir2]...]]]...`). + - Set UID/GID manually for your users if you want them to make changes to your mounted volumes with permissions matching your host filesystem. -- Mount volumes in user's home folder. + - Add directory names at the end, if you want to create them and/or set user + owership. Perfect when you just want a fast way to upload something without + mounting any directories, or you want to make sure a directory is owned by + a user. +- Mount volumes in user's home direcotry. - The users are chrooted to their home directory, so you must mount the volumes in separate directories inside the user's home directory (/home/user/**mounted-directory**). # Examples -## Simple docker run example + +## Simplest docker run example + +``` +docker run -p 22:22 -d atmoz/sftp foo:pass:::upload +``` + +No mounted directories or custom UID/GID. User "foo" with password "pass" can login with sftp and upload files to a folder called "upload". Later you can inspect the files and use `--volumes-from` to mount them somewhere else (or see next example). + +## Sharing a directory from your computer + +Let's mount a direcotry and set UID: ``` docker run \ @@ -80,9 +95,9 @@ docker run \ Tip: you can use [atmoz/makepasswd](https://hub.docker.com/r/atmoz/makepasswd/) to generate encrypted passwords: `echo -n "your-password" | docker run -i --rm atmoz/makepasswd --crypt-md5 --clearfrom=-` -## Using SSH key (without password) +## Using SSH key (and no password) -Mount all public keys in the user's `.ssh/keys/` folder. All keys are automatically +Mount all public keys in the user's `.ssh/keys/` direcotry. All keys are automatically appended to `.ssh/authorized_keys`. ``` diff --git a/entrypoint b/entrypoint index 5d5f81d..18d9e7b 100755 --- a/entrypoint +++ b/entrypoint @@ -7,7 +7,7 @@ userConfFinalPath="/var/run/sftp-users.conf" function printHelp() { echo "Add users as command arguments, STDIN or mounted in $userConfPath" - echo "Syntax: user:pass[:e][:uid[:gid]]..." + echo "Syntax: user:pass[:e][:uid[:gid[:dir1[,dir2]...]]] ..." echo "Use --readme for more information and examples." } @@ -25,9 +25,11 @@ function createUser() { chpasswdOptions="-e" uid="${param[3]}" gid="${param[4]}" + dir="${param[5]}" else uid="${param[2]}" gid="${param[3]}" + dir="${param[4]}" fi if [ -z "$user" ]; then @@ -72,6 +74,18 @@ function createUser() { chown $user /home/$user/.ssh/authorized_keys chmod 600 /home/$user/.ssh/authorized_keys fi + + # Make sure dirs exists and has correct permissions + if [ -n "$dir" ]; then + while IFS=',' read -ra dirParam; do + for dirPath in $dirParam; do + dirPath=/home/$user/$dirPath + echo "Creating and/or setting permissions on $dirPath" + mkdir -p $dirPath + chown -R $user:users $dirPath + done + done <<< $dir + fi } if [[ $1 =~ ^--help$|^-h$ ]]; then @@ -128,7 +142,10 @@ fi # Source custom scripts, if any if [ -d /etc/sftp.d ]; then for f in /etc/sftp.d/*; do - [ -x "$f" ] && . "$f" + if [ -x "$f" ]; then + echo "Running $f ..." + $f + fi done unset f fi diff --git a/tests/run b/tests/run index 44b74bf..246fec8 100755 --- a/tests/run +++ b/tests/run @@ -36,7 +36,7 @@ function beforeTest() { rm -rf "$tmpDir" # clean state mkdir "$tmpDir" - echo "test::$(id -u):$(id -g)" >> "$tmpDir/users" + echo "test::$(id -u):$(id -g):dir" >> "$tmpDir/users" docker run \ -v "$tmpDir/users:/etc/sftp-users.conf:ro" \ -v "$scriptDir/id_rsa.pub":/home/test/.ssh/keys/id_rsa.pub:ro \ @@ -86,6 +86,51 @@ function runSftpCommands() { ############################################################################## +function testContainerIsRunning() { + $skipAllTests && skip && return 0 + + ps="$(docker ps -q -f name="$sftpContainerName")" + assertNotEqual "$ps" "" + + if [ -z "$ps" ]; then + skipAllTests=true + fi +} + +function testLoginUsingSshKey() { + $skipAllTests && skip && return 0 + + runSftpCommands "$sftpContainerName" \ + "test" \ + "exit" + assertReturn $? 0 +} + +function testWritePermission() { + $skipAllTests && skip && return 0 + + runSftpCommands "$sftpContainerName" \ + "test" \ + "cd share" \ + "mkdir test" \ + "exit" + test -d "$tmpDir/test" + assertReturn $? 0 +} + +function testDir() { + $skipAllTests && skip && return 0 + + runSftpCommands "$sftpContainerName" \ + "test" \ + "cd dir" \ + "mkdir test2" \ + "get -rf test2 $tmpDir/" \ + "exit" + test -d "$tmpDir/test2" + assertReturn $? 0 +} + function testMinimalContainerStart() { $skipAllTests && skip && return 0 @@ -114,32 +159,6 @@ function testMinimalContainerStart() { fi } -function testContainerIsRunning() { - $skipAllTests && skip && return 0 - - ps="$(docker ps -q -f name="$sftpContainerName")" - assertNotEqual "$ps" "" - - if [ -z "$ps" ]; then - skipAllTests=true - fi -} - -function testLoginUsingSshKey() { - $skipAllTests && skip && return 0 - - runSftpCommands "$sftpContainerName" "test" "exit" - assertReturn $? 0 -} - -function testWritePermission() { - $skipAllTests && skip && return 0 - - runSftpCommands "$sftpContainerName" "test" "cd share" "mkdir test" "exit" - test -d "$tmpDir/test" - assertReturn $? 0 -} - # Bind-mount folder using script in /etc/sftp.d/ function testCustomContainerStart() { $skipAllTests && skip && return 0