# DProxy

**Repository Path**: suxuss_admin/dproxy

## Basic Information

- **Project Name**: DProxy
- **Description**: 基于WinTun的透明代理项目
- **Primary Language**: Delphi
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-04-01

## Categories & Tags

**Categories**: networklib

**Tags**: None

## README

# DProxy

> ⚠️ 本项目仍处于开发阶段，功能尚未稳定，请勿用于生产环境。

---

## 📌 项目简介

DProxy 是一个基于 WinTun 的**轻量级网络调试代理框架**，用于在**已授权环境**中进行流量转发、协议分析与网络行为研究。

本项目专注于提供**基础网络能力与扩展接口**，不内置针对特定目标的攻击或绕过机制。

---

## 🎯 设计目标

* 提供稳定的透明代理基础能力
* 支持灵活的流量观察与分析扩展
* 保持核心模块**中立、最小化设计**
* 便于开发者在合法授权环境下进行二次开发

---

## ✨ 功能特性（开发中）

* 基于 WinTun 的透明流量转发
* 会话级数据处理模型
* 可扩展的插件接口（用于自定义分析逻辑）
* 高性能异步处理架构

> ⚠️ 当前版本仅提供基础能力，部分功能仍在开发中。

---

## 🚫 使用范围说明（重要）

本项目：

* ✅ 适用于：

  * 网络调试
  * 协议分析
  * 安全研究（需合规性授权）
  * 教学与实验

* ❌ 不提供：

  * 不针对**任何特定目标**设计
  * 不提供**攻击**或**利用**能力
  * 不包含绕过安全机制的内置方案

---

## 工程贡献与代码规范指南

### 1. 代码质量与风格一致性 (Code Quality & Style)
* **注释规范**：所有提交的代码必须包含充分的文档化注释。
    * **接口与类**：必须使用 Delphi 标准的 XML 注释格式（如 `<summary>`, `<param>`, `<returns>`），明确描述其功能、参数含义及返回值。
    * **逻辑注释**：对于复杂的算法或关键业务逻辑，应标注实现思路及潜在的副作用。
* **风格对齐**：代码风格必须与现有项目保持高度一致。
    * **命名约定**：严格遵守项目的变量前缀规范（如 成员变量 `F`，参数 `A`，局部变量 `L`）。
    * **格式化**：提交前请统一进行代码格式化，确保缩进、空格及 Begin/End 布局的整齐。

### 2. 模块化设计原则 (Modular Design)
* **高内聚与低耦合**：新功能模块应遵循“单一职责原则”。
    * **独立性**：模块内部逻辑应高度内聚，严格禁止不必要的跨模块交叉引用（Cross-Dependency）。
    * **边界清晰**：模块间仅通过定义的接口进行通信，确保模块可以独立测试和替换。
* **接口隔离**：优先定义精简的接口（Interface），避免设计臃肿的“上帝接口”。

### 3. 基于 Spring4D 的解耦实践 (Decoupling with Spring4D)
* **依赖注入 (DI)**：强制使用 Spring4D 容器进行模块间的解耦。
    * **注入方式**：推荐优先使用**构造函数注入 (Constructor Injection)**，以确保依赖关系的显式化和不可变性。
    * **容器注册**：新模块必须在全局容器中正确注册实现（Implementations）。
* **控制反转 (IoC)**：杜绝代码中的硬编码依赖。禁止在业务层直接 Create 跨模块的实现类（本地临时容器类除外）。

### 4. 提交安全性与可观测性 (Submission & Observability)
* **逻辑变更标注**：若重构过程中涉及隐性逻辑调整，必须在提交说明（Commit Message）和代码中显著标记，并注明变更原因。
* **防御性编程**：充分考虑代码的可扩展性，同时通过日志或监控点预留，提升系统的可观测性，但应避免过度设计。

---

## ⚖️ 合规声明

本项目定位为**通用网络调试框架**，不针对任何特定系统或目标提供支持。

项目拥有者和贡献者无法对用户的具体使用行为进行控制或干预，使用者需自行确保其行为符合适用法律法规。

---

## 📄 免责声明

#### 0.免责声明优先级说明：

本项目可能同时提供多语言版本的免责声明文件，包括但不限于 DISCLAIMER.CN.md（中文）与 DISCLAIMER.EN.md（英文）。
This project may provide disclaimer documents in multiple languages, including but not limited to DISCLAIMER.CN.md (Chinese) and DISCLAIMER.EN.md (English).

如不同语言版本之间存在任何歧义、不一致或解释冲突，应以 DISCLAIMER.CN.md 的内容为准。
In the event of any inconsistency, ambiguity, or conflict between different language versions, the content of DISCLAIMER.CN.md shall prevail.

各语言版本仅为便于理解而提供，不应被视为对免责声明内容的独立或替代性解释。
All translated versions are provided for convenience only and shall not be considered as independent or alternative interpretations of the disclaimer.

#### 1. 合法授权与用途限制

本项目及其附属工具（以下简称“本项目”）仅用于**已获得合法授权**的安全研究、调试分析及教学用途。

* **强制前提**：使用本项目即表示您声明并保证，您对所涉及的网络、系统或应用环境拥有充分的合法控制权，或已获得明确的书面授权。
* **合规要求**：严禁将本项目用于任何未经授权的行为，包括但不限于流量拦截、协议篡改、数据获取、服务干扰或其他可能违反适用法律法规的用途。否则可能承担相应的法律责任（包括但不限于民事责任、行政责任或刑事责任）。

---

### 2. 代码规范与架构原则 (Code & Architecture)

* **代码注释与风格一致性**：提交的代码应包含充分的文档化注释。接口与类必须使用 Delphi 标准的 **XML 注释格式**（包含 `<summary>`、`<param>`、`<returns>`）。代码风格须与现有项目保持高度一致，严格遵守变量命名规范（成员变量 `F`，参数 `A`，局部变量 `L`）。
* **模块高内聚与低耦合**：新功能模块应具备高度内聚性，严格禁止不必要的跨模块交叉依赖。模块间仅允许通过接口进行通信，确保边界清晰。
* **Spring4D 依赖注入**：强制使用 **Spring4D** 容器实现模块解耦。
    * **注入方式**：优先采用**构造函数注入 (Constructor Injection)**，确保依赖关系的显式化。
    * **控制反转 (IoC)**：原则上禁止在业务模块内部直接实例化（Manual Instantiate）其他模块的实现类（用作列表存储的极小结构除外）。所有外部依赖必须通过接口从容器中获取；若确需动态创建，应通过声明**工厂接口**（如 `TFactory<I>`）来实现，以减轻耦合。
* **可观测性与逻辑标注**：在优化或修复代码时，必须保留足够的可观测性接口。对于确需调整业务逻辑的地方，应当在代码及提交说明中**显著标记并注明**逻辑变化的原因。

### 3. 许可终止（基于 Apache License 2.0 的附加条款）

本条款作为 **Apache License 2.0** 授权协议在特定使用场景下的**补充解释与增强约束**。

* **自动与即时终止 (Automatic Termination)**：如您违反任何适用法律法规、本声明条款或 Apache 2.0 协议要求，您基于该许可享有的权利将**立即终止（Terminate）**。授权终止后，您必须立即停止对本项目的一切使用行为，并销毁所有相关副本（包括源代码、编译产物及衍生作品）。
* **责任承担 (Liability)**：许可终止后的任何继续使用行为，均可能构成侵权或违法行为。由此产生的一切法律责任（包括但不限于民事赔偿、行政处罚或刑事责任）均由您**全额自行承担**，与本项目的开发者及贡献者无关。本项目不为任何违反法律或协议的行为背书或承担连带责任。

---

#### 4. 数据与隐私合规（GDPR 及相关法规）

本项目本身：

* 不主动收集、上传或存储任何个人数据
* 不内置数据分析或用户行为跟踪功能

但由于其技术特性，用户在使用过程中 **可能处理网络流量数据**（可能包含个人数据，如 IP 地址等）。

因此：

* 所有数据处理行为均由用户自行控制
* 需确保其使用行为符合适用的数据保护法律法规，包括但不限于：

  * 欧盟《通用数据保护条例》（GDPR）
  * 当地数据保护及隐私法律

本项目拥有者及贡献者不对用户的数据处理行为承担责任。
---

#### 5. 担保排除与风险提示（AS IS）

本项目按“**原样（AS IS）**”提供，不提供任何形式的明示或暗示担保，包括但不限于适销性、特定用途适用性及非侵权保证。

* **稳定性风险**：由于涉及底层网络组件（例如 WinTun 等驱动），使用本项目可能导致系统异常（如蓝屏）、网络中断、数据损坏或其他不可预期的问题。
* **责任限制**：在任何情况下，开发者或贡献者均不对因使用或无法使用本项目所产生的任何直接、间接、附带、特殊或后果性损害承担责任，包括但不限于利润损失、业务中断、数据丢失、信息泄露或相关费用支出。

---

#### 6. 合规与跨境使用

用户有责任确保本项目的使用符合：

* 所在国家或地区的法律法规
* 目标系统所在地法律法规

如涉及跨境数据或网络使用，还应符合：

* 数据跨境传输规定
* 网络安全相关法律
* 出口管制及相关法规

由此产生的全部风险与责任由用户自行承担。

---

#### 7. 条款接受

您一旦**下载、安装、编译或以任何形式使用**本项目的全部或部分，即视为您已阅读、理解并同意本声明的全部内容。

如您不同意本声明的任何条款，请**立即停止使用并删除所有相关副本**。