mirror of
https://github.com/caiwx86/small-packages.git
synced 2026-07-29 18:01:55 +08:00
58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# simple-obfs 维护说明（维护模式）
|
||
|
||
## 当前定位
|
||
|
||
simple-obfs 已长期停更。当前仓库策略是：
|
||
|
||
- 以 **兼容性维护** 为主（保证新工具链可编译）
|
||
- 不做大规模功能迭代
|
||
- 优先保证打包可复现、构建稳定
|
||
|
||
## 关键设计
|
||
|
||
### 1) 版本来源
|
||
|
||
- 上游基础：`simple-obfs v0.0.7`
|
||
- 本仓库发布：`v0.0.9`（仅做构建可复现增强）
|
||
|
||
### 2) libcork 处理
|
||
|
||
历史问题：`v0.0.7` 的 `libcork` 是 submodule gitlink，tarball 不含子模块内容，导致构建中 autoreconf/Makefile 链路失败。
|
||
|
||
当前方案：
|
||
|
||
- 在 `kenzok8/simple-obfs v0.0.9` 中直接 **vendor libcork 源码**
|
||
- 打包阶段不再在线 `git clone` libcork
|
||
- OpenWrt 包仅使用固定 tarball + hash
|
||
|
||
收益：
|
||
|
||
- 构建可复现
|
||
- 减少 CI 网络依赖
|
||
- 降低“偶发失败”概率
|
||
|
||
## 打包规范
|
||
|
||
`Makefile` 关键字段：
|
||
|
||
- `PKG_VERSION:=0.0.9`
|
||
- `PKG_SOURCE_URL:=https://codeload.github.com/kenzok8/simple-obfs/tar.gz/v$(PKG_VERSION)?`
|
||
- `PKG_HASH:=f9c05de42608691dad77c707504ad855191cd26ccd7095a0b3d4be939055111e`
|
||
- `PKG_FIXUP:=autoreconf`
|
||
|
||
## 排错要点
|
||
|
||
1. 先看 `logs/package/feeds/packages_ci/simple-obfs/compile.txt`
|
||
2. 常见失败关键词：
|
||
- `No targets specified and no makefile found`
|
||
- `required file 'libcork/Makefile.in' not found`
|
||
3. 优先确认：
|
||
- 版本和 hash 是否一致
|
||
- 是否误回退到旧版（v0.0.7）
|
||
|
||
## 未来路线（建议）
|
||
|
||
- simple-obfs 保持兼容包定位
|
||
- 新能力优先放到更活跃的替代方案
|
||
- 若要继续维护，仅做最小兼容补丁（工具链/警告）
|