amimof/sftp

sftp

镜像概述和主要用途

这是一个快速且安全的SFTP服务器，运行在Alpine Linux容器中，针对Kubernetes进行了优化。它提供轻量级、高效的文件传输服务，适合在容器化环境中部署和使用。

核心功能和特性

• 基于Alpine Linux，轻量高效，资源占用低
• 支持密码认证和SSH密钥认证两种方式
• 可通过环境变量灵活配置用户信息（用户名、用户ID）
• 自定义数据目录名称，默认为/home/<username>/data/
• 支持自动生成或自定义SSH主机密钥，避免容器重启时密钥变化
• 可调整日志级别和启用调试模式
• 针对Kubernetes优化，适合在容器编排平台中部署

使用场景和适用范围

• 需要安全文件传输的容器化应用环境
• Kubernetes集群中的SFTP服务部署
• 快速搭建临时或持久的SFTP服务器
• 需要灵活配置认证方式和用户权限的场景

使用方法和配置说明

基本用法

配置参数通过环境变量传递给容器，所有变量均为可选，以便最小化配置启动容器。使用Docker运行的最简单方式如下：

bash
$ docker run -p 22:22 -e SSH_PASSWORD=notsecure amimof/sftp:latest

注意：尽管用户名默认为sftpuser，但仍需指定密码。虽然不是强制要求，但没有密码的容器无法正常使用。

环境变量

示例

用户名密码认证

bash
$ docker run \
    -p 22:22 \
    -e SSH_USERNAME=sftpuser \
    -e SSH_PASSWORD=notsecure \
    amimof/sftp:latest

SSH密钥认证

bash
$ docker run \
    -p 22:22 \
    -e SSH_USERNAME=sftpuser \
    -v ~/.ssh/id_rsa.pub:/home/sftpuser/.ssh/keys/id_rsa.pub \
    amimof/sftp:latest

指定SSH主机密钥

除非通过SSH_GENERATE_HOSTKEYS环境变量指定，否则SSH主机密钥将自动生成并在容器重启时变化。为避免“中间人***”警告，可将自定义主机密钥挂载到容器中。

bash
$ docker run \
    -p 22:22 \
    -e SSH_USERNAME=sftpuser \
    -e SSH_PASSWORD=notsecure \
    -e SSH_GENERATE_HOSTKEYS=false \
    -v ~/ssh_host_ed25519_key:/etc/ssh/host_keys/ssh_host_ed25519_key \
    -v ~/ssh_host_rsa_key:/etc/ssh/host_keys/ssh_host_rsa_key \
    amimof/sftp:latest

注意！ 主机密钥位于非默认路径/etc/ssh/host_keys/，以便使用Kubernetes Secret挂载主机密钥。如果将密钥挂载到默认路径/etc/ssh/，该目录下的其他文件（包括sshd_config）将被覆盖，导致SSH服务器无法正常启动。

指定SSH主机密钥并使用密钥认证

bash
$ docker run \
    -p 22:22 \
    -e SSH_USERNAME=sftpuser \
    -e SSH_GENERATE_HOSTKEYS=false \
    -v ~/.ssh/id_rsa.pub:/home/sftpuser/.ssh/keys/id_rsa.pub \
    -v ~/ssh_host_ed25519_key:/etc/ssh/host_keys/ssh_host_ed25519_key \
    -v ~/ssh_host_rsa_key:/etc/ssh/host_keys/ssh_host_rsa_key \
    amimof/sftp:latest

生成密钥

bash
# rsa
ssh-keygen -t rsa -b 4096 -f ~/mykeys/ssh_host_rsa_key

# dsa
ssh-keygen -t dsa -f ~/mykeys/ssh_host_dsa_key

# ecdsa
ssh-keygen -t ecdsa -f ~/mykeys/ssh_host_ecdsa_key

# ed25519
ssh-keygen -t ed25519 -f ~/mykeys/ssh_host_ed25519_key