Skip to content

Commit 47b664c

Browse files
authored
Create README.md
1 parent 395fefe commit 47b664c

1 file changed

Lines changed: 140 additions & 0 deletions

File tree

.github/workflows/README.md

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
# ECH Workers 客户端
2+
3+
跨平台的 ECH Workers 代理客户端,支持 Windows 和 macOS。
4+
5+
## 功能特性
6+
7+
- ✅ 服务器配置管理(支持多个服务器配置)
8+
- ✅ 启动/停止代理进程
9+
- ✅ 实时日志显示
10+
- ✅ 系统托盘图标(可选)
11+
- ✅ 开机自动启动
12+
- ✅ 配置自动保存
13+
14+
## 快速开始
15+
16+
### 方法 1: 使用预编译版本(推荐)
17+
18+
[GitHub Releases](https://github.com/your-repo/releases) 下载对应平台的压缩包:
19+
20+
- **Windows**: `ECHWorkers-windows-amd64.zip`
21+
- **macOS Intel**: `ECHWorkers-darwin-amd64.zip`
22+
- **macOS Apple Silicon**: `ECHWorkers-darwin-arm64.zip`
23+
24+
解压后:
25+
1. 安装 Python 3.6+(如果还没有)
26+
2. 安装依赖: `pip install PyQt5`
27+
3. 运行: `python gui.py` 或使用启动脚本
28+
29+
### 方法 2: 从源码编译
30+
31+
#### 编译 Go 程序
32+
33+
```bash
34+
# 初始化 Go 模块
35+
go mod init ech-workers
36+
go mod tidy
37+
38+
# 编译
39+
go build -o ech-workers ech-workers.go
40+
```
41+
42+
#### 运行 Python 客户端
43+
44+
```bash
45+
# 安装依赖
46+
pip install PyQt5
47+
48+
# 运行
49+
python3 gui.py
50+
```
51+
52+
## 文件说明
53+
54+
### 核心文件
55+
- `ech-workers.go` - Go 源码(核心代理程序)
56+
- `gui.py` - Python GUI 客户端(使用 PyQt5)
57+
58+
### 配置文件
59+
- `go.mod`, `go.sum` - Go 模块文件
60+
- `requirements.txt` - Python 依赖列表
61+
62+
## 系统要求
63+
64+
- **Windows**: Windows 10+
65+
- **macOS**: macOS 10.13+
66+
- **Python**: 3.6+
67+
- **Go**: 1.23+ (仅编译时需要,ECH 功能需要此版本)
68+
69+
## 配置说明
70+
71+
配置文件保存在:
72+
- **Windows**: `%APPDATA%\ECHWorkersClient\config.json`
73+
- **macOS**: `~/Library/Application Support/ECHWorkersClient/config.json`
74+
- **Linux**: `~/.config/ECHWorkersClient/config.json`
75+
76+
## 使用说明
77+
78+
1. **配置服务器**
79+
- 点击"新增"添加服务器配置
80+
- 填写服务地址和监听地址
81+
- 可选:填写身份令牌、IP、DNS、ECH 等高级选项
82+
83+
2. **启动代理**
84+
- 点击"启动代理"按钮
85+
- 查看日志区域了解运行状态
86+
87+
3. **系统托盘**(如果安装了 pystray)
88+
- 应用会在菜单栏显示图标
89+
- 点击图标可以打开/隐藏窗口
90+
91+
## 故障排除
92+
93+
### PyQt5 安装问题
94+
95+
如果遇到 PyQt5 安装问题:
96+
```bash
97+
# macOS
98+
pip3 install --user PyQt5
99+
#
100+
pip3 install --break-system-packages PyQt5
101+
102+
# Windows
103+
pip install PyQt5
104+
```
105+
106+
### 找不到 ech-workers
107+
108+
确保已编译 Go 程序:
109+
```bash
110+
go build -o ech-workers ech-workers.go
111+
```
112+
113+
## 开发
114+
115+
### 本地测试
116+
117+
```bash
118+
# 编译 Go
119+
go build -o ech-workers ech-workers.go
120+
121+
# 测试 Python
122+
python3 -m py_compile gui.py
123+
```
124+
125+
### GitHub Actions
126+
127+
推送标签会自动触发构建和发布:
128+
```bash
129+
git tag v1.0.0
130+
git push origin v1.0.0
131+
```
132+
133+
## 许可证
134+
135+
[添加你的许可证]
136+
137+
## 贡献
138+
139+
欢迎提交 Issue 和 Pull Request!
140+

0 commit comments

Comments
 (0)