writl/sftp

SFTP服务器Docker镜像

一个安全、可配置的SFTP服务器Docker容器，用于便捷的文件传输。

核心功能与特性

• SFTP用户的Chroot环境
• 可配置的用户ID（UID）和组ID（GID）
• 支持密码和公钥认证
• 持久化SSH主机密钥
• 现代加密算法
• Terrapin***防护

快速开始

bash
# 使用密码认证启动（必填）
docker run --name sftp -p 2222:22 -e PASS=your_secure_password -d mobilistics/sftp

# 使用数据卷
docker run --name sftp -p 2222:22 -v /host/path:/data/incoming -d mobilistics/sftp

# 使用持久化SSH密钥
docker run --name sftp -p 2222:22 \
  -v /host/path/data:/data/incoming \
  -v /host/path/ssh:/ssh \
  -d mobilistics/sftp

# 使用自定义用户凭据
docker run --name sftp -p 2222:22 \
  -v /host/path/data:/data/incoming \
  -e USER=myuser \
  -e PASS=secure_password \
  -d mobilistics/sftp

配置选项

重要提示：必须指定PASS或PUBKEY。为提高安全性，建议使用SSH密钥（PUBKEY）而非密码。

卷配置

镜像使用两个重要卷：

1. /data/incoming：文件传输目录
2. /ssh：SSH主机密钥存储目录（可选，用于持久化）

bash
# 带卷定义的示例
docker volume create sftp-data
docker volume create sftp-keys

docker run --name sftp -p 2222:22 \
  -v sftp-data:/data/incoming \
  -v sftp-keys:/ssh \
  -d mobilistics/sftp

连接到SFTP服务器

命令行（Linux/macOS/Windows带OpenSSH）

bash
# 使用密码连接（交互式输入）
sftp -P 2222 sftp@localhost

# 使用私钥连接
sftp -P 2222 -i /path/to/private_key sftp@localhost

Docker Compose示例

yaml
version: "3"

services:
  sftp:
    image: mobilistics/sftp
    container_name: sftp-server
    ports:
      - "2222:22"
    volumes:
      - ./data:/data/incoming
      - ./ssh:/ssh
    environment:
      - USER=myuser
      - PASS=my_secure_password
      - USER_ID=1000
      - GROUP_ID=1000
    restart: unless-stopped

故障排除

SSH/SFTP连接问题

bash
# 检查容器是否运行
docker ps | grep sftp

# 查看容器日志
docker logs sftp

# 进入容器调试
docker exec -it sftp bash