fq-book README

The project's README from github.com/hoochanlon/fq-book. As one markdown file: README.md.

《这本书能让你连接互联网》

cc fq-book

[!important] 《这本书》示例的多数网址,以及更多资料收录在 hamuleite ,推荐相关网络切换及计算软件: Ip-Switch、network-calculator。

不得不说,Pawdroid/Free-servers、YoulianBoshi/vpn 这些免费梯子真厉害,利用 cloudflare LancelotRar/free-subs 搭建节点也是可以参考的,DiningFactory/panda-vpn-pro 低价付费机场也不失为一种选择。

clash-verge-rev 都实现VPN的功能了,以及千种配置 mihomo_yamls 太强了。

随着AI时代的到来,panxunying/ai-coding-welfare 知道一些 AI Coding 福利站导航也不赖,我更多的是用咸鱼...

intro

《这本书能让你连接互联网》(以下简称《这本书》)着重于上网的方式与获取信息的技巧,并对相关流行且典型的软件做简要的上手配置,以及原理的相关说明。

update

这本书的更新要点:

此外,还精简了不必要的重复内容,图片采用 postimages 支持,项目由30M降低到144KB大小,非常方便在线部署及下载,欢迎 fork 《这本书》!

NET::ERR_CERT_AUTHORITY_INVALID

浏览器会额外提示:攻击者可能试图从 xxx.github.io 窃取你的信息,此服务器无法证明它是 xxx.github.io;你的计算机的操作系统不信任它的安全证书。这可能是由配置错误或者有攻击者截获你的连接而导致的。当继续访问时又会403。

解招!:更改为如下提供的百度、阿里、腾讯DNS,再用ipconfig/flushdns 刷新缓存。原因简述:ISP提供的DNS发送错误的根证书,换成能向访问网站提供正确证书的第三方DNS。

usage

在线部署

  1. fork 《这本书》 到你的 repo
  2. 修改 docs/index.html 将window.$docsify = {} 的repo 修改成你的 repo
  3. 在 settings 找到 GitHub Pages 并选择 master brach/docs folder
  4. 访问 https://你的GitHub用户名.github.io/fq-book 即可看到效果
这里以 anhoodie 为示例 click me!

预览

Snipaste_2019-06-10_06-18-56

本地部署

所需环境:git、node;安装很简单一直 下一步 直到完成安装即可。

关于更多详细,请看docsify官网文档

使用Offline Explorer可将《这本书》的整个网页内容下载到本地,进行离线观看

当然,也可选择将该书docsify类型转换为gitbook生成格式,并用其自带的命令制作《这本书》的PDF

获取更新

以01user为例,在本地部署时,旧版图链已经失效了,新版已经采用 postimage 支持;此时就需升级成 《这本书Ⅱ》,获取更新其实非常简单,在fork的基础上,执行以下指令

git clone https://github.com/你的github用户名/fq-book.git
cd fq-book
git remote add upstream https://github.com/hoochanlon/fq-book.git
# 若需必要的分支变更,还是使用合适: git fetch --all
git fetch upstream
# 对Git有所了解的话,建议还是使用:`git pull upstream master --allow-unrelated-histories` 以审查代码的形式更新
git reset --hard upstream/master

提交到自己的repo

git add .
git commit -m "test"
# 此指令只方便newbie或不得已的强制;会些Git还是推荐:git push -u --force-with-lease origin master
git push -u -f origin master  

输入账号&密码即可上传到自己repo完成Github账户仓库远程更新。更多作业指令操作说明,请看Git 官方文档,在特殊情况,有可能需要涉及到代理、镜像、浅克隆设置

更新图示 click me!

部署测试

提交到repo

代理设置

git代理

git客户端代理设置,以及取消代理

git config --global http.proxy 'socks5://127.0.0.1:1080' && \
git config --global https.proxy 'socks5://127.0.0.1:1080'

git config --global --unset https.proxy
git config --global --unset http.proxy

git clone 默认会下载项目的完整历史版本,若只关心最新的代码,而不关心之前的历史,网速差的朋友可以使用浅复制功能:

git clone --depth=1  https://github.com/你的用户名/你的repo.git

Mac终端

Mac终端的代理设置(http&https)以及取消代理

export ALL_PROXY=socks5://127.0.0.1:1080

unset ALL_PROXY"

代理软件即便是开全局模式,终端也不会走代理的,需另设。此外,Mac终端设置了代理git是可以不用在设置了。这个可用 curl cip.cc 来判断软件是否走了代理通道

ssh

## github ssh 配置
### https://help.github.com/articles/using-ssh-over-the-https-port/

## HTTP 代理
ProxyCommand socat - PROXY:127.0.0.1:%h:%p,proxyport=8848

## socks5 代理
 ProxyCommand nc -v -x 127.0.0.1:1080 %h %p

更多代理设置见:SunSeekerX's Notebook-代理设置大全,相关问题见:v2ex-为什么全局代理后,CMD依然Ping不通Google? (2024.1.12)

essays

设置HOSTS、DNS的软件,推荐:Ip Switch(导入GitHub hosts可参考ineo6/hosts)、DNSCrypt ,我觉得不管代理、vpn怎么变(技术迭代,换来换去),反正这两个设置软件总是要的。VPN、proxy软件又出来个新玩意什么,clashios提及到的软件也是可以参考的咯。

下载组件方面,一些喜欢折腾环境配置的人也自然总结了一些经验写着项目里,例如:homebrew-install、Thanks-Mirror、package-manager-proxy-settings。

SteamTools游戏加速器,满足steam基本的社区商店、社区消息浏览,还行吧,毕竟是免费的。dogfight360写的UsbEAm Hosts Editor在进入游戏anti-cheat(反外挂插件)加速上也还好。以及apex英雄(iOS/iPadOS版)虽然锁区,但挂个小火箭,其实也能玩。

mind you

本书允许演绎及共享但禁止商用,科学上网仅为研究需要,以下是免责声明:

[!note] 接下来的 人生进阶指南 或许很有趣...当然还有 润(run)学。

Star History

Star History Chart

fq-book (hoochanlon/fq-book)

ipfs
Searching Database…

What is this?A free open-source Chinese-language book, 《这本书能让你连接互联网》 (This Book Can Get You Online), about getting online under censorship: hands-on setup for popular circumvention tools plus the principles behind proxies, tunnels, VPNs and GFW blocking.
So is it a paper book, a PDF, or a website?A website: the book is a docsify documentation project you read on GitHub Pages. You can also fork the repo and deploy your own copy, convert it to GitBook format, or export it as a PDF.
How do I start reading it right now?Fork the repo, edit docs/index.html to point the repo field inside window.$docsify at your fork, then enable GitHub Pages on the master branch /docs folder — your own copy of the site goes live immediately.
Do I need to install anything to keep a local copy?Only git and node for local reading: install docsify-cli globally (npm i docsify-cli -g), then run docsify init . and docsify serve in the docs folder and open localhost:3000.
Does content like this go stale?Constantly — the author notes older editions already suffered dead image links, so images moved to postimages hosting and the repo shrank from 30MB to 144KB. You stay current by syncing your fork with upstream via git and pushing to your own repo.
Is this written for users inside China or for the diaspora?For overseas Chinese users, explicitly framed as research-and-study material only; the disclaimer goes as far as asking mainland-China residents to close the book and delete all related content within 24 hours.
What if github.io itself is unreachable — can I still read it?Yes: the whole site can be downloaded for offline viewing with Offline Explorer, and the docsify source can be converted to GitBook format to build a PDF.
What does the book teach beyond tool setup?A quick-start circumvention chapter, plus practical tricks: virtual phone numbers for registrations, the new Google account sign-up route, using a web time machine to find similar sites, and relaying traffic through a personal blog. It also covers fixes for real failures like crxheaderinvalid and VPN-connected-but-no-pages.
Does it explain how the blocking actually works?Yes — for example it breaks down the NET::ERR_CERT_AUTHORITY_INVALID case: the ISP's DNS serves a wrong root certificate, so the fix is switching to third-party DNS (Baidu 180.76.76.76, Ali 223.5.5.5, Tencent 119.29.29.29) and flushing the cache with ipconfig/flushdns.
Any companion tools the author recommends?Ip-Switch for HOSTS switching and DNSCrypt for DNS — in the author's view these two stay useful no matter how proxy and VPN software churn. Most URLs referenced in the book are collected in the companion hamuleite list.
Does it point to actual node sources and clients?It name-checks free node lists (Pawdroid/Free-servers, YoulianBoshi/vpn), Cloudflare-based nodes via LancelotRar/free-subs, a low-cost paid provider (DiningFactory/panda-vpn-pro), and notes that clash-verge-rev with its thousands of mihomo configs is worth a look.
Creator
hoochanlon
Size
0.5 MB
Stars
7K
Updated
CommitSep 19
Age
8y
Commits · 90 Days