vishaljain088/sftp

SFTP镜像概述

该镜像提供基于OpenSSH的SFTP（SSH文件传输协议）服务器功能，支持Debian和Alpine两种基础版本，具备轻量、安全、易配置的特点，满足企业或个人的安全文件传输需求。

核心功能

• 灵活用户管理：通过命令参数、环境变量或配置文件定义用户（支持密码加密、UID/GID设置）
• 安全认证：支持SSH公钥登录，提升访问安全性
• 目录挂载：可将主机目录或卷挂载到用户家目录，实现文件共享
• 自定义脚本：容器启动时自动执行/etc/sftp.d/目录下的脚本
• 主机密钥持久化：挂载自定义SSH主机密钥，避免重建容器时的MITM警告

使用场景

• 企业内部文件安全传输
• 跨团队文件共享与协作
• 云环境下的文件备份与同步
• 开发测试环境的文件交换

配置说明

支持标签

• debian/latest：基于Debian的稳定版本
• alpine：基于Alpine的轻量版本

部署示例

最简启动命令

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

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

挂载主机目录并指定UID

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

Docker Compose配置

yaml
sftp:
    image: vishaljain088/sftp
    volumes:
        - /host/upload:/home/foo/upload
    ports:
        - "2222:22"
    command: foo:pass:1001

密钥登录配置

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

自定义主机密钥

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 vishaljain088/sftp \
    foo::1001

注意事项

• 用户默认chroot到家目录，需确保家目录下有可写子目录
• 使用mount的自定义脚本需开启CAP_SYS_ADMIN权限
• 加密密码需加:e标记，可通过atmoz/makepasswd生成加密密码