From 2d118688a562c1f26c972624d15281df4bfc83ef Mon Sep 17 00:00:00 2001 From: isboyjc Date: Wed, 1 Apr 2026 22:37:25 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E2=9C=A8=20add=20CHANGELOG.md=20to=20d?= =?UTF-8?q?ocument=20project=20updates=20and=20version=20history?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 129 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..45a394a --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,129 @@ +# 更新日志 + +所有重要的项目变更都会记录在此文件中。 + +格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)， +版本号遵循 [语义化版本 2.0.0](https://semver.org/lang/zh-CN/)。 + +## [v0.3.0] - 2026-04-01 + +### 新增 + +- **地理过滤增强** + - 支持国家白名单（`ALLOWED_COUNTRIES`）和黑名单（`BLOCKED_COUNTRIES`）配置 + - 白名单优先级高于黑名单：白名单非空时仅允许指定国家，否则使用黑名单屏蔽 + - 支持通过环境变量、配置文件、WebUI 动态配置地理过滤规则 + - 启动时自动清理违反当前过滤规则的已入池代理 + - 详细文档：`GEO_FILTER.md` + +- **项目指南文档** + - 新增 `CLAUDE.md`，提供项目架构、设计模式、代码规范的完整指导 + - 包含模块依赖流程图、后台协程说明、端口映射表等 + +- **HTTPS 可用性验证增强** + - HTTP 协议代理入池前增加 HTTPS CONNECT 隧道验证 + - 随机访问真实 HTTPS 网站（Google/GitHub/OpenAI 等）确认可用性 + - 失败自动切换验证站点重试，确保入池的 HTTP 代理都能访问 HTTPS + - 新增测试脚本：`test/test_http_https.sh` 用于持续测试 HTTPS 访问能力 + +### 变更 + +- 默认 HTTP 协议占比从 50% 调整为 30%（配置 `PoolHTTPRatio: 0.3`） +- 地理过滤配置优先级：`config.json` > 环境变量 +- WebUI 地理过滤设置界面支持动态修改白名单/黑名单 + +### 修复 + +- 修复地理过滤在验证器和存储层的逻辑一致性问题 +- 修复启动时地理过滤清理逻辑，正确处理白名单优先场景 +- 修复代理池补充逻辑：当 HTTP 和 SOCKS5 协议都缺失时，同时补充两个协议，而非先后补充 +- 修复槽位计算问题：调整默认配置比例为 0.3（3:7），符合 HTTP/SOCKS5 实际使用场景 + +## [v0.2.0] - 2026-03-30 + +### 新增 + +- **SOCKS5 协议支持** + - 实现完整的 SOCKS5 代理服务器（支持 CONNECT 命令） + - 提供两个 SOCKS5 端口：`:7779`（随机轮换）+ `:7780`（最低延迟） + - SOCKS5 服务仅使用 SOCKS5 上游代理，避免 HTTP 代理不支持 CONNECT 的问题 + - 协议并发验证：SOCKS5 和 HTTP 分组并发验证，SOCKS5 无额外检测，优先填充 + - 新增测试脚本：`test/test_socks5.sh` 用于测试 SOCKS5 代理 + +- **配置增强** + - 新增 `SOCKS5Port` 和 `StableSOCKS5Port` 配置项 + - 支持通过环境变量配置 SOCKS5 端口 + - 优化代理池槽位分配逻辑，支持 HTTP/SOCKS5 比例配置 + +### 变更 + +- 存储层新增协议筛选方法 `CountByProtocol`、`GetRandomByProtocol`、`GetLowestLatencyByProtocol` +- 代理池管理器适配双协议槽位计算 +- Docker Compose 配置新增 SOCKS5 端口映射 + +## [v0.1.0] - 2026-03-29 + +### 新增 + +- **代理认证功能** + - HTTP 和 SOCKS5 代理服务支持可选的用户名密码认证 + - 环境变量配置：`PROXY_AUTH_ENABLED`、`PROXY_AUTH_USERNAME`、`PROXY_AUTH_PASSWORD` + - 默认关闭，开启后可保护代理服务不被未授权访问 + +- **环境变量支持** + - `WEBUI_PASSWORD`：自定义 WebUI 管理密码（默认 `goproxy`） + - `DATA_DIR`：自定义数据目录路径（默认当前目录） + - `BLOCKED_COUNTRIES`：屏蔽特定国家的代理（如 `CN,RU,KP`） + +- **数据目录集中管理** + - 支持通过 `DATA_DIR` 环境变量指定数据存储位置 + - 配置文件 `config.json` 和数据库 `proxy.db` 统一存放在数据目录 + +- **智能抓取机制** + - 智能状态监控：Healthy / Warning / Critical / Emergency 四级状态 + - 按需抓取：根据池子状态自动选择合适的抓取模式 + - 源断路器：连续失败的代理源自动降级或禁用，冷却后恢复 + +- **WebUI 增强** + - 实时日志流显示：支持查看最近 1000 条系统日志 + - 代理质量分布图表：S/A/B/C 各等级代理数量可视化 + - 延迟趋势图：HTTP 和 SOCKS5 平均延迟变化趋势 + +### 变更 + +- 验证超时从 8 秒增加到 10 秒，适应较慢的代理网络 +- 健康检查批次大小从 10 个增加到 20 个，提高检查效率 +- 优化配置参数命名，统一使用 `MaxLatency` 前缀 + +### 文档 + +- 完善 README.md，新增快速导航、Docker 部署、测试指南等章节 +- 新增 `.env.example` 示例环境变量文件 +- 更新 Docker Compose 配置示例 +- 新增 GitHub Container Registry 镜像源说明 + +## [v0.0.1] - 2026-03-27 + +### 新增 + +- 项目初始化 +- 基础 HTTP 代理池功能 +- WebUI 管理界面 +- SQLite 数据持久化 +- 代理验证和健康检查 +- Docker 支持 + +--- + +## 版本说明 + +- **主版本号**：不兼容的 API 变更 +- **次版本号**：向下兼容的功能新增 +- **修订号**：向下兼容的问题修复 + +## 相关链接 + +- [项目仓库](https://github.com/isboyjc/GoProxy) +- [Docker Hub](https://hub.docker.com/r/isboyjc/goproxy) +- [GitHub Container Registry](https://github.com/isboyjc/GoProxy/pkgs/container/goproxy) +- [问题反馈](https://github.com/isboyjc/GoProxy/issues)