node+lftp Docker镜像文档

镜像概述

本Docker镜像整合了Node.js运行环境与lftp文件传输工具，旨在为需要在Node.js应用中集成文件传输功能的场景提供一站式解决方案。镜像基于轻量级Linux基础镜像构建，包含完整的Node.js运行时（含npm包管理工具）和lftp客户端（支持多协议文件传输），可直接用于开发、测试及生产环境部署。

核心功能与特性

Node.js运行环境

• 提供稳定的Node.js执行环境，支持运行JavaScript/TypeScript应用
• 集成npm包管理器，可直接安装和管理Node.js依赖
• 兼容主流Node.js生态工具（如yarn、pnpm，需手动安装）

lftp文件传输工具

• 支持多协议文件传输：FTP、FTPS（FTP over SSL/TLS）、SFTP（SSH File Transfer Protocol）、HTTP、HTTPS等
• 提供断点续传、文件校验、递归目录传输等高级功能
• 支持脚本化传输任务，可通过命令行参数或配置文件自动化传输流程
• 轻量级设计，资源占用低，传输效率高

使用场景

1. Node.js应用文件同步：需定期与FTP/SFTP服务器同步数据的Node.js服务（如日志收集、数据备份）
2. 前端构建资源上传：前端项目经Node.js构建工具（Webpack、Vite等）打包后，通过lftp自动上传至静态资源服务器
3. 自动化部署流程：CI/CD流水线中，结合Node.js脚本与lftp实现应用构建产物的跨服务器传输
4. 开发环境集成：本地开发时快速测试Node.js应用与文件传输逻辑的交互

使用方法

1. 获取镜像

假设镜像已发布至Docker Hub（实际使用时替换为具体镜像名称）：

docker pull [镜像仓库地址]/node-lftp:latest

2. 基本运行方式

交互式运行（用于调试或临时操作）

docker run -it --rm [镜像仓库地址]/node-lftp /bin/bash

进入容器后，可直接使用Node.js和lftp命令：

# 验证Node.js环境
node -v
npm -v

# 验证lftp工具
lftp -v

执行文件传输任务

在容器中直接运行lftp命令（以连接FTP服务器为例）：

docker run --rm [镜像仓库地址]/node-lftp lftp -u username,password ftp.example.com -e "get remote-file.txt -o local-file.txt; bye"

运行Node.js应用并集成lftp

将本地Node.js项目挂载至容器，执行应用（假设项目中包含调用lftp的脚本）：

docker run -v $(pwd):/app -w /app [镜像仓库地址]/node-lftp node app.js

其中app.js可通过child_process模块调用lftp命令实现文件传输：

const { exec } = require('child_process');

// 示例：通过lftp上传文件至SFTP服务器
exec('lftp -u sftp-user,pass -e "put local-file.txt -o /remote/path/; bye" s[***] (error, stdout, stderr) => {
  if (error) {
    console.error(`传输失败: ${error.message}`);
    return;
  }
  console.log(`传输成功: ${stdout}`);
});

3. 高级配置

自定义lftp配置

lftp支持通过配置文件（~/.lftprc或/etc/lftp.conf）定义默认行为，可通过挂载本地配置文件实现自定义：

docker run -v $(pwd)/.lftprc:/root/.lftprc -it --rm [镜像仓库地址]/node-lftp lftp

示例.lftprc配置（启用被动模式、设置超时）：

set ftp:passive-mode yes
set timeout 300
set ssl:verify-certificate no  # 可选，用于自签名证书环境

Node.js环境变量配置

通过-e参数设置Node.js环境变量（如NODE_ENV）：

docker run -e NODE_ENV=production -v $(pwd):/app -w /app [镜像仓库地址]/node-lftp node app.js

注意事项

• 敏感信息（如FTP/SFTP账号密码）建议通过环境变量或挂载配置文件传入，避免硬编码在镜像或脚本中
• 生产环境使用时，建议基于本镜像构建业务镜像，通过Dockerfile预装依赖并固化配置，减少运行时操作
• lftp命令执行过程中可能产生日志，可通过重定向或日志收集工具捕获，便于问题排查