metabrainz/docker-anon-ftp

anon-ftp：快速***FTP服务器Docker镜像

镜像概述和主要用途

anon-ftp是一个轻量快速的FTP服务器Docker镜像，专为公共只读文件共享场景设计。该镜像不支持用户账户，所有数据访问均通过FTP登录实现，且文件系统默认为只读模式，确保数据安全性和访问控制。

核心功能和特性

• 访问：仅允许FTP登录，无需用户账户
• 只读共享：所有数据访问权限为只读，防止文件被意外修改
• 被动模式支持：采用FTP被动模式，无需使用--net=host即可正常工作
• 灵活配置：支持多种运行时参数调整，如端口范围、连接限制、带宽控制等
• 轻量高效：基于vsftpd构建，资源占用低，运行稳定

使用场景和适用范围

• 公共文件共享服务器（如软件安装包、文档资料分发）
• 只读资源库（如开源项目资源、公共数据集）
• 临时文件分发服务（需限制访问带宽和连接数）

使用方法

快速启动

通过以下命令可快速启动***FTP服务器：

bash
docker run -d -p 20-21:20-21 -p 65500-65515:65500-65515 -v /tmp:/var/ftp:ro metabrainz/docker-anon-ftp

参数说明：

• -d：后台运行容器
• -p 20-21:20-21：映射FTP控制端口
• -p 65500-65515:65500-65515：映射FTP被动模式数据端口范围
• -v /tmp:/var/ftp:ro：挂载本地目录（/tmp）到容器内FTP根目录，必须指定只读权限（:ro）

Docker Compose配置

可参考镜像内置的docker-compose.yml文件进行配置，典型配置示例：

yaml
version: '3'
services:
  anon-ftp:
    image: metabrainz/docker-anon-ftp
    ports:
      - "20-21:20-21"
      - "65500-65515:65500-65515"
    volumes:
      - /path/to/local/files:/var/ftp:ro
    environment:
      - ANON_MAX_RATE=10485760  # 10MB/s带宽限制
      - MAX_CLIENTS=100         # 最大客户端连接数
    restart: unless-stopped

配置参数

可通过环境变量调整运行时配置，默认值适用于大多数场景：

注意事项

• 只读挂载：卷挂载必须添加:ro标记，确保数据不会被修改
• 被动模式：镜像默认使用被动模式，需映射配置的端口范围（默认65500-65515）
• 配置参考：更多vsftpd配置细节可参考Archwiki文档或vsftpd手册

项目来源

基于 https://github.com/InAnimaTe/docker-vsftpd-anon 项目构建