update 2026-05-27 23:25:57

simple-obfs/Makefile

@@ -0,0 +1,69 @@
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+# Copyright (C) 2017-2019 Jian Chang <aa65535@live.com>
+# Copyright (C) 2021 ImmortalWrt.org
+
+include $(TOPDIR)/rules.mk
+
+PKG_NAME:=simple-obfs
+PKG_VERSION:=0.0.11
+PKG_RELEASE:=1
+
+PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.gz
+PKG_SOURCE_URL:=https://codeload.github.com/kenzok8/simple-obfs/tar.gz/v$(PKG_VERSION)?
+PKG_HASH:=b5f1de228bbc3fcb7b2e1160c4736e9eb47978bd92b7bb3f0948f6a06bc979f0
+
+PKG_LICENSE:=GPL-3.0-or-later
+PKG_LICENSE_FILES:=LICENSE
+PKG_MAINTAINER:=Jian Chang <aa65535@live.com>
+
+PKG_BUILD_DEPENDS:=libev
+PKG_FIXUP:=autoreconf
+PKG_BUILD_PARALLEL:=1
+PKG_INSTALL:=1
+
+include $(INCLUDE_DIR)/package.mk
+
+define Package/simple-obfs/template
+  SECTION:=net
+  CATEGORY:=Network
+  TITLE:=A simple obfuscating tool
+  URL:=https://github.com/kenzok8/simple-obfs
+  DEPENDS:=+libpthread +libev
+endef
+
+define Package/simple-obfs-client
+  $(call Package/simple-obfs/template)
+  TITLE+= (client)
+  PROVIDES:=simple-obfs
+endef
+
+define Package/simple-obfs-server
+  $(call Package/simple-obfs/template)
+  TITLE+= (server)
+endef
+
+define Package/simple-obfs/description
+  Simple-obfs is a simple obfusacting tool, designed as plugin server of shadowsocks.
+endef
+
+Package/simple-obfs-client/description = $(Package/simple-obfs/description)
+Package/simple-obfs-server/description = $(Package/simple-obfs/description)
+
+CONFIGURE_ARGS += \
+	--disable-ssp \
+	--disable-documentation \
+	--disable-assert
+
+define Package/simple-obfs-client/install
+	$(INSTALL_DIR) $(1)/usr/bin
+	$(INSTALL_BIN) $(PKG_INSTALL_DIR)/usr/bin/obfs-local $(1)/usr/bin/
+endef
+
+define Package/simple-obfs-server/install
+	$(INSTALL_DIR) $(1)/usr/bin
+	$(INSTALL_BIN) $(PKG_INSTALL_DIR)/usr/bin/obfs-server $(1)/usr/bin/
+endef
+
+$(eval $(call BuildPackage,simple-obfs-client))
+$(eval $(call BuildPackage,simple-obfs-server))

simple-obfs/README-maintenance.md

@@ -0,0 +1,57 @@
+# 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 保持兼容包定位
+- 新能力优先放到更活跃的替代方案
+- 若要继续维护，仅做最小兼容补丁（工具链/警告）