更新日志

所有重要的项目变更都会记录在此文件中。

[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 访问能力

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 端口映射

代理认证功能
- 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 平均延迟变化趋势