# sokit-go

**Repository Path**: xcmrfc-thanos/sokit-go

## Basic Information

- **Project Name**: sokit-go
- **Description**: 一个基于Go语言开发的现代化TCP/UDP网络通信工具，提供直观的Web界面进行端口转发、网络调试和数据分析。
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/xcmrfc-thanos/sokit-go
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-19
- **Last Updated**: 2025-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Sokit - 现代化网络通信工具

[![Go Version](https://img.shields.io/badge/Go-1.23+-blue.svg)](https://golang.org)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen.svg)]()

> 🚀 一个基于Go语言开发的现代化TCP/UDP网络通信工具，提供直观的Web界面进行端口转发、网络调试和数据分析。

![image-20250719021931050](./image-20250719021931050.png)

## ✨ 功能特性

### 🔄 端口转发
- **TCP/UDP转发**：支持TCP和UDP协议的端口转发
- **多实例管理**：同时运行多个转发实例
- **实时监控**：实时显示连接状态和传输统计
- **灵活配置**：支持自定义本地监听地址和目标地址

### 🌐 网络调试工具
- **TCP/UDP客户端**：连接远程服务器进行数据收发
- **TCP/UDP服务器**：创建本地服务器监听连接
- **实时数据流**：实时显示接收和发送的数据
- **连接管理**：查看和管理活跃连接

### 🛠️ 实用工具
- **数据格式转换**：ASCII ↔ HEX 双向转换
- **网络统计**：实时监控网络流量和连接状态
- **记事本编辑器**：内置文本编辑器，支持文件导入导出
- **系统日志**：详细的操作日志记录

### 🎨 现代化界面
- **响应式设计**：适配各种屏幕尺寸
- **实时更新**：WebSocket实时通信
- **直观操作**：简洁明了的用户界面
- **主题优化**：现代化的视觉设计

## 🚀 快速开始

### 环境要求
- Go 1.23 或更高版本
- 现代浏览器（Chrome、Firefox、Safari、Edge）

### 安装运行

1. **克隆仓库**
```bash
git clone https://github.com/your-username/sokit-go.git
cd sokit-go
```

2. **安装依赖**
```bash
go mod download
```

3. **运行应用**
```bash
go run main.go
```

4. **访问界面**
打开浏览器访问：`http://localhost:8088`

### 配置文件

应用会自动创建 `config.ini` 配置文件，您可以根据需要修改：

```ini
[server]
# 默认监听端口
default_port = 8088

[features]
# 功能模块控制
transfer_enabled = true
client_enabled = true
server_enabled = true
tools_enabled = true
notepad_enabled = true
```

## 📖 使用指南

### 端口转发

1. **创建转发**
   - 输入转发名称
   - 设置本地监听地址和端口
   - 设置目标服务器地址和端口
   - 选择协议（TCP/UDP）
   - 点击"创建转发"

2. **管理转发**
   - 查看转发列表和状态
   - 启动/停止转发实例
   - 监控连接数和传输字节
   - 删除不需要的转发

### 网络调试

1. **客户端模式**
   - 设置目标服务器地址和端口
   - 选择协议类型
   - 连接后发送测试数据

2. **服务器模式**
   - 设置监听端口
   - 启动服务器监听连接
   - 查看客户端连接列表
   - 向所有客户端广播数据

### 工具使用

1. **数据转换**
   - 输入ASCII文本或十六进制数据
   - 选择转换方向
   - 查看转换结果

2. **网络统计**
   - 实时查看网络流量统计
   - 监控连接状态
   - 查看传输速率

## 🏗️ 项目结构

```
sokit-go/
├── main.go                 # 应用程序入口
├── config.ini             # 配置文件
├── network/               # 网络通信模块
│   ├── client.go         # 客户端实现
│   ├── server.go         # 服务器实现
│   ├── transfer.go       # 转发实现
│   └── manager.go        # 网络管理器
├── utils/                 # 工具模块
│   ├── config.go         # 配置管理
│   ├── logger.go         # 日志系统
│   ├── toolkit.go        # 工具函数
│   └── file.go           # 文件操作
├── web/                   # Web界面
│   ├── templates/        # HTML模板
│   └── static/           # 静态资源
│       ├── css/          # 样式文件
│       └── js/           # JavaScript文件
└── logs/                  # 日志文件
```

## 🔧 开发指南

### 本地开发

1. **安装依赖**
```bash
go mod tidy
```

2. **运行测试**
```bash
go test ./...
```

3. **构建应用**
```bash
go build -o sokit-go main.go
```

### 代码结构

- **网络层**：基于Go标准库的net包实现
- **Web层**：使用Gorilla WebSocket实现实时通信
- **配置管理**：支持INI格式配置文件
- **日志系统**：分级日志记录

### 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📝 更新日志

### v1.0.0 (2024-07-19)
- ✨ 初始版本发布
- 🔄 支持TCP/UDP端口转发
- 🌐 实现WebSocket实时通信
- 🛠️ 添加数据格式转换工具
- 📊 集成网络统计功能
- 🎨 现代化Web界面设计

## 🤝 贡献者

感谢所有为这个项目做出贡献的开发者！

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## ⚠️ 免责声明

本工具仅用于合法的网络调试和开发测试目的。使用者应遵守当地法律法规，不得用于任何非法活动。开发者不对使用本工具造成的任何后果承担责任。

## 📞 联系方式

- 项目主页：https://gitee.com/xcmrfc-thanos/sokit-go
- 问题反馈：[https://gitee.com/xcmrfc-thanos/sokit-go/issues](https://gitee.com/xcmrfc-thanos/sokit-go/issues)
- 邮箱：eastspirit@foxmail.com

---

⭐ 如果这个项目对您有帮助，请给我们一个星标！