zftpd
ftp 连接
功能特性
版本与更新日志
需要登录后才能下载插件文件
插件文件下载当前仅对注册登录用户开放,欢迎在此登录后免费下载使用。
变更内容
- 通过安装器辅助程序 (zhttp) 添加原生 PKG 卸载功能,由 @NotSoTypicalGamer 提交于 https://github.com/seregonwar/zftpd/pull/15
- 修复:保留原生安装/卸载错误码,由 @NotSoTypicalGamer 提交于 https://github.com/seregonwar/zftpd/pull/16
- 修复 FEAT 回复格式并拒绝非普通 SIZE 目标,由 @gmelikov 提交于 https://github.com/seregonwar/zftpd/pull/19
新贡献者
- @NotSoTypicalGamer 在 https://github.com/seregonwar/zftpd/pull/15 中完成了首次贡献
- @gmelikov 在 https://github.com/seregonwar/zftpd/pull/19 中完成了首次贡献
下载统计
完整变更日志:https://github.com/seregonwar/zftpd/compare/v1.6.0...v1.7.0
zFTPd 1.6.0 是该项目的一次重大更新,引入了全新的传输架构、扩展的 PS4/PS5 平台支持、重新设计的 ZHTTP 界面、游戏管理功能,以及大规模的内部重构。 与 v1.5.0 相比,本次发布包含 40 次提交,变更涉及 200 多个文件。
传输子系统
- 用统一传输管理器替换了此前自定义的下载栈。
- 通过 libcurl 新增 HTTP 和 HTTPS 下载。
- 新增 FTP 和 FTPS 远程下载。
- 在受支持的 PS5 构建上新增
nfs://远程下载支持。 - 新增 BitTorrent 和磁力链接传输支持。
- 新增并发传输调度和队列管理。
- 新增持久化传输状态和中断下载续传支持。
- 下载在完成前现在使用
.zftpd.part文件或目录。 - 新增通过 HTTP API 报告传输进度和状态。
- 修复了中止远程下载时
SIGPIPE导致的进程终止问题。
FTP 服务器
- 将 FTP 命令拆分为专用的控制、列表、文件系统、传输、扩展和数据连接模块。
- 新增 FTP 实例管理。
- 重构了传输参数处理。
- 改进了 FTP 路径和文件系统处理。
- 改进了服务端复制和移动操作。
- 为服务端复制新增了更深的并行读取流水线。
- 修复了针对文件和目录的
CHMOD处理。解决 #9。 - 修复了
LIST -a处理以兼容 curlftpfs,由 @aydencharles 在 https://github.com/seregonwar/zftpd/pull/8 中贡献
ZHTTP 和 Web UI
- 重新设计了浏览器界面。
- 将前端重组为文件、传输、游戏、任务、系统控制和设置等专用模块。
- 将 HTTP 服务器拆分为监听器、响应流式传输、上传、JSON 和路由组件。
- 按子系统拆分 HTTP API 处理程序。
- 新增通用 HTTP API 原语和统一路由匹配。
- 新增
/api/notify用于自定义 PS4/PS5 系统通知。解决 #10。 - 新增针对多个文件和目录的流式 ZIP 生成。
- 新增通过 HTTP API 进行归档解压。
- 新增对受保护 SELF 文件的可选解密下载。
- 新增额外的系统和平台控制端点。
游戏管理
- 新增游戏目录支持。
- 新增游戏启动支持。
- 新增软件包安装支持。
- 新增
app.db修复功能。 - 新增带进度报告和取消功能的解密游戏转储。
- 新增通过
appmeta/param.json进行 PS5 标题检测。 - 修复了单包
app.pkg安装的标题检测。 - 软件包安装支持现在可在构建时完全排除。
归档子系统
- 新增流式 ZIP 写入器。
- 新增通用归档路径处理。
- 重做了内置 ZIP 解压实现。
- 新增 HTTP 归档创建和解压 API。
- 归档可直接流式传输到客户端,无需先在主机存储上创建完整归档。
文件 I/O
- 引入了供 FTP 和 HTTP 共用的文件 I/O 层。
- 将文件系统操作拆分为专用的目录、复制、树和 sendfile 实现。
- 改进了服务端复制行为。
- 新增跨设备移动回退。
- 减少了协议特定文件系统处理程序之间的重复。
PS4 和 PS5 平台支持
- 集中管理 PS5 固件特定的内核偏移。
- 将 PS5 固件表扩展至固件 13.60。
- 新增针对光盘操作、卷处理、DNS 过滤和实例控制的平台抽象。
- 用基于 libcurl 的传输后端替换了 PS4 原生 HTTP/TLS 下载路径。
- 新增 PacBrew PS4 portlib 集成以支持 HTTPS 下载。解决 #12。
- 新增嵌入式 CA 证书包支持,同时保留 TLS 证书验证。
- 新增 PS4 PIE payload 支持。
- 改进了 PS4 和 PS5 依赖处理。
- 新增条件性 PS5 安装助手编译。
休息模式和可靠性
- 新增休息模式监听器恢复。
- 新增守护进程实例跟踪,以检测恢复后的陈旧连接。
- 改进了主机网络状态变化后的监听器恢复。
- 修复了
CHMOD和复制回归。 - 加固了 PID 解析和 HTTP API 验证。
- 改进了传输和文件系统操作中的故障处理。
内部架构
- 按子系统重组了源代码树。
- 将此前单体的 FTP 命令实现拆分为专用模块。
- 将 HTTP API 拆分为归档、文件系统、进程、系统、传输、转储和游戏组件。
- 将游戏目录、元数据、安装、启动和管理代码模块化。
- 将平台特定功能整合到专用平台模块下。
- 移除了被新架构取代的过时 HTTP、curl、TLS 和文件 I/O 实现。
构建和 CI
- 重做了 Makefile 和构建配置。
- 改进了 ZHTTP、软件包安装、curl、NFS 和 torrent 支持的可选功能处理。
- 修复了非 Web 构建。
- 修复了较新 Clang 版本的构建问题。
- 更新了 GitHub Actions 发布工作流。
- 新增 PS4 依赖设置和构建集成到 CI。
文档
- 扩展了 API 文档。
- 新增架构文档。
- 新增依赖文档。
- 新增游戏转储文档。
- 新增软件包安装文档。
- 新增休息模式文档。
- 新增结构化 bug 报告、主机崩溃和功能请求模板。
- 新增拉取请求模板。
已解决的问题
- #9 — 无法将文件或目录权限更改为 777
- #10 — 用于自定义 PS4/PS5 系统通知的 HTTP 端点
- #12 — 通过 PacBrew libcurl 实现 PS4 ZHTTP HTTPS 下载
下载统计
新贡献者
- @aydencharles 在 https://github.com/seregonwar/zftpd/pull/8 中做出了首次贡献 完整变更日志: https://github.com/seregonwar/zftpd/compare/v1.5.0...v1.6.0
v1.4.0 发布说明
一次重大更新,重点包括性能增强、安全加固、可靠性提升,以及全新设计的 Web 仪表板,支持实时传输管理。
⚡ 性能改进
- 零拷贝 HTTP 文件下载:HTTP 响应使用
sendfile(2),消除用户空间缓冲区拷贝并提升下载吞吐量。 - Sendfile 突发/冷却重试:针对 PS4/PS5 exFAT 页缓存停顿(约 28 MB 突发),在停滞后实施 1 MB
read()冷却,重试sendfile,仅在立即重试失败时回退到缓冲 I/O。 - 文件系统感知的 sendfile 安全性:在 PS4/PS5 上使用
fstatfs()自动检测不安全的文件系统(exfatfs、msdosfs、nullfs、pfsmnt),以禁用sendfile并避免内核恐慌。 - TCP 自动调优:启用操作系统级 TCP 缓冲区自动调优,并优化 FTP 和 HTTP 下载的块大小。
- HTTP 上传流式传输:引入专用上传缓冲区和套接字调优,以实现一致的写入吞吐量。
- 优化跨设备拷贝:在 PS4/PS5 上文件拷贝期间,执行直接大块写入并附带扩展的顺序预读提示。
- 惰性目录大小计算:新增
GET /api/dirsize端点,用于按需计算,深度限制为 32 级;UI 在渲染后异步获取大小。 - 服务器端峰值速度:服务器端操作达到最高约 470 MB/s 的峰值。
- 千兆饱和上传:通过 zhttp 上传可完全饱和千兆连接,速度达到 113 MB/s。
🔒 安全增强
- HTTP/FTP 路径限制:实现
http_api_set_root、http_validate_and_confine以及所有 API 端点(列表、下载、统计、创建、上传)的规范安全路径验证,以阻止路径遍历和符号链接攻击。 - CSRF 加固:
http_csrf_init现在在熵不可用时失败;对状态更改操作强制执行 CSRF 验证;CSRF 初始化失败时禁用上传。 - FTP PORT IP 验证:拒绝 IP 地址不匹配的 PORT 命令(可通过
FTP_PORT_ALLOW_FOREIGN_IP配置)。 - 原子连接计数器:将 HTTP 连接计数器和使用中标志切换为原子类型,以确保线程安全。
- 缓冲池安全:添加静态断言和边界检查,以防止大型
FTP_MAX_SESSIONS位掩码导致未定义行为。
📂 FTP 协议更新
- CPFR / CPTO / COPY 命令:新增完整的服务器端文件拷贝支持,基于异步
pthread的后台拷贝、进度跟踪和自动跨设备回退。 - 跨设备移动(RNTO):提供透明的 EXDEV 回退,支持目录的递归跨设备移动,包括安全回滚(仅当目标在当前操作中创建时才移除目标)。
- STOR 零窗口修复:修复 PS4/PS5 上因
SO_RCVBUF上限导致的约 800 KB 上传停顿;强制单缓冲区模式并条件性增加缓冲区。 - 优雅关闭:确保服务器停止时正确清理会话池并重置 TCP 缓冲区。
- 更好的错误消息:为重命名/拷贝错误提供详细、人类可读的 550 回复,使 FileZilla 和 WinSCP 等客户端能够显示可操作的反馈。
🌐 Web 仪表板重新设计
- 传输管理卡片:显示实时进度,包括速度、已用时间、百分比、进度条和目标路径(
→ /path)。 - 暂停 / 恢复:通过
POST /api/copy_pause启用服务器端拷贝暂停/恢复;拷贝线程在暂停期间使用 100 ms 睡眠等待粒度,并支持取消。 - 取消:通过
POST /api/copy_cancel允许立即取消活动拷贝,并即时更新 UI。 - 错误诊断:显示具体的人类可读错误原因,映射操作系统 errno(例如 ENOSPC →“磁盘已满”,EROFS →“只读文件系统”)。
- 智能时间格式化:根据持续时间动态格式化已用时间为
Xs、Xm Ys或Xh Ym。 - 发送到模态框:引入用于服务器端拷贝的文件夹浏览器覆盖层,始终从根目录
/开始以便全面导航。 - 递归目录删除:支持通过
POST /api/delete?recursive=1在确认后删除非空文件夹。 - 上下文菜单:新增右键菜单,包含文件/文件夹的下载、发送到、重命名、删除等操作;背景菜单包括新建文件、新建文件夹、上传、刷新。
- 独立上传输入:为文件和文件夹上传提供不同的按钮。
- 主题系统:提供多种颜色主题,并为触摸设备提供原生下拉菜单。
- 统计监视器:包含用于磁盘使用、CPU 温度、RAM、进程列表和网络图表的模态覆盖层。
🛠 PS5 平台支持
- 内核网络过滤器:开发
ps5_net_filter模块,使用内核 R/W 原语进行系统调用级网络钩子安装。 - 内核辅助函数:新增
kernel_get_base()、kernel_get_phys_addr()(通过 x86-64 4 级页表遍历)和kernel_clear_pte_nx(),使用 ps5-payload-sdk 原语(KERNEL_ADDRESS_TEXT_BASE、kernel_copyout、kernel_mprotect)。 - PFS inode 锁串行化:在 PS4/PS5 上使用互斥锁串行化
O_CREAT打开操作,以避免 inode 分配锁争用(防止超过 20 秒的延迟)。 - 扩展 TCP 缓冲区:在 PS4 上将
FTP_TCP_RCVBUF增加到 4 MB,以匹配 PS5 并处理 PFS 写入延迟。
🐛 错误修复
- sendfile EINTR 处理:将
EINTR视为部分发送,以防止重传已发送的字节。 - 临时文件名溢出:解决临时文件名生成中的缓冲区溢出;现在将临时名称放置在目标目录中。
- 中断关闭时的 fd 泄漏:针对 FreeBSD/PS 主机与 Linux 之间不同的
EINTR语义进行调整,以避免文件描述符泄漏。 - 被动模式绑定/选择:修正 PS4/PS5 上被动模式中的套接字绑定和
select()问题。 - 删除后验证:在 DELETE API 中验证
unlink/rmdir后的路径移除,以检测静默失败。 - 上传统计显示:增强拖放区域覆盖层,包含实时上传统计和关闭按钮。
- PS4 上禁用
POSIX_FADV_DONTNEED:防止不支持的fadvise调用干扰操作。
📦 构建与工具更新
- 统一平台定义:在配置头文件中引入
PLATFORM_PS4/PLATFORM_PS5,与PS4/PS5并存。 - HTTP 限制测试:创建
test_http_confinement.c测试套件,用于验证路径遍历和符号链接保护。 - Makefile 改进:更新测试目标以包含
LIB_OBJECTS;将 HTTP sendfile 块大小提高到 1 MB。
完整差异:38 个文件更改,约 40,000 次插入,约 15,000 次删除。
完整变更日志:在 GitHub 上查看
🚀zftpd | zhttp v1.3.0
版本 1.3.0 引入了全新的可选 ZHTTP Web 文件浏览器 —— 一个直接集成到 zftpd 中的完整基于浏览器的文件管理器。此版本还扩展了 FTP 命令支持,新增了完整的 FFI(外部函数接口)子系统,改进了并发处理,并带来了大规模的文档 overhaul。
核心变更
🌐 ZHTTP Web 文件浏览器(重大新功能)
- 引入了可选的 ZHTTP 集成 HTTP 服务器,用于基于浏览器的文件列表、导航和管理(编译时通过
ENABLE_ZHTTPD=1启用)。 - 添加了实时 HTTP 统计报告。
- 将默认 HTTP 端口从 8080 更改为 8888,以防止与常见服务冲突。 📡 FTP 协议增强
- 添加了对
EPSV、OPTS、SITE、CLNT和MLSD命令的完整支持。 - 全面改进了命令解析和响应一致性。 🔌 FFI(外部函数接口)子系统
- 实现了完整的 FFI 层,支持外部语言(C、Rust、Zig 等)。
- 添加了专用的 Makefile、使用指南,并更新了用于 FFI 开发的
.gitignore。 🛠️ 稳定性与并发修复 - 在多客户端场景下,将并发的
MKD(创建目录)视为成功而非错误。 - 各种文件 I/O 健壮性改进。 📖 文档 overhaul
- 完全重写并扩展了 README.md,包含性能说明、设置说明、支持的 FTP 命令完整列表、致谢、鸣谢以及更清晰的解释。
- 更新了 logo 路径,修复了图片标签格式,并提高了整体可读性。 ⚙️ 构建与维护
- 增强了构建系统以支持新的 FFI 子系统。
- 对内部文件和配置进行了小幅清理。
照片
🚀 zftpd v1.2.2
版本 1.2.2 在数据传输稳健性和整体网络性能方面带来了显著改进。此版本着重优化了文件 I/O 和套接字行为——尤其是针对 PS4 和 PS5 平台——确保更高的稳定性、更安全的连接以及更一致的传输速度。
核心变更
📡 网络与传输优化
- 用围绕
sendfile/read循环的 socket corking 替换了旧的按会话令牌桶限速器。 - 实现了优雅的数据套接字关闭序列,以避免连接重置(RST)。
- 为
RETR、STOR和APPE命令添加了fsync刷新和更丰富的失败报告。 - 加固了 HTTP CSRF 令牌格式化,以防止缓冲区溢出。 🎮 平台特定(PS4 / PS5 / 主机)
- 增加了默认缓冲区和流大小,以获得更好的吞吐量。
- 为 PS4、PS5 和其他平台添加了数据特定的 I/O 超时和 linger 设置。
- 在 PS5 上禁用了传输速率限制,以最大化速度。
- 通过使用
F_NOCACHE和posix_fadvise,使主机上的文件 I/O 显著更加稳健。 🛠️ PAL(平台抽象层)更新 - 引入了新的 PAL 网络原语(例如
pal_socket_configure_data、cork/uncork、超时和 drain 辅助函数)。 - 更新了
pal_network.h和.c,以实现更安全、更可配置的套接字行为和遥测。 ⚙️ 构建与维护 - 修复了轻微的
Makefile问题,以确保构建目录正确创建。 - 添加了内部 API 文档,并调整了构建配置和
.gitignore。
🙌 致谢
我要感谢所有帮助我实现如此高稳定性和一致速度的测试人员。没有他们,zftpd 不可能在如此短的时间内取得这些成果。
完整更新日志:https://github.com/seregonwar/zftpd/compare/v1.2.1...v1.2.2
🚀 zftpd v1.2.1
此版本新增可选的 ChaCha20 加密,提升传输稳健性(断点续传、速率限制、原子复制),收紧构建/测试流程,并更新文档。
核心变更
加密与安全
- 在控制/数据路径中新增
AUTH XCRYPT(ChaCha20 PSK)支持。 - 记录了加密用法与安全防护措施。
传输与 I/O
- 为上传新增断点续传支持(
REST+STOR),并改进速率限制。 - 引入原子文件复制辅助函数,并优化
sendfile快速路径回退。 - 提高最大会话数,以支持更繁重的工作负载。
构建与工具
- 目标选择现在不区分大小写(
TARGET=PS5/PS4已规范化)。 make test现在会与 ELF 一起生成已剥离的.bin产物(PS4/PS5)。- 围绕
pal alloc/scratch集成进行构建修复与安全性调整。
文档
- 扩展 README,加入支持的 FTP 命令、ZHTTP 概述及平台说明。
- 为模块作者新增内部 API 指南(PAL、I/O、网络、日志、加密),并附代码片段。
致谢
我要感谢所有帮助我实现如此高稳定性和一致速度的测试人员。没有他们,zftpd 不可能在如此短的时间内取得这些成果。特别感谢 M///Class!
完整变更日志:
https://github.com/seregonwar/zftpd/compare/v1.2.0...v1.2.1
🚀 zftpd v1.2.0
此版本在日志记录、安全性、会话处理、PS4/PS5 运行时行为以及构建工具方面引入了结构性改进,同时正式确立了测试覆盖范围并增强了 I/O 的健壮性。
核心变更
🔎 日志子系统
- 新增
ftp_log.h和src/ftp_log.c。 - 会话级和命令级日志记录。
- 基于行的日志工具。
- 将日志钩子集成到 RETR/STOR/APPE 流程中。
🧪 单元测试
- 新增:
tests/test_security.ctests/test_path_security.c- Makefile 更新:
LIB_OBJECTS目标(不包含main的构建)。- 多测试构建/运行支持。
- 在不支持的平台上自动跳过测试。
安全与路径处理
路径规范化与根目录强制(ftp_path.c)
- 强化路径组件解析。
- 严格的
realpath()解析。 - 针对
session->root_path的显式验证。 - 防止目录遍历和符号链接逃逸至会话根目录之外。
PORT / PASV 处理
PORT限制为同一客户端 IP。- PASV:
- 正确复用/关闭先前的被动套接字。
- 绑定到
INADDR_ANY。 - 改进 PASV 响应的本地 IP 检测。
- 改进生命周期验证和套接字管理。
会话层变更
ftp_session_t 扩展
新增:
root_path- 控制 RX 缓冲区
- 认证标志
- 速率限制器字段 初始化更新:
- 会话初始化期间解析
realpath(root)。 - 初始化时应用套接字超时。
- 速率限制集成到数据接收路径中。
速率限制
- 基于实际接收字节数的传输计量。
include/ftp_config.h中的编译时配置项:- 控制超时
- 数据超时
- 传输速率限制
- 突发大小
FTP_SOCKET_TELEMETRY
数据路径与 I/O
RETR / STOR / APPE
- 聚合字节计量。
- 通过
ftp_session_send_data统一数据发送路径。 - 仅在禁用速率限制时使用
sendfile。 - STOR/APPE:
- 切换为
ftp_buffer_acquire()/ftp_buffer_release()。 - 使用
pal_file_write_all()进行健壮写入。
PAL 新增
新抽象:
pal_socket_set_timeoutspal_send_allpal_file_write_all控制回复现在使用pal_send_all。ftp_session.c中的额外辅助函数:wait_fd_readymonotonic_ns
PS4 / PS5 改进
运行时与启动
- 更安全的 PID 查找。
- 在绑定前终止现有实例。
- 端口回退初始化(
server_init_with_fallback)。 - 改进通知处理。
- 重新组织 include 并改进 POSIX 构建的 CLI 解析。
缓冲区与 TCP
- 增大 PS4/PS5 的默认缓冲区大小。
- 增大 TCP 缓冲区大小。
- 改善主机约束下的吞吐量行为。
构建系统
- 版本号升级至 v1.2.0。
- 统一各源文件的 MIT 许可证头。
- Makefile:
STRIP支持。- PS4/PS5 的
.bin输出。 - 更新部署目标。
- PS5 链接
libSceNotification。 - README 重写并精简。
支持的平台
- OrbisOS (PS4)
- ProsperoOS (PS5)
- macOS
- Linux (Debian)
完整变更日志: https://github.com/seregonwar/zftpd/compare/v1.1.0...v1.2.0
🚀 zftpd v1.1.0 – 稳定性改进(主机堆栈修复)
本版本专注于主机环境的稳定性改进,修复了线程执行路径中发现的堆栈溢出问题。
🛠 修复与改进
- 解决了 PS4/PS5 上的线程堆栈溢出
- 定位到堆栈溢出情况(故障地址接近 RSP,触发保护页)。
- 在主机平台上将默认线程堆栈大小增加到 512KB。
- 在非主机平台上堆栈大小保持 64KB。
- 显式配置 pthread 堆栈
- 现在使用
pthread_attr_setstacksize()显式设置线程堆栈大小。 - 应用于:
- Accept 线程
- Session 线程 这显著提升了 Orbis/Prospero 环境下高会话负载和深层调用堆栈时的稳定性。
✅ 支持并测试的平台
- OrbisOS (PlayStation 4):原生执行,支持完整沙盒逃逸(root / 访问权限)。
- macOS:功能完整。
- Linux (Debian):功能完整。
🚧 路线图 / 后续计划
- ProsperoOS (PlayStation 5):仍在寻找测试者。如果你能运行 payload 并提供日志,将非常有帮助。
- 扩展 Linux 支持:更广泛的发行版兼容性测试。
- Windows 支持:计划原生兼容。
- 未来绑定:BD-J、Lua 及其他执行面正在评估中。 完整更新日志:https://github.com/seregonwar/zftpd/compare/v1.0...v1.1
🚀 zftpd v1.0.0 - 初始版本发布
zftpd 的核心引擎现已正式稳定并完全可用。采用纯 C 语言编写,专注于零拷贝性能和最小内存占用。
✅ 已支持并测试的平台
- OrbisOS (PlayStation 4): 原生执行,完全沙盒逃逸(root
/访问权限)。 - macOS: 完全可用。
- Linux (Debian): 完全可用。
🚧 路线图 / 后续计划
- ProsperoOS (PlayStation 5): 我目前没有 PS5,因此如果有人能试用该 payload 并向我们提供日志和反馈,我将不胜感激!
- 扩展操作系统支持: 针对更广泛的 Linux 发行版进行兼容性测试。
- 新增操作系统支持: 我计划让项目也兼容 Windows。
- 未来绑定: 计划支持通过 BD-J、Lua 和其他攻击面进行执行。 完整变更日志: https://github.com/seregonwar/zftpd/commits/v1.0