FtpNextClient-是一款免费开源的FTP客户端软件，支持 OpenHarmony系统，主要用于客户端链接服务端进行数据传输等。

文件传输工具

📅 最后更新：2025/12/16

📖 简介

FtpNextClient是一款免费开源的FTP客户端软件，支持 HarmonyOS系统，主要用于客户端链接服务端进行数据传输等。

🚀 快速开始

系统要求

• HarmonyOS 5.0 或更高版本
• 网络连接权限
• 访问用户下载文件夹权限
• 访问用户文档文件夹权限
• 访问用户桌面文件夹权限

安装步骤

1. 下载最新版本的FtpNextClient安装包
2. 在鸿蒙设备上安装应用
3. 启动应用进行隐私协议，权限管理等配置

基础使用

创建连接

1. 打开FtpNextClient应用
2. 在主界面输入服务器信息：
   - 协议: FTP/FTPS/SFTP
   - 主机: 服务器IP地址
   - 端口: 服务器支持的端口号
   - 用户名: 用户名
   - 密码: 密码
   - 编码: UTF-8/GBK（SFTP不支持更改编码）
   - 传输模式: 主动模式/被动模式（SFTP不支持更改模式）
3. 点击【快速连接】建立连接

文件传输

1. 支持文件常规的上传下载
2. 支持文件拖拽文件上传下载
3. 支持文件添加到队列上传下载
4. 支持传输中文件的暂停恢复
5. 支持重命名、新建、删除等文件操作

📋 功能模块

模块	功能描述
登录	远程服务器登录和身份验证
本地文件展示	本地文件夹遍历和文件列表显示
服务器文件展示	远程服务器文件目录展示
上传	将本地文件传输到远程服务器
下载	将远程文件下载到本地
文件传输协议	支持FTP、FTPS、SFTP等多种文件传输协议
文件操作	文件上传/下载、删除/重命名、远程文件夹创建、文件导出沙箱
传输队列管理	传输任务控制(创建、保存、取消)、断点续传、并发控制、传输速度限制
远程服务器管理	服务器参数配置、兼容性处理、密码保护、加密配置、传输模式设置、文件名编码检测

🏗️ 架构设计

• 应用层:ArkUI、ArkTS语言交互、业务逻辑编排、用户操作响应
• 桥接层（NAPI）:C++ 与 ArkTS 的双向通信、参数转换、异常捕获、接口封装
• 原生层（C++ 层）:高性能计算、底层能力实现（如硬件交互、加密、复杂算法）、跨平台逻辑封装
• 系统适配层:鸿蒙系统 API 调用、设备能力检测、权限适配、分布式能力对接

软件架构图：

🐛 故障排除

常见问题

连接失败

• 检查网络连接和防火墙设置
• 验证服务器地址和端口正确性
• 确认用户名密码准确性

文件传输中断

• 检查网络稳定性
• 确认磁盘空间充足
• 尝试重新启动传输任务

📄 更新日志

v1.0.0 (2025-09-18)

• 🎉 首个正式版本发布
• ✨ 完整的文件传输功能
• 🎨 明暗主题切换
• 📝 完整的日志记录功能
• ……

🤝 贡献

欢迎提交Issue和Pull Request来帮助改进FtpNextClient！

开发指南

1. Fork本项目
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建Pull Request

📞 支持与反馈

• 💬 社区: FtpNextClient用户社区
• 🐛 问题反馈: GitCode Issues

📜 许可证

本项目基于 MIT License 开源协议发布

---

FtpNextClient - 让文件传输更简单，让文件管理更高效！