multimediabs/sftp

SFTP镜像

!https://img.shields.io/github/workflow/status/atmoz/sftp/build?logo=github !https://img.shields.io/github/stars/atmoz/sftp?logo=github !https://img.shields.io/docker/stars/atmoz/sftp?label=stars&logo=docker !https://img.shields.io/docker/pulls/atmoz/sftp?label=pulls&logo=docker

!https://raw.githubusercontent.com/atmoz/sftp/master/openssh.png "Powered by OpenSSH"

支持的标签及对应Dockerfile链接

• https://github.com/atmoz/sftp/blob/master/Dockerfile !https://img.shields.io/docker/image-size/atmoz/sftp/debian?label=debian&logo=debian&style=plastic
• https://github.com/atmoz/sftp/blob/master/Dockerfile-alpine !https://img.shields.io/docker/image-size/atmoz/sftp/alpine?label=alpine&logo=Alpine%20Linux&style=plastic

镜像概述

基于OpenSSH实现的SFTP（SSH文件传输协议）服务器镜像，提供安全、灵活的文件共享能力。支持多种用户配置方式、卷挂载、密钥登录等特性，适用于个人或团队的文件交换场景。

核心功能

1. 灵活用户配置：通过命令行参数、环境变量或配置文件定义用户，支持明文/加密密码、UID/GID设置及目录创建。
2. 卷挂载：用户被限制在主目录内，可挂载主机目录实现文件持久化或共享。
3. 密钥登录：挂载公钥文件实现无密码登录，提升安全性。
4. 自定义主机密钥：挂载自定义SSH主机密钥，避免容器重建时的MITM警告。
5. 自定义脚本：在/etc/sftp.d/目录放置脚本，容器启动时自动执行。

使用场景

• 个人文件跨设备传输
• 团队协作文件共享
• 开发环境资源同步

配置说明

用户定义语法

格式：user:pass[:e][:uid[:gid[:dir1[,dir2]...]]]

• :e：标记密码为加密形式
• uid/gid：手动设置用户ID，匹配主机权限
• dir1,dir2：用户主目录下自动创建的子目录（带写权限）

卷挂载注意事项

• 用户主目录为chroot环境，需挂载到用户主目录内（如/home/user/upload）
• 直接挂载/home时，需确保用户主目录下有至少一个子目录（用户无法直接在主目录创建文件）

部署示例

最简启动

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

用户foo用密码pass登录，可上传文件到upload目录。

共享主机目录

bash
docker run \
    -v <主机目录>/upload:/home/foo/upload \
    -p 2222:22 -d atmoz/sftp \
    foo:pass:1001

Docker Compose配置

yaml
sftp:
    image: atmoz/sftp
    volumes:
        - <主机目录>/upload:/home/foo/upload
    ports:
        - "2222:22"
    command: foo:pass:1001

登录方式

bash
sftp -P 2222 foo@<主机IP>

配置文件管理用户

bash
docker run \
    -v <主机目录>/users.conf:/etc/sftp/users.conf:ro \
    -v mySftpVolume:/home \
    -p 2222:22 -d atmoz/sftp

users.conf示例：

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

加密密码登录

bash
docker run \
    -v <主机目录>/share:/home/foo/share \
    -p 2222:22 -d atmoz/sftp \
    'foo:$1$0G2g0GSt$ewU0t6GXG15.0hWoOX8X9.:e:1001'

生成加密密码：

bash
echo -n "你的密码" | docker run -i --rm atmoz/makepasswd --crypt-md5 --clearfrom=-

SSH密钥登录

bash
docker run \
    -v <主机目录>/id_rsa.pub:/home/foo/.ssh/keys/id_rsa.pub:ro \
    -v <主机目录>/share:/home/foo/share \
    -p 2222:22 -d atmoz/sftp \
    foo::1001

自定义主机密钥

bash
docker run \
    -v <主机目录>/ssh_host_ed25519_key:/etc/ssh/ssh_host_ed25519_key \
    -v <主机目录>/ssh_host_rsa_key:/etc/ssh/ssh_host_rsa_key \
    -v <主机目录>/share:/home/foo/share \
    -p 2222:22 -d 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倍
• 稳定性：Debian更稳定（仅安全更新）；Alpine更新周期快（6个月），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
  镜像构建时间可能影响版本可用性，建议手动构建确保版本可控。