h0tmann/alpine_proftpd_db

Alpine ProFTPD Docker镜像文档

镜像概述

Alpine ProFTPD是一个基于Alpine Linux的轻量级ProFTPD Docker镜像，内置配置模板，支持通过环境变量灵活自定义服务参数。该镜像集成了FTP、SFTP协议支持，提供管理Web界面，并包含日志轮转、用户权限控制等功能，适用于快速部署安全高效的文件传输服务。

核心功能与特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 多协议支持：同时支持FTP、SFTP协议，满足不同场景需求
• 灵活配置：通过环境变量自定义端口、用户权限、加密算法等关键参数
• 管理界面：内置Web管理界面，便于配置管理和用户维护
• 安全增强：支持公钥认证（RFC4716格式）、传输加密、目录访问限制等安全特性
• 日志管理：支持多种日志类型（传输日志、服务器日志、SFTP日志等）及日志轮转
• 时区与编码：支持自定义时区和语言编码，适应不同地区需求

使用场景

• 企业内部安全文件传输服务部署
• 个人或小团队文件共享与备份
• 开发/测试环境中的文件传输节点
• 需要快速迁移的FTP/SFTP服务容器化改造
• 对资源占用敏感的轻量级文件服务场景

部署与使用方法

Docker Compose配置示例

yaml
alpine_proftpd:
  container_name: alpine_proftpd
  image: h0tmann/alpine_proftpd_db:latest
  hostname: alpine_proftpd
  network_mode: host  # 推荐使用host模式以确保端口映射和网络规则正常工作
  environment:
    # 系统变量
    - TZ=Europe/Berlin  # 时区设置，例如"Asia/Shanghai"
    - LANG=de_DE.UTF-8  # 语言编码，例如"zh_CN.UTF-8"
    # 基础ProFTPD设置
    # - PUBLIC_IP=0.0.0.0  # 公网IP，host模式下必填，IPv4+IPv6使用"0.0.0.0 ::"
    # - SFTP_PORT=22       # SFTP端口，默认22
    # - FTP_PORT=21        # FTP端口，默认21
    # 应用用户权限
    # - APP_UID=850        # 运行ProFTPD的用户UID，默认850
    # - APP_GID=850        # 运行ProFTPD的用户GID，默认850
    # 其他配置参数参见"配置参数说明"部分
  volumes:
    - "/etc/timezone:/etc/timezone:ro"        # 挂载主机时区配置
    - "/etc/localtime:/etc/localtime:ro"      # 挂载主机时间配置
    - "/var/log/proftpd/:/var/log/proftpd/:rw" # 日志存储目录
    - "./folder/data/:/etc/proftpd/data/:rw"   # 配置数据目录
    - "/mnt/ftpusers/:/mnt/ftpusers/:rw"       # 用户文件存储目录
  deploy:
    resources:
      limits:
        memory: 512M  # 内存限制，根据需求调整
  restart: unless-stopped

Docker Run命令示例

bash
docker run -d \
  --name alpine_proftpd \
  --hostname alpine_proftpd \
  --net=host \
  -e TZ=Asia/Shanghai \
  -e LANG=zh_CN.UTF-8 \
  -v /etc/timezone:/etc/timezone:ro \
  -v /etc/localtime:/etc/localtime:ro \
  -v /var/log/proftpd/:/var/log/proftpd/:rw \
  -v ./folder/data/:/etc/proftpd/data/:rw \
  -v /mnt/ftpusers/:/mnt/ftpusers/:rw \
  --restart unless-stopped \
  h0tmann/alpine_proftpd_db:latest

配置参数说明

系统环境变量

基础ProFTPD配置

SFTP配置

FTP(S)配置

日志配置

管理Web界面配置

卷挂载说明

注意事项

网络模式选择

推荐使用network_mode: host，可避免端口映射复杂问题，且便于从物理机ProFTPD迁移。若使用端口映射，需注意被动模式端口范围需与宿主机端口一致，且可能需要调整配置以适配Docker网络。

公钥格式转换

ProFTPD要求SFTP公钥使用RFC4716格式，转换命令：

bash
ssh-keygen -e -f ~/.ssh/id_rsa.pub -m RFC4716 > ~/.ssh/id_rsa.rfc4716.pub

也可通过管理Web界面内置功能转换。

IPTABLES/NFTABLES配置

在较新系统中，需创建/etc/modprobe.d/iptables.conf：

options nf_conntrack_ftp ports=21  # 端口需与FTP_PORT一致

然后加载模块：modprobe nf_conntrack_ftp（旧系统使用ip_conntrack_ftp）。

JWT令牌安全

管理界面JWT令牌密钥（ADMIN_JWT_SIGN、ADMIN_JWT_ENC）需设置为32位以上随机字符串，且每个实例使用唯一密钥以确保安全。

日志管理

日志文件默认存储在/var/log/proftpd/，建议定期备份或通过日志轮转配置（LOGROTATE_*参数）控制日志大小和保留数量。

常见问题

• Q: 被动模式连接失败？
  A: 确保被动端口范围（FTP_PASS_PORT_MIN至FTP_PASS_PORT_MAX）在防火墙中开放，且PUBLIC_IP正确配置为公网IP。

• Q: SFTP公钥认证失败？
  A: 检查公钥是否为RFC4716格式，可通过转换命令或管理界面转换后重试。

• Q: 管理界面无法访问？
  A: 检查ADMIN_IP是否允许当前IP访问（默认0.0.0.0允许所有），ADMIN_PORT是否映射正确，以及防火墙规则是否开放该端口。