ez123/sftp

SFTP

支持的标签及对应Dockerfile链接

• https://github.com/atmoz/sftp/blob/master/Dockerfile
• https://github.com/atmoz/sftp/blob/debian-jessie/Dockerfile
• https://github.com/atmoz/sftp/blob/alpine/Dockerfile
• https://github.com/atmoz/sftp/blob/alpine-3.6/Dockerfile

镜像概述

这是一个基于OpenSSH的轻量易用SFTP（SSH文件传输协议）服务器镜像，支持Debian和Alpine两种Linux发行版，通过自动化构建与官方基础镜像同步更新，提供安全可靠的文件传输能力。

核心功能

1. 灵活的用户管理：支持通过命令参数、环境变量或配置文件定义用户，可设置密码（明文/加密）、UID/GID及自定义目录。
2. 安全认证方式：支持密码登录和SSH密钥登录，保障访问安全。
3. 目录挂载：用户被限制在其主目录内，可通过卷挂载实现本地目录与容器目录的映射。
4. 自定义SSH主机密钥：支持挂载自定义主机密钥，避免容器重建时的MITM警告。
5. 启动脚本执行：可将自定义脚本放入/etc/sftp.d/目录，容器启动时自动运行。

使用场景

• 个人文件备份与远程访问
• 团队内部文件协作与共享
• 跨服务器间的安全文件同步
• 应用系统的文件上传/下载服务

配置说明

1. 用户定义语法：user:pass[:e][:uid[:gid[:dir1[,dir2]...]]]，其中:e表示密码已加密，dir为用户主目录下的子目录（自动创建）。
2. 目录挂载注意事项：用户无法直接在主目录创建文件，需挂载或创建子目录用于文件上传。
3. 密钥登录配置：将公钥文件挂载到用户主目录下的.ssh/keys/目录，容器会自动添加到authorized_keys。

部署示例

最简Docker Run示例

bash
docker run -p 22:22 -d docker.xuanyuan.run/atmoz/sftp foo:pass:::upload

用户foo使用密码pass登录，可上传文件到upload目录，无自定义UID/GID或卷挂载。

共享本地目录

挂载本地目录并设置用户UID：

bash
docker run \
    -v /host/upload:/home/foo/upload \
    -p 2222:22 -d docker.xuanyuan.run/atmoz/sftp \
    foo:pass:1001

Docker Compose配置

yaml
sftp:
    image: docker.xuanyuan.run/atmoz/sftp
    volumes:
        - /host/upload:/home/foo/upload
    ports:
        - "2222:22"
    command: foo:pass:1001

登录方式

使用OpenSSH客户端登录：sftp -P 2222 foo@<主机IP>

通过配置文件管理用户

bash
docker run \
    -v /host/users.conf:/etc/sftp/users.conf:ro \
    -v mySftpVolume:/home \
    -p 2222:22 -d docker.xuanyuan.run/atmoz/sftp

/host/users.conf内容示例：

foo:123:1001:100
bar:abc:1002:100
baz:xyz:1003:100

加密密码登录

在密码后添加:e标记为加密密码：

bash
docker run \
    -v /host/share:/home/foo/share \
    -p 2222:22 -d docker.xuanyuan.run/atmoz/sftp \
    'foo:$1$0G2g0GSt$ewU0t6GXG15.0hWoOX8X9.:e:1001'

可使用atmoz/makepasswd生成加密密码：

bash
echo -n "your-password" | docker run -i --rm atmoz/makepasswd --crypt-md5 --clearfrom=-

SSH密钥登录

挂载公钥文件到用户的.ssh/keys/目录：

bash
docker run \
    -v /host/id_rsa.pub:/home/foo/.ssh/keys/id_rsa.pub:ro \
    -v /host/id_other.pub:/home/foo/.ssh/keys/id_other.pub:ro \
    -v /host/share:/home/foo/share \
    -p 2222:22 -d docker.xuanyuan.run/atmoz/sftp \
    foo::1001

自定义SSH主机密钥

bash
docker run \
    -v /host/ssh_host_ed25519_key:/etc/ssh/ssh_host_ed25519_key \
    -v /host/ssh_host_rsa_key:/etc/ssh/ssh_host_rsa_key \
    -v /host/share:/home/foo/share \
    -p 2222:22 -d docker.xuanyuan.run/atmoz/sftp \
    foo::1001

生成密钥命令：

bash
ssh-keygen -t ed25519 -f ssh_host_ed25519_key < /dev/null
ssh-keygen -t rsa -b 4096 -f ssh_host_rsa_key < /dev/null

Debian与Alpine版本区别

• 大小：Alpine版本比Debian小10倍左右。
• OpenSSH版本：Alpine更新周期更快（约6个月），OpenSSH版本较新；Debian更稳定（约2年更新一次），仅提供 bugfix 和安全更新。

OpenSSH版本查询

根据选择的发行版及版本，可通过以下链接查询OpenSSH版本：

• https://pkgs.alpinelinux.org/packages?name=openssh&branch=&repo=main&arch=x86_64
• https://packages.debian.org/search?keywords=openssh-server&searchon=names&exact=1&suite=all&section=main 注意：镜像构建时间可能延迟OpenSSH新版本的发布，可通过克隆仓库手动构建以获取最新版本。