# github_link

**Repository Path**: konghailei/github_link

## Basic Information

- **Project Name**: github_link
- **Description**: 链接github的工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: go
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ghaccel - GitHub 加速工具（Windows）

让国内访问 GitHub 稳定流畅，支持 **Git 加速 + 系统代理 + DNS 优化 + 网页代理**。

---

## 🚀 快速开始

### 1. 双击运行
双击 `ghaccel_systray.exe`，右下角出现托盘图标。

### 2. 打开管理界面
右键托盘图标 → 「🌐 打开管理界面」（或浏览器访问 `http://localhost:20875`）

### 3. 一键加速
在管理界面点击 **「⚡ 一键全栈加速」** 按钮，自动完成最佳配置。

---

## 🔧 v1.4.1 核心修复（一键配置真正生效！）

### ✅ 修复"一键配置点了没效果"
- **问题根源**：`handleStatus` 依赖 `git config` 命令检测状态，如果电脑没装 git，永远显示"未配置"
- **修复方案**：
  - 状态显示改为**读取配置文件**（不依赖 git 命令）
  - 添加 `CheckGitAvailable()` 检测 git 是否安装
  - 一键配置时，如果 git 不可用，**保存配置并给出明确提示**（而不是静默失败）
  - 状态网格新增"Git 环境"项，直观显示 git 是否已安装

### 🆕 v1.4.0 功能（无代理也能用）
- **网页代理**：启动本地代理服务（`127.0.0.1:8087`），浏览器配置后通过镜像站访问 GitHub 网页
- **系统代理**：通过注册表设置 Windows 代理，浏览器走代理访问 GitHub
- **DNS 优化**：自动更新 hosts 文件，加速 GitHub 域名解析
- **自动切换**：节点失效时自动切换

---

### ✅ 无代理方案（无需本地代理工具）
当你电脑**没有 Clash/V2Ray** 等代理工具时，仍可加速 GitHub：

| 功能 | 说明 |
|------|------|
| **镜像加速** | `git clone` 自动走 `ghproxy.com` 镜像，加速下载 |
| **DNS 优化** | 修改 `hosts` 文件，直连 GitHub IP |
| **网页代理（新增 v1.4.0）** | 启动本地代理（`127.0.0.1:8087`），浏览器配置后 GitHub 网页可访问 |
| **自动切换** | 节点失效时自动切换 |

### ✅ 有代理方案（推荐）
当你有 Clash/V2Ray 等代理工具时，使用完整方案：

| 功能 | 说明 |
|------|------|
| **Git 代理加速** | `git push/pull/clone` 走代理，速度飞起 |
| **镜像加速** | `git clone` 自动替换为镜像地址 |
| **系统代理（浏览器）** | 设置 Windows 系统代理，浏览器访问 GitHub 也加速 |
| **DNS 优化** | 修改 `hosts` 文件，加速 DNS 查询 |
| **自动切换** | 节点失效时自动切换 |

---

## 🌐 v1.4.0 新增：网页代理（无代理也能访问 GitHub 网页！）

### 使用方法
1. 打开管理界面 → 找到「🖥️ 网页代理」卡片
2. 点击 **「🖥️ 启动网页代理」** 按钮
3. 按提示配置浏览器代理：
   - 代理地址：`127.0.0.1`
   - 端口：`8087`
4. 配置完成后，访问 `https://github.com` 即可（通过镜像站加速）

### 原理
本地代理服务将 `github.com` 的请求转发到 `github.moeyy.xyz` 镜像站，实现无代理访问。

---

## 📊 使用说明

### Git 加速配置
- **启用 Git 代理加速**：勾选后填写代理地址（如 `sock5://127.0.0.1:7890`）
- **启用镜像加速**：`git clone` 自动替换为镜像地址（如 `https://ghproxy.com/`）

### 系统代理（浏览器加速）
- **需要 HTTP 类型代理**（如 `http://127.0.0.1:7890`）
- **注意**：Windows 系统代理不支持 SOCKS 类型

### DNS 优化（hosts 文件）
- 修改 `C:\Windows\System32\drivers\etc\hosts`
- 需要**管理员权限**
- 修改前自动备份到 `hosts.backup_*`

### 镜像节点选择
- 支持多个镜像站，自动检测可用性
- 点击即可选择使用的镜像

---

## 🛠️ 托盘菜单功能

| 菜单项 | 功能 |
|--------|------|
| 🌐 打开管理界面 | 浏览器打开 Web 管理界面 |
| 📊 查看状态 | 在日志中显示当前加速状态 |
| ⚡ 应用加速 | 应用 Git 加速配置 |
| 🔄 恢复默认 | 恢复所有配置为默认 |
| 🌐 系统代理：关/开 | 开启/关闭 Windows 系统代理 |
| 📋 DNS 优化：关/开 | 开启/关闭 hosts 优化 |
| 🖥️ 网页代理：关（新增 v1.4.0） | 从管理界面启动网页代理 |
| 🔀 自动切换：开/关 | 开启/关闭节点自动切换 |
| ℹ️ 关于 | 显示版本信息 |
| ❌ 退出 | 退出 ghaccel |

---

## 📁 配置文件

配置文件保存到：`C:\Users\<你的用户名>\.ghaccel\config.json`

```json
{
  "enable_proxy": false,
  "proxy_url": "sock5://127.0.0.1:7890",
  "enable_mirror": true,
  "mirror_url": "https://ghproxy.com/",
  "enable_system_proxy": false,
  "enable_hosts": false,
  "enable_auto_switch": true,
  "enable_web_proxy": false,
  "web_proxy_port": 8087,
  "enable_webui": true,
  "webui_port": 20875,
  "auto_start": false
}
```

---

## 🔍 常见问题

### Q1：点击"一键全栈加速"没反应？
**A**：检查：
1. 是否以管理员身份运行？（修改 hosts 需要管理员权限）
2. 查看日志区域是否有错误提示
3. v1.4.0 已修复：无本地代理时，仍可使用镜像加速 + 网页代理

### Q2：系统代理开启后浏览器还是打不开 GitHub？
**A**：
1. 确认代理地址是 **HTTP 类型**（`http://127.0.0.1:7890`），不是 SOCKS
2. 确认浏览器使用的是系统代理设置
3. 尝试清除浏览器缓存并重启浏览器

### Q3：网页代理启动后怎么用？
**A**：
1. 启动网页代理后，会显示代理地址（如 `127.0.0.1:8087`）
2. 配置浏览器代理为上述地址
3. Chrome 可使用 SwitchyOmega 插件快速切换代理

### Q4：DNS 优化开启失败？
**A**：需要管理员权限。右键 `ghaccel_systray.exe` →「以管理员身份运行」。

---

## 🔨 编译方法

```bash
# 设置 Go 环境变量
$env:GOPROXY = "https://goproxy.cn,direct"

# 编译 Windows exe
$env:GOOS = "windows"
$env:GOARCH = "amd64"
go build -o ghaccel_systray.exe .
```

---

## 📝 更新日志

### v1.4.0 (2026-06-05)
- ✅ **新增：网页代理功能**（无本地代理也能访问 GitHub 网页！）
- ✅ 修复：无本地代理时"一键配置"失败的问题
- ✅ 优化：无代理时自动使用镜像加速 + DNS 优化
- ✅ 新增：`/api/web-proxy` API 端点（控制网页代理服务）

### v1.3.0 (2026-06-05)
- ✅ 新增：系统代理设置（让浏览器也能访问 GitHub）
- ✅ 新增：hosts 优化（DNS 加速）
- ✅ 新增：自动切换（节点失效自动切换）
- ✅ 优化：状态显示更友好

### v1.2.0 (2026-06-05)
- ✅ 新增：自动代理检测（Clash/V2Ray/SSR 等）
- ✅ 新增：一键自动加速按钮
- ✅ 优化：UI 大幅改进，状态显示更直观
- ✅ 修复：加速逻辑 bug（`insteadOf` 配置格式错误）

### v1.1.0 (2026-06-05)
- ✅ 新增：系统托盘常驻（systray）
- ✅ 修复：fyne 需要 CGO，改用 systray 纯 Go 方案

### v1.0.0 (2026-06-05)
- ✅ 初始版本：Git 代理加速 + 镜像加速 + Web 管理界面

---

## 📄 技术栈

- **Go 1.22.5**
- **systray**（系统托盘）
- **embed**（HTML 模板打包进 exe）
- **纯 Go**，CGO_ENABLED=0，单文件 exe
- **PowerShell**（注册表操作 + hosts 文件写入）

---

## 📧 文件清单

| 文件 | 说明 |
|------|------|
| `ghaccel_systray.exe` | 编译好的可执行文件（11MB，单文件） |
| `main.go` | 主程序（托盘菜单逻辑） |
| `config/config.go` | 配置管理 |
| `accelerator/git.go` | Git 加速逻辑 |
| `accelerator/system_proxy.go` | 系统代理设置（注册表） |
| `accelerator/hosts.go` | hosts 文件优化 |
| `web/server.go` | Web 管理界面服务端 |
| `web/templates/index.html` | Web 管理界面前端 |
| `README.md` | 本文件 |
| `go.mod` / `go.sum` | Go 依赖 |

---

## 🚩 许可

MIT License