crushftp/crushftp11

CrushFTP 镜像文档

概述

CrushFTP是一款功能强大、易于使用的文件传输解决方案，支持在多种操作系统上运行，包括macOS 10.9+/11/12+、Win2012+、Linux、Solaris、BSD、Unix等。任何能够运行Java 8及以上版本的操作系统均可部署和运行CrushFTP。

核心功能与特性

• 跨平台兼容性：支持所有可运行Java 8及以上环境的操作系统，包括macOS、Windows、Linux等。
• 灵活的管理员配置：通过-ad标志设置初始管理员用户，支持密码文件或直接指定密码两种配置方式。
• 多标签镜像：提供latest（distroless容器，无shell，适合生产）和latest-dev/-dev（含shell，用于调试）两种镜像标签。
• 安全的初始配置：初始管理员密码仅在首次创建时生效，后续可删除密码文件，确保配置安全性。

使用场景

适用于企业级文件传输需求，尤其适合需要跨平台部署、易于管理和维护的文件传输服务，可用于内部文件共享、客户数据交换、远程文件传输等场景。

使用方法与配置说明

初始管理员用户配置

通过-ad标志定义初始管理员用户参数，格式如下：

"-ad", "crushadmin", "PASSFILE"

• crushadmin：默认初始管理员用户名。
• PASSFILE：环境变量，指向密码文件路径，默认路径为/app/CrushFTP11/passfile，文件需包含单个密码字符串（无引号）。

注意事项：

• 初始密码仅用于管理员用户创建，设置完成后可删除密码文件，后续密码文件变更在使用-ad标志时将被忽略。
• 若-ad的第二个参数为字符串（非变量名），则直接作为crushadmin用户的初始密码。

镜像标签说明

• latest：生产环境镜像，基于distroless容器，无shell或执行环境。
• latest-dev、-dev：开发环境镜像，包含shell，用于调试场景。

Docker Compose部署

生产环境部署

使用latest标签镜像，执行以下命令启动：

shell
docker compose up

开发环境部署（带shell）

使用latest-dev标签镜像，执行以下命令启动：

shell
docker compose -f docker-compose-dev.yaml up

Docker Compose配置示例（latest标签）

yaml
version: '3.8'
services:
  crushftp-init:
    image: 'crushftp/crushftp11:latest-dev'
    container_name: crushftp-init
    environment:
      - INIT=true
    volumes:
    - ./CrushFTP11/:/app/CrushFTP11
    entrypoint: ["/bin/sh", "-c", "/entrypoint.sh"]
    user: "${UID}:${GID}"
  crushftp:
    image: 'crushftp/crushftp11:latest'
    container_name: crushftp
    ports:
      - '8081:8080'
      - '9091:9090'
      - '8443:443'
    volumes:
    - ./CrushFTP11/:/app/CrushFTP11
    working_dir: "/app/CrushFTP11"
    entrypoint: ["java", "-Ddir=/app/CrushFTP11", "-Xmx512M", "-jar", "/app/CrushFTP11/plugins/lib/CrushFTPJarProxy.jar", "-ad", "crushadmin", "PASSFILE"]
    user: "${UID}:${GID}"
    depends_on:
      crushftp-init:
        condition: service_completed_successfully
volumes:
  local_folder:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: ${PWD}

开发环境Docker Compose配置（docker-compose-dev.yaml）

yaml
version: '3.8'
services:
  crushftp:
    user: "${UID}:${GID}"
    image: 'crushftp/crushftp11:latest-dev'
    container_name: crushftp
    ports:
      - '8081:8080'
      - '9091:9090'
      - '8443:443'
    environment:
      CRUSHFTP_ADMIN_PASSWORD: "changeme"
    volumes:
    - ./CrushFTP11/:/app/CrushFTP11:rw
volumes:
  CrushFTP11:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: ${PWD}

权限设置注意事项

本地挂载CrushFTP11文件夹时默认以root用户权限挂载。为便于本地用户编辑文件，可通过以下命令更新权限：

shell
sudo chown -R $(id -u):$(id -u) CrushFTP11

否则需使用root用户编辑本地文件。

Helm Chart安装

如需通过Helm Chart安装，可参考：[***]