Browse Source

update readme

老九 3 years ago
parent
commit
e968225d76
2 changed files with 53 additions and 14 deletions
  1. 28 7
      README.html
  2. 25 7
      README.md

+ 28 - 7
README.html

@@ -368,7 +368,7 @@ code {
 <h1 id="fastgithub">FastGithub</h1>
 <p>github加速神器,解决github打不开、用户头像无法加载、releases无法上传下载、git-clone、git-pull、git-push失败等问题。</p>
 <h3 id="1-%E7%A8%8B%E5%BA%8F%E4%B8%8B%E8%BD%BD">1 程序下载</h3>
-<p>如果不能下载<a href="https://github.com/dotnetcore/FastGithub">releases</a>里发布的程序,可以到Q群<code>307306673</code>里面的群文件下载。</p>
+<p>如果不能下载<a href="https://github.com/dotnetcore/fastgithub/releases">releases</a>里发布的程序,可以到Q群<a href="https://qm.qq.com/cgi-bin/qm/qr?k=cx_MgEIvoo1EMkrKg5tXz8vMdtPap3Rw&amp;jump_from=webapi">307306673</a>里面的群文件下载。</p>
 <h3 id="2-%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F">2 部署方式</h3>
 <h4 id="21-windows-x64">2.1 windows-x64</h4>
 <ul>
@@ -388,16 +388,37 @@ code {
 <li>安装cacert/fastgithub.cer并设置信任</li>
 <li>设置系统自动代理为<code>http://127.0.0.1:38457</code>,或手动代理http/https为<code>127.0.0.1:38457</code></li>
 </ul>
-<h3 id="3-%E8%AF%81%E4%B9%A6%E9%AA%8C%E8%AF%81">3 证书验证</h3>
-<h4 id="31-git">3.1 git</h4>
+<h3 id="3-%E5%8A%A0%E9%80%9F%E5%8E%9F%E7%90%86">3 加速原理</h3>
+<h4 id="31-windows">3.1 windows</h4>
+<ol>
+<li>客户端访问<code>https://github.com</code></li>
+<li>客户端向dns查询github.com的ip,fastgithub拦截dns数据包并伪造解析结果为127.0.1</li>
+<li>客户端请求到fastgithub的<code>https://127.0.0.1:443</code></li>
+<li>fastgithub使用fastgithub.cer颁发服务器证书给客户端</li>
+<li>fastgithub查询和计算github.com最快的ip</li>
+<li>fastgithub与github.com进行无sni的tls连接</li>
+<li>fastgithub将请求反向代理到<code>https://github.com</code></li>
+</ol>
+<h4 id="32-linuxosx">3.2 linux/osx</h4>
+<ol>
+<li>客户端访问<code>https://github.com</code></li>
+<li>客户端使用fagithub的代理端口38457代理请求</li>
+<li>fastgithub将代理的流量请求到自身的反向代理服务</li>
+<li>fastgithub使用fastgithub.cer颁发服务器证书给客户端</li>
+<li>fastgithub查询和计算github.com最快的ip</li>
+<li>fastgithub与github.com进行无sni的tls连接</li>
+<li>fastgithub将请求反向代理到<code>https://github.com</code></li>
+</ol>
+<h3 id="4-%E8%AF%81%E4%B9%A6%E9%AA%8C%E8%AF%81">4 证书验证</h3>
+<h4 id="41-git">4.1 git</h4>
 <p>git操作提示<code>SSL certificate problem</code></br></p>
 <p>需要关闭git的证书验证:<code>git config --global http.sslverify false</code></p>
-<h4 id="32-firefox">3.2 firefox</h4>
+<h4 id="42-firefox">4.2 firefox</h4>
 <p>firefox提示<code>连接有潜在的安全问题</code></br></p>
-<p>设置-&gt;隐私与安全-&gt;证书-&gt;查看证书-&gt;证书颁发机构,导入fastgithub.cer,勾选信任由此证书颁发机构来标识网站</p>
-<h3 id="4-%E5%AE%89%E5%85%A8%E6%80%A7%E8%AF%B4%E6%98%8E">4 安全性说明</h3>
+<p>设置-&gt;隐私与安全-&gt;证书-&gt;查看证书-&gt;证书颁发机构,导入cacert/fastgithub.cer,勾选信任由此证书颁发机构来标识网站</p>
+<h3 id="5-%E5%AE%89%E5%85%A8%E6%80%A7%E8%AF%B4%E6%98%8E">5 安全性说明</h3>
 <p>FastGithub为每台不同的主机生成自颁发CA证书,保存在cacert文件夹下。客户端设备需要安装和无条件信任自颁发的CA证书,请不要将证书私钥泄露给他人,以免造成损失。</p>
-<h3 id="5-%E5%90%88%E6%B3%95%E6%80%A7%E8%AF%B4%E6%98%8E">5 合法性说明</h3>
+<h3 id="6-%E5%90%88%E6%B3%95%E6%80%A7%E8%AF%B4%E6%98%8E">6 合法性说明</h3>
 <p>《国际联网暂行规定》第六条规定:“计算机信息网络直接进行国际联网,必须使用邮电部国家公用电信网提供的国际出入口信道。任何单位和个人不得自行建立或者使用其他信道进行国际联网。”
 FastGithub本地代理使用的都是“公用电信网提供的国际出入口信道”,从国外Github服务器到国内用户电脑上FastGithub程序的流量,使用的是正常流量通道,其间未对流量进行任何额外加密(仅有网页原有的TLS加密,区别于VPN的流量加密),而FastGithub获取到网页数据之后发生的整个代理过程完全在国内,不再适用国际互联网相关之规定。</p>
 

+ 25 - 7
README.md

@@ -2,7 +2,7 @@
 github加速神器,解决github打不开、用户头像无法加载、releases无法上传下载、git-clone、git-pull、git-push失败等问题。
 
 ### 1 程序下载
-如果不能下载[releases](https://github.com/dotnetcore/FastGithub)里发布的程序,可以到Q群`307306673`里面的群文件下载。
+如果不能下载[releases](https://github.com/dotnetcore/fastgithub/releases)里发布的程序,可以到Q群[307306673](https://qm.qq.com/cgi-bin/qm/qr?k=cx_MgEIvoo1EMkrKg5tXz8vMdtPap3Rw&jump_from=webapi)里面的群文件下载。
 
 ### 2 部署方式
 #### 2.1 windows-x64
@@ -20,22 +20,40 @@ github加速神器,解决github打不开、用户头像无法加载、releases
 * 安装cacert/fastgithub.cer并设置信任
 * 设置系统自动代理为`http://127.0.0.1:38457`,或手动代理http/https为`127.0.0.1:38457`
 
+### 3 加速原理
+#### 3.1 windows
+1. 客户端访问`https://github.com`
+2. 客户端向dns查询github.com的ip,fastgithub拦截dns数据包并伪造解析结果为127.0.1
+3. 客户端请求到fastgithub的`https://127.0.0.1:443`
+4. fastgithub使用fastgithub.cer颁发服务器证书给客户端
+5. fastgithub查询和计算github.com最快的ip
+6. fastgithub与github.com进行无sni的tls连接
+7. fastgithub将请求反向代理到`https://github.com`
+
+#### 3.2 linux/osx
+1. 客户端访问`https://github.com`
+2. 客户端使用fagithub的代理端口38457代理请求
+3. fastgithub将代理的流量请求到自身的反向代理服务
+4. fastgithub使用fastgithub.cer颁发服务器证书给客户端
+5. fastgithub查询和计算github.com最快的ip
+6. fastgithub与github.com进行无sni的tls连接
+7. fastgithub将请求反向代理到`https://github.com`
   
-### 3 证书验证
-#### 3.1 git
+### 4 证书验证
+#### 4.1 git
 git操作提示`SSL certificate problem`</br>
 
 需要关闭git的证书验证:`git config --global http.sslverify false`
 
-#### 3.2 firefox
+#### 4.2 firefox
 firefox提示`连接有潜在的安全问题`</br>
 
-设置->隐私与安全->证书->查看证书->证书颁发机构,导入fastgithub.cer,勾选信任由此证书颁发机构来标识网站
+设置->隐私与安全->证书->查看证书->证书颁发机构,导入cacert/fastgithub.cer,勾选信任由此证书颁发机构来标识网站
   
 
-### 4 安全性说明
+### 5 安全性说明
 FastGithub为每台不同的主机生成自颁发CA证书,保存在cacert文件夹下。客户端设备需要安装和无条件信任自颁发的CA证书,请不要将证书私钥泄露给他人,以免造成损失。
 
-### 5 合法性说明
+### 6 合法性说明
 《国际联网暂行规定》第六条规定:“计算机信息网络直接进行国际联网,必须使用邮电部国家公用电信网提供的国际出入口信道。任何单位和个人不得自行建立或者使用其他信道进行国际联网。”
 FastGithub本地代理使用的都是“公用电信网提供的国际出入口信道”,从国外Github服务器到国内用户电脑上FastGithub程序的流量,使用的是正常流量通道,其间未对流量进行任何额外加密(仅有网页原有的TLS加密,区别于VPN的流量加密),而FastGithub获取到网页数据之后发生的整个代理过程完全在国内,不再适用国际互联网相关之规定。