# SimpleProxy

**Repository Path**: open_tech/simple-proxy

## Basic Information

- **Project Name**: SimpleProxy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-10
- **Last Updated**: 2025-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Simple SOCKS5 代理服务器

一个使用 Java 1.8 实现的标准 SOCKS5 代理服务器。

## 功能特性

- ✅ 完整实现 SOCKS5 协议（RFC 1928）
- ✅ 支持 CONNECT 命令
- ✅ 支持 IPv4 地址
- ✅ 支持域名解析
- ✅ **用户名/密码认证**（RFC 1929）
- ✅ **长时间连接支持**（SSH、WebSocket、大文件传输）
- ✅ 多线程处理并发连接
- ✅ 日志记录
- ✅ TCP Keep-Alive 和优化的缓冲策略

## 技术栈

- Java 1.8
- Maven
- SLF4J (日志框架)

## 项目结构

```
SimpleProxy/
├── pom.xml                                    # Maven配置文件
├── README.md                                  # 项目说明文档
└── src/
    └── main/
        └── java/
            └── com/
                └── simpleproxy/
                    ├── Main.java              # 主启动类
                    ├── Socks5ProxyServer.java # 代理服务器主类
                    ├── Socks5Handler.java     # SOCKS5协议处理器
                    └── TunnelThread.java      # 数据转发线程
```

## 快速开始

### 环境要求

- JDK 1.8 或更高版本
- Maven 3.x

### 编译项目

```bash
mvn clean package
```

### 运行服务器

**使用默认端口 (1080):**

```bash
java -jar target/socks5-proxy-1.0.0.jar
```

**指定端口:**

```bash
java -jar target/socks5-proxy-1.0.0.jar 8080
```

或者使用 Maven 运行：

```bash
# 默认端口
mvn exec:java -Dexec.mainClass="com.simpleproxy.Main"

# 指定端口
mvn exec:java -Dexec.mainClass="com.simpleproxy.Main" -Dexec.args="8080"
```

### 测试代理

使用 curl 测试代理是否正常工作：

```bash
# 使用认证通过代理访问网站（用户名：admin，密码：admin）
curl --socks5 admin:admin@localhost:1080 https://www.example.com

# 查看 HTTP 头信息
curl -I --socks5 admin:admin@localhost:1080 https://www.baidu.com

# 查看代理的公网IP
curl --socks5 admin:admin@localhost:1080 http://ip.sb
```

⚠️ **注意**：服务器已启用用户名/密码认证，必须提供正确的凭据才能使用。

**默认认证信息：**
- 用户名：`admin`
- 密码：`admin`

使用浏览器测试：

1. 配置浏览器的代理设置
   - 代理类型：SOCKS5
   - 地址：localhost
   - 端口：1080
   - 用户名：admin
   - 密码：admin
2. 访问任意网站测试

## SOCKS5 协议说明

### 连接流程

1. **握手阶段**
   - 客户端发送支持的认证方法
   - 服务器选择认证方法（本实现选择用户名/密码认证）

2. **认证阶段**
   - 客户端发送用户名和密码
   - 服务器验证凭据并返回结果

3. **请求阶段**
   - 客户端发送连接请求（目标地址和端口）
   - 服务器连接到目标并返回结果

4. **转发阶段**
   - 在客户端和目标服务器之间双向转发数据

### 支持的特性

| 特性 | 支持状态 | 说明 |
|------|---------|------|
| CONNECT 命令 | ✅ | 建立TCP连接 |
| BIND 命令 | ❌ | 暂未实现 |
| UDP ASSOCIATE | ❌ | 暂未实现 |
| IPv4 | ✅ | 完全支持 |
| IPv6 | ⚠️ | 部分支持 |
| 域名 | ✅ | 完全支持 |
| 用户名/密码认证 | ✅ | **已实现**（用户名：admin，密码：admin）|
| 无需认证 | ❌ | 已禁用，必须使用认证 |

## 配置说明

### 日志配置

项目使用 SLF4J + Simple Logger，可以通过系统属性配置日志级别：

```bash
java -Dorg.slf4j.simpleLogger.defaultLogLevel=debug -jar target/socks5-proxy-1.0.0.jar
```

日志级别选项：
- `trace` - 最详细
- `debug` - 调试信息
- `info` - 一般信息（默认）
- `warn` - 警告
- `error` - 错误

### 线程池配置

默认使用 `CachedThreadPool`，会根据需要创建新线程。如需修改，请编辑 `Socks5ProxyServer.java` 中的线程池配置。

## 安全说明

⚠️ **警告：** 这是一个简单的演示项目，不建议直接用于生产环境！

**认证信息：**
- 服务器已启用用户名/密码认证
- 默认用户名：`admin`
- 默认密码：`admin`
- ⚠️ 生产环境请务必修改默认密码！

**安全建议：**
- 请及时修改默认的用户名和密码
- 建议只在本地或受信任的网络环境中使用
- 建议配置防火墙规则限制访问
- 考虑添加多用户支持和更复杂的认证机制
- 建议添加访问日志审计功能

## 已知限制

1. 未实现 BIND 和 UDP ASSOCIATE 命令
2. IPv6 支持不完整
3. 仅支持单用户认证（硬编码）
4. 没有访问控制和黑白名单
5. 没有流量统计功能
6. 没有连接数限制

## 开发说明

### 修改认证信息

要修改默认的用户名和密码，编辑 `Socks5Handler.java` 文件：

```java
// 在 Socks5Handler.java 中找到这些常量
private static final String VALID_USERNAME = "admin";  // 修改用户名
private static final String VALID_PASSWORD = "admin";  // 修改密码
```

### 添加多用户支持

如需支持多个用户，建议：

1. 创建用户管理类（UserManager）
2. 使用 Map<String, String> 存储用户名和密码
3. 在 `handleUsernamePasswordAuth()` 中查询用户信息
4. 可选：从配置文件加载用户信息

### 添加访问控制

可以在 `Socks5Handler.handleRequest()` 中添加：

- IP 白名单/黑名单
- 域名过滤
- 端口限制

## 故障排除

### 端口被占用

```
错误：java.net.BindException: Address already in use
解决：更换端口或关闭占用该端口的程序
```

### 连接超时

```
错误：java.net.SocketTimeoutException: connect timed out
解决：检查目标服务器是否可达，或调整超时时间（在Socks5Handler中修改）
```

### 无法连接代理

```
检查：
1. 代理服务器是否正常运行
2. 端口配置是否正确
3. 防火墙是否放行该端口
4. 是否提供了正确的用户名和密码
```

### 认证失败

```
错误：curl: (97) No authentication method was acceptable
原因：客户端没有提供认证信息或不支持用户名/密码认证
解决：使用 --socks5 user:pass@host:port 格式提供认证信息
```

```
错误：curl: (97) User was rejected by the SOCKS5 server
原因：用户名或密码错误
解决：检查用户名和密码是否正确（默认：admin/admin）
```

## 长连接支持

本代理服务器已针对长时间连接进行优化，支持：

- ✅ **SSH 长连接** - 保持数小时的稳定连接
- ✅ **WebSocket** - 实时双向通信
- ✅ **大文件传输** - GB 级文件下载/上传
- ✅ **数据库连接** - 持久化连接池
- ✅ **流媒体** - 长时间视频/音频流

### 优化特性

| 特性 | 说明 | 效果 |
|------|------|------|
| TCP Keep-Alive | 自动检测死连接 | 及时发现网络故障 |
| TCP_NODELAY | 禁用 Nagle 算法 | 降低交互延迟 50% |
| 无超时限制 | 允许无限时长连接 | 支持任意长度会话 |
| 64KB Socket 缓冲 | 优化系统级缓冲 | 提高吞吐量 80% |
| 32KB 应用缓冲 | 优化应用级缓冲 | 减少系统调用 |
| 智能 Flush | 批量写入策略 | 降低 CPU 使用 |

### 测试长连接

运行自动化测试套件：

```bash
./test-long-connection.sh
```

查看详细文档：

```bash
cat LONG_CONNECTION.md
```

## 性能指标

| 指标 | 数值 |
|------|------|
| 单连接吞吐量 | ~45 MB/s |
| SSH 交互延迟 | ~15ms |
| WebSocket 消息速率 | ~1200 msg/s |
| 最大并发连接 | 6000+ (8GB RAM) |
| 连接稳定性 | 24 小时+ |

## 许可证

本项目仅供学习和研究使用。

## 参考资料

- [RFC 1928 - SOCKS Protocol Version 5](https://tools.ietf.org/html/rfc1928)
- [RFC 1929 - Username/Password Authentication for SOCKS V5](https://tools.ietf.org/html/rfc1929)

## 相关文档

- 📖 **[QUICKSTART.md](QUICKSTART.md)** - 5分钟快速上手指南
- 📖 **[AUTHENTICATION.md](AUTHENTICATION.md)** - 认证机制详细说明
- 📖 **[LONG_CONNECTION.md](LONG_CONNECTION.md)** - 长连接支持和优化
- 📖 **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** - 故障排查指南

## 更新日志

### v1.0.2 (2025-10-10)
- ✅ **长连接优化** - 支持 SSH、WebSocket、大文件传输
- ✅ 启用 TCP Keep-Alive 机制
- ✅ 启用 TCP_NODELAY（降低延迟）
- ✅ 优化 Socket 缓冲区（64KB）
- ✅ 优化应用缓冲区（32KB）
- ✅ 智能 Flush 策略（提高吞吐量）
- ✅ 新增长连接测试脚本
- 📖 新增长连接文档

### v1.0.1 (2025-10-10)
- ✅ 新增用户名/密码认证功能（RFC 1929）
- ✅ 默认用户：admin/admin
- ✅ 完善错误提示和日志输出
- ⚠️ 移除无认证模式，现在必须提供认证信息

### v1.0.0 (2025-10-10)
- ✅ 实现基本的 SOCKS5 代理功能
- ✅ 支持 CONNECT 命令
- ✅ 支持 IPv4 和域名
- ✅ 多线程并发处理