tkal/sftpstaticssl

SFTP服务器镜像概述

本镜像基于OpenSSH实现SFTP（SSH文件传输协议）服务，提供安全、易用的文件传输能力。支持多种用户配置方式，可灵活适配不同场景的文件共享需求，适用于团队协作、服务器间数据同步等场景。

核心功能

1. 灵活用户管理：通过命令参数、环境变量或配置文件定义用户，支持明文/加密密码、UID/GID及自定义目录设置；
2. 安全认证：支持密码登录与SSH密钥登录，保障访问安全性；
3. 自定义配置：可挂载SSH主机密钥避免MITM警告，支持启动脚本实现个性化配置；
4. 卷挂载：支持主机目录/卷挂载到用户主目录，实现文件持久化与共享。

使用场景

• 团队内部文件共享与协作；
• 服务器间安全文件传输；
• 开发环境文件上传与部署；
• 敏感数据的安全交换。

配置说明

用户定义方式

• 命令参数：格式为user:pass[:e][:uid[:gid[:dir1[,dir2]...]]]；
• 环境变量：通过SFTP_USERS设置用户；
• 配置文件：挂载/etc/sftp/users.conf（每行一个用户，格式同命令参数）。

关键注意事项

• 用户默认chroot到主目录，需确保主目录下有可写子目录；
• 加密密码需加:e标记，推荐使用atmoz/makepasswd生成；
• 挂载自定义SSH主机密钥可保持指纹一致。

部署示例

最简启动

bash
docker run -p 22:22 -d tkal/sftpstaticssl foo:pass:::upload

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

Docker Compose配置

yaml
sftp:
  image: tkal/sftpstaticssl
  volumes:
    - ./upload:/home/foo/upload
  ports:
    - "2222:22"
  command: foo:pass:1001

映射主机./upload到用户foo的upload目录，端口2222→22。

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 tkal/sftpstaticssl \
  foo::1001

用户foo仅通过密钥登录，访问share目录。

自定义主机密钥

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 tkal/sftpstaticssl \
  foo::1001

挂载自定义密钥，避免容器重建时指纹变化。