From cde3024d94c3e064c368a79bf80699943dfb2691 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=80=81=E4=B9=9D?= <366193849@qq.com> Date: Mon, 6 Sep 2021 13:40:48 +0800 Subject: [PATCH] update readme --- FastGithub/Views/Home/Index.cshtml | 115 +---------------------------- README.md | 50 +++++++++++-- 2 files changed, 45 insertions(+), 120 deletions(-) diff --git a/FastGithub/Views/Home/Index.cshtml b/FastGithub/Views/Home/Index.cshtml index b37421c..1ab8e20 100644 --- a/FastGithub/Views/Home/Index.cshtml +++ b/FastGithub/Views/Home/Index.cshtml @@ -42,120 +42,7 @@

CA证书

你可能需要在客户端设备下载FastGithub自颁发的CA证书FastGithub.cer，导入到受信任的根证书颁发机构或浏览器 -

- - -

部署方式

-
-
-
-
windows本机
-
-

x64系统

-

双击运行FastGithub.exe程序

-

FastGithub.exe start // 以windows服务安装并启动

-

FastGithub.exe stop // 以windows服务卸载并删除

-
-
-
- -
-
-
linux本机
-
-

x64系统

-

执行sudo ./FastGithub

-

手工添加127.0.0.1做为/etc/resolv.conf的第一条记录

-

手工安装CACert/FastGithub.cer到受信任的根证书颁发机构

-
-
-
- -
-
-
macOS本机
-
-

x64系统

-

双击运行FastGithub程序

-

手工添加127.0.0.1做为连接网络的DNS的第一条记录

-

手工安装CACert/FastGithub.cer并设置信任

-
-
-
- -
-
-
局域网服务器
-
-

x64系统

-

在局域网服务器运行FastGithub程序

-

手工将你电脑的主DNS设置为局域网服务器的ip

-

手工在你电脑安装FastGithub.cer到受信任的根证书颁发机构

-
-
-
-
- -

证书验证

-
-
-
-
git
-
-

SSL certificate problem

-

需要关闭git的证书验证：

-

git config --global http.sslverify false

-
-
-
-
-
-
firefox
-
-

未连接：有潜在的安全问题

-

设置->隐私与安全->证书->查看证书->证书颁发机构

-

导入FastGithub.cer，勾选信任由此证书颁发机构来标识网站

-
-
-
-
- - -

应用冲突

-
- -
-
-
hosts文件
-
-

hosts规则冲突

-

需要从hosts文件移除github相关域名的配置

-
-
-
- -
-
-
代理(proxy)
-
-

浏览器或系统代理冲突

-

关闭代理，或将浏览器和系统配置为不代理github相关域名

-
-
-
- -
-
-
浏览器安全DNS
-
-

浏览器安全DNS冲突

-

关闭浏览器的安全DNS功能或将安全DNS设置为https://@(Model?.Host)

-
-
-
- -
- +

diff --git a/README.md b/README.md index 7ef5eff..12aaf55 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,9 @@ # FastGithub github加速神器，解决github打不开、用户头像无法加载、releases无法上传下载、git-clone、git-pull、git-push失败等问题。 +### 程序下载 +如果不能下载[releases](https://github.com/dotnetcore/FastGithub)里发布的程序，可以到Q群`307306673`里面的群文件下载。 + ### 加速原理 * 修改本机的dns服务指向FastGithub自身 * 解析匹配的域名为FastGithub自身的ip @@ -8,19 +11,54 @@ github加速神器，解决github打不开、用户头像无法加载、releases * 选择最优的ip进行ssh代理或https反向代理 ### 协议列表 -| 协议 | 资源标识 | 端口要求 | 用途 | -| ----- | ------------------- | ---------- | ---------------------------- | +| 协议 | 资源标识 | 端口要求 | 用途 | +| ----- | --------------------- | ---------- | ---------------------------- | | DNS | `udp://0.0.0.0:53` | 要求可用 | 解析配置的域名指向FastGithub | | DoH | `https://0.0.0.0:443` | 要求可用 | 解析配置的域名指向FastGithub | | HTTPS | `https://0.0.0.0:443` | 要求可用 | 反向代理https请求 | | HTTP | `http://0.0.0.0:80` | 不要求可用 | 反向代理http请求 | | SSH | `ssh://0.0.0.0:22` | 不要求可用 | 代理ssh请求到github | -### 程序下载 -如果不能下载[releases](https://github.com/dotnetcore/FastGithub)里发布的程序，可以到Q群`307306673`里面的群文件下载。 +### 部署方式 +#### windows本机 +* 双击运行FastGithub.exe程序 +* `FastGithub.exe start` // 以windows服务安装并启动 +* `FastGithub.exe stop` // 以windows服务卸载并删除 +#### linux本机 +* 执行`sudo ./FastGithub` +* 手工添加127.0.0.1做为/etc/resolv.conf的第一条记录 +* 手工安装CACert/FastGithub.cer到受信任的根证书颁发机构 -### 使用说明 -运行FastGithub，然后浏览器访问 http://127.0.0.1 或 https://127.0.0.1 或其它ip进入Dashboard +#### macOS本机 +* 双击运行FastGithub程序 +* 手工添加127.0.0.1做为连接网络的DNS的第一条记录 +* 手工安装CACert/FastGithub.cer并设置信任 + +#### 局域网服务器 +* 在局域网服务器运行FastGithub程序 +* 手工将你电脑的主DNS设置为局域网服务器的ip +* 手工在你电脑安装FastGithub.cer到受信任的根证书颁发机构 + +### 证书验证 +#### git +git操作提示`SSL certificate problem` + +需要关闭git的证书验证：`git config --global http.sslverify false` + +#### firefox +firefox提示`连接有潜在的安全问题` + +设置->隐私与安全->证书->查看证书->证书颁发机构，导入FastGithub.cer，勾选信任由此证书颁发机构来标识网站 + +### 应用冲突 +#### hosts文件 +需要从hosts文件移除github相关域名的配置 + +#### 代理(proxy) +关闭代理，或将浏览器和系统配置为不代理github相关域名 + +#### 浏览器安全DNS +关闭浏览器的安全DNS功能或将安全DNS设置为https://127.0.0.1 ### 安全性说明 FastGithub为每台不同的主机生成自颁发CA证书，保存在CACert文件夹下。客户端设备需要安装和无条件信任自颁发的CA证书，请不要将证书私钥泄露给他人，以免造成损失。