3分钟快速部署：Docker SFTP服务器终极指南

【免费下载链接】sftpSecurely share your files项目地址: https://gitcode.com/gh_mirrors/sf/sftp

想要在团队中安全地共享文件，但又不想搭建复杂的FTP服务器？atmoz/sftp项目为你提供了一个简单高效的解决方案！🚀 这是一个基于Docker的轻量级SFTP服务器，让你在几分钟内就能搭建起安全的文件传输服务。

📁 快速入门：3步搞定SFTP服务器

第一步：获取项目代码

git clone https://gitcode.com/gh_mirrors/sf/sftp

第二步：最简单的启动方式

docker run -p 2222:22 -d atmoz/sftp alice:password123:::upload

这个命令会创建一个名为"alice"的用户，密码为"password123"，并自动创建upload目录用于文件上传。

第三步：连接测试

sftp -P 2222 alice@localhost

输入密码后，你就可以开始上传下载文件了！

⚡ 核心功能一览

🔒 安全文件传输

基于OpenSSH构建，提供企业级的安全保障。所有数据传输都经过SSH加密，确保文件传输过程中的绝对安全。

📦 多用户管理

支持通过三种方式管理用户：

1. 命令行参数：直接传递用户名密码
2. 环境变量：通过SFTP_USERS环境变量配置
3. 配置文件：使用/etc/sftp/users.conf文件管理

🗂️ 灵活的目录挂载

每个用户都可以拥有独立的目录结构，支持自定义UID/GID，确保文件权限与宿主机系统保持一致。

🔑 SSH密钥认证

支持免密码登录，只需将公钥文件挂载到用户的.ssh/keys/目录即可。

⚙️ 进阶配置技巧

💡专业提示：对于生产环境，建议使用配置文件管理用户，这样更易于维护和版本控制。

使用Docker Compose部署

创建docker-compose.yml文件：

version: '3' services: sftp: image: atmoz/sftp volumes: - ./uploads:/home/alice/uploads - ./users.conf:/etc/sftp/users.conf:ro ports: - "2222:22" restart: unless-stopped

自定义用户配置文件

创建users.conf文件：

# 格式：用户名:密码[:e][:uid[:gid[:dir1[,dir2]...]]] alice:password123:1000:100:uploads,downloads bob:securepass:1001:100:shared charlie::1002:100 # 无密码，仅使用SSH密钥

持久化SSH主机密钥

为了避免容器重启后SSH指纹变化导致的安全警告，可以挂载自定义的SSH主机密钥：

docker run \ -v ./ssh_host_keys/:/etc/ssh/ \ -v ./uploads:/home/alice/uploads \ -p 2222:22 -d atmoz/sftp \ alice:password123:1000

❓ 常见问题解答

docker run --rm python:alpine python -c "import crypt; print(crypt.crypt('你的密码'))"

docker run -p 2222:22 -d atmoz/sftp user:pass:1000:100:uploads

#!/bin/bash mount --bind /shared-data /home/user1/shared mount --bind /shared-data /home/user2/shared

🎯 最佳实践建议

安全第一

1. 使用强密码：避免使用简单密码
2. 启用SSH密钥认证：对于经常访问的用户
3. 定期更新镜像：获取最新的安全补丁

性能优化

1. 选择合适的基础镜像：资源紧张用Alpine，稳定性要求高用Debian
2. 合理规划目录结构：避免单个目录文件过多
3. 监控日志：定期检查访问日志

备份策略

1. 定期备份用户配置
2. 备份SSH主机密钥
3. 重要文件异地备份

📊 实际应用场景

开发团队协作

开发团队可以使用atmoz/sftp快速搭建一个临时的文件共享服务器，用于分享构建产物、测试数据等。

客户文件上传

为客户提供一个安全的文件上传入口，每个客户有独立的目录，互不干扰。

自动化脚本集成

通过SFTP协议与各种自动化工具集成，实现文件的自动化传输和处理。

🔧 故障排除

问题：连接被拒绝解决：检查端口映射是否正确，防火墙是否放行2222端口。

问题：权限错误解决：确保挂载的目录对容器内的用户有正确的读写权限。

问题：SSH密钥认证失败解决：检查公钥文件权限，确保为644或更严格的权限。

🚀 开始你的SFTP之旅

atmoz/sftp项目最大的优势就是简单。你不需要成为系统管理员，也不需要深入理解SSH的复杂配置。只需要几条Docker命令，就能拥有一个功能完整、安全可靠的SFTP服务器。

记住，安全文件传输不再是大型企业的专利。现在，你也可以轻松拥有！⚡

基于OpenSSH的安全文件传输架构

无论你是个人开发者、小团队，还是需要临时文件共享的场景，atmoz/sftp都能满足你的需求。现在就去试试吧，体验简单安全的文件传输！

【免费下载链接】sftpSecurely share your files项目地址: https://gitcode.com/gh_mirrors/sf/sftp