Repository navigation
JavSP-fork v0.4.3
JavSP-fork v0.4.3 发布说明
派生自 Yuukiy/JavSP 的带 WEBUI 刮削器。本版本聚焦安全 / 性能加固、全库去死代码与脱敏终扫,
无破坏性功能变更;Docker 与 Windows 桌面版均可平滑升级。
本次要点
安全 / 性能加固(B-001 ~ B-010,按批次)
- 第一批:下载产物做 sha256 校验(失败拒绝落地);网络请求统一走
tls_verify()不再默认关闭证书校验;路径白名单比较补齐大小写归一,避免大小写绕过。 - 第二批:更新页版本号兜底(接口层级取错时回退到可用字段);封面引擎字段修正;高危更新端点(
/api/update/download、/api/update/apply)强制会话校验,仅回环地址无条件放行以保证桌面版一键升级。 - 第三批:命名预览由横向改为纵向堆叠(长命名规则不再被挤变形);解压流程加 zip slip 防护(禁止
../越界写出);关机逻辑按平台分支处理并对取版本号增加容错;附带修正源码模式下 CLI 自动更新重命名自身解释器导致自毁的路径。
去死代码(22 项)
全库 vulture(min-confidence 60)+ pyflakes 扫描,移除上游遗留、从未被调用的空函数 / 废弃导入 / 无效分支共 22 处;无功能行为变化,仅清理。
脱敏终扫
测试文件中残留的本地内网地址示例改为 RFC 5737 文档保留段(198.51.100.0/24),避免真实内网信息随仓库发布。
安装 / 升级
Docker(推荐,NAS / 服务器)
docker load -i javsp-fork-0.4.3-image.tar.gz
docker restart javsp容器内版本以
/api/health返回的version为准;界面右下角显示版本号。
Windows 桌面版
- 下载
JavSP-0.4.3-windows.zip,解压到任意目录(便携,exe 同级即数据目录)。 - 升级已有安装:启动旧版 → 设置页「软件更新」→「立即升级」会自动完成下载、替换并保留
config.yml/.sessions.json/JavSP.log;或直接把新 zip 内容覆盖到旧目录(保留旧config.yml)。 - 首次使用请把自己的
config.yml放到 exe 同级。
校验
下载后可用发布资产 javsp-fork-0.4.3.sha256 核对(含 windows.zip 与 image.tar.gz 两个值):
sha256sum -c javsp-fork-0.4.3.sha256回归验证
- 6 个指定回归用例文件共 42/42 通过。
- NAS 部署后
/api/health返回version=0.4.3、container=true;前端资产名与新构建一致;挂载卷config.yml未被改动。
附注
- 历史 CHANGELOG 中保留的早期部署位置描述(如本机安装目录、网盘共享名)属已发布记录,本次未做破坏性清洗。
- 完整变更见仓库
CHANGELOG_FORK.md的 v0.4.3 段。