jauderho/sftpd

jauderho/sftpd 镜像文档

镜像概述

jauderho/sftpd 是一个最小化的 SFTP 服务器 Docker 容器，旨在提供轻量级、可靠的文件传输服务。该镜像支持多平台部署，且保持高度时效性——在 upstream 发布后一小时内完成构建，并每周至少重建一次，确保安全性和功能更新。

镜像信息

• 构建状态：https://github.com/jauderho/dockerfiles/workflows/sftpd/badge.svg](https://github.com/jauderho/dockerfiles/actions?query=workflow%3Asftpd)
• 最新版本：
• 拉取量：
• 镜像大小：

核心功能与特性

1. 最小化设计：镜像体积精简，仅包含运行 SFTP 服务所需的核心组件，减少资源占用。
2. 多平台支持：适配多种架构，可在不同硬件平台上稳定运行。
3. 及时更新：在 upstream（如 OpenSSH）发布新版本后一小时内完成镜像构建，并每周至少重建一次，确保安全补丁和功能更新及时应用。
4. 基于 OpenSSH：使用开源的 OpenSSH 实现 SFTP 功能，兼容性强且安全可靠。

使用场景与适用范围

• 开发环境：用于开发团队内部的文件传输与共享。
• 测试环境：作为轻量级文件服务器，支持自动化测试中的文件上传/下载场景。
• 生产环境：适用于对资源占用敏感、需要稳定 SFTP 服务的场景（需结合实际安全需求配置）。
• 临时文件传输：快速部署临时 SFTP 服务，完成短期文件交换任务。

使用方法与配置说明

基本运行命令

通过 docker run 快速启动 SFTP 服务：

bash
docker run -d \
  -p 2222:22 \  # 映射容器 22 端口到主机 2222 端口（避免与主机 SSH 冲突）
  -v /path/on/host:/data \  # 挂载主机目录到容器内 /data（作为 SFTP 根目录）
  jauderho/sftpd \
  user:pass  # 设置 SFTP 用户名和密码（格式：username:password）

关键参数说明

• 端口映射：容器默认使用 22 端口（SFTP 标准端口），建议映射到主机非默认端口（如示例中的 2222）以避免冲突。
• 数据卷挂载：通过 -v 参数挂载主机目录，确保 SFTP 传输的文件持久化存储在主机上。
• 用户认证：启动命令中需指定 user:pass 格式的用户名和密码，作为 SFTP 登录凭证。

高级配置

如需更复杂的配置（如 SSH 密钥认证、用户权限控制等），建议参考 https://github.com/jauderho/dockerfiles/tree/main/sftpd 获取详细说明。

docker-compose 示例

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  sftpd:
    image: jauderho/sftpd:latest
    ports:
      - "2222:22"
    volumes:
      - ./sftp-data:/data
    command: "myuser:mypassword"  # 替换为实际用户名和密码
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 生产环境中建议使用 SSH 密钥认证替代密码认证，以提升安全性。
• 定期更新镜像（docker pull jauderho/sftpd:latest）以获取最新安全补丁。
• 根据实际需求调整文件权限和挂载目录，避免敏感数据暴露。