From 382f911d0c0563b168ad69fd771244c776244211 Mon Sep 17 00:00:00 2001 From: Harphuna <86975697+Hakunasc11@users.noreply.github.com> Date: Tue, 24 May 2022 01:03:19 +0200 Subject: [PATCH] Delete README.md A --- README.md | 393 ------------------------------------------------------ 1 file changed, 393 deletions(-) delete mode 100644 README.md diff --git a/README.md b/README.md deleted file mode 100644 index 5b0d6fd..0000000 --- a/README.md +++ /dev/null @@ -1,393 +0,0 @@ -# dev-sidecar - - -开发者边车,命名取自service-mesh的service-sidecar,意为为开发者打辅助的边车工具(以下简称ds) -通过本地代理的方式将https请求代理到一些国内的加速通道上 - -GitHub stars -star - -> -> Gitee上的同步项目已被封禁,此项目将不再更新与维护 【狗头保命】 -> -> 我将继续奋战在开源一线,为社区贡献更多更好的开源项目。 -> 感兴趣的可以关注我的主页 [【github】](https://github.com/greper) [【gitee】](https://gitee.com/greper) -> - - - -> ------------------------------重要提醒2--------------------------------- -> -> 注意:由于electron无法监听windows的关机事件,开着ds情况下直接重启电脑,会导致无法上网,你可以手动启动ds即可恢复网络,你也可以将ds设置为开机自启。 -> -> 关于此问题的更多讨论请前往: -> https://gitee.com/docmirror/dev-sidecar/issues/I49OUL -> https://github.com/docmirror/dev-sidecar/issues/109 -> - -> ------------------------------重要提醒3--------------------------------- -> -> 注意:本应用启动会自动修改系统代理,所以会与其他代理软件有冲突,请务必不要一起使用。 -> 本应用主要目的在于直连访问github,如果你已经有飞机了,那建议还是不要用这个自行车(ds)了 -> - - - -## 一、 特性 - -### 1、 dns优选(解决***污染问题) -* 根据网络状况智能解析最佳域名ip地址,获取最佳网络速度 -* 解决一些网站和库无法访问或访问速度慢的问题 -* 建议遇到打开比较慢的国外网站,可以优先尝试将该域名添加到dns设置中(注意:被***封杀的无效) - -### 2、 请求拦截 -* 拦截打不开的网站,代理到加速镜像站点上去。 -* 可配置多个镜像站作为备份 -* 具备测速机制,当访问失败或超时之后,自动切换到备用站点,使得目标服务高可用 - -### 3、 github加速 -* github 直连加速 (通过修改sni实现,感谢 [fastGithub](https://github.com/dotnetcore/FastGithub) 提供的思路) -* release、source、zip下载加速 -* clone 加速 -* 头像加速 -* 解决readme中图片引用无法加载的问题 -* gist.github.com 加速 -* 解决git push 偶尔失败需要输入账号密码的问题(fatal: TaskCanceledException encountered / fatal: HttpRequestException encountered) -* raw/blame加速 - -> 以上部分功能通过`X.I.U`的油猴脚本实现, 以下是仓库和脚本下载链接,大家可以去支持一下。 -> * https://github.com/XIU2/UserScript -> * https://greasyfork.org/scripts/412245 -> -> 由于此脚本在ds中是打包在本地的,更新会不及时,你可以直接通过浏览器安装油猴插件使用此脚本,从而获得最新更新(ds本地的可以通过`加速服务->基本设置->启用脚本`进行关闭)。 - - -### 4、 Stack Overflow 加速 -* 将ajax.google.com代理到加速CDN上 -* recaptcha 图片验证码加速 - -### 5、 npm加速 -* 支持开启npm代理 -* 官方与淘宝npm registry一键切换, -* 某些npm install的时候,并且使用cnpm也无法安装时,可以尝试开启npm代理再试 - - -***安全警告***: -* 请勿使用来源不明的服务地址,有隐私和账号泄露风险 -* 本应用及服务端承诺不收集任何信息。介意者请使用安全模式。 - - - - -## 二、快速开始 -支持windows、Mac、Linux(Ubuntu) - -### DevSidecar桌面应用 - -#### 1 下载安装包 -* release下载 -[Gitee Release](https://gitee.com/docmirror/dev-sidecar/releases) -[Github Release](https://github.com/docmirror/dev-sidecar/releases) - -> Windows: 请选择DevSidecar-x.x.x.exe -> Mac: 请选择DevSidecar-x.x.x.dmg -> Ubuntu: 请选择DevSidecar-x.x.x.deb -> 其他linux: 请选择DevSidecar-x.x.x.AppImage (未做测试,不保证能用) - -> linux安装说明请参考 [linux安装文档](./doc/linux.md) - -> 注意:由于没有买应用证书,所以应用在下载安装时会有“未知发行者”等安全提示,选择保留即可。 - - -#### 2 安装后打开 - -> 注意:mac版安装需要在“系统偏好设置->安全性与隐私->通用”中解锁并允许应用安装 - -![](./doc/index.png) - -#### 3 安装根证书 - -第一次打开会提示安装证书,根据提示操作即可 - -更多有关根证书的说明,请参考 [为什么要安装根证书?](./doc/caroot.md) - -> 根证书是本地随机生成的,所以不用担心根证书的安全问题(本应用不收集任何用户信息) -> 你也可以在加速服务设置中自定义根证书(PEM格式的证书与私钥) - - -> 火狐浏览器需要[手动安装证书](#3浏览器打开提示证书不受信任) - -#### 4 开始加速吧 -去试试打开github - - - -### 开启前 vs 开启后 - -| | 开启前 | 开启后 | -| ---- | ---- | ---- | -|头像| ![](./doc/avatar2.png) |![](./doc/avatar1.png) | -|clone |![](./doc/clone-before.png) |![](./doc/clone.png) | -|zip 下载 |![](./doc/download-before.png) |![](./doc/download.png)秒下的,实在截不到速度的图 | - - -## 三、模式说明 - -### 安全模式 -* 此模式:关闭拦截、关闭增强、开启dns优选、开启测速 -* 最安全,无需安装证书,可以在浏览器地址栏左侧查看域名证书 -* 功能也最弱,只有特性1,相当于查询github的国外ip,手动改hosts一个意思。 -* github的可访问性不稳定,取决于IP测速,如果有绿色ip存在,就 `有可能` 可以直连访问。 - ![](./doc/speed.png) - -### 默认模式 -* 此模式:开启拦截、关闭增强、开启dns优选、开启测速 -* 需要安装证书,通过修改sni直连访问github -* 功能上包含特性1/2/3/4。 - -## 四、 最佳实践 - -* 把dev-sidecar一直开着就行了(注意windows下开着ds重启电脑,会无法上网,重新打开ds即可。) -* 建议遇到打开比较慢的国外网站,可以尝试将该域名添加到dns设置中(注意:被***封杀的无效) - -### 其他加速 - 1. git clone 加速 - - 方式1:快捷复制: - > 开启脚本支持,然后在复制clone链接下方,即可复制到加速链接 - - 方式2: - > 使用方式用实际的名称替换{}的内容,即可加速clone - > https://hub.fastgit.org/{username}/{reponame}.git - > clone 出来的 remote "origin" 为fastgit的地址,需要手动改回来 - > 你也可以直接使用他们的clone加速工具 [fgit-go](https://github.com/FastGitORG/fgit-go) - - 2. github.com的镜像网站(注意:不能登录) - >1. [hub.fastgit.org](https://hub.fastgit.org/) - >2. [github.com.cnpmjs.org](https://github.com.cnpmjs.org/) 这个很容易超限 - - -## 五、api - -### 拦截配置 -没有配置域名的不会拦截,其他根据配置进行拦截处理 -```js -const intercepts = { - // 要拦截的域名 - 'github.com': { - //需要拦截url的正则表达式 - '/.*/.*/releases/download/': { - //拦截类型 - // redirect:url, 临时重定向(url会变,一些下载资源可以通过此方式配置) - // proxy:url, 代理(url不会变,没有跨域问题) - // abort:true, 取消请求(适用于被***封锁的资源,找不到替代,直接取消请求,快速失败,节省时间) - // success:true, 直接返回成功请求(某些请求不想发出去,可以伪装成功返回) - redirect: 'download.fastgit.org' - }, - '.*':{ - proxy:'github.com', - sni:'baidu.com' //修改sni,规避***握手拦截 - } - }, - 'ajax.googleapis.com': { - '.*': { - proxy: 'ajax.loli.net', //代理请求,url不会变 - backup: ['ajax.proxy.ustclug.org'], //备份,当前代理请求失败后,将会切换到备用地址 - test: 'ajax.googleapis.com/ajax/libs/jquery/1.12.4/jquery.min.js', - replace:'/(.*)/xxx'//当加速地址的链接和原链接不是完全相同时,可以通过正则表达式replace,此时proxy通过$1$2来重组url, proxy:'ajax.loli.net/xxx/$1' - } - }, - 'clients*.google.com': { - '.*':{ - abort: true //取消请求,被***封锁的资源,找不到替代,直接取消请求,快速失败,节省时间 - } - } -} -``` - -### DNS优选配置 -某些域名解析出来的ip会无法访问,(比如api.github.com会被解析到新加坡的ip上,新加坡的服务器在上午挺好,到了晚上就卡死,基本不可用) -通过从dns上获取ip列表,切换不同的ip进行尝试,最终会挑选到一个最快的ip - -```js - dns: { - mapping: { - // - 'api.github.com': 'usa', // "解决push的时候需要输入密码的问题", - 'gist.github.com': 'usa' // 解决gist无法访问的问题 - "*.githubusercontent.com": "usa" // 解决github头像经常下载不到的问题 - } - }, -``` -注意:暂时只支持IPv4的解析 - -## 六、问题排查 - -### 1、dev-sidecar的前两个开关没有处于打开状态 -1. 尝试将开关按钮手动打开 -2. 请尝试右键dev-sidecar图标,点退出。再重新打开 -3. 如果还不行,请将日志发送给作者 - -如果是mac系统,可能是下面的原因 - -#### 1.1 Mac系统使用时,首页的系统代理开关无法打开 -出现这个问题可能是没有开启系统代理命令的执行权限 -``` -networksetup -setwebproxy 'WiFi' 127.0.0.1 1181 -#看是否有如下错误提示 -** Error: Command requires admin privileges. -``` -如果有上面的错误提示,请尝试如下方法: - ->取消访问偏好设置需要管理员密码 ->系统偏好设置—>安全性与隐私—> 通用—> 高级—> 访问系统范围的偏好设置需要输入管理员密码(取消勾选) - - -### 2、没有加速效果 - ->本应用仅支持https加速,请务必确认你访问的网站地址是https开头的 - -1. 本应用仅支持https加速 -请务必确认你访问的地址是https开头的 -比如: https://github.com/ - -2. 检查浏览器是否装了什么插件,与ds有冲突 - -3. 检查是否安装了其他代理软件,与ds有冲突 - -4. 请确认浏览器的代理设置为使用IE代理/或者使用系统代理状态 - -6. 可以尝试换个浏览器试试 - -7. 请确认网络代理设置处于勾选状态 -正常情况下ds在“系统代理”开关打开时,会自动设置系统代理。 - - -### 3、浏览器打开提示证书不受信任 - -![](./doc/crt-error.png) -一般是证书安装位置不对,重新安装证书后,重启浏览器 - -#### 3.1 windows: 请确认证书已正确安装在“信任的根证书颁发机构”下 - -#### 3.2 mac: 请确认证书已经被安装并已经设置信任。 - -#### 3.3 火狐浏览器:火狐浏览器不走系统的根证书,需要在选项中添加根证书 - -> 1、火狐浏览器->选项->隐私与安全->证书->查看证书 -> 2、证书颁发机构->导入 -> 3、选择证书文件`C:\Users(用户)\Administrator(你的账号)\.dev-sidecar\dev-sidecar.ca.crt`(Mac或linux为`~/.dev-sidecar`目录) -> 4、勾选信任由此证书颁发机构来标识网站,确定即可 - -### 4. 打开github显示连接超时 -```html -DevSidecar Warning: -Error: www.github.com:443, 代理请求超时 -``` -1、检查测速界面github.com是否有ip ,如果没有ip,则可能是由于你的网络提供商封锁了dns服务商的ip(试试能否ping通:1.1.1.1 / 9.9.9.9 ) -2、如果是安全模式,则是因为不稳定导致的,等一会再刷新试试 -3、如果是增强模式,则是由于访问人数过多,正常现象 - -### 5、查看日志是否有报错 - 如果还是不行,请在下方加作者好友,将服务日志发送给作者进行分析 - 日志打开方式:加速服务->右边日志按钮->打开日志文件夹 - -![](./doc/log.png) - - -### 6、某些原本可以打开的网站打不开了 -1、可以尝试关闭pac -2、可以将域名加入白名单 - -### 7、应用意外关闭导致没有网络了 -应用开启后会自动修改系统代理设置,正常退出会自动关闭系统代理 -当应用意外关闭时,可能会因为没有将系统代理恢复,从而导致完全无法上网。 - - 对于此问题有如下几种解决方案可供选择: - 1、重新打开应用即可(右键应用托盘图标可完全退出,将会正常关闭系统代理设置) - 2、如果应用被卸载了,此时需要[手动关闭系统代理设置](./doc/recover.md) - 3、如果你是因为开着ds的情况下重启电脑导致无法上网,你可以设置ds为开机自启 - - -### 8、卸载应用后上不了网,git请求不了 -如果你在卸载应用前,没有正常退出app,就有可能无法上网。请按如下步骤操作恢复您的网络: - -1、关闭系统代理设置,参见:[手动关闭系统代理设置](./doc/recover.md) -2、执行下面的命令关闭git的代理设置(如果你开启过git.ext的开关) -```shell -git config --global --unset http.proxy -git config --global --unset https.proxy -``` -3、执行下面的命令关闭npm的代理设置(如果你开启过npm加速的开关) -```shell -npm config delete proxy -npm config delete https-proxy -``` - -## 七、在其他程序使用 -* [java程序使用](./doc/other.md#Java程序使用) - -## 八、贡献代码 - -### 开发调试模式启动 - -运行如下命令即可开发模式启动 -```shell -git clone https://github.com/docmirror/dev-sidecar - -cd dev-sidecar - -npm install lerna -g -lerna bootstrap - -cd packages/gui - -npm run electron - -``` -> 如果electron依赖包下载不动,可以开启ds的npm加速 - -### 打包成可执行文件 -```shell -# 先执行上面的步骤,然后运行如下命令打包成可执行文件 -npm run electron:build -``` - -### 提交pr -如果你想将你的修改贡献出来,请提交pr - - -## 九、联系作者 -欢迎bug反馈,需求建议,技术交流等(请备注dev-sidecar,或简称DS) - -1、 加群 -
- -
- - - - - -## 十、求star -我的其他项目求star -* [fast-crud](https://github.com/fast-crud/fast-crud) : 开发crud快如闪电 -* [certd](https://github.com/certd/certd) : 让你的证书永不过期 - -## 十一、感谢 -本项目使用lerna包管理工具 - -[![lerna](https://img.shields.io/badge/maintained%20with-lerna-cc00ff.svg)](https://lerna.js.org/) - -本项目参考如下开源项目 -* [node-mitmproxy](https://github.com/wuchangming/node-mitmproxy) -* [ReplaceGoogleCDN](https://github.com/justjavac/ReplaceGoogleCDN) - -特别感谢 -* [github增强油猴脚本](https://greasyfork.org/zh-CN/scripts/412245-github-%E5%A2%9E%E5%BC%BA-%E9%AB%98%E9%80%9F%E4%B8%8B%E8%BD%BD) 本项目部分加速功能完全复制该脚本。 - -本项目部分加速资源由如下组织提供 -* [FastGit UK](https://fastgit.org/) - - -