Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,7 +106,7 @@
>
> 其他Linux: 请选择DevSidecar-x.x.x-linux-[架构].AppImage (未做测试,不保证能用)

> linux安装说明请参考 [linux安装文档](./doc/linux.md)
> Linux安装说明请参考 [linux安装文档](https://github.com/docmirror/dev-sidecar/wiki/Linux支持)

> 注意:由于没有买应用证书,所以应用在下载安装时会有“未知发行者”等安全提示,选择保留即可。

Expand All @@ -115,13 +115,13 @@
界面应大致如下图所示:
> 注意:mac版安装需要在“系统偏好设置->安全性与隐私->通用”中解锁并允许应用安装

![](./doc/index.png)
![](./doc/figures/open-after-installed.png)

#### 3)安装根证书

第一次打开会提示安装证书,根据提示操作即可

更多有关根证书的说明,请参考 [为什么要安装根证书?](./doc/caroot.md)
更多有关根证书的说明,请参考 [为什么要安装根证书?](https://github.com/docmirror/dev-sidecar/wiki/关于信任根证书的说明)

> 根证书是本地随机生成的,所以不用担心根证书的安全问题(本应用不收集任何用户信息)
>
Expand All @@ -135,11 +135,11 @@

### 2.2、开启前 vs 开启后

| | 开启前 | 开启后 |
| -------- | ------------------------------ | ----------------------------------------------- |
| 头像 | ![](./doc/avatar2.png) | ![](./doc/avatar1.png) |
| clone | ![](./doc/clone-before.png) | ![](./doc/clone.png) |
| zip 下载 | ![](./doc/download-before.png) | ![](./doc/download.png)秒下的,实在截不到速度的图 |
| | 开启前 | 开启后 |
|----------|----------------------------------------|----------------------------------------------------------|
| 头像 | ![](./doc/figures/avatar-before.png) | ![](./doc/figures/avatar.png) |
| clone | ![](./doc/figures/clone-before.png) | ![](./doc/figures/clone.png) |
| zip 下载 | ![](./doc/figures/download-before.png) | ![](./doc/figures/download.png)秒下的,实在截不到速度的图 |

## 三、模式说明

Expand All @@ -149,7 +149,7 @@
- 最安全,无需安装证书,可以在浏览器地址栏左侧查看域名证书
- 功能也最弱,只有特性1,相当于查询github的国外ip,手动改hosts一个意思。
- github的可访问性不稳定,取决于IP测速,如果有绿色ip存在,就 `有可能` 可以直连访问。
![](./doc/speed.png)
![](./doc/figures/speed.png)

### 3.2、默认模式

Expand Down Expand Up @@ -187,10 +187,9 @@
### 5.1、拦截配置

没有配置域名的不会拦截,其他根据配置进行拦截处理。

在【加速服务-拦截设置】中配置,格式如下:(更多内容参见[wiki](https://github.com/docmirror/dev-sidecar/wiki/%E5%8A%A0%E9%80%9F%E6%9C%8D%E5%8A%A1%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E))

```json
```jsonc
{
// 要拦截的域名
"github.com": {
Expand Down Expand Up @@ -288,7 +287,8 @@ networksetup -setwebproxy 'WiFi' 127.0.0.1 31181

### 6.3、浏览器打开提示证书不受信任

![](./doc/crt-error.png)
![](./doc/figures/crt-error.png)
一般是证书安装位置不对,重新安装根证书后,重启浏览器

一般是证书安装位置不对,重新安装根证书后,重启浏览器

Expand Down Expand Up @@ -322,7 +322,7 @@ DevSidecar Warning: Error: www.github.com:443, 代理请求超时

日志打开方式:加速服务->右边日志按钮->打开日志文件夹

![](./doc/log.png)
![](./doc/figures/log.png)

### 6.6、某些原本可以打开的网站打不开了

Expand All @@ -337,14 +337,14 @@ DevSidecar Warning: Error: www.github.com:443, 代理请求超时
对于此问题有如下几种解决方案可供选择:

1. 重新打开应用即可(右键应用托盘图标可完全退出,将会正常关闭系统代理设置)
2. 如果应用被卸载了,此时需要[手动关闭系统代理设置](./doc/recover.md)
2. 如果应用被卸载了,此时需要[手动关闭系统代理设置](https://github.com/docmirror/dev-sidecar/wiki/恢复网络)
3. 如果你是因为开着ds的情况下重启电脑导致无法上网,你可以设置ds为开机自启

### 6.8、卸载应用后上不了网,git请求不了

如果你在卸载应用前,没有正常退出app,就有可能无法上网。请按如下步骤操作恢复您的网络:

1、关闭系统代理设置,参见:[手动关闭系统代理设置](./doc/recover.md)
1、关闭系统代理设置,参见:[手动关闭系统代理设置](https://github.com/docmirror/dev-sidecar/wiki/恢复网络)
2、执行下面的命令关闭git的代理设置(如果你开启过 `Git.exe代理` 的开关)

```shell
Expand All @@ -368,7 +368,7 @@ npm config delete https-proxy

## 七、在其他程序使用

- [java程序使用](./doc/other.md#Java程序使用)
- [java程序使用](https://github.com/docmirror/dev-sidecar/wiki/其他程序使用#Java程序使用)

## 八、贡献代码

Expand Down
Binary file removed doc/chatgpt2.png
Binary file not shown.
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
File renamed without changes
Binary file removed doc/gitee.png
Binary file not shown.
Binary file removed doc/me.png
Binary file not shown.
Binary file removed doc/qq_group.png
Binary file not shown.
26 changes: 0 additions & 26 deletions doc/recover.md

This file was deleted.

8 changes: 4 additions & 4 deletions doc/linux.md → doc/wiki/Linux支持.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

`Linux`使用说明,目前仅官方支持`Ubuntu x86_64 GNOME桌面版(原版)`,其他`Linux`未测试

> 注意:需要开启 [sudo 免密支持](https://www.jianshu.com/p/5d02428f313d),否则请自行安装证书
> 注意:需要开启 [sudo 免密支持](https://www.jianshu.com/p/5d02428f313d),否则请自行参照issue手动安装证书

## 一、安装

Expand Down Expand Up @@ -40,13 +40,13 @@

### 1.4. 版本选择

不同CPU架构,选择对应的版本,如果安装失败,请下载 `universal` 版本
优先建议下载 `universal` 版本,也可根据自己设备架构选择对应版本。


## 二、证书安装

默认模式和增强模式需要系统信任CA证书。
由于Linux上火狐和Chrome都不走系统证书,所以除了安装系统证书之外,还需要给浏览器安装证书
由于Linux上火狐和Chrome都不走系统证书,所以除了安装系统证书之外,还需要给浏览器安装证书

### 2.1. 系统证书安装

Expand All @@ -67,4 +67,4 @@

证书文件目录为 `~/.dev-sidecar`

![](../packages/gui/public/setup-linux.png)
![setup-chrome-on-linux](../packages/gui/public/setup-chrome-on-linux.png)
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ windows、mac、linux或者浏览器他们都内置了市面上可信的大型

本应用的实现原理如下图:

![](./flow.jpg)
![](../figures/flow.jpg)

> 简单来说就是DevSidecar在本地启动了一个代理服务器帮你访问目标网站。
> 实际上就是 [中间人攻击](https://baike.baidu.com/item/%E4%B8%AD%E9%97%B4%E4%BA%BA%E6%94%BB%E5%87%BB/1739730?fr=aladdin) 的原理,只是本应用没有用它来干坏事,而是帮助开发者加速目标网站的访问。
Expand Down
File renamed without changes.
Loading
Loading