serversideup/proftpd

ProFTPD Docker镜像

[!CAUTION] 此镜像为特定使用场景创建。我们不计划扩展该项目的功能，仅因客户项目中需要处理遗留集成而创建，供可能有类似需求的用户使用。

该Docker镜像提供可定制的ProFTPD服务器，支持MySQL认证和TLS加密。

基础镜像

该镜像基于ubuntu:24.04构建，提供稳定且最新的ProFTPD运行环境。

核心功能与特性

• 支持MySQL认证的ProFTPD服务器
• TLS加密支持
• 通过环境变量自定义配置
• 自签名SSL证书生成
• IP地址封禁（10分钟内5次认证失败的IP将被封禁1小时）
• 原生Docker健康检查，确保服务器运行状态

环境变量

以下环境变量可用于自定义ProFTPD服务器：

构建默认值

镜像构建过程中使用以下构建参数：

使用方法

若需将Let's Encrypt与ProFTPD + CloudFlare + MySQL认证结合使用，可搭配我们的另一个镜像https://github.com/serversideup/docker-certbot-dns-cloudflare%EF%BC%8C%E4%BB%A5%E8%87%AA%E5%8A%A8%E7%94%9F%E6%88%90SSL%E8%AF%81%E4%B9%A6%E5%B9%B6%E4%B8%8EProFTPD%E5%AE%B9%E5%99%A8%E5%85%B1%E4%BA%AB%E3%80%82

以下是使用ProFTPD镜像配合Let's Encrypt的完整示例配置，只需设置符合您环境的变量即可：

yml
services:
  certbot:
    image: serversideup/certbot-dns-cloudflare:latest
    volumes:
      - certbot_data:/etc/letsencrypt
    environment:
      CLOUDFLARE_API_TOKEN: "${CERTBOT_CLOUDFLARE_API_TOKEN}"
      CERTBOT_EMAIL: "${CERTBOT_EMAIL}"
      CERTBOT_DOMAINS: "${FTP_SERVER}"
      CERTBOT_KEY_TYPE: "rsa"
      PUID: "999"
      PGID: "999"
  ftp:
    volumes:
      - ftp_data:/var/ftp/users
      - ftp_logs:/var/log/proftpd
      - certbot_data:/etc/letsencrypt
    environment:
      FTP_DEBUG_LEVEL: "0" # 0-10（10为最详细）
      FTP_LOG_LEVEL: "info" # debug, info, warn, error
      FTP_MASQUERADE_ADDRESS: "${FTP_SERVER}"
      FTP_PASSIVE_PORT_RANGE_START: "60000"
      FTP_PASSIVE_PORT_RANGE_END: "60049"
      FTP_SQL_USERS_TABLE: "users"
      FTP_TLS_CERTIFICATE_FILE: "/etc/letsencrypt/live/${FTP_SERVER}/fullchain.pem"
      FTP_TLS_CERTIFICATE_KEY_FILE: "/etc/letsencrypt/live/${FTP_SERVER}/privkey.pem"
      FTP_TLS_REQUIRED: "on"
      FTP_TLS_WAIT_FOR_CERTIFICATE: "true"
      MYSQL_DATABASE: "${FTPUSER_DATABASE}"
      MYSQL_HOST: "${FTPUSER_HOST}"
      MYSQL_PASSWORD: "${FTPUSER_PASSWORD}"
      MYSQL_PORT: "${FTPUSER_PORT}"
      MYSQL_USER: "${FTPUSER_USERNAME}"
    depends_on:
      - certbot
    ports:
      - target: 21
        published: 21
        protocol: tcp
        mode: host
      - target: 990
        published: 990
        protocol: tcp
        mode: host
      - target: 60000
        published: 60000
        protocol: tcp
        mode: host
      - target: 60001
        published: 60001
        protocol: tcp
        mode: host
      - target: 60002
        published: 60002
        protocol: tcp
        mode: host
volumes:
  ftp_logs:
  ftp_data:
  certbot_data:

请确保将MySQL连接详情替换为您自己的配置。

配置说明

镜像中包含ProFTPD配置文件（proftpd.conf），其主要设置如下：

• 支持FTP和FTPS（TLS）
• MySQL认证
• 被动端口范围：60000-60100
• TLS协议：TLSv1.2和TLSv1.3
• 日志配置
• 用户主目录自动创建
• 禁用***访问
• IP地址封禁（10分钟内5次认证失败的IP将被封禁1小时）

您可根据需求修改proftpd.conf文件以进一步自定义ProFTPD服务器。

安全注意事项

• 镜像为FTPS生成自签名SSL证书，生产环境中应替换为有效证书。
• 确保为MySQL认证使用强密码。
• 根据安全需求审查并调整proftpd.conf配置。
• 考虑使用Docker secrets或其他安全方式传递数据库凭证等敏感信息。

端口

暴露以下端口：

编排工具特别说明

若使用Kubernetes等编排工具，需确保容器和主机上均开放相关端口。

例如，在Docker Swarm中，需在docker-compose文件中使用长格式的ports指令：

yml
services:
  ftp:
    image: serversideup/proftpd
    ports:
      - target: 21
        published: 21
        protocol: tcp
        mode: host
      - target: 990
        published: 990
        protocol: tcp
        mode: host
      - target: 60000
        published: 60000
        protocol: tcp
        mode: host
      - target: 60001
        published: 60001
        protocol: tcp
        mode: host
      - target: 60002
        published: 60002
        protocol: tcp
        mode: host

遗憾的是，Docker Swarm不支持在长格式中指定已发布端口范围，因此需逐个指定端口。请确保开放FTP_PASSIVE_PORT_RANGE_START和FTP_PASSIVE_PORT_RANGE_END环境变量定义范围内的所有端口。

MySQL数据库

可使用MySQL或MariaDB。在数据库中创建以下表：

sql
CREATE TABLE ftpusers (
    id INT AUTO_INCREMENT PRIMARY KEY,  -- 自增主键
    username VARCHAR(255) NOT NULL,     -- 用户名，最大长度255字符
    password VARCHAR(255) NOT NULL,     -- 密码，最大长度255字符
    uid INT NOT NULL,                   -- 用户ID，整数类型
    gid INT NOT NULL,                   -- 组ID，整数类型
    homedir VARCHAR(255) NOT NULL,      -- 主目录路径，最大长度255字符
    shell VARCHAR(255) NOT NULL         -- Shell，最大长度255字符
);

然后使用以下SQL添加用户：

sql
INSERT INTO ftpusers (username, password, uid, gid, homedir, shell)
VALUES (
  'testuser',
  CONCAT('{sha256}', TO_BASE64(UNHEX(SHA2('mypassword', 256)))),
  2001,
  2001,
  '/var/ftp/users/testuser',
  '/bin/false'
);

资源

• ******* - 社区和团队提供的友好支持
• https://github.com/serversideup/docker-proftpd - 源代码、问题报告和项目管理
• 专业帮助 - 直接从核心贡献者获取视频+屏幕共享帮助

贡献

作为开源项目，我们致力于开发过程的透明度和协作。非常感谢社区成员提供的任何贡献，无论是修复错误、提出功能、改进文档还是传播项目，您的参与都将增强项目实力。

• 错误报告：使用镜像时遇到问题，请https://github.com/serversideup/docker-proftpd/issues/new/choose%E3%80%82
• 安全报告：通过我们的负责任披露政策报告严重安全问题。

需要入门帮助？加入我们的***社区，我们将为您提供支持！

赞助商

我们所有的软件都是免费开源的。这些成果离不开赞助商的资金支持。

https://github.com/***/serversideup

黑级赞助商

青铜赞助商

目前暂无青铜赞助商。https://github.com/***/serversideup

个人支持者

https://github.com/GeekDougle  https://github.com/JQuilty  https://github.com/MaltMethodDev  

关于我们

我们是Dan和Jay——一个热爱开源产品的两人团队。我们创建了Server Side Up来分享我们所学的知识。

联系我们：

• 📖 博客 - 获取最新的Web/移动开发指南和免费课程
• 🙋 社区 - 从社区成员获取友好帮助
• 🤵‍♂️ 专业帮助 - 从核心贡献者获取视频+屏幕共享支持
• 💻 https://github.com/serversideup - 查看我们的其他开源项目
• 📫 新闻通讯 - 跳过算法，直接获取优质内容到您的收件箱
• **🐥 ***** - 您也可以关注Dan和Jay
• ❤️ https://github.com/***/serversideup - 请考虑赞助我们，以便我们创建更多有用的资源

我们的产品

如果您喜欢这个项目，一定要查看我们的其他项目。

📚 书籍

• 构建API和SPA的终极指南：从同一代码库构建Web和移动应用
• 构建多平台浏览器扩展：从同一代码库向所有浏览器发布扩展

🛠️ 软件即服务

• Bugflow：直接在GitHub、GitLab等平台获取可视化错误报告
• SelfHost Pro：将Stripe或Lemonsqueezy连接到私有Docker registry，用于自托管应用

🌍 开源项目

• AmplitudeJS：开源HTML5和JavaScript Web音频库
• Spin：Laravel Sail的替代方案，用于从开发到生产运行Docker
• **https://github.com/serversideup/financial-*****%EF%BC%9AMint%E3%80%81YNAB%E5%92%8CMonarch Money的开源替代品