From 010d2323259b58af8e32f54b6895cff7c8085d72 Mon Sep 17 00:00:00 2001
From: Ryan Yin <ryan4yin@linux.com>
Date: Sat, 16 Mar 2024 11:13:06 +0800
Subject: [PATCH] docs: cache mirror & proxy server - china (#120)

---
 docs/zh/introduction/installation.md | 59 +++++++++++++++++++++++++++-
 1 file changed, 58 insertions(+), 1 deletion(-)

diff --git a/docs/zh/introduction/installation.md b/docs/zh/introduction/installation.md
index cb7e53a..75016fc 100644
--- a/docs/zh/introduction/installation.md
+++ b/docs/zh/introduction/installation.md
@@ -14,4 +14,61 @@ NixOS 的安装步骤很简单，这里不多介绍，仅列一下我觉得比
     1. <https://mirrors.ustc.edu.cn/help/nix-channels.html>
     2. <https://mirrors.tuna.tsinghua.edu.cn/help/nix/> 
 
-> 如果你使用的是 MacOS，可以通过 [ryan4yin/nix-darwin-kickstarter](https://github.com/ryan4yin/nix-darwin-kickstart) 结合本书的内容来学习使用 Nix.
+> 如果你使用的是 macOS，可以通过 [ryan4yin/nix-darwin-kickstarter](https://github.com/ryan4yin/nix-darwin-kickstart) 结合本书的内容来学习使用 Nix.
+
+
+## 对中国大陆用户流畅使用 NixOS 的建议
+
+国内用户在使用 NixOS 时会存在一些网络问题，一是 NixOS 高度依赖 GitHub 作为 channel/flake 数据源——在国内访问 GitHub 相当的慢，二是 NixOS 官方的包缓存服务器在国内访问速度较慢。
+
+为了解决这些问题，你可以使用国内的镜像源，或者使用代理工具来加速访问。
+
+这里我先介绍几个比较简单的配置方法。
+
+
+### 1. 包缓存服务器的加速访问
+
+首先，在执行后面给出的任何 `nix` 相关命令时，你都可以通过 `--option` 选项来指定镜像源，例如：
+
+```bash
+# 使用上海交通大学的镜像源
+# 官方文档: https://mirror.sjtu.edu.cn/docs/nix-channels/store
+nixos-rebuild switch --option substituters "https://mirror.sjtu.edu.cn/nix-channels/store"
+
+# 使用中国科学技术大学的镜像源
+# 官方文档: https://mirrors.ustc.edu.cn/help/nix-channels.html
+nixos-rebuild switch --option substituters "https://mirrors.ustc.edu.cn/nix-channels/store"
+
+# 使用清华大学的镜像源
+# 官方文档: https://mirrors.tuna.tsinghua.edu.cn/help/nix-channels/
+nixos-rebuild switch --option substituters "https://mirrors.tuna.tsinghua.edu.cn/nix-channels/store"
+
+# 其他 nix 命令同样可以使用 --option 选项，例如 nix shell
+nix shell nixpkgs#cowsay --option substituters "https://mirrors.tuna.tsinghua.edu.cn/nix-channels/store"
+```
+
+你可以自己测试下上述几个镜像源的速度，选速度最快的一个。
+
+
+### 2. Channel/Flake 的加速访问
+
+对于 Flake Inputs 跟 Channels 的加速访问，这个就需要使用代理工具加速访问。
+
+可以通过如下命令设置代理环境变量，实现使用 socks5/http 代理加速 nix 的网络访问：
+
+```bash
+sudo mkdir /run/systemd/system/nix-daemon.service.d/
+cat << EOF >/run/systemd/system/nix-daemon.service.d/override.conf
+[Service]
+Environment="https_proxy=socks5h://localhost:7891"
+EOF
+sudo systemctl daemon-reload
+sudo systemctl restart nix-daemon
+```
+
+**但请注意，系统重启后 `/run/` 目录下的内容会被清空，所以每次重启后都需要重新执行上述命令**！
+
+更详细的说明与其他用法介绍，参见 [添加自定义缓存服务器](../nixos-with-flakes/add-custom-cache-servers.md) 一节，注意这部分内容可能需要一定的 NixOS 使用经验才能理解。
+
+> 注意：使用一些商用代理或公共代理时你可能会遇到 GitHub 下载时报 HTTP 403 错误（[nixos-and-flakes-book/issues/74](https://github.com/ryan4yin/nixos-and-flakes-book/issues/74)），
+> 可尝试通过更换代理服务器或者设置 [access-tokens](https://github.com/NixOS/nix/issues/6536) 来解决。