doc: 将 wiki 页面的内容添加到仓库中，方便别人修改文档。
王良
parent
8ed6193513
commit
88687e8709
|
|
@ -0,0 +1,52 @@
|
|||
> **给作者打个广告：**<br>
|
||||
> [https://github.com/certd/certd](https://github.com/certd/certd) 我的开源证书管理工具项目，全自动申请和部署证书，有需求的可以去试试，帮忙点个star
|
||||
|
||||
> 注：Wiki还在完善中，敬请期待更多内容。<br>
|
||||
> 说明：以下文档均以最新版本进行编写，请下载最新版DS后，再参考以下文档使用！<br>
|
||||
|
||||
# 一、下载安装：
|
||||
|
||||
访问 https://github.com/docmirror/dev-sidecar/releases 页面，下载对应操作系统的安装程序进行安装。
|
||||
|
||||
如安装有问题，请查看 [各平台安装说明](https://github.com/docmirror/dev-sidecar/wiki/%E5%90%84%E5%B9%B3%E5%8F%B0%E5%AE%89%E8%A3%85%E8%AF%B4%E6%98%8E)
|
||||
|
||||
# 二、功能使用说明：
|
||||
|
||||
1. [`加速服务`使用说明](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)
|
||||
2. 系统代理使用说明：
|
||||
3. 通用功能使用说明：
|
||||
1. 开机自启动：
|
||||
2. 远程配置：
|
||||
3. 主题设置：
|
||||
4. 窗口设置：
|
||||
5. 检查更新：
|
||||
4. 应用使用说明：
|
||||
1. NPM加速：
|
||||
2. Git.exe加速：
|
||||
3. PIP加速：
|
||||
4. 彩蛋（功能增强）：
|
||||
5. 帮助中心
|
||||
6. 反馈问题
|
||||
|
||||
# 三、解决问题：
|
||||
|
||||
1. [解决Github访问不了或速度很慢的问题](https://github.com/docmirror/dev-sidecar/wiki/%E8%A7%A3%E5%86%B3Github%E8%AE%BF%E9%97%AE%E4%B8%8D%E4%BA%86%E6%88%96%E9%80%9F%E5%BA%A6%E5%BE%88%E6%85%A2%E7%9A%84%E9%97%AE%E9%A2%98)
|
||||
2. [Linux安装证书失败的避坑](https://github.com/docmirror/dev-sidecar/issues/238)
|
||||
3. [解决Linux（deb）系统下无法安装根证书的问题](https://github.com/docmirror/dev-sidecar/issues/135)
|
||||
4. [在Arch/Fedora下的证书安装](https://github.com/docmirror/dev-sidecar/issues/204)
|
||||
5. [Mac安装：`无法打开“dev-sidecar”，因为无法验证开发者。` 的解决方案](https://github.com/docmirror/dev-sidecar/issues/147)
|
||||
6. [在 WSL 中的使用方法](https://github.com/docmirror/dev-sidecar/issues/73)
|
||||
|
||||
[> 点击前往Issue区查找更多帮助信息](https://github.com/docmirror/dev-sidecar/issues)
|
||||
|
||||
# 四、DevSidecar技术交流群
|
||||
|
||||
- QQ 1群：[390691483](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=hIG_VClE1CU2gHuLSSTaazMlo6M760iL&authKey=5VUMMwzH5FeabLDbZNZJbqmZk1gfmB%2B%2FlotO%2Brszz%2BW3E8xwKD2hTg2%2FV2LJEKL7&noverify=0&group_code=390691483)，人数：496 / 500
|
||||
- QQ 2群：[667666069](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=n4nksr4sji93vZtD5e8YEHRT6qbh6VyQ&authKey=XKBZnzmoiJrAFyOT4V%2BCrgX5c13ds59b84g%2FVRhXAIQd%2FlAiilsuwDRGWJct%2B570&noverify=0&group_code=667666069)，人数：488 / 500
|
||||
- QQ 3群：[419807815](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=zRkm0eHUhRmWWJA5O35C7BOKPZ4_gmrz&authKey=X9JHezR1BOalcEmvV6If04TN%2BIbzjAayBDaOSiuOg1SPpPguA7RqoLSHVEeo7A4e&noverify=0&group_code=419807815)，人数：494 / 500
|
||||
- QQ 4群：[438148299](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=i_NCBB5f_Bkm2JsEV1tLs2TkQ79UlCID&authKey=nMsVJbJ6P%2FGNO7Q6vsVUadXRKnULUURwR8zvUZJnP3IgzhHYPhYdcBCHvoOh8vYr&noverify=0&group_code=438148299)，人数：295 / 1000
|
||||
- QQ 5群：[767622917](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=nAWi_Rxj7mM4Unp5LMiatmUWhGimtbcB&authKey=aswmlWGjbt3GIWXtvjB2GJqqAKuv7hWjk6UBs3MTb%2Biyvr%2Fsbb1kA9CjF6sK7Hgg&noverify=0&group_code=767622917)，人数：068 / 200（new）
|
||||
|
||||
# 五、版本更新日志
|
||||
|
||||
https://github.com/docmirror/dev-sidecar/releases
|
||||
|
|
@ -0,0 +1,173 @@
|
|||
# 1. 加速服务:
|
||||
1. 什么是 `加速服务`？
|
||||
`加速服务` 即 `代理服务`，它通过中间人攻击的方式，将网络请求拦截下来，并经过DNS加速、篡改、重定向、代理等一系列的功能，达到加速访问、或访问原本无法访问的站点等目的。
|
||||
|
||||
2. 启动加速服务：点击首页的 `代理服务` 右侧的开关按钮，即可启动加速服务。
|
||||
|
||||
# 2. 根证书使用说明：
|
||||
1. 什么是根证书？
|
||||
2. [为什么需要安装根证书这么高风险性的步骤](https://github.com/docmirror/dev-sidecar/blob/master/doc/caroot.md)
|
||||
3. 如何安装根证书：
|
||||
|
||||
# 3. 模式：
|
||||
1. 安全模式：
|
||||
2. 默认模式：
|
||||
3. 增强模式（彩蛋）：
|
||||
|
||||
# 4. 拦截功能使用和配置说明：
|
||||
1. 请求拦截器：
|
||||
| 请求拦截器名称 | 拦截器配置名 | 请求拦截优先级 | 快速响应码 |
|
||||
| ----------------- | -------------- | ------------- | --------- |
|
||||
| OPTIONS请求拦截器 | options | 101 | 200 |
|
||||
| 快速成功拦截器 | success | 102 | 200 |
|
||||
| 快速失败拦截器 | abort | 103 | 403 |
|
||||
| 缓存请求拦截器 | cacheXxx | 104 | 304 |
|
||||
| 重定向拦截器 | redirect | 105 | 302 |
|
||||
| 请求篡改拦截器 | requestReplace | 111 | |
|
||||
| 代理拦截器 | proxy | 121 | |
|
||||
| SNI拦截器 | sni | 122 | |
|
||||
|
||||
2. 响应拦截器：
|
||||
| 响应拦截器名称 | 拦截器配置名 | 响应拦截优先级 |
|
||||
| ---------------- | --------------- | ------------- |
|
||||
| OPTIONS响应拦截器 | options | 201 |
|
||||
| 缓存响应拦截器 | cacheXxx | 202 |
|
||||
| 响应篡改拦截器 | responseReplace | 203 |
|
||||
| 脚本拦截器 | script | 211 |
|
||||
|
||||
# 5. 域名白名单：
|
||||
|
||||
# 6. DNS服务管理：
|
||||
|
||||
## 6.1. 配置 `DNS-over-HTTPS` 的DNS服务：
|
||||
```json
|
||||
{
|
||||
"cloudflare": {
|
||||
"type": "https",
|
||||
"server": "https://1.1.1.1/dns-query",
|
||||
"cacheSize": 1000
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
```json
|
||||
{
|
||||
"cloudflare": {
|
||||
"server": "https://1.1.1.1/dns-query", // 地址上带有 `https://`，type可以不配置
|
||||
"cacheSize": 1000
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 6.2. 配置 `DNS-over-TLS` 的DNS服务：
|
||||
|
||||
```json
|
||||
{
|
||||
"cloudflareTLS": {
|
||||
"type": "tls",
|
||||
"server": "1.1.1.1",
|
||||
"port": 853, // 不配置时，默认端口为：853
|
||||
"servername": "cloudflare-dns.com", // SNI
|
||||
"cacheSize": 1000
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
|
||||
```json
|
||||
{
|
||||
"cloudflareTLS": {
|
||||
"server": "tls://1.1.1.1",
|
||||
"port": 853, // 不配置时，默认端口为：853
|
||||
"servername": "cloudflare-dns.com", // SNI
|
||||
//"sni": "cloudflare-dns.com", // SNI缩写配置
|
||||
"cacheSize": 1000
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
|
||||
```json
|
||||
{
|
||||
"cloudflareTLS": {
|
||||
"server": "tls://1.1.1.1:853",
|
||||
"servername": "cloudflare-dns.com", // SNI
|
||||
//"sni": "cloudflare-dns.com", // SNI缩写配置
|
||||
"cacheSize": 1000
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 6.3. 配置 `TCP` 的DNS服务：
|
||||
|
||||
```json
|
||||
{
|
||||
"googleTCP": {
|
||||
"type": "tcp",
|
||||
"server": "8.8.8.8",
|
||||
"port": 53, // 不配置时，默认端口为：53
|
||||
"cacheSize": 1000,
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
|
||||
```json
|
||||
{
|
||||
"googleTCP": {
|
||||
"server": "tcp://8.8.8.8",
|
||||
"port": 53, // 不配置时，默认端口为：53
|
||||
"cacheSize": 1000,
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
|
||||
```json
|
||||
{
|
||||
"googleTCP": {
|
||||
"server": "tcp://8.8.8.8:53",
|
||||
"cacheSize": 1000,
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## 6.4. 配置 `UDP` 的DNS服务：
|
||||
|
||||
```json
|
||||
{
|
||||
"google": {
|
||||
"type": "udp",
|
||||
"server": "8.8.8.8",
|
||||
"port": 53, // 不配置时，默认端口为：53
|
||||
"cacheSize": 1000,
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
|
||||
```json
|
||||
{
|
||||
"google": {
|
||||
"server": "udp://8.8.8.8",
|
||||
"port": 53, // 不配置时，默认端口为：53
|
||||
"cacheSize": 1000,
|
||||
}
|
||||
}
|
||||
```
|
||||
或
|
||||
|
||||
```json
|
||||
{
|
||||
"google": {
|
||||
"server": "udp://8.8.8.8:53",
|
||||
"cacheSize": 1000,
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
# 7. DNS设置：
|
||||
|
||||
# 8. IP预设置：
|
||||
|
||||
# 9. IP测速：
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
|平台|安装说明 |
|
||||
|---|---|
|
||||
| 【Windows】 | 下载后提示无法验证发行者时，选择保留即可 <br/>注意：开着ds重启电脑会导致无法上网，你可以再次打开ds，然后右键小图标退出ds即可。[更多说明](https://github.com/docmirror/dev-sidecar/issues/109)|
|
||||
| 【Mac】 |安装时提示无法验证开发者时，请先取消<br/>然后去系统偏好设置->安全与隐私->下方已阻止使用DevSidecar<br/>选择仍要打开 |
|
||||
| 【Ubuntu】 | [安装说明](https://github.com/docmirror/dev-sidecar/blob/master/doc/linux.md)|
|
||||
|【其他Linux】| |
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
> 注：请使用 `v2.0.0-RC2` 及以上版本，下载地址：https://github.com/docmirror/dev-sidecar/releases
|
||||
|
||||
目前，Github通过预设置的IP来访问的，选取测速排在前的IP。
|
||||
|
||||
可是，虽然IP测速延迟很低，但是依然会存在不同地区访问部分预设IP不通或很慢的问题。
|
||||
|
||||
如果碰到此问题，可以通过将预设IP设置为 `false` 来禁用访问慢的IP，以此达到切换IP的目的，如下图：
|
||||
如果访问还慢，再将测速排在第1的IP再禁用掉，以此循环，将访问慢的IP都禁掉，直到选取到的IP访问Github速度很快为止。
|
||||
|
||||
> 假如：测速排第1的IP为 `20.27.177.113`，则将其配置为 `false`，或者删除该IP
|
||||
|
||||
Loading…
Reference in New Issue