GitHub520/README_template.md

# GitHub520
<p align="center">
  <img src="https://cdn.jsdelivr.net/gh/521xueweihan/img_logo@main/logo/readme.gif"/>
  <br><strong><a href="https://github.com/521xueweihan/HelloGitHub" target="_blank">HelloGitHub</a></strong> 分享 GitHub 上有趣、入门级的开源项目。<br>兴趣是最好的老师，这里能够帮你找到编程的兴趣！
</p>

hosts 镜像站的服务器即将到期，续费需要 1000 元 😢，有余粮的朋友可以[点击扫码赞助](https://cdn.jsdelivr.net/gh/521xueweihan/img_logo@main/logo/receiving_code.png)！

## 一、介绍
对 GitHub 说"爱"太难了：访问慢、图片加载不出来。

*注：* 本项目还处于测试阶段，仅在本机测试通过，如有问题欢迎提 [issues](https://github.com/521xueweihan/GitHub520/issues/new)

---

本项目无需安装任何程序，通过修改本地 hosts 文件，试图解决：
- GitHub 访问速度慢的问题
- GitHub 项目中的图片显示不出的问题

花 5 分钟时间，让你"爱"上 GitHub。

## 二、使用方法

### 2.1 复制下面的内容
```bash
{hosts_str}
```

上面内容会自动定时更新，保证最新有效。数据更新时间：{update_time}（内容无变动不会更新）

- 文件：`https://raw.hellogithub.com/hosts`
- JSON：`https://raw.hellogithub.com/hosts.json`

### 2.1 手动方式

#### 2.1.1 修改 hosts 文件
hosts 文件在每个系统的位置不一，详情如下：
- Windows 系统：`C:\Windows\System32\drivers\etc\hosts`
- Linux 系统：`/etc/hosts`
- Mac（苹果电脑）系统：`/etc/hosts`
- Android（安卓）系统：`/system/etc/hosts`
- iPhone（iOS）系统：`/etc/hosts`

修改方法，把第一步的内容复制到文本末尾：

1. Windows 使用记事本。
2. Linux、Mac 使用 Root 权限：`sudo vi /etc/hosts`。
3. iPhone、iPad 须越狱、Android 必须要 root。

#### 2.1.2 激活生效
大部分情况下是直接生效，如未生效可尝试下面的办法，刷新 DNS：

1. Windows：在 CMD 窗口输入：`ipconfig /flushdns`

2. Linux 命令：`sudo nscd restart`，如报错则须安装：`sudo apt install nscd` 或 `sudo /etc/init.d/nscd restart`

3. Mac 命令：`sudo killall -HUP mDNSResponder`

**Tips：** 上述方法无效可以尝试重启机器。

### 2.2 自动方式

**Tip**：推荐 [SwitchHosts](https://github.com/oldj/SwitchHosts) 工具管理 hosts

以 SwitchHosts 为例，看一下怎么使用的，配置参考下面：

- Title: 随意

- Type: `Remote`

- URL: `https://raw.hellogithub.com/hosts`

- Auto Refresh: 最好选 `1 hour`

如图：

![](./img/switch-hosts.png)

这样每次 hosts 有更新都能及时进行更新，免去手动更新。

### 2.3 AdGuard Home 用户（自动方式）

在 **过滤器>DNS 封锁清单>添加阻止列表>添加一个自定义列表**，配置如下：

- 名称: 随意

- URL: `https://raw.hellogithub.com/hosts`（和上面 SwitchHosts 使用的一样）

如图：

![](./img/AdGuard-rules.png)

更新间隔在 **设置>常规设置>过滤器更新间隔（设置一小时一次即可）**，记得勾选上 **使用过滤器和 Hosts 文件以拦截指定域名**

![](./img/AdGuard-rules2.png)

**Tip**：不要添加在 **DNS 允许清单** 内，只能添加在 **DNS 封锁清单** 才管用。另外，AdGuard for Mac、AdGuard for Windows、AdGuard for Android、AdGuard for IOS 等等 **AdGuard 家族软件** 添加方法均类似。

### 2.4 Chrome 插件方式

[FasterHosts](https://github.com/gauseen/faster-hosts) 是个 Chrome 插件，主要原理是拦截浏览器的某些请求，将 `domain` 替换成访问速度较快的那个。hosts 资源来自 [GitHub520](https://github.com/521xueweihan/GitHub520)，每 1 小时更新一次。

> 1. 下载 [FasterHosts](https://github.com/gauseen/faster-hosts/archive/master.zip) 然后解压，找到 `extension` 子目录
> 2. 打开 Chrome，输入: `chrome://extensions/`
> 3. 打开「开发者模式」
> 4. 选择「加载已解压的扩展程序」，然后定位到刚才解压的文件夹里面的 `extension` 目录，确定
> 5. 这就安装好了，关闭「开发者模式」

## 三、效果对比
之前的样子：

![](./img/old.png)

修改完 hosts 的样子：

![](./img/new.png)


## TODO
- [x] 定时自动更新 hosts 内容
- [x] hosts 内容无变动不会更新
- [ ] 寻到最优 IP 解析结果


## 声明
<a rel="license" href="https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh"><img alt="知识共享许可协议" style="border-width: 0" src="https://licensebuttons.net/l/by-nc-nd/4.0/88x31.png"></a><br>本作品采用 <a rel="license" href="https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh">署名-非商业性使用-禁止演绎 4.0 国际</a> 进行许可。
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
+								# GitHub520
 								<p align="center">
-												update image

											
										
										
											2021-11-05 11:26:32 +08:00
+								  <img src="https://cdn.jsdelivr.net/gh/521xueweihan/img_logo@main/logo/readme.gif"/>
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
+								  <br><strong><a href="https://github.com/521xueweihan/HelloGitHub" target="_blank">HelloGitHub</a></strong> 分享 GitHub 上有趣、入门级的开源项目。<br>兴趣是最好的老师，这里能够帮你找到编程的兴趣！
 								</p>
-												增加赞助

											
										
										
											2021-12-13 10:54:46 +08:00
+								hosts 镜像站的服务器即将到期，续费需要 1000 元 😢，有余粮的朋友可以[点击扫码赞助](https://cdn.jsdelivr.net/gh/521xueweihan/img_logo@main/logo/receiving_code.png)！
-D 星史

											
										
										
											2021-03-22 23:39:59 +08:00
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
+								## 一、介绍
 								对 GitHub 说"爱"太难了：访问慢、图片加载不出来。
 								*注：* 本项目还处于测试阶段，仅在本机测试通过，如有问题欢迎提 [issues](https://github.com/521xueweihan/GitHub520/issues/new)
 								---
 								本项目无需安装任何程序，通过修改本地 hosts 文件，试图解决：
 								- GitHub 访问速度慢的问题
 								- GitHub 项目中的图片显示不出的问题
 								花 5 分钟时间，让你"爱"上 GitHub。
 								## 二、使用方法
 								### 2.1 复制下面的内容
 								```bash
 								{hosts_str}
 								```
 								上面内容会自动定时更新，保证最新有效。数据更新时间：{update_time}（内容无变动不会更新）
-												add hk url

											
										
										
											2021-07-11 12:20:50 +08:00
+								- 文件：`https://raw.hellogithub.com/hosts`
 								- JSON：`https://raw.hellogithub.com/hosts.json`
-												add json

											
										
										
											2021-05-31 13:59:34 +08:00
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
+								### 2.1 手动方式
-												add json

											
										
										
											2021-05-31 13:59:34 +08:00
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
+								#### 2.1.1 修改 hosts 文件
 								hosts 文件在每个系统的位置不一，详情如下：
 								- Windows 系统：`C:\Windows\System32\drivers\etc\hosts`
 								- Linux 系统：`/etc/hosts`
 								- Mac（苹果电脑）系统：`/etc/hosts`
 								- Android（安卓）系统：`/system/etc/hosts`
 								- iPhone（iOS）系统：`/etc/hosts`
 								修改方法，把第一步的内容复制到文本末尾：
 . Windows 使用记事本。
 . Linux、Mac 使用 Root 权限：`sudo vi /etc/hosts`。
 . iPhone、iPad 须越狱、Android 必须要 root。
 								#### 2.1.2 激活生效
 								大部分情况下是直接生效，如未生效可尝试下面的办法，刷新 DNS：
 . Windows：在 CMD 窗口输入：`ipconfig /flushdns`
-												update

											
										
										
											2021-10-08 12:15:09 +08:00
+. Linux 命令：`sudo nscd restart`，如报错则须安装：`sudo apt install nscd` 或 `sudo /etc/init.d/nscd restart`
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
 . Mac 命令：`sudo killall -HUP mDNSResponder`
 								**Tips：** 上述方法无效可以尝试重启机器。
 								### 2.2 自动方式
 								**Tip**：推荐 [SwitchHosts](https://github.com/oldj/SwitchHosts) 工具管理 hosts
 								以 SwitchHosts 为例，看一下怎么使用的，配置参考下面：
 								- Title: 随意
 								- Type: `Remote`
-												add hk url

											
										
										
											2021-07-11 12:20:50 +08:00
+								- URL: `https://raw.hellogithub.com/hosts`
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
 								- Auto Refresh: 最好选 `1 hour`
 								如图：
 								![](./img/switch-hosts.png)
 								这样每次 hosts 有更新都能及时进行更新，免去手动更新。
 								### 2.3 AdGuard Home 用户（自动方式）
 								在 **过滤器>DNS 封锁清单>添加阻止列表>添加一个自定义列表**，配置如下：
 								- 名称: 随意
-												add hk url

											
										
										
											2021-07-11 12:20:50 +08:00
+								- URL: `https://raw.hellogithub.com/hosts`（和上面 SwitchHosts 使用的一样）
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
 								如图：
 								![](./img/AdGuard-rules.png)
 								更新间隔在 **设置>常规设置>过滤器更新间隔（设置一小时一次即可）**，记得勾选上 **使用过滤器和 Hosts 文件以拦截指定域名**
 								![](./img/AdGuard-rules2.png)
 								**Tip**：不要添加在 **DNS 允许清单** 内，只能添加在 **DNS 封锁清单** 才管用。另外，AdGuard for Mac、AdGuard for Windows、AdGuard for Android、AdGuard for IOS 等等 **AdGuard 家族软件** 添加方法均类似。
-												feat: 支持 Chrome 插件方式

											
										
										
											2021-05-24 15:06:29 +08:00
+								### 2.4 Chrome 插件方式
 								[FasterHosts](https://github.com/gauseen/faster-hosts) 是个 Chrome 插件，主要原理是拦截浏览器的某些请求，将 `domain` 替换成访问速度较快的那个。hosts 资源来自 [GitHub520](https://github.com/521xueweihan/GitHub520)，每 1 小时更新一次。
 								> 1. 下载 [FasterHosts](https://github.com/gauseen/faster-hosts/archive/master.zip) 然后解压，找到 `extension` 子目录
 								> 2. 打开 Chrome，输入: `chrome://extensions/`
-												fix: README.md

											
										
										
											2021-05-27 22:57:14 +08:00
+								> 3. 打开「开发者模式」
-												feat: 支持 Chrome 插件方式

											
										
										
											2021-05-24 15:06:29 +08:00
+								> 4. 选择「加载已解压的扩展程序」，然后定位到刚才解压的文件夹里面的 `extension` 目录，确定
-												fix: README.md

											
										
										
											2021-05-27 22:57:14 +08:00
+								> 5. 这就安装好了，关闭「开发者模式」
-												feat: 支持 Chrome 插件方式

											
										
										
											2021-05-24 15:06:29 +08:00
-												init commit 否则项目体积会越来越大

											
										
										
											2021-01-04 09:45:04 +08:00
+								## 三、效果对比
 								之前的样子：
 								![](./img/old.png)
 								修改完 hosts 的样子：
 								![](./img/new.png)
 								## TODO
 								- [x] 定时自动更新 hosts 内容
 								- [x] hosts 内容无变动不会更新
 								- [ ] 寻到最优 IP 解析结果
 								## 声明
-												update gitee name

											
										
										
											2021-01-12 23:18:54 +08:00
+								<a rel="license" href="https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh"><img alt="知识共享许可协议" style="border-width: 0" src="https://licensebuttons.net/l/by-nc-nd/4.0/88x31.png"></a><br>本作品采用 <a rel="license" href="https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh">署名-非商业性使用-禁止演绎 4.0 国际</a> 进行许可。