cepharum/sftp

cepharum/sftp 镜像说明

镜像概述

本容器是云服务的组成部分，用于让用户通过SFTP协议安全访问其云存储中的个人文件。镜像基于Debian系统构建，集成LDAP认证与chroot隔离机制，确保用户访问的安全性与数据隔离性。

核心功能

• 基于Debian模板构建，提供稳定的基础运行环境；
• 配置OpenSSH服务，仅开放SFTP访问权限，限制其他SSH功能；
• 通过PAM集成远程LDAP服务，实现用户列表获取与身份认证；
• 用户登录时自动进入chroot jail，仅能访问自身文件目录；
• 登录时自动创建必要子文件夹（如files），限制用户对主目录的写入权限，仅允许写入指定子文件夹。

使用场景

• 企业内部员工通过SFTP安全访问个人云存储文件；
• 需要LDAP统一用户认证的SFTP服务部署场景；
• 对用户文件访问权限有严格隔离要求的云服务场景。

配置说明

环境变量

• LDAP_URI（必填）：LDAP服务的URI，例如ldaps://ldap.mycompany.com；
• LDAP_BASE_DN（必填）：限制访问用户的Base-DN，例如ou=people,dc=mycompany,dc=com；
• LDAP_BIND_DN（可选）：LDAP绑定的DN，用于获取用户列表或认证前的绑定操作；
• LDAP_BIND_PW（可选）：LDAP绑定的密码，与LDAP_BIND_DN配合使用。

Docker部署示例

docker run命令

bash
docker run -d \
  -p 2222:22 \
  -v /host/path/to/user/storage:/home \
  -e LDAP_URI=ldaps://ldap.example.com \
  -e LDAP_BASE_DN=ou=users,dc=example,dc=com \
  -e LDAP_BIND_DN=cn=sftp-auth,dc=example,dc=com \
  -e LDAP_BIND_PW=your_auth_password \
  docker.xuanyuan.run/cepharum/sftp

说明

• -p 2222:22：将容器的22端口映射到主机的2222端口；
• -v /host/path/to/user/storage:/home：挂载主机目录到容器的用户文件存储位置；
• 替换环境变量值为实际的LDAP服务配置信息。