checkoutfinland/dummy-sftp-server

SFTP模拟服务器Docker镜像

https://travis-ci.org/CheckoutFinland/docker-dummy-sftp-server.svg?branch=master](https://travis-ci.org/CheckoutFinland/docker-dummy-sftp-server)

该镜像用于在集成测试中模拟SFTP服务器，提供轻量级的SSH服务环境。

镜像概述

基于Alpine基础镜像构建的轻量级SFTP服务器，支持灵活的环境变量配置，适用于测试场景下快速搭建模拟SFTP服务。

核心功能

• 基于Alpine镜像，体积小巧
• 内置SSH服务器
• 通过环境变量配置用户信息（用户名、密钥/密码）
• 自定义用户主目录
• 支持chroot模式（限制用户访问范围）
• 支持SSH公钥认证

使用场景

• 集成测试中模拟SFTP服务器交互
• 开发环境中快速搭建测试用SFTP服务
• 验证SFTP客户端功能的测试场景

配置说明

环境变量配置

必选变量

• USERNAME: 登录用户名
• PUBLIC_KEY: SSH公钥（与PASSWORD二选一）
• PASSWORD: 登录密码（与PUBLIC_KEY二选一）
• FOLDER: 用户主目录路径

可选变量

• CHROOT: 是否启用chroot模式（1=启用，默认1）
• OWNER_ID: 用户UID（未设置时自动获取FOLDER目录的所有者UID）
• PUBLIC_KEYS_PATH: 授权密钥文件路径（默认/etc/ssh/authorized_keys）
• PORT: 服务端口（默认22）

Docker Compose示例

yml
version: '2'
services:
  sshtest:
    image: checkoutfinland/dummy-sftp-server
    environment:
      USERNAME: sftp
      PUBLIC_KEY: ssh-rsa AAAA.... # 替换为实际公钥
      PUBLIC_KEYS_PATH: /etc/ssh/authorized_keys
      FOLDER: /in
      CHROOT: 1
      PORT: 2238
    cap_add:
      - SYS_ADMIN # 启用chroot需添加
    security_opt:
      - apparmor:unconfined # 启用chroot需添加
    ports:
      - 2238:2238
    volumes:
      - ./ssh-data:/in

验证方法

使用SFTP客户端连接验证：

bash
sftp -oPort=2238 sftp@localhost:/in

许可证

http://www.fsf.org/licensing/licenses/info/GPLv2.html 或更高版本GPL许可。