willia4/sftp_volume

willia4/sftp_volume镜像说明

镜像概述

本镜像用于创建容器，通过SFTP协议暴露来自其他容器或主机目录的单个卷。支持单用户通过多个私钥进行认证（需注意：若多用户/设备使用各自私钥访问，无法将操作关联到特定主体，因此更适合单一用户或设备访问的场景）。

核心功能

• 暴露其他容器或主机目录的卷供SFTP访问
• 支持单用户密钥认证
• 可自动或手动生成服务器SSH密钥
• 支持自定义用户ID/组ID以匹配卷的权限
• 提供调试模式查看SSH daemon输出

使用场景

适用于需要通过SFTP管理特定目录的场景，例如：

• 静态文件服务器（如Nginx）的文件目录共享与维护
• 容器数据卷的安全远程访问

配置说明

服务器密钥

需挂载卷到/volumes/ssh_keys，包含以下文件：

• ssh_host_rsa_key
• ssh_host_dsa_key
• ssh_host_ecdsa_key
• ssh_host_ed25519_key

自动创建密钥

设置环境变量SFTP_CONTAINER_KEYS='CREATE'，容器会自动生成密钥。警告：若已挂载含密钥的卷并设置此变量，现有密钥将被覆盖！

手动创建密钥

在主机的密钥目录执行以下命令：

bash
cd /my/key/directory
ssh-keygen -f ./ssh_host_rsa_key -N '' -t rsa -b 4096
ssh-keygen -f ./ssh_host_dsa_key -N '' -t dsa
ssh-keygen -f ./ssh_host_ecdsa_key -N '' -t ecdsa -b 521
ssh-keygen -f ./ssh_host_ed25519_key -N '' -t ed25519

用户ID/组ID

• 通过SFTP_CONTAINER_USER指定用户名，SFTP_CONTAINER_GROUP指定组名（不存在则自动创建）
• 通过SFTP_CONTAINER_USER_ID和SFTP_CONTAINER_GROUP_ID指定用户ID和组ID，需与卷所在系统/容器的对应ID一致以确保权限正确

用户密钥

挂载卷到/volumes/user/，包含authorized_keys文件（格式与标准~/.ssh/authorized_keys相同，列出允许访问的公钥）。

数据卷

需暴露的SFTP目录应挂载为/volumes/sftp_root下的子目录（例如：/volumes/sftp_root/www），目录权限需允许SFTP_CONTAINER_USER或SFTP_CONTAINER_GROUP读写。注意：在docker-machine或boot2docker中使用主机挂载卷效果不佳，建议使用数据卷容器。

调试模式

设置环境变量SFTP_CONTAINER_DEBUG="DEBUG"可查看SSH daemon的调试输出（不适合生产环境）。

部署示例

假设主机通过Nginx从/www提供静态文件，文件属主为www-data，需通过SFTP访问该目录：

1. 创建服务器密钥目录并生成密钥：

bash
mkdir /sftp_keys
ssh-keygen -f /sftp_keys/ssh_host_rsa_key -N '' -t rsa -b 4096
ssh-keygen -f /sftp_keys/ssh_host_dsa_key -N '' -t dsa
ssh-keygen -f /sftp_keys/ssh_host_ecdsa_key -N '' -t ecdsa -b 521
ssh-keygen -f /sftp_keys/ssh_host_ed25519_key -N '' -t ed25519

2. 创建用户授权文件：

bash
mkdir /sftp_user
cp $AUTHORIZED_KEYS /sftp_user/authorized_keys

3. 获取www-data的ID：

bash
id www-data
# 输出示例：uid=33(www-data) gid=33(www-data) groups=33(www-data)

4. 确保/www权限正确：

bash
chown www-data:www-data /www

5. 运行容器：

bash
docker run -d \
-e SFTP_CONTAINER_USER="www-data" \
-e SFTP_CONTAINER_USER_ID="33" \
-e SFTP_CONTAINER_GROUP="www-data" \
-e SFTP_CONTAINER_GROUP_ID="33" \
-v "/sftp_keys:/volumes/ssh_keys" \
-v "/www:/volumes/sftp_root/www" \
-v "/sftp_user:/volumes/user" \
-p 4577:22 willia4/sftp_volume

6. 客户端连接：使用SFTP客户端连接主机的4577端口，使用对应私钥认证。