一、现象与环境

• Git Bash 终端卡顿：输入有明显延迟，命令执行后迟迟不返回提示符。
• 使用的是 zsh（配合 oh-my-zsh），启用了包括 z 在内的多个插件。
• 家目录出现了很多 .z 相关文件（z 插件的跳转数据库），怀疑数据库过大导致慢响应。

二、我的排查与解决过程

1) 先隔离配置：用干净的 zsh -f 启动

• zsh -f 会在不加载 ~/.zshrc 的前提下启动一个“空配置”的 zsh，能快速判断是否是配置或插件导致问题。
• 如果 zsh -f 下终端恢复顺畅，基本可以确定问题在 ~/.zshrc 或其引入的插件与脚本。

2) 定位“嫌疑插件”：移除 ~/.zshrc 中的 z 插件

• 打开 ~/.zshrc，从 plugins=(...) 中移除 z，保存退出，重新打开终端。
• 如果卡顿消失，进一步确认 z 插件就是主要原因。

3) 清理 z 插件数据库：删除家目录下的 .z 数据文件

• z 插件默认会在家目录存储路径权重数据库，文件名通常为 ~/.z（可能还有备份，比如 ~/.z.1 等）。

• 执行：

  rm -f ~/.z ~/.z.*
  

  注意：只删除 .z 及其备份，勿用宽泛的通配符误删其他以 .z 开头的配置文件（例如 ~/.zshrc、~/.zsh_history 等）。

4) 验证

• 再次启动 Git Bash，观察输入响应与命令执行返回。若明显恢复正常，则问题确认并解决。

三、更多可能导致终端卡顿的原因与优化方法

下面按层次列出常见瓶颈与处理策略。建议从“快速隔离”到“逐步优化”依次进行。

A. zsh 配置与插件层面

• 用 zsh -f 快速隔离：先确认卡顿是否源自 ~/.zshrc。

• 用内置性能分析：

  1. 在交互会话里执行：

     zmodload zsh/zprof
     source ~/.zshrc
     zprof
     

  2. 查看哪个函数或插件耗时最多，针对性优化或禁用。

• 精简/优化高开销插件：

  • zsh-autosuggestions：在超长历史或远程磁盘上可能放大延迟，必要时暂时禁用。
  • zsh-syntax-highlighting：对超长命令行或复杂高亮也可能造成卡顿，可移到 ~/.zshrc 最末加载或暂时禁用。
  • git 相关主题/段：提示符中显示仓库状态若每次刷新都做代价高的检测，易导致卡顿（详见下一节）。

• 清理与限制缓存/历史：

  • 删除过期的 ~/.zcompdump* 文件，让补全缓存重新生成：

    rm -f ~/.zcompdump*
    compinit -C
    

  • 限制历史大小，避免历史过大：

    export HISTSIZE=5000
    export SAVEHIST=5000
    

  • 必要时压缩或清理 ~/.zsh_history（先备份，再用专门工具或谨慎操作）。

• 优化补全与缓存（选做）：

  # 开启补全缓存（需确保缓存目录存在）
  zstyle ':completion:*' use-cache on
  zstyle ':completion:*' cache-path $HOME/.zsh/cache
  

• 控制 PATH 长度与重复项：超长 PATH 或大量网络路径会增加命令解析成本，去重并移除不必要条目。

• 跳转插件替代：如果依赖频繁路径跳转，可以考虑更高性能的 zoxide（Rust 实现，跨平台），或使用 fzf + cd 组合实现快速导航。

B. Git 状态/提示符层面（对大型仓库尤其重要）

• 减少提示符的 Git 状态开销：

  • 如果使用 oh-my-zsh 的 git 主题段，可以只显示分支名，不显示“脏状态”（新增/删除/未跟踪），显著减少每次刷新调用：

    export DISABLE_UNTRACKED_FILES_DIRTY="true"
    

  • 避免在 PROMPT 或 RPROMPT 中触发完整的 git status（尤其是有大量未跟踪文件时）。

• 提升 Git 的基础性能（全局设置，温和安全）：

  git config --global core.preloadIndex true
  git config --global core.fscache true
  git config --global gc.writeCommitGraph true
  git maintenance start
  

  说明：

  • core.preloadIndex 与 core.fscache 常见于 Git for Windows 的加速选项（新版本多为默认开启，显式配置更稳妥）。
  • 写入 commit-graph 与开启维护任务，可以加速多种 Git 操作（包括 status、log 等），对大仓库尤为明显。

• 仅在确定版本支持的情况下考虑文件监控（fsmonitor）：新版本 Git 在 Windows 上逐步完善内置 FS 监控特性，能减少反复扫描文件系统的成本。建议升级到较新的 Git for Windows 后再查阅对应版本说明开启；旧版或不支持时不要启用。

C. 终端/系统层面（Windows）

• 升级工具与组件：
  • 升级到最新的 Git for Windows。
  • 如果使用外部终端（如 Windows Terminal），留意 ConPTY 后端的兼容参数；不同设置在部分环境下会影响交互流畅度。
• 杀毒/安全软件与索引扫描：
  • 为 C:\Program Files\Git\ 安装目录与主要仓库路径添加实时扫描排除规则，避免每次命令触发大量 I/O 扫描。
  • 避免在网络盘、同步盘（如 OneDrive）或被系统索引服务重度扫描的目录中工作。
• 字体与渲染：
  • 某些 Nerd Font 或高开销渲染配置在低配环境下也会造成刷新卡顿，可换用常规字体测试。

四、快速排查与操作清单（可直接拿来用）

• 干净启动，判断是否为配置问题：

  zsh -f
  

• 性能画像（找出最慢的函数/插件）：

  zmodload zsh/zprof
  source ~/.zshrc
  zprof
  

• 移除 z 插件，并清理数据库：

  1. 编辑 ~/.zshrc，从 plugins=(...) 中删除 z；

  2. 删除数据库文件：

     rm -f ~/.z ~/.z.*
     

• 限制 Git 状态显示开销（oh-my-zsh）：

  export DISABLE_UNTRACKED_FILES_DIRTY="true"
  

• 提升 Git 基础性能（全局）：

  git config --global core.preloadIndex true
  git config --global core.fscache true
  git config --global gc.writeCommitGraph true
  git maintenance start
  

• 清理补全缓存并快速初始化：

  rm -f ~/.zcompdump*
  compinit -C
  

五、结语

这次卡顿的根因是 z 插件的路径数据库过大，移除插件并清理 .z 数据后问题即刻消失。更通用的经验是：先用 zsh -f 快速隔离，再用 zprof 定位耗时点

安装工具

以下是简单的安装步骤，App版本可以前往Elevate for Strava的github主页Release页面下载。

1. 安装扩展程序

   • 用户可以通过 Chrome 或 Firefox 浏览器的扩展商店搜索“Elevate for Strava”，然后点击“安装”按钮。如果你是Chrome用户，可以点击此链接直达。其他浏览器可以访问官网查看。

2. 同步 Strava 数据

   • 安装完成后，用户需要登录他们的 Strava 账户，并授权 Elevate 访问其运动数据。之后，Elevate 将自动同步 Strava 数据，并开始生成各种分析报告。
     

3. 配置和使用

   • 用户可以根据自己的需求调整 Elevate 的设置，包括单位、分析参数等选项。

使用介绍

第一次导入成功后先别着急查看数据，先配置一下个人信息，参考下图。切记基本信息和Strava保持一致，不然重新导入真的很费时间，因为Strava接口请求有限制，你可以在Strava申请导出所有数据为文件，这样会快很多，后面再详细介绍。

查看活动汇总

设置年度目标，计算目标进度

你是不是也想知道自己关注的大佬功率是多少？嘿嘿，Elevate会根据大佬公开的数据，预估一个功率和工体比。以下就是范二特的一次骑行数据。

More Data！点击橙色的按钮，可以显示更多的数据信息，当然这些信息对于普通骑行者作用不大。对于业余车手可以通过这些数据来学习一下职业车手的骑行习惯。比如功率分配，踏频分配等等。

首先需要将固态硬盘映射到qBittorrent的容器中。我是使用docker-compose部署的qBittorrent，所以需要在docker-compose.yml中添加一个volume：

services:
  qbittorrent:
    image: linuxserver/qbittorrent:latest
    container_name: qbittorrent
    restart: always
    ports:
      - 8080:8080
    environment:
      - TZ=Asia/Shanghai
    volumes:
      - /root/sharedfolder/appdata/qbittorrent:/config
      - /root/sharedfolder/downloads/qbittorrent:/downloads
      - /srv/download-disk/downloads/qbittorrent:/download-disk

其中/root/sharedfolder/downloads/qbittorrent:/downloads是原来机械硬盘的目录，我们不需要动他。/srv/download-disk/downloads/qbittorrent:/download-disk是新的固态硬盘的目录，我在download-disk目录下新建了和之前一样的目录结构。将它映射到容器的/download-disk目录下。

进入qBittorrent的web页面，先全选所有的任务，将任务暂停。

点击工具->选项->下载，设置保存未完成的文件到固态硬盘。路径就是我们在docker-compose.yml中设置的/download-disk目录下的qbincomplete目录。

重启qBittorrent容器，这样就设置好了。

再次登录qBittorrent的web页面，qBittorrent会自动将之前暂停的任务都移动到固态硬盘/download-disk中。你在宿主机的/srv/download-disk/downloads/qbittorrent/qbincomplete目录下就能看到这些任务。你可以重新启动所有任务，当他们移动完成后就会继续下载。下载完成后就会自动移动到机械硬盘中。也就是你设置的默认下载位置，比如我的下载位置为/root/sharedfolder/downloads/qbittorrent/qbcomplete。

• https://chickfrp.com?affcode=2649EJBPNQ
• https://console.openfrp.net/

创建隧道，下载配置文件如下：

[common]
protocol=tcp
server_addr=ali-shanghai-a.chickfrp.com
server_port=7000
user=xxxxxxxxx
token=xxxxxxxx
tcp_mux=true

[ openai ]
type= tcp

remote_port= 10006
local_ip= 192.168.1.9
local_port= 3322
use_compression=false
use_encryption=false

配置客户端，下面以 Linux 为例，因为需要配置 Docker 服务，所以做个简单记录。

# 下载 frp 应用，解压后 frpc 是客户端，frps 是服务端，今天我们只用到 frpc
wget https://github.com/fatedier/frp/releases/download/v0.56.0/frp_0.56.0_linux_amd64.tar.gz
tar zxvf frp_0.56.0_linux_amd64.tar.gz

将服务商提供的配置文件复制到frpc.toml中。服务商提供的可能是旧版本的 frp 配置，是ini格式，需要转换成toml格式。有能力可以自己稍微改一下格式就行，不会的话，可以用在线转换工具，比如：https://toml.info/zh/ini-to-toml。

简单启动：

./frpc  -c ./frpc.toml
2024-04-01 21:04:29.326 [I] [client/control.go:170] [19341bf77b5454753237] [SDSDasdaderf.openai] start proxy success

配置 Docker-compose 一键启动，将配置文件frpc.toml映射到容器中。

version: "3.7"

services:
  frp:
    image: stilleshan/frpc:latest
    container_name: frp
    volumes:
      - /path/to/frpc.toml:/frp/frpc.toml
    restart: always

docker-compose up -d启动容器。docker logs frp查看日志。出现start proxy success表示成功。

参考官方文档：Using GitHub Copilot in the CLI - GitHub Docs

安装

前提：

1. 需要订阅Github Copilot，每月$10。

2. 需要安装GH CLI

订阅自行解决，接下来安装GH CLI：

sudo mkdir -p -m 755 /etc/apt/keyrings && wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y

如果没法安装，可以下载deb文件手动安装。Release GitHub CLI 2.46.0 · cli/cli

安装完GH CLI后，安装Copilot CLI：

$ gh auth login
# 选择登录账号类型为Github.com
? What account do you want to log into?  [Use arrows to move, type to filter]
> GitHub.com
  GitHub Enterprise Server
# 选择传输协议为SSH
? What is your preferred protocol for Git operations on this host?  [Use arrows to move, type to filter]
  HTTPS
> SSH
# 选择一个本地的公钥，并命名SSH key的名称
? Title for your SSH key: (GitHub CLI) wsl2
# 选择验证方式为使用浏览器验证
? How would you like to authenticate GitHub CLI?  [Use arrows to move, type to filter]
> Login with a web browser
  Paste an authentication token
! First copy your one-time code: 7AAA-SA47
# 回车后会弹出浏览器，输入验证码即可
Press Enter to open github.com in your browser...
! Failed opening a web browser at https://github.com/login/device
  fork/exec /usr/bin/winchrome: exec format error
  Please try entering the URL in your browser manually

WSL2 环境下可能会出现无法打开浏览器的情况，可以手动打开浏览器输入地址验证https://github.com/login/device。

使用

支持两个命令：

# 解释代码
gh copilot explain
# 获取命令行建议
gh copilot suggest

示例：

$ gh copilot explain "sudo apt-get"

Welcome to GitHub Copilot in the CLI!
version 1.0.1 (2024-03-22)

I'm powered by AI, so surprises and mistakes are possible. Make sure to verify any generated code or suggestions, and share feedback so that we can learn and improve. For more information, see https://gh.io/gh-copilot-transparency

Explanation:                                                                                                                                                                       
                                                                                                                                                                                   
  • sudo is used to run a command with elevated rights, typically as a superuser.                                                                                                  
    • apt-get is the Ubuntu package manager.                                                                                                                                       
      • It is used to manage packages on the system, including installing, updating, and removing software packages.                                                               
      • It requires administrative privileges to perform these operations.                                                                                                         
      • Additional sub-commands can be used with apt-get to perform specific tasks, such as install, remove, update, etc.                                                          

$ gh copilot suggest "Install git"
Welcome to GitHub Copilot in the CLI!
version 1.0.1 (2024-03-22)

I'm powered by AI, so surprises and mistakes are possible. Make sure to verify any generated code or suggestions, and share feedback so that we can learn and improve. For more information, see https://gh.io/gh-copilot-transparency

? What kind of command can I help you with?  [Use arrows to move, type to filter]
> generic shell command
  gh command
  git command
Suggestion:                                                                                                                                                                        
  sudo apt-get install git                                                                                                                                                     
? Select an option  [Use arrows to move, type to filter]
> Copy command to clipboard
  Explain command
  Execute command
  Revise command
  Rate response
  Exit

gh copilot 默认提供了这两个命令的别名，无需输入完整命令，可以直接使用：

# ghce 为 gh copilot explain 的别名
ghce "sudo apt-get"
# ghcs 为 gh copilot suggest 的别名
ghcs "install git"

为了便于在每个终端中使用 gh copilot cli，将以下配置放到配置文件中：

echo 'eval "$(gh copilot alias -- zsh)"' >> ~/.zshrc

配置Windows

下载安装XMing，启动Xlaunch。

1. 选择MultiWindow
2. 设置Display number为10（可以自行设置，主要是需要和后面在WSL2中设置的变量保持一致）
3. 选择Start no client（Windows的XMing是被动等待接收图像数据，所以选择该项）
4. 一直下一页，其余保持默认，点击完成即可。

配置VSCode

安装RemoteX11插件，直接在插件中心搜索安装即可。

打开设置页面，搜索Remote x11，找到如下配置项，将Display Number配置为10

配置WSL2

安装xclock用于测试

sudo apt-get install xclock

设置环境变量

export DISPLAY=localhost:10.0
# 或者
export DISPLAY=:0

运行xclock查看结果

在VSCode中，你可以通过以下步骤安装Clangd插件：

• 打开VSCode；
• 点击左侧的插件图标（Ctrl+Shift+X）；
• 搜索“Clangd”插件；
• 点击“安装”按钮。

生成compile_commands.json

对于make项目来说，常规来讲，可以使用Bear来对源码生成compile_commands.json。首先安装Bear：

sudo apt install bear

然后在项目根目录下执行：

bear make -j32

编译完成后，会在项目根目录下生成compile_commands.json文件。

对于CMAKE项目来说，可以在CMakeLists.txt中添加以下语句，然后重新编译项目即可生成compile_commands.json文件： set(CMAKE_EXPORT_COMPILE_COMMANDS True)

配置Clangd插件

进入到项目目录下，下载配置文件：

git clone --depth 1 https://github.com/Dunky-Z/dot-vscode.git .vscode

主要修改--compile-commands-dir参数，将其修改为自己的路径。

随便打开内核源码文件，clangd将会自动生成索引，并将索引文件.idx保存在项目根目录下的.cache目录中。

Linux-5.4
├── .cache
│   └── clangd
├── .config
├── .git

如果生成了索引文件，那么说明配置成功，可以打开源码文件看看是否能够正常跳转。

安装

sudo apt install ocrmypdf

使用

指定 OCR 的语言

安装语言包

sudo apt install tesseract-ocr-chi-sim

查看是否安装成功

$ tesseract --list-langs
List of available languages (3):
chi_sim
eng
osd

注意参数 -l 后面的语言包名称是下划线，而不是短横线。

ocrmypdf -l chi_sim input.pdf output.pdf

$  ocrmypdf -l chi_sim  --redo-ocr  input.pdf output.pdf
Scanning contents: 100%|██████████████████████████████████████████████████████████████████████████████████████████████████████| 752/752 [00:14<00:00, 51.36page/s]
Start processing 24 pages concurrently
   33 redoing OCR                                                                                                                                                 
   26 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
   54 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
   88 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  119 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  203 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  256 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  265 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  347 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  376 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  383 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  386 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  402 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  404 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  403 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  412 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  415 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  410 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  439 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  519 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  526 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  587 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  591 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  595 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  607 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  644 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  661 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  682 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  720 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
  742 [tesseract] lots of diacritics - possibly poor OCR                                                                                                          
OCR: 100%|████████████████████████████████████████████████████████████████████████████████████████████████████████████████| 752.0/752.0 [03:41<00:00,  3.40page/s]
Postprocessing...
Some input metadata could not be copied because it is not permitted in PDF/A. You may wish to examine the output PDF's XMP metadata.                              
PDF/A conversion: 100%|███████████████████████████████████████████████████████████████████████████████████████████████████████| 752/752 [01:09<00:00, 10.80page/s]
Recompressing JPEGs: 0image [00:00, ?image/s]
Deflating JPEGs: 100%|██████████████████████████████████████████████████████████████████████████████████████████████████████| 756/756 [00:00<00:00, 920.21image/s]
JBIG2: 0item [00:00, ?item/s]
Optimize ratio: 1.20 savings: 17.0%
Output file is okay but is not PDF/A (seems to be No PDF/A metadata in XMP)

转换的结果还不错，页面排版不会改变，保持原样，但是搜索文字时可能需要用空格分开。

配置 yaml 文件时会遇到需要将配置的内容按照键值排序的情况，比如下面这样riscv_fork_list.yaml：

packages:
- name: accumulo
- name: abseil-cpp
- name: acpica-tools
- name: acpid
- name: activemq
- name: afflib
- name: adcli
- name: adwaita-icon-theme
- name: aide
- name: alsa-lib
- name: amtk
- name: anaconda
- name: apache-sshd
- name: annobin
- name: antlr3
- name: apache-commons-csv
- name: aom
- name: apache-commons-beanutils
- name: apache-commons-daemon
- name: apache-commons-el
- name: apache-commons-exec
- name: apache-commons-jexl
- name: apache-poi
- name: apache-rat

我想按照 name 的字母顺序排序，可以使用 yq 工具来实现。

安装 yq

wget https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64 -O /usr/bin/yq &&\
    chmod +x /usr/bin/yq

使用 yq

yq -i '.packages |= sort_by(.name)' riscv_fork_list.yaml

packages:
- name: abseil-cpp
- name: accumulo
- name: acpica-tools
- name: acpid
- name: activemq
- name: adcli
- name: adwaita-icon-theme
- name: afflib
- name: aide
- name: alsa-lib
- name: amtk
- name: anaconda
- name: annobin
- name: antlr3
- name: aom
- name: apache-commons-beanutils
- name: apache-commons-csv
- name: apache-commons-daemon
- name: apache-commons-el
- name: apache-commons-exec
- name: apache-commons-jexl
- name: apache-poi
- name: apache-rat
- name: apache-sshd

在 VSCode 中编辑 Markdown 文本，复制到思源笔记后，思源笔记无法转义为 Markdown 格式。会变成一个代码块，但是代码块内的内容并不是复制的内容。

比如上面这段话复制到思源笔记成了下图这样：

但是我需要的是能够转义为 Markdown 的阅读模式。

解决方法

问题的原因在于 VSCode 复制的文本是带格式的，而思源笔记默认的粘贴模式是纯文本模式，所以会出现上面的问题。

解决方法就是从 VSCode 复制的内容为纯文本，一种可以把文本复制到 txt 文件中，再复制，但是比较麻烦。

第二种方法是使用 VSCode 的插件 Copy Plain Text，搜索下载后，默认快捷键为 Ctrl+Alt+C，可以复制为纯文本。

再次粘贴到思源笔记中，就可以转义为 Markdown 格式了。

在 Windows 中，可以使用 netsh 命令来添加、查看和删除端口转发规则。

要添加一个端口转发规则，可以使用以下命令：

netsh interface portproxy add v4tov4 listenaddress=<local_address> listenport=<local_port> connectaddress=<remote_address> connectport=<remote_port>

其中：

• <local_address>是本地监听的地址（可以是 IP 地址或 0.0.0.0 表示所有地址）。
• <local_port>是本地监听的端口。
• <remote_address>是转发连接到的远程地址。
• <remote_port>是转发连接到的远程端口。

例如，要将本地的 8080 端口转发到远程服务器上的 80 端口，可以使用以下命令：

netsh interface portproxy add v4tov4 listenaddress=127.0.0.1 listenport=8080 connectaddress=192.168.0.100 connectport=80

要查看当前的端口转发规则，可以使用以下命令：

netsh interface portproxy show v4tov4

要删除特定的端口转发规则，可以使用以下命令：

netsh interface portproxy delete v4tov4 listenaddress=<local_address> listenport=<local_port>

其中的<local_address>和<local_port>应该与你想删除的规则匹配。

请注意，执行这些操作通常需要管理员权限。

GUI

使用开源工具PortProxyGUI可以在 UI 界面快速增删改查端口映射。

WSL2 是 Windows 的子系统，可以在 Windows 上运行 Linux，但是 WSL2 是运行在虚拟机中的，所以无法直接访问 WSL2 中的服务，比如 SSH 服务。本文介绍如何使用内网穿透工具花生壳来实现远程访问 WSL2 中的服务。

实现这一需求需要完成两个功能。

1. WSL2 中的服务是运行在虚拟机中的，如何将公网的访问转发到 WSL2 中。
2. Windows 没有公网 IP，如何通过公网来访问。

WSL2 端口转发

获取 WSL2 的 IP 地址：

hostname -I | awk '{print $1}'
172.26.13.98

Windows 自带的netsh interface portproxy可以实现端口转发。管理员身份打开 cmd，执行以下命令：

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=2222 connectaddress=172.26.13.98 connectport=22

• listenport：公网访问的端口（改一个不冲突的就行）
• connectaddress：WSL2 的 IP 地址
• connectport：WSL2 中 SSH 服务的端口 (默认为 22，不需要更改)

开启 Windows 防火墙入站规则，管理员身份打开 cmd，执行以下命令：

netsh advfirewall firewall add rule name=WSL2 dir=in action=allow protocol=TCP localport=2222

这个命令是用于在 Windows 高级防火墙中添加一条规则。下面是对每个参数的解释：

• name=WSL2：将规则命名为 “WSL2”。
• dir=in：指定规则适用于传入的网络流量。
• action=allow：允许通过该规则的流量通过防火墙。
• protocol=TCP：指定规则适用于 TCP 协议的流量。
• localport=2222：指定本地端口号为 2222。

验证端口转发是否成功：

ssh -p 2222 user@localhost

• user 修改成 WSL2 的用户名

如果配置成功，则会成功登录 WSL2。

安装配置花生壳

进入官网下载花生壳客户端，安装后打开，注册账号，登录。需要实名认证

免费账户可以绑定2 个映射，对我来说暂时够用了，免费流量 1G/月。实测阅读代码不编译的话大概每天 50M左右。

打开客户端，添加映射，配置如下：

保存即可。

验证是否配置成功，找一台不在同一个局域网的电脑，使用 SSH 连接 WSL2：

如果复制出来的访问地址为abcdjsj.goho.co:33445，那么 SSH 命令修改为如下：

ssh -p 33445  user@abcdjsj.goho.co

• user 修改成 WSL2 的用户名

如果配置成功，则会成功登录 WSL2。

题外话

1. WSL2 的 IP 会经常变化，如果连不上了，可以重新获取一下 IP，然后修改一下各个配置。或者想办法将 WSL2 的 IP 固定下来。
2. 带宽有限，登录时比较慢，耐心等待。后续准备使用 frp 自建一个穿透服务。
3. PC 耗电伤不起啊，一百多瓦赶上三四台 NAS 了。这玩意只能应急，长时间挂机电费都够买个云服务器了。

常见问题

“System is booting up. Unprivileged users are not permitted to log in yet”

登录服务端，也就是 WSL2，执行以下命令

sudo rm /run/nologin

version: "3.7"

services:
  radarr:
    container_name: radarr
    image: dockerproxy.com/linuxserver/radarr:latest
    ports:
      - "7878:7878"
    environment:
      - PUID=1000
      - PGID=1000
      - UMASK=002
      - TZ=Asia/Shanghai
    volumes:
      - /root/sharedfolder/appdata/radarr:/config
      - /root/sharedfolder/media:/movies
      - /root/sharedfolder/downloads/qbittorrent:/downloads

配置中文界面：

导入视频：

宿主机任意下目录执行：

$ ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/home/user/.ssh/id_rsa): host2servera_id_rsa
Enter passphrase (empty for no passphrase): 
Enter same passphrase again: 
Your identification has been saved in host2servera_id_rsa.
Your public key has been saved in host2servera_id_rsa.pub.
The key fingerprint is:
SHA256:OkWcw+R3x6Z2mzeYQuG033H3N9qIeym3TZKzz6YD8tQ user@ubuntu18
The key's randomart image is:
+---[RSA 2048]----+
|        .        |
|       = .   .   |
|        B .o. +  |
|       . oo.o+   |
|        S  ++ ..o|
|       o ..+.A=o=|
|      o   +..B+=+|
|       .   oo=@o+|
|           o=ss= |
+----[SHA256]-----+

一直回车确定，生成公私钥，保存在~/.ssh目录下。

我在宿主机上生成的公私钥名称为，分别是host2servera_id_rsa,host2servera_id_rsa.pub方便我记忆。如果一直回车，那么生成的公私钥名称为id_rsa，id_rsa.pub。

发送公钥

将公钥复制到服务器 ServerA 上，以 IP：10.12.193.53 为例。

$ ssh-copy-id 10.12.193.53
# 输入密码
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys
user@10.12.193.53's password: 

Number of key(s) added: 1

Now try logging into the machine, with:   "ssh '10.12.193.53'"
and check to make sure that only the key(s) you wanted were added.

默认是把 ServerA 的用户当做 user 进行登录。如果有确定的用户如userA，就使用ssh-copy-id userA@10.12.193.53

然后就可以直接免密码登录了：

ssh user@10.12.193.53
# 或者
ssh userA@10.12.193.53

如果还是需要输入密码，可能ssh-agent没有启动，执行eval $(ssh-agent)启动ssh-agent，然后再次登录即可。然后将私钥添加到ssh-agent中，执行ssh-add ~/.ssh/host2servera_id_rsa，然后再次登录即可。

配置快捷登录

即使免密登录，输入一长串 IP 也太麻烦了，能不能配置更简单的登录方式，比如给服务器起个名字如ServerA直接使用ssh ServerA就登录服务器，能。

打开~/.ssh/config配置如下内容：

Host ServerA
    HostName 10.12.193.53
    Port 22
    User userA
    IdentityFile ~/.ssh/host2servera_id_rsa

然后就可以直接使用ssh ServerA登录了。

安装 yadm

安装

安装 yadm 非常简单，只需在终端输入以下命令：

sudo apt-get install yadm

初始化 yadm 仓库

创建一个新的 yadm 仓库很容易，只需在 home 目录中运行以下命令：

yadm init

现在，yadm 已经创建了一个空白的 git 仓库。

存储库位置/home/nic/.local/share/yadm/

添加 dotfile 文件

要将现有的 dotfile 添加到 yadm 仓库中，请使用以下命令：

yadm add ~/.zshrc

一旦您完成了对要添加的文件的更改并将它们添加到 yadm 仓库中，您需要提交它们。可以使用以下命令：

yadm commit -m "Add .zshrc file to yadm repository"

建立远程仓库

使用 yadm 还可以将 dotfile 文件同步到 GitHub 等 Git 托管服务中。

登录 Github，创建一个新的仓库。例如，您可以创建一个名为 dotfile 的仓库。现在，您需要将本地仓库与远程仓库连接起来。要将本地仓库连接到远程仓库，请使用以下命令：

yadm remote add origin https://github.com/[用户名]/dotfile.git

现在 yadm 已经连接到您在 Github 上创建的仓库。要将本地代码上传到远程仓库，请使用以下命令：

yadm push

使用多台电脑时如何同步配置

假设需要在多个计算机之间共享 dotfile 文件。只需按照以下步骤即可：

1. 在另一台计算机上安装 yadm 并初始化 yadm 仓库。
2. 将远程仓库克隆到该计算机的 yadm 仓库中：

yadm clone https://github.com/[用户名]/dotfile.git

3. 此时，您的 dotfile 文件应在计算机上自动更新。

执行完 clone 命令后实际上就是 yadm 会把远程仓库的文件都拷贝到本地。

如果本地有修改和远程有冲突怎么办

如果本地有修改，远程也有修改，那么就会产生冲突。这时候需要先解决冲突，然后再提交。

每台电脑的配置不一样怎么办

比如我们会在.zshrc中配置一些环境变量，但是每台电脑的环境变量可能不一样。这时候我们可以在.zshrc中添加一些判断，比如我们可以简单的判断一下主机名，然后根据主机名来加载不同的配置。

if [ $HOSTNAME = "xxx" ]; then
    # xxx的配置
elif [ $HOSTNAME = "yyy" ]; then
    # yyy的配置
fi

但有一些配置文件可能不支持这样的添加语句，比如.gitconfig，这时候我们可以使用 yadm 的 Alternate Files 功能解决。

Alternate Files 是一个用于管理同一文件不同版本的功能，有时在不同的主机、操作系统和用户需要不同的文件。Alternate Files 允许使用同一个文件名字，在文件名后添加一个带有条件的后缀，例如##os.Linux,hostname.host1，class.work，yadm 会根据当前系统的特定条件自动选择适当的版本，并创建符号链接。如果没有符合条件的版本，它将选择默认版本。

就以.gitconfig配置文件为例，我们通常在公司的电脑和家里的电脑配置不太一样，比如公司使用下面的配置：

[user]
	email = 公司邮箱
	name = 公司用户名

在家里使用下面的配置：

[user]
    email = 日常使用邮箱
    name = 日常使用用户名

配置文件不支持条件语句，所以无法通过直接在同一个配置文件里完成不同环境的配置。这就用到了 Alternate Files 功能，我们可以复制两个.gitconfig文件后面添加一个条件后缀，比如.gitconfig##class.work，然后在.gitconfig##class.work文件中添加公司的配置，.gitconfig文件中添加家里的配置。这样 yadm 就会根据当前的主机名自动选择合适的配置文件。并把这三个文件都加入到 yadm 仓库中。

yadm add ~/.gitconfig
yadm add ~/.gitconfig##class.work
yadm add ~/.gitconfig##class.home

那么 yadm 是如何实现不同环境的切换呢？我们还需要进一步配置，有注意到我们的配置文件名中的class属性吗，这是 yadm 支持的条件属性之一。我们可以通过yadm config命令来配置当前电脑的属性。比如我们配置公司电脑的class属性为work，家里的电脑的class属性为home。

yadm config local.class work

我们执行完此命令后，yadm 会自动为.gitconfig文件添加一个软链接，链接到.gitconfig##class.work文件。这样我们就可以在公司电脑上使用公司的配置了。如果我们在家里的电脑上执行yadm config local.class home，那么 yadm 会自动为.gitconfig文件添加一个软链接，链接到.gitconfig##class.home文件。这样我们就可以在家里的电脑上使用家里的配置了。

yadm 支持以下这些条件：

再举个例子，上面用的 class 条件是必须通过yadm config local.class <class>手动设置的。但是有一些条件不需要手动设置 yadm 可以自动识别。比如 os 属性。我们将.zshrc文件复制两份份，命名为.zshrc##os.Linux和.zshrc##os.Darwin，然后在.zshrc##os.Linux文件中添加一些 Linux 系统的配置，.zshrc##os.Darwin文件中添加一些 Mac 系统的配置。并把这三个文件都加入到 yadm 仓库中。这样 yadm 就会根据当前的系统自动选择合适的配置文件。

安装 REST Client 插件

在 VSCode 中，你可以通过以下步骤安装 REST Client 插件：

• 打开 VSCode；
• 点击左侧的插件图标（Ctrl+Shift+X）；
• 搜索“REST Client”插件；
• 点击“安装”按钮。
• 发送 HTTP 请求

使用 REST Client 插件发送 HTTP 请求非常简单。你只需要创建一个新的.rest文本文件，将请求信息放入其中，然后使用快捷键Ctrl + Alt + R 或者右键菜单的 Send Request 选项发送请求。

下面是一个简单的 GET 请求的例子：

GET https://jsonplaceholder.typicode.com/posts/1 HTTP/1.1

这个请求会获取 JSONPlaceholder API 中的一篇博客文章。

如果你想添加请求头或请求体，可以使用以下语法：

GET https://jsonplaceholder.typicode.com/posts/1 HTTP/1.1
Content-Type: application/json

{
  "title": "foo",
  "body": "bar",
  "userId": 1
}

这个请求会在请求头中添加 Content-Type 头，请求体中包含 JSON 数据。

查看响应

发送请求后，你可以在编辑器底部看到响应信息。如果你想查看响应头、响应体或状态码等详细信息，可以使用以下语法：

###
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
...

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi optio reprehenderit",
  "body": "quia et suscipit\nsuscipit..."
}

在这个例子中，###用来分隔请求和响应，这样你就可以很方便地查看请求和响应的详细信息了。

变量

REST Client 插件还支持变量的使用。你可以使用${variable}语法来定义变量，然后在请求中使用它们。例如：

@host = https://jsonplaceholder.typicode.com

GET ${host}/posts/1 HTTP/1.1

在这个例子中，我们定义了一个名为 host 的变量，并在请求中使用它来指定 API 的基础 URL。

循环

如果你需要发送多个请求，REST Client 插件支持循环语法。例如：

@host = https://jsonplaceholder.typicode.com

@for(i,1,10){
    GET ${host}/posts/${i} HTTP/1.1
}

在这个例子中，我们使用@for 语法来发送 10 个 GET 请求，每个请求 URL 中的 i 变量从 1 到 10 依次递增。

条件语句

如果你需要根据条件发送请求，REST Client 插件也支持条件语句。例如：

@host = https://jsonplaceholder.typicode.com

@if(isDebug){
    GET ${host}/posts/1 HTTP/1.1
}else{
    GET ${host}/posts/2 HTTP/1.1
}

在这个例子中，我们使用@if 语法来判断是否为调试模式，如果是就发送一个请求，否则发送另一个请求。

导入环境变量

REST Client 插件支持从外部文件中导入环境变量。例如，你可以在.env 文件中定义变量：

host=https://jsonplaceholder.typicode.com
isDebug=true

然后在请求文件中使用@environment 语法来导入这些变量：

@environment .env

@if(isDebug){
    GET ${host}/posts/1 HTTP/1.1
}else{
    GET ${host}/posts/2 HTTP/1.1
}

在这个例子中，我们使用@environment 语法从.env 文件中导入环境变量，然后在请求文件中使用这些变量。

结论

REST Client 插件是一个非常好用的工具，能够帮助开发人员快速、方便地发送 HTTP 请求并查看响应。在本文中，我们介绍了 REST Client 的基本使用方法，包括发送请求、查看响应、使用变量、循环、条件语句和导入环境变量等。希望这篇文章能够帮助你更好地使用 REST Client 插件。

准备工作

在开始使用 GitLab CI/CD 的 Pipeline 功能之前，需要进行一些准备工作。具体步骤如下：

1. 创建 GitLab 项目：在 GitLab 上创建一个新项目，并将 Markdown 文件上传至项目的某个目录下。例如，我们将 Markdown 文件上传至项目的根目录下，并命名为 example.md。

• 安装 Pandoc：Pandoc 是一个用于文档转换的工具，我们将使用它将 Markdown 文件转换为 PDF。在安装 Pandoc 之前，需要先安装 LaTeX，因为 Pandoc 使用 LaTeX 进行 PDF 渲染。具体安装步骤请参考 Pandoc 和 LaTeX 的官方文档。

• 创建 Release：在 GitLab 上创建一个 Release，用于存储编译好的 PDF 文件。具体操作方法请参考 GitLab 的官方文档。

• 创建 CI/CD 配置文件：在项目根目录下创建一个.gitlab-ci.yml 文件，并在其中定义 Pipeline 的流程。

编写 CI/CD 配置文件

下面是一个样例的.gitlab-ci.yml 文件，用于实现将 Markdown 文件编译为 PDF 并上传至 GitLab Release 界面的功能。

image: pandoc/core:latest

stages:
  - build

pdf:
  stage: build
  script:
    - pandoc example.md -o example.pdf
    - curl --header "PRIVATE-TOKEN: ${CI_PRIVATE_TOKEN}" --upload-file example.pdf "${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/uploads"
  artifacts:
    paths:
      - example.pdf

上述配置文件中，我们使用了 pandoc/core:latest 作为 Docker 镜像，该镜像已经预安装了 Pandoc 工具。

该文件中包含了一个 build 阶段，其中包含了一个 pdf 任务。在 pdf 任务中，我们使用 Pandoc 工具将 Markdown 文件转换为 PDF 文件，并使用 cURL 工具将编译好的 PDF 文件上传至 GitLab Release 界面。注意，我们使用了环境变量${CI_PRIVATE_TOKEN}和${CI_API_V4_URL}，这些变量是 GitLab 自动注入的，用于进行身份验证和上传文件。

最后，我们将编译好的 PDF 文件定义为 Pipeline 的 artifacts，这样可以确保文件能够被保留并可用于后续的部署。

运行 Pipeline

完成 CI/CD 配置文件的编写后，我们可以在 GitLab 上启动 Pipeline，将 Markdown 文件自动编译为 PDF 并上传至 GitLab Release 界面。具体步骤如下：

• 提交代码：将.gitlab-ci.yml 文件提交到 GitLab

• 启动 Pipeline：在 GitLab 上打开项目，并点击“CI/CD”->“Pipelines”选项卡。点击“Run Pipeline”按钮，启动 Pipeline 流程。

• 等待 Pipeline 完成：在 Pipeline 启动后，GitLab 会自动创建一个 Runner 并分配任务。Pipeline 的状态会在页面上实时更新，直到 Pipeline 执行完成。

• 查看 Release：Pipeline 执行完成后，我们可以在 GitLab Release 界面中找到编译好的 PDF 文件。点击 PDF 文件链接，即可下载并查看编译好的 PDF 文件。

文件—导出为 HTML—导出—新窗口打开—复制 HTML 代码—只保留<body>标签之间的内容，不包含<body>和</body>。

Markdown 中的表格，只要符合语法就能够正常渲染显示，但是符合语法但是 Markdown 源码却不一定易读。就如以下的这个表格，可以正常显示，但是源码在源文件中竖线不对齐，就阅读困难。

源码：

|诗名|作者|朝代|
|-|-|-|
|白头吟|卓文君|两汉|
|锦瑟|李商隐|唐代|
|登科后|孟郊|唐代|

显示效果：

我们可以手动将其竖线对齐，如下这样就易读许多：

| 诗名   | 作者   | 朝代 |
| ------ | ------ | ---- |
| 白头吟 | 卓文君 | 两汉 |
| 锦瑟   | 李商隐 | 唐代 |
| 登科后 | 孟郊   | 唐代 |

显示效果保持一致。但是如果一个字符一个字符去手动对齐效率太低，也不符合 Markdown 设计初衷。这就用到了额外的插件，能够辅助我们完成这个工作。

Markdown All in One

VSCode 插件中心搜索Markdown All in One安装。

安装完成后，使用时右击窗口选择Format Document with：

选择Markdown All in One即可自动对齐所有表格竖线：

常见问题

格式化文档后仍未对齐

这是由于表格中同时有中英文，而中英文字体不等宽导致的。如果对阅读要求不高，可以不用管，实际上已经格式化完成了。如果需要对齐，那么可以查看编码字体与阅读字体推荐这篇文章的中文等宽字体下载并安装，即可正常对齐。

自从有天忘了忘了休眠电脑，一个自动备份任务开启，在 40 度的高温天，满速跑了一天，下班回来硬盘直接报废。这就加速我折腾部署 NAS 的进程。

准备阶段

威联通的几款中意的 NAS 放购物车很久了，如果硬盘没有这么早坏掉，可能在双十一就买整机了，现在离双十一还早，硬件价格都不便宜，想来想去还是买二手硬件攒一台更划算。如果买整机，硬盘加 NAS 主机就得五千大洋，只是用来存文件，部署个 Jellyfin 看电影用，属实奢侈了。

￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥￥

买二手就得从零开始学。生命不休，折腾不止。经过一次完整的 NAS 攒机过程发现，其实 NAS 就是安装了专用系统的一台电脑而已。这个专用系统就是面向网络存储开发的，如群晖，威联通，开源的 OMV，FreeNAS 等等。

既然是一台电脑，其实攒 NAS 就和攒电脑一样，选配好以下几大件即可。

• CPU
• 主板
• 散热器
• 机箱
• 内存
• 电源
• 机箱风扇

下面分别介绍在攒机过程中遇到的一些概念，参数到底是什么意思。

CPU

CPU 型号字母数字都是什么意思

• Intel 是英特尔的英文名称，也是目前热门的 CPU 品牌；
• “酷睿”代表英特尔品牌下面向普通消费者的一个 CPU 系列，一般划分为 Core（酷睿）、Pentium（奔腾）、Celeron（赛扬）、Xeon（至强）、Atom（凌动）等；
• i5 代表这款 CPU 定位中端，在其下面还有 i3，在其上面还有 i7 和 i9，同一代中，数字越大，性能越强；但是不同代 - 数之间，性能不能直接相比，比如 12 代的 i5 在理论性能上是强于 10 代 i7 的。
• 12 代表这款 CPU 的代数，说明其已经发展到第十二代了，数字越大越新；
• 600 这三位数字代表 Intel SKU 型号划分，一般来说 Core i7 有固定几个 SKU，比方说 700；Core i5 有 600/500/400；Core i3 有 300/100 等等，一般来说数字越大说明隶属的 Core 系列越高级，同级别下比较，数字越大频率越高，换句话说性能就越强，比方说 Core i5-8600 默认 3.1GHz，睿频 4.3GHz，比 Core i5-8500 默认 3.0GHz，睿频 4.1GHz 要强。
• K 带 K 的表示不锁频，可以配合 Z 系列主板进行超频操作，适合会超频玩家使用，比方说 i7-12700K，i5-12600K 等
• F 带 F 的表示不带集成显卡，你必须配合独立显卡使用；

当然，除了例子中的这种情况，我们还会遇到其它 CPU 型号的后缀：

• K：表示支持超频且内置核显的 CPU 型号，例如型号：i5-12600K、i7-12700K；
• F：表示无内置核显，例如型号：i5-12400F、i7-12700F；
• KF：表示支持超频且无内置核显的 CPU 型号，例如型号：i5-12600KF，i7-12700KF。
• T：表示低功耗版，相同型号下功耗更低，性能也差一些，例如型号：i7-10700T；
• X/XE：表示至尊旗舰级，例如型号：i9-10980XE。
• KS：可以理解为官方超频版，提升了主频的版本，例如 i9-9900K 和 i9-9900KS，i9-9900KS 出厂的主频要高于 K，例如型号：i9-9900KS。
• U：低电压，性能弱些但功耗低，通常出现在轻薄本中，举例型号：i7 10510U；
• H：标压，性能强，通常出现在游戏本中，举例型号：i5-11300H
• Y：超低电压，性能很弱功耗非常低，通常出现在轻薄本中，举例型号：i3-10110Y；
• HK：一般使用在 Intel 高端发烧级 CPU 上，可超频，举例型号：i9-11980HK；
• G：G1、G4 以及 G7 等，G 后面的数字表示核显性能强弱，数字越大代表核显性能越强，通常数字小于 4 的是集成的普通超高清 (UHD) 核显，大于等于 4 的是集成的高性能锐炬 (Iris) 核显。Intel 移动版 CPU 后缀，举例型号：i5-1155G7、i3-1115G4、i3-1005G1；
• HQ：标准电压，Q 板载四核，早期的老后缀，举例型号：i7-7700HQ；
• MQ：标准电压，Q 插拔四核，早期的老后缀，举例型号：i7-4810MQ；
• M：早期后缀 M 就是移动端 CPU，只是为了与台式机区别开，举例型号：i7-2620M。

主板

ATX，Micro-ATX，Mini-ITX 区别

在了解买啥主板时，不免会看到各种 TX，比如我买的这块七彩虹 B460iTX 主板，简称就是七彩虹 B460i，还有不带最后字母i的。他们有啥区别呢？其实这就是表示了主板的尺寸。主板尺寸常见的有三种尺寸：

• 标准-ATX：30.5 厘米 x 24.4 厘米

• Micro-ATX：24.4 cm x 24.4 cm

• Mini-ITX：17 厘米 x 17 厘米

一般攒机会用标准 ATX，或者 MATX 也很常用，而 ITX 就常被用来搭建低功耗的服务器，如我们要搭建的 NAS。因为它是 7*24 小时不间断工作的，功耗是需要多考虑的。

散热器

风冷与水冷

风冷就是散热鳍片加风扇。散热鳍片会穿入铜管，铜管与下方底座相连，底座与 CPU 直接接触。CPU 热量铜管底座传导给铜管，铜管传导给散热鳍片，散热鳍片铜管风扇散热。

水冷就是水冷头加风扇。简单理解就是风冷的铜管换成了液体。液体流动传导比铜管更快。

各有优缺点，风冷更安全，比较简单，性能上限比较低，而水冷在外观、性能方面有很大的优势，缺点就是相对比较贵，还有漏液风险，不过现在的水冷漏液概率很小。细分的话风冷还有下压式，下压式比较适合 itx 小机箱，而塔式就适合普通机箱，水冷也分一体式水冷和分体式水冷，常见的都是一体式水冷。

机箱

塔式，机架与刀片区别

塔式服务器外形和普通家用服务器相差不多，塔式主机在主板扩展上有优势，一般预留接口较多，方便扩展。适用于入门和工作站。

机架服务器的外观安装工业标准统一设计，需要配合机柜统一使用，主要用于企业服务器密集部署。机架服务器因为需要密集紧凑，所以在设计时会非常紧凑，充分利用有限的空间。机架服务器宽度 19 英寸，高度以 U 为单位 (1U=1.75 英寸 =44.45 毫米）.

刀片服务器的主体结构是主体机箱中可以有许多热拔插的主板，每一块主板都可以独立运行自己的系统，这些主板可以集合成一个服务器集群，在集群模式下可以连接起来提供更好的网络以及共享资源。

全塔，中塔与小塔区别

形容的是机箱的大小。

普通机箱，只能放 mATX 主板和一个标准电源，仅有 1-2 个光驱位；

中塔机箱 AT，X 主板甚至是 EATX 主板和一个标准电源，拥有 3-4 个光驱位；

全塔机箱，可以在主板上下的位置都安放一个电源，一共放两个电源拥有 4 个以上的光驱位。

内存

电源

全模组，半模组与非模组区别

总结一句话就是能不能拔掉不需要的供电线，能拔多少。

非模组

一个都不能拔，电源线直接从电源内部引出，输出线缆固定，无法进行扩展。

半模组

能拔一部分，输出设计上既有非模组电源的直出线，又有全模组电源的扩展接口。

全模组

能全拔，所有线缆都能按需插上。因为一般一块主板不会把所有电源线都用上，这样只需要插上自己需要的线缆即可，可以保证走线清楚，机箱清爽。

金牌，银牌和铜牌啥区别

金牌，银牌，铜牌指的是电源的转换效率。有钛金、白金、金牌、银牌、铜牌、白牌等档次，档次越高，转换效率也越高，但成本也越高，功率越小，相对成本也越高。每个“牌”对应的攻略转换或者参数也是不同的。

白牌：最低要求是 20-100% 负载下，转换效率必须达到 80%；

铜牌：与上同条件大于等于 82%，85%@50% 负载；

银牌：大于等于 85%，88%@50% 负载；

金牌：大于等于 87%，90%@50% 负载；

白金牌：90%@20% 负载、92%@50% 负载、89%@100% 负载。

钛金牌：要求 10%、20%、50%、100% 负载下的效率分别为 90%、94%、96%、92%。

举个例子： 500w 金牌和 500w 铜牌，都能带动 500w 功耗的电脑。金牌电源在 100% 负载时，转换率超过 87%，可以算一下，500/0.87=575w 耗电。 铜牌 100% 负载转换率超过 82% 500/0.82=610w耗电，简单说就是好电源省电。

硬盘

固态硬盘

机械硬盘

垂直盘 PMR 与叠瓦盘 SMR 区别

作者：一起学点什么 链接：https://www.zhihu.com/question/369882964/answer/2227127605

垂直磁记录（Perpendicular magnetic recording，PMR），也称为传统磁性记录 (conventional magnetic recording，CMR)，由于 SMR 其实也是垂直式磁记录的一种，只是相较于垂直磁记录方式磁盘优化了写入密度，因此为了避免被认为所有垂直磁记录的硬盘都是 SMR 硬盘，大家也习惯把非 SMR 的垂直机械盘称为 CMR。

最开始由于硬盘容量提升的需求，磁性记录颗粒的尺寸需要不断下降，导致出现了电磁学上的超顺磁效应（超顺磁性：当某些具有磁性的颗粒小于某个尺寸时，外场产生的磁取向力太小而无法抵抗热扰动的干扰，而导致其磁化性质与顺磁体（通俗来说就是指材料对磁场响应很弱的磁）相似。），这就限制了硬盘容量提升的潜力。

之前硬盘厂商使用纵向（平行，Longitudinal Magnetic Recording，LMR）读写技术，磁性记录颗粒的易磁化方向相对于碟片是平行的，颗粒沿着碟片圆周以端对端排列，所以便有机会出现 SS（南）和 NN（北）的互斥排列。当颗粒的尺寸不断下降而密度不断提升，在室温的情况下颗粒便会对随机的热运动异常敏感，失去稳定性，导致出现比特（0 和 1）翻转的现象，记录的数据因此被破坏。

而为了解决以上问题，后来就开发出了垂直磁记录技术（Perpendicular Recording）的硬盘，这种硬盘中的磁性记录颗粒的易磁化方向相对于碟片是垂直的，允许使用单极磁头配合磁记录介质下的软磁层将信息写入磁记录介质中，这样采用具有相同饱和磁化强度的材料所制备的垂直写入磁头，能产生远多于传统写入磁头所能产生的磁场。更大的写入磁场允许我们使用具有更高磁各向异性的材料来制备磁记录介质，而磁各向异性越强，出现超顺磁性效应的临界体积就越小，因此，碟片中的存储密度可以在一定程度内得到进一步的提高。

但是这样虽然提高了硬盘的存储密度，但是很快也就达到了瓶颈，工程师又开始想新的方法来提高硬盘的存储密度，这就诞生了大家都知道的 SMR 叠瓦盘。

叠瓦式机械硬盘（Shingled magnetic recording，SMR，直译为分层磁记录）：也是一种用于硬盘驱动器的磁存储数据记录技术，可提高存储密度和每个驱动器的整体存储容量。常规的硬盘驱动器通过写入彼此平行而不重叠的磁道来记录数据，例如 PMR。而叠瓦磁记录技术的硬盘写入的新磁道则与先前写入的磁道部分重叠，从而使先前的磁道更窄，因此能拥有更高的磁道密度，进而提高磁盘容量。使用叠瓦磁技术的磁道相互重叠，与用作屋顶的瓦片堆叠方式类似。之所以能这样做是因为磁盘写入磁头由于物理上的原因比读取磁头宽上许多，因而由正常方式写入的磁道宽度远比读取磁头所需的磁道宽度来得宽，此外为了避免磁道间相互干扰，磁道和磁道之间其实还有一部分空隙，因此读取信息的磁道仅占所有磁道的很小一部分，很大的磁盘空间都被浪费了，只是因为技术原因我们不能将写入磁头制作的和读取磁头一样小。

由于磁道存在重叠，叠瓦式磁盘的写入过程较为复杂。如果我们随机写入一个磁道，由于写入磁头的宽度比磁道宽，因此写入会影响到临近磁道，如果这个临近磁道有数据，这些数据就也需要依次重写以免数据被破坏，依此类推。因此，SMR 磁盘一般分成很多块只能追加数据（顺序写入）的区域（Zone），这和固态硬盘的闪存页管理类似。使用“设备管理”（device-managed）方式的 SMR 磁盘通过内部固件处理了 SMR 磁盘复杂的写入问题，从而对用户封装了 SMR 磁盘的复杂性，令用户可以像使用 PMR 硬盘一样随机写入 SMR 硬盘。其他 SMR 磁盘则使用“主机管理”（host-managed）方式，需要操作系统识别 SMR 磁盘并拥有能对 SMR 磁盘进行正确顺序写入的驱动程序才能被正常使用。

叠瓦盘相较于垂直盘性能也有一定下降，因为传统的 CMR 硬盘磁道之间不会互相干扰，写入数据时可以任意进行写入，而叠瓦盘由于在一个磁道写入数据时不可避免会影响相邻的磁道，需要将下一磁道的数据先拿出（暂时放入硬盘 CMR 缓冲区）再进行写入，而恢复下一磁道的数据则又会对下下磁道的数据进行影响，则又需要先取出下下磁道的数据，因此完成传统垂直硬盘一次的写入操作，叠瓦式硬盘则需要多次的写入，同样的数据量需要更多的写入操作，也会增大损坏的概率。

配件选购

1.表示二手价格

主板

刚入门其实最头疼的就是到底买什么型号，因为各个配件之间又有兼容问题，比如相中了一款 ITX 的机箱，但是主板却是 ATX 的，主板都放不进机箱里，这就很麻烦。所以我们首先要确定一个配件，其余配件都安装这个配件的规格去买，并且都要适配这个配件。那么这个配件最好的选择就是主板。

我们先确定自己要买一个什么样的主板，让所有其他的配件都适配这个主板。选择主板的好处是，主板上各个接口就能体现出这台 NAS 的性能。不至于配件买的太离谱。

机箱

微型机箱买 ITX 板，MINI 机箱买 M-ATX 板和 ITX 板，中塔机箱买 ATX 板。因为 NAS 是个服务器，可能会永远被放在墙角，所以颜值不重要，实用才是王道，买一个盘位多实用性强的就行。

在前期准备时看到很多推荐迎广的机箱，本来决定要买它，但是了解到 NAS 的本质就是一台电脑主机时，意识到为何不买个电脑机箱？为何要选择成品的机箱？虽然成品的 NAS 机箱有硬盘位，可热插拔。但是我为啥要去插拔服务器上的硬盘？

当我有这个意识后，我的选择一下子多了起来，我最终选了逛淘宝偶然看的 Invasion 机箱。十分简约的外形，甚至还有玻璃侧罩，四格金属硬盘架专为 NAS 打造。只要不到三百块。于是立马转头打开小黄鱼，一搜还真有转卖的，升级版的 8 格硬盘架只要 330。收到货后也很满意，几乎是全新的，玻璃膜都没有撕，还送了俩风扇。

CPU

选择 CPU 对于小白来说最重要的就是要选择带核显的 CPU，因为 NAS 上显卡其实没必要，CPU 的核显就绰绰有余了，如果既没有显卡也没有核显就会无法亮机。所以选择 CPU 时要选择带核显的，也就是 Intel 的 CPU 型号不带F的，比如我最终选择的 I3-10100。AMD 的 CPU 型号标识我也没弄清楚，可以自己搜索一下自己想要的 CPU 是否有核显。

其次就是功耗，因为 NAS 要 7*24 小时运行，所以选择性能低一点的 CPU 就好了，另外就是需要关注 CPU 是否有音视频解码的能力。因为平时爱折腾，想着以后指不定在 NAS 上折腾些啥，所以选择了性能不算低的 I3-10100。两个月体验下来，性能还是过剩了，日常基本上都处于待机状态，只有周末看电影会用一下，CPU 利用率很低，好在日常功耗只有 30W。-

安装 OVM (OpenMediaVaultt)

参考视频：蜗牛星际安装开源 NAS 系统 Openmediavault 及初始化配置（司波图）——OMV 系列教程 01

为什么选择它

OpenMediaVault（以下均简称 OMV）是除 FreeNAS 外目前使用最广泛的开源 NAS 系统。

预备软件下载

下载 OpenMediaVaultt 系统，我选择的是 ISO 格式 Old Stable 版本，虽然想用最新的版本，但是第一次安装没有成功，选择了旧版本安装成功了。

下载 微 PE 工具箱，用来格式化系统盘，如果是新买的系统盘就不需要下载。

下载 Rufus 轻松创建 USB 启动盘，这个必须要用的。

制作启动盘

需要一个容量大于 4G 的 U 盘，用 Rufus 将 OMV 写入 U 盘即可。安装时会从 U 盘启动，然后将系统安装到插在主板上的系统盘内。

启动盘制作就不详细说了，都是一键式操作。

制作完后进入 U 盘内查看是否写入成功，U 盘内是否有文件，或者查看一下 U 盘使用大小，如果比系统 ISO 大小还小，那肯定没有写成功。我就制作了三遍才发现没有写成功，虽然能看到启动选项，但是进入安装就黑屏，因为根本没有可以安装的文件。

如果没有制作成功，尝试格式化U 盘后重新制作。

安装过程

参考视频即可，很详细。

踩坑记录

# git
sudo apt install git
# python
sudo apt install python
# vim
sudo apt install vim

Docker 配置

安装 Portainer 管理容器

更换国内镜像源

• 网易 http://hub-mirror.c.163.com
• ustc http://docker.mirrors.ustc.edu.cn
• 阿里云 http://<你的 ID>.mirror.aliyuncs.com
• 或者使用一位网友提供的 http://1nj0zren.mirror.aliyuncs.com

因为可能有朋友看了比较老的教程（比如我，:( ），可能会用到一些停止服务的进行，如：

• https://dockerhub.azk8s.cn
• https://reg-mirror.qiniu.com
• https://registry.docker-cn.com

如果无法拉取镜像，检查是否用了这几个，如果用了请换镜像源。

安装 Jellyfin 部署影音服务器

安装 Transmission 下载

安装 qBittorrent 下载

添加 tracker list

ngosang/trackerslist: Updated list of public BitTorrent trackers

安装 Jackett 搜索种子

Docker 中安装，选择网易的镜像，阿里的镜像太旧了。

配置端口号9117，映射两个路径即可。

安装过程参考How to configure Jackett plugin。

点击这里下载源码，复制全文并保存为jackett.py文件。

如果按照以上安装 qBittorrent 那么保存路径为共享文件夹下appdata/qBittorrent/nova3/engines/。

如果没找到，找找是否有以下路径。

~/.local/share/data/qBittorrent/nova3/engines/
# 或者
~/.local/share/qBittorrent/nova3/engines/

再在相同路径下，新建一个配置文件jackett.json，写入以下配置：

{
    "api_key": "YOUR_API_KEY_HERE", 
    "tracker_first": false, 
    // 如果你登录 OMV 的地址是 192.168.0.1
    "url": "http://192.168.0.1:9117"
}

安装 Hlink 硬链接持续做种

下载的文件名太过杂乱，可以用 TMM 等刮削工具刮削，重命名，建立影音库。但是重命名后就无法做种。想起了 Linux 有硬链接功能，在每天学命令-ln 软硬链接这篇文章中有详细说明。简言之就是创建的硬链接可以任意修改文件名，看上去是一份拷贝，但是实际不占用硬盘空间。

下载的文件太多，又是文件夹嵌套，手动创建比较麻烦，有人专门为这个需求开源了一个项目hlink，可以批量创建硬链接。这里还是以使用 Docker 为例。

配置 Docker

镜像名：likun7981/hlink 端口号：9090 目录映射：/media : /root/sharedfolder 环境变量：HLINK_HOME：/root/sharedfolder/appdata/hlink 选择自己放配置文件的目录即可

/root/sharedfolder 是我挂载的硬盘的根目录，建议映射根目录，不要创建多个目录，比如映射/root/sharedfolder/movie 和/root/sharedfolder/music。因为硬链接不支持跨盘符创建，虽然我们本地 music 和 movie 是在一个盘符，但是这样映射在容器中就是两个盘，就会无法创建硬链接，所以只映射一个根目录。

配置 Hlink

浏览器输入 IP:9090，打开配置界面。

添加一个新配置，注释十分详细，就不赘述了，但是路径一定要写对，可以新建两个测试目录，测试一下是否能够创建成功。

两个重要配置解释：

/**
 * /media 是容器里的目录，因为我只映射了一个目录，所以这就是容器的根目录
 * 对应到我主机，就是/root/sharedfolder 这个目录
 * 所以/media/downloads/qbittorrent/qbcomplete/movie
 * 就是/root/sharedfolder/downloads/qbittorrent/qbcomplete/movie
 * 后一个路径/media/media/movie 同理
 * 等价于/root/sharedfolder/media/movie
 */

 /**
  * 前一个路径是下载的路径，这里的文件都是不能重命名整理的
  * 后一个路径是影音库的路径，hlink 执行完会在这里创建相同的文件链接
  * 这个链接可以任意修改，移动，删除
  */
  pathsMapping: {
      '/media/downloads/qbittorrent/qbcomplete/movie': '/media/media/movie',
  },

  /**
   * 设置 true 打开缓存，这样即使影音库里的文件被删除，移动
   * 也不会创建新的硬链接
   */
  openCache: true,

缓存的文件信息在右上角编辑缓存可以查看，如果已经执行过创建硬链接但是没有显示，Shfit+F5刷新界面重试。

踩坑记录

主板无法识别固态硬盘

因为想利用上三年前从笔记本上拆下来的固态，但没注意接口的协议。主板现在大多默认支持 NEVe 协议，但是我的硬盘是很久之前的 SATA 协议。这块 B460i 主板默认支持 NVMe 协议的，但是也支持 SATA 协议，需要更改跳帽。

找了半天图片没有找到一样的，官网的图片是和说明书上的一样是拨动开关形式的，但是我买的二手的是跳帽（哭），不会是买到假的了吧。开关全部拨到左边才支持 SATA 协议。用跳帽也是一样，必须都连接的是左边两个引脚。

无法识别 U 盘启动盘

引导模式有两种 UEFI 和 Legacy，这个在做启动盘时就确定了。如果主板使用的 UEFI 模式，而启动盘制作的是 Legacy 模式，就无法识别，需要在 Bios 里找到启动模式选择的相关选项，配置可以使用 Legacy 模式或者 UEFI。（记录这些时已经不想再进 Bios 了所以也没有图片，总之要配置引导方式，避免过滤了一些引导方式导致 U 盘无法识别）

不同网段设备无法互通

OVM 无法挂载移动硬盘

报错：The filesystem label contains blanks. Please remove them by renaming the filesystem to be able to mount it.

移动硬盘名里有空格，插到 Windows 上重命名一下即可。

ifconfig not found

# ifconfig
sudo apt install net-tools

ll not found

vim ~/.bashrc
# 找到 #alias ll=’ls -l’，去掉前面的#就可以了。
source ~/.bashrc

参考

1. CPU 型号解读：教你 CPU 型号后缀怎么看？CPU 型号后面的字母和数字区别是什么？ - 知乎
2. 从零开始搭建 NAS: 硬件篇 | Verne in GitHub
3. 从零搭建一台 NAS：软件篇 | Verne in GitHub
4. Intel CPU 型号解读以及如何粗略判断 Intel CPU 的性能 (i3、i5、i7 以及 CPU 的代数)_吮指原味张的博客-CSDN 博客_cpu 代数
5. NAS | 群晖安装 qBittorrent 套件并优化设置、替换 UI（非 docker 安装） | 醉渔小站
6. Docker 中国源 - 简书
7. 金牌 铜牌 什么区别呀？ - 电源 - Antec 网站
8. 机·科普贴：电脑电源金、银、铜牌到底是什么意思？_铜牌电源和金牌电源的区别 - 调色盘网络
9. 【非模组电源，半模组电源，全模组电源有什么区别？】 - 知乎
10. 电源全模组和非模组究竟有什么区别？_电脑电源_什么值得买
11. 浅谈组装机机箱的选择（篇一：大小） - 知乎
12. 哪種 PC 機箱尺寸最適合您的下一個版本？ - HowThere
13. 199 元风冷/水冷散热器简单对比：谁才是你的爱 - 超能网
14. 【教程】蜗牛星际安装开源 NAS 系统 Openmediavault 及初始化配置（司波图）——OMV 系列教程 01_哔哩哔哩_bilibili
15. How to configure Jackett plugin · qbittorrent/search-plugins Wiki
16. 安装 NAS Tools，打造自动化观影、追剧系统，NAS 媒体库整理工具，威联通 Docker 版 NAS Tools 安装教程~feat.威联通 HS 264_哔哩哔哩_bilibili
17. Home | hlink

点击下载 Linux 版本的 Clash，下载完成后解压缩。

unzip clash-linux.zip
sudo mv clash-linux /usr/local/bin/clash
sudo chmod +x /usr/local/bin/clash

初步使用

下载配置文件，配置文件一般由订阅商（机场）提供，是一个 yaml 文件，编写了代理服务器的信息，以及访问规则等。这是最关键的一步。

clash-linux-amd64-v1.10.0 -f 从订阅商那获取的配置文件.ymal -d .

可以尝试在 Git clone 时使用代理，如果可以正常下载，说明代理配置成功。

git clone https://github.com/twbs/bootstrap.git --config "http.proxy=127.0.0.1:7890"  
# 即可正常下载

开机启动

cd ~
sudo cp /usr/local/bin/clash /etc/
sudo vim /etc/systemd/system/clash.service

添加如下内容，并保存：

[Unit]
Description=Clash Daemon

[Service]
ExecStart=/usr/local/bin/clash -f /etc/clash/订阅的配置文件.yaml -d /etc/clash/
Restart=on-failure

[Install]
WantedBy=multi-user.target

启用 clash 服务

sudo systemctl enable clash.service

启动 clash 服务

sudo systemctl start clash.service

此外也可以停止或者禁用 clash 服务

sudo systemctl stop clash.service
sudo systemctl disable clash.service

查看运行状态：

sudo systemctl status clash

查看 clash 服务日志

journalctl -e -u clash.service

配置定期更新

crontab -e

添加如下内容：

29 6    * * *   root    pgrep clash | xargs kill -s 9 
30 6    * * *   root    cp /etc/clash/订阅的配置文件.yaml /etc/clash/backup.yaml 
31 6    * * *   root    curl https://订阅链接.yaml > /etc/clash/订阅的配置文件.yaml
32 6    * * *   root    sudo systemctl start clash.service

重启 cron 服务

sudo systemctl restart cron.service

使用 Dashboard

编辑/etc/clash/glados.yaml，修改以下配置，默认配置为127.0.0.1:9090。如果你的9090端口没有被占用，将其修改为0.0.0.0:9090即可，因为我的 NAS9090端口被占用，所以修改成了0.0.0.0:19090。

external-controller: 0.0.0.0:19090

这样就可以在浏览器通过Nas IP:19090/ui访问 Dashboard，比如192.168.1.9:19090/ui。

更方便的方式：使用 Docker 部署

version: "3.7"

services:
  clash:
    image: dreamacro/clash-premium
    container_name: clash
    hostname: clash
    restart: unless-stopped
    ports:
      - 7890:7890
      - 7891:7891
      - 9090:9090
    volumes:
      - /root/sharefolder/appdata/clash:/root/.config/clash # 修改为你的配置文件目录
    environment:
      - TZ=Asia/Shanghai

  clash-dashboard:
    image: haishanh/yacd:master
    container_name: clash-dashboard
    ports:
      - "7880:80"
    restart: always
    environment:
      - TZ=Asia/Shanghai
    depends_on:
      - clash

这样就可以在浏览器通过Nas IP:7880访问 clash-dashboard，比如192.168.1.9:7880。点击配置，大概率显示无法连接到后端。修改后端地址位http://192.168.1.9:9090。

定时更新：

crontab -e 
# 添加以下的内容
# 每隔 8 小时备份配置文件
0 */8 * * * cp /root/sharefolder/appdata/clash/config.yaml /root/sharedfolder/appdata/clash/config.yaml.bak
# 每隔 8 小时延迟 5 分钟支更新配置文件
5 */8 * * * curl https://xxxxxxx > /root/sharedfolder/appdata/clash/config.yaml
# 每隔 8 小时延迟 6 分钟修改配置文件 allow-lan: false 修改为true
6 */8 * * * sed -i 's/allow-lan: false/allow-lan: true/' /root/sharedfolder/appdata/clash/config.yaml
# 每隔 8 小时延迟 7 分钟修改配置文件 external-controller:
7 */8 * * * sed -i 's/external-controller: 127.0.0.1:9090/external-controller: 0.0.0.0:9090/' /root/sharedfolder/appdata/clash/config.yaml 
# 每隔 8 小时延迟 8 分钟修改配置文件 external-ui: dashboard 注释掉，即不使用内置的dashboard，有的机场提供的配置文件没有这个配置，就不需要添加这行
8 */8 * * * sed -i 's/external-ui: dashboard/#external-ui: dashboard/' /root/sharefolder/appdata/clash/config.yaml
# 每隔 8 小时延迟 9 分钟重启 clash
9 */8 * * * docker restart clash
10 */8 * * * docker restart clash-dashboard

参考

ghostxu97/clash-for-linux: Linux 环境安装配置 Clash 工具，以实现代理上网效果。包含下载、安装、配置、运行、测试以及开机自启动、定期自动更新订阅功能的操作文档，希望对你有所帮助

工作时需要开启多个标签页，在同一个窗口里打开又查找不变，于是分为多个窗口，每个窗口里的标签页工作内容一致。如所有文档放在一个窗口，需要百度，Google 搜索时用单独的一个问题搜索窗口。这样就避免每次打开窗口都要挨个点一遍。

Edge 设置

打开设置-更多工具 - 为窗口命名。即可重命名窗口

Chrome 设置

同上，路径基本一致都是在设置-更多工具中。

升级

在使用过程中发现窗口太多任务栏太挤了，Chrome 自身有标签分组的功能，其实完全可以替代窗口。也可以满足我的需求。少数派有介绍，就不造轮子了。体验一段时间确实很好用。

编码字体首要原则：等宽，等宽，还是 TMD 等宽！

JetBrains Mono

Hack

Source Code Pro

Fira Mono

Consolas

保底字体，基本上 Windows 电脑都有预装。

阅读字体

看多了黑体，其实有衬线的宋体才能体现中文文字之美。

思源宋体

华文中宋

中文等宽字体

对于既想要满足编程字体又想要中文书写的，有几款等宽中文字体也不错。

Sarasa Gothic / 更纱黑体

思源黑体/Source Han Sans

Markdown 的简便性是 LaTeX 无法替代的，LaTeX 对排版的精准控制能力又是 Markdown 无法比拟的。一直在寻找一种能够将 Markdown 优雅地转换成 PDF 的解决方案，虽然早就听说也使用过 Pandoc 这把瑞士军刀，但是它太过强大，以致于一直都没用明白。只会简单的转换命令，但是实际效果并不好，最近学会了使用 LaTeX 模板的功能，这才让我眼前一亮，这才是我想要的结果。

效果演示

基础环境配置

Markdown 生成 PDF 主要需要使用 Pandoc 和 LaTeX 两个工具，具体安装方式如下：

Pandoc 的安装

Pandoc 是由 John MacFarlane 开发的标记语言转换工具，可实现不同标记语言间的格式转换。

• Windows 下的安装：

  • 下载安装包直接安装即可
  • 如果安装了 Chocolate：choco install pandoc
  • 如果安装了 winget：winget install pandoc

• Linux/FreeBSD下的安装：

  • Pandoc 已经包含在大部分 Linux 发行版的官方仓库中，直接使用诸如apt/dnf/yum/pacman之类的安装工具直接安装即可

• macOS 下的安装：

  • brew install pandoc

详细的安装说明参见：官方安装文档

LaTeX 的安装

LaTeX 工具，建议安装 texlive。

• Windows 下的安装：
  • 参考该文章下载完整 texlive，注意安装后需要再安装 cjk，cjk-fonts 等相关 package
• Linux/FreeBSD下的安装：
  • 使用 apt/dnf/yum/pacman/pkg 等安装工具安装 texlive、texlive-latex 等相关软件包
• macOS 下的安装：
  • 使用 HomeBrew 安装 texlive 即可

模板配置

配置 Pandoc 模板

为保证生成的 pdf 格式（自动插入封面、目录页、页眉页脚等信息），在本地环境中安装模板，具体步骤是：

• 下载MPPL: Markdown to PDF with Pandoc via Latex仓库
• 将template/mppl.latex拷贝到*/pandoc/templates目录下
  • Window 下：C:/Users/USERNAME/AppData/Roaming/pandoc/templates，如果Roaming没有pandoc目录，请手动创建！
  • Linux/FreeBSD/MacOS：~/.pandoc/templates/

配置 LaTeX 模板

模板定制主要修改模板最前面的模板基础配置相关内容，主要可修改的包括：

• 公司和组织，目前默认是"MPPL"
• 正文缩进，目前默认是 2em（2 个中文字符，4 个英文字符）
• 主要中文字体和英文字体：目前都是微软雅黑
• 页眉、页脚展示内容，目前是：
  • 左页眉：title
  • 右页眉：“企业机密 - 禁止外传”
  • 左页脚：company
  • 右页脚：页码

字体设置

目前页面默认的字体是微软雅黑，对于非 Windows 系统，可能不存在该字体，则有以下两种解决方案：

1. 手工安装微软雅黑字体（需要 msyh,msyhbd 两个文件）
2. 修改为其他字体，如苹方、文泉驿等

若需要多个团队共同使用，建议采用方案一。

如何生成 PDF

PDF 文件指定 metadata 信息

在每个 Markdown 最前面增加以下主要 metadata 信息，metadata 内容开始行内容为三个“-”，结束行为三个“.”，示例如下：

title: "MPPL"
version: "0.1"
subtitle: "Markdown to PDF with Pandoc via LaTeX"
date: "2022-08"
author: "Dominic"
company: COMPANYNAME
file-code: COMPANY-DEPARTMENT-00000000
logo: true
logo-url: ./img/logo.png
history:
  - version: V0.1
    author: Dominic
    date: 2022-08-19
    desc: 创建文档

其他可选配置项目如下：

• header-left: 左页眉
• header-right: 右页眉
• footer-left: 左页脚
• footer-right: 右页脚
• CJKmainfont: 主要中文字体
• mainfont: 主要字体
• lot: 是否创建表格目录
• lof: 是否创建图片目录

可选配置项中，建议除了 subtitle 外，全部在模板中定制，不在 Markdown 文件中定制

Markdown 其他编写要求

Pandoc 默认使用的 pandoc_markdown 格式，为避免 Markdown 转 pdf 格式异常，在编写 Markdown 的时候有几个原则要求：

• 每个标题前后都必须有空行
• 每个表格前后都必须有空行
• 每个代码块前后收必须有空行
• 每个列表前后必须有空行

总之，不同文本类型之间都要有空行。

生成 PDF 文件

pandoc --listings --pdf-engine=xelatex --template=mppl.latex README.md -o README.pdf

摆脱命令行，优雅的 VSCode 书写转换方案

VSCode 与插件安装

打开 VSCode 编辑器，在插件页搜索 markdown-preview-enhanced，接着点击 Install 按钮。详情参考VS Code 安装 MPE。

Markdown Preview Enhanced 以下简称 MPE

使用 VSCode 书写 Markdown

新建文件以.md为后缀即可开始编辑 Markdown 文件，使用 MPE 实时预览与导出。

配置 MPE 使用 Pandoc 导出

右击 MPE 的预览区域，可以看到 MPE 提供多种导出 PDF 的方案，如使用 Chrome 的 Puppeteer 导出，Prince 导出，Pandoc 导出等等。

在未使用 Pandoc 前，我也一直使用 MPE 提供的 Chrome 方式导出，但是导出的 PDF 排版总是不尽如意。现在介绍如何使用 Pandoc 方式导出。

创建 PDF 文档，你需要在 markdown 文件中的 front-matter 里声明 pdf_document 的输出类型：

---
output:
  pdf_document:
    latex_engine: xelatex
    pandoc_args: [--template=mppl.latex,--listings]
---

• front-matter：文章的最开头，也就是上文元数据放的地方。和元数据放在一起即可，如图所示：

  

• latex_engine：默认情况下 PDF 文档由 pdflatex 生成。你可以用 latex_engine 选项来定义你想用的引擎。支持的引擎有 pdflatex，xelatex，以及 lualatex。这里需要使用xelatex。

• pandoc_args：配置 Pandoc 接受的一些参数，这里我们使用 --template=mppl.latex 和 --listings 来指定模板和使用 listings。这里配置的参数就是执行 Pandoc 时使用的参数，以后就不需要命令行输入了。这里使用上文的mppl.latex模板。

配置完之后，右击预览界面，选择 Pandoc 导出，稍等片刻，即可生成 PDF 文件。

常见问题解决

LaTeX 相关错误

VSCode 导出出错时报错信息较短，并且常常不知道具体报错原因及位置，因为是 LaTeX 转换成 PDF 的过程中出现的错误。报错位置是 LaTeX 中间源码的位置，而不是 VSCode 中的位置。这时候我常用的方法是先将 Markdown 转为 LaTeX，然后再转为 PDF，在 LaTeX 编辑器里就可以看到错误位置了。

比如下面这个错误，我们能看到一些报错信息cant use \spacefactor in math mode，但是并不知道具体哪里的错误。从信息里可以看出和\LaTex有关，大概能推测出是使用了这个命令，因为文章里使用了这个命令的地方只有一处。但是如果有其他的错误，就很难确定了。

Markdown 转换 LaTeX

这里还是以模板仓库的README.md为例，当然这个文件是可以正常转换 PDF 的，不会报错。这里只是拿README.md做一个如何使用命令的演示。

pandoc --listings --template=mppl.latex -s README.md -o README.tex

LaTeX 编辑器打开，以 TexStudio 为例

打开README.tex文件，编译：

我们可以快速的定位到问题出现的位置，只要搜索相关问题即可。

\LaTeX{} 这个宏不能用在数学模式下。但是因为我在 Markdown 里必须使用美元符号$$才能表示 LaTeX 环境，才能正确输出 LaTeX 符号，而 Markdown 转换成 LaTeX 源码时，这个宏就会被包裹在数学环境里，就会报错。如果我想在 PDF 里显示这个符号，那就在 Markdown 里不使用美元符号$$，而是直接输入\LaTeX{}即可，再导出 PDF 时就不会报错。

可以通过配置服务端或客户端的 SSH 来保持 SSH 链接：

方法一：配置服务端

可以在服务端配置，让 server 每隔 30 秒向 client 发送一个 keep-alive 包来保持连接：

vim /etc/ssh/sshd_config

ClientAliveInterval 30
ClientAliveCountMax 60

第二行配置表示如果发送 keep-alive 包数量达到 60 次，客户端依然没有反应，则服务端 sshd 断开连接。如果什么都不操作，该配置可以让连接保持 30s*60，30 min

重启本地 ssh

sudo service ssh restart

如果找不到 ssh,”Failed to restart ssh.service: Unit ssh.service not found.” ，需要安装

sudo apt-get install openssh-server

方法二：配置客户端

如果服务端没有权限配置，或者无法配置，可以配置客户端 ssh，使客户端发起的所有会话都保持连接：

vim /etc/ssh/ssh_config

ServerAliveInterval 30
ServerAliveCountMax 60

本地 ssh 每隔 30s 向 server 端 sshd 发送 keep-alive 包，如果发送 60 次，server 无回应断开连接。

在 VSCode 里可以直接添加配置，效果一样：

Host 11.22.33.44
  HostName 11.22.33.44
  User user
  Port 112343
  ServerAliveInterval 30
  ServerAliveCountMax 60

一直想找一个能够快速同步手机与电脑数据的工具，因为手机云服务的空间少的可怜，所以习惯隔一段时间将手机里的照片、视频还有一些文件导出到电脑上。但是每次备份文件都得连接数据线，并且没法增量备份，得手动挑选，也还挺麻烦的。

逛 GitHub 时，无意间发现了 Syncthing，几乎符合了我所有的预期。

• 开源，免费，自己电脑就可以当服务器，以后入了 NAS，可以自己搭建本地服务器。
• 同步速度快，取决 WIFI 的速度，目前使用 30M/s，基本满速。
• 多端支持，除了 IOS（反正我也没有 iOS 设备，嘿嘿），几乎全平台支持，包括 NAS 及路由器。
• 增量同步，再也不用挑文件备份了。

话不多说，开整。

下载安装

直接进入Syncthing官网，下载安装。在 Ubuntu 下安装参考这里。Android 版本下载Syncthing。

接下来以 Windows 与 Android 手机同步为例，下载安装后，打开syncthing.exe，即可打开管理界面，或者浏览器输入http://127.0.0.1:8384也可进入管理界面。

Windows 界面：

Android 界面：

设备配对

Windows 管理页面->操作->显示 ID，会显示本机的二维码：

Android 手机打开应用，切换到设备界面，点击右上角加号，点击二维码标识，即可扫描二维码，完成设备添加。

如果正确添加，Windows 管理界面会显示 Android 设备：

Android 同步至 Windows

打开 Android 应用，切换到文件夹界面，点击右上角加号，配置同步的文件夹：

根据下图提示，配置应用，记得保存：

点击打开，开启与远程设备 Windows 同步：

当返回时，Windows 端将会弹出通知，提示有 Android 设备的文件要分享到电脑，点击添加：

至此，Android 同步至 Windows 完成。此时在 Android 设备的文件夹中添加任意文件，都会同步到 Windows。

如果是局域网内，发现设备的速度很慢，可以尝试设置静态的 IP。手机端 -> 设备 -> 链接图标。默认为 dynamic，将其改为 Windows 的 IP 和 syncthing 的端口。如tcp://192.168.1.9:22000。

也可以在服务端配置手机的IP，手机IP可以通过设置中心->关于手机->状态->IP地址查看。比如192.168.1.16，那么可以配置为tcp://192.168.1.16:22000。

Windows 同步至 Android

Windows 管理界面，添加文件夹：

点击保存后，与之前类似，Android 会提示有 Windows 设备的文件要分享到 Android，点击添加：

如果 Android 设备没有弹出提示添加共享文件夹，那么打开应用侧边栏->网页管理页面，将会有弹窗，如下图

点击添加，配置文件夹目录等与之前类似。

至此，Windows 同步至 Android 完成。此时在 Windows 设备的文件夹中添加任意文件，都会同步到 Android。

使用技巧

Syncthing 支持三种工作模式

• 发送和接收，Send & Receive Folder，这是文件夹的默认模式，对文件夹的修改会发送，其他设备的修改也会同步回来。
• 仅发送 Send Only，这种模式表示仅仅将当前设备上的文件夹的改动发送到其他设备，用来隐式地表示其他同步设备上的文件不会被修改，或者其他设备上的修改可以被忽略。这种模式非常适合，将当前设备设定为工作设备，然后设定一台设备作为此设备的备份。
  • 在 Send Only 模式下，集群中其他设备的修改都会被忽略，修改依然会接收，文件夹可能会出现 「out of sync」，但是没有修改会被应用到本地。
  • 当 Send Only 文件夹出现 out of sync，那么一个红色的 Override Changes 会出现在文件夹详情中，点击该按钮会强制将当前主机的状态同步到其他剩余节点。任何对文件的修改，都会被当前主机上的版本所覆盖，任何不存在于当前主机节点的文件都会被删除，其他类似。
• 仅接收 Receive Only，这种模式下所有的修改都会被接收并应用，然后重新分发给其他使用 send-receive 模式的设备。但是本地的修改不会被分发给其他设备。这种模式适合于建立备份镜像（replication mirrors），或者备份目的主机的场景，这些情况下不期望有本地修改或者本地的修改是不允许的
  • 当本地文件被删除时，Syncthing 会显示一个 Revert Local Changes 按钮。使用这个按钮会将本地的修改回撤，所有添加的文件会被删除，修改或删除的文件会重新从其他节点同步，比较容易理解，但是假如 A 设备设置仅发送，B 设备设置发送和接收，A 是不会同步 B 的更改的！

忽略特定文件、目录

忽略列表，和 gitignore 类似。每一台设备上的 .stignore 都是分别设置的，不会进行同步。

如果 A 的.stignore忽略了 test ，而 B 没有这样做，实际上会发生这样的事情：

• A 不会扫描和通知 B（广播）关于 test 的变动；
• B 对关于 test 的变动持开放的姿态，但不会收到任何关于 A 上面 test 的变动信息（可能接收到其它同步设备的）；
• B 会扫描 test 以及推送其关于 test 变动的信息，但会被 A 忽略，A 也会忽略其它同步设备关于 test 的信息；
• B 会接收来自其它同步设备推送的关于 test 的信息；

参考资料

Syncthing 又一款同步工具 | Verne in GitHub

Folder Types — Syncthing documentation

公司使用 Gerrit 作为 Review 平台，但是每次提交代码都需要手动添加 Reviewer，还要抄送组内成员，这种重复性劳动，程序员是绝不能容忍的。gerrit 提供了发送邮件的功能。

解决方法

官方示例：

git push ssh://john.doe@git.example.com:29418/kernel/common HEAD:refs/for/experimental%r=a@a.com,cc=b@o.com

最后的%是个分隔符，r='a@a.com表示 Reviewer 是a@a.com，cc=b@o.com表示抄送组内成员是b@o.com。

注意！邮箱之间不能有空格！

以一个仓库为例：

git push origin HEAD:refs/for/branch_dev_name%cc=zhangsan@qq.com,cc=lisi@qq.com,cc=wangerma@qq.com,cc=chenwu@qq.com

但是要这么写，岂不是把操作搞更复杂了。

终极办法，打开项目路径下的.git目录。编辑config文件：

原文件里有如下字段：

[core]
 repositoryformatversion = 0
 filemode = false
 bare = false
 logallrefupdates = true
 ignorecase = true
[remote "origin"]
 url = git@github.com:Dunky-Z/Dunky-Z.github.io.git
 fetch = +refs/heads/*:refs/remotes/origin/*

我们可以将远程仓库名换成容易区分的名字，自己随意：

[core]
 repositoryformatversion = 0
 filemode = false
 bare = false
 logallrefupdates = true
 ignorecase = true
[remote "origin"]
 url = git@github.com:Dunky-Z/Dunky-Z.github.io.git
 fetch = +refs/heads/*:refs/remotes/origin/*
# 以下为新增内容
[remote "review"]
 url = git@github.com:Dunky-Z/Dunky-Z.github.io.git
 fetch = +refs/heads/*:refs/remotes/origin/*
 push =  HEAD:refs/for/%cc=zhangsan@qq.com,
 cc=lisi@qq.com,
 cc=wangerma@qq.com,
 cc=chenwu@qq.com

下次想要推送需要 review 的代码，就直接执行git push review，其中push就相当于：

push HEAD:refs/for/%cc=zhangsan@qq.com,cc=lisi@qq.com,cc=wangerma@qq.com,cc=chenwu@qq.com

参考资料

Gerrit Code Review - Uploading Changes

下载与安装

官网： https://keepass.info/download.html

下载完成后进行安装，默认安装位置是：C:\Program Files (x86)\KeePass Password Safe 2文件夹下，可以根据自己需要选择安装路径。

更改中文语言

中文语言包： KeePass-Chinese_Simplified

将语言包下载后复制到安装路径下的Languages文件夹下，默认为：C:\Program Files (x86)\KeePass Password Safe 2\Languages。重启软件。

点击 View->Change Language. 选择中文简体（Chinese-Simplified）。重启软件，即可完成语言更改。

中文界面：

基本使用

1.创建一个数据库

点击 文件-》新建。弹出对话框为数据库创建管理密码。这个密码是唯一需要记忆的密码。当然如果追求更高的安全性，可以点击显示高级选项，提供更多的密码选项。

2.添加记录

点击添加记录，在弹出的窗口填入相关信息。即可完成密码添加。

如果是第一次使用的网站，第一次注册密码。可以通过密码生成器，生成一个高强度的密码来添加记录。

3.创建一个密码生成模板

正常国内的网站可以使用的密码长度 6-16 位，可以使用大小写，数字，下划线。我们把这些选项勾选，密码长度设置 16 位。

点击保存并给模板设置个名字方便下次使用

如果保存后想更改一下，比如再加个可以使用空格，可以重新勾选刚刚的选项，保存时点击小三角，选择刚刚保存的方案就可以覆盖。

导入 Chrome 已保存的密码

很多小伙伴在使用 KeePass 之前肯定在 Chrome 等浏览器里也保存了很多密码。想将其导入 KeePass 方便管理。Chrome 是可以导出密码的，KeePass 也可以导入密码。

点击浏览器右上角，打开设置界面。找到密码

找到已保存的密码-》导出密码。选择方便找到的路径，保存密码记录。

打开 KeePass，点击文件-》导入，选择 Chrome 浏览器的格式。点击文件夹图标找到刚刚导出的密码文件。

高级配置

KeePass 搭配坚果云实现云同步

登录坚果云创建个人同步文件夹，若没有先注册。

最好单独建一个专门的文件夹

将已经生成的数据库上传到这个文件夹下

点击右上角进入账户信息，点击安全选项：

点击添加应用

输入应用名称，应用名称只是方便区分作用，所以和要同步的应用名称一致就好：

点击生成密码：

此时云盘端配置完成，切回到 KeePass 进行客户端配置。点击文件-》同步-》与网址（URL）同步

网址： https://dav.jianguoyun.com/dav/KeePass/keepassData.kdbx

注意：红色部分是个人同步文件夹的名称，绿色部分是上传的数据库全称，一定别忘了后缀

**用户名：**你的坚果云登录名（邮箱或者手机号）

密码：生成应用的密码，（不是登录坚果云的密码）

点击确定，此时已经可以完成同步，但是每次同步仍然需要手动确定。参考了什么值得买上小乐 CSN的方法，通过触发器实现自动同步。

触发器代码：

<?xml version="1.0" encoding="utf-8"?>
<TriggerCollection xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <Triggers>
                <Trigger>
                        <Guid>L2euC7Mr/EKh7nPjueuZvQ==</Guid>
                        <Name>SaveSync</Name>
                        <Events>
                                <Event>
                                        <TypeGuid>s6j9/ngTSmqcXdW6hDqbjg==</TypeGuid>
                                        <Parameters>
                                                <Parameter>1</Parameter>
                                                <Parameter>kdbx</Parameter>
                                        </Parameters>
                                </Event>
                        </Events>
                        <Conditions />
                        <Actions>
                                <Action>
                                        <TypeGuid>tkamn96US7mbrjykfswQ6g==</TypeGuid>
                                        <Parameters>
                                                <Parameter>SaveSync</Parameter>
                                                <Parameter>0</Parameter>
                                        </Parameters>
                                </Action>
                                <Action>
                                        <TypeGuid>Iq135Bd4Tu2ZtFcdArOtTQ==</TypeGuid>
                                        <Parameters>
                                                <Parameter>https://dav.jianguoyun.com/dav/keePass/passwordSync.kdbx</Parameter>
                                                <Parameter>123456</Parameter>
                                                <Parameter>123456</Parameter>
                                        </Parameters>
                                </Action>
                                <Action>
                                        <TypeGuid>tkamn96US7mbrjykfswQ6g==</TypeGuid>
                                        <Parameters>
                                                <Parameter>SaveSync</Parameter>
                                                <Parameter>1</Parameter>
                                        </Parameters>
                                </Action>
                        </Actions>
                </Trigger>
        </Triggers>
</TriggerCollection>

复制触发器代码，点击工具-》触发器，点击工具-》从剪切板粘贴触发器：

导入成功后，在触发器页面会多一个触发器：

双击打开SaveSync,打开最后一个动作窗口：

双击中间的条目：

将信息换成同步云盘的信息：

文件/网址： https://dav.jianguoyun.com/dav/KeePass/keepassData.kdbx

注意：红色部分是个人同步文件夹的名称，绿色部分是上传的数据库全称，一定别忘了后缀

**IO 连接 - 用户名：**你的坚果云登录名（邮箱或者手机号）

IO 连接 - 密码：生成应用的密码，（不是登录坚果云的密码）

点击确定，回到主页面，点击工具-》选项

找到 高级，向下翻，在文件输入/输出连接 栏目里找到 写入数据库时使用文件交换 此项不勾选

点击确定，返回主页面。此时点击保存按钮或者 Ctrl+S。即可与云盘进行同步。

Chrome 上使用插件实现密码自动填充与同步

在 KeePass 客户端安装KeePassRPC 插件：

将其放入安装目录（.\KeePass\Plugins）文件夹下，退出软件，重启即可自动安装。

在浏览器客户端安装浏览器插件Kee，若无法科学上网，可能需要自行百度搜索 Kee 插件

安装完成后会跳出窗口提示授权，将 KeePass 客户端跳出的窗口中的红色授权码填入即可连接浏览器：

使用 Kee

再次使用浏览器填写密码是可以看到文本框会有 logo，Kee 会自动填写已保存的密码。如果第一次登陆，在登录后可以点击浏览器插件图标，找到 Save latest login，保存刚刚输入的密码。

密码管理器的重要作用之一就是生成高强度密码，可以用 KeePass 客户端来生成，也可以是 Kee 这个插件的一个生成密码功能生成。英文版的是Generate new password

下载原有图片

从gitee下载整个仓库。保持原有目录结构。

配置腾讯云 COS

注册腾讯云账号，创建 COS 存储桶，选择公有读私有写。创建 COS 存储桶地址：https://console.cloud.tencent.com/cos，创建存储桶后可以在存储桶里打开防盗链设置。

创建桶–选择地域–填写名称–选择公有读私有写–点击创建。

如果忘了设置读写权限可以按一下方法设置；

选择菜单–文件列表。上传下载好的文件夹（整个仓库的文件夹）。鼠标放到选择文件出现上传文件夹选项，或者将文件夹拖入浏览器。

配置 Picgo

COS 版本：V5 设定 Secreid，设定 Secrekey，设定 APPID： APPID、SecretID 与 SecretKey 点此直达获取。 选择继续使用–创建秘钥。

设定存储空间名，设定存储区域： 点此获取存储空间名以及存储区域。桶名称即存储空间名，所属区域：ap-shanghai即确认存储区域。

指定存储区域： 指定上传到 COS 的目录，比如我原先从gitee下载来的图床的仓库名是markdown_picbed，图片又保存在markdown_picbed/img目录下，那么就指定markdown_picbed/img目录。

替换旧图床 URL

VSCode 全局替换：

一些常用的离线软件在重新安装，重装电脑或者更好环境时，调教好的配置总需要重新设置一遍，甚是麻烦。但是这些设置通常都保存在配置文件里，只要能备份好这些配置文件，下次重装后覆盖就可以恢复所需设置。

现在的问题就是如何备份这些配置文件，可以选择各类网盘，硬盘等等。但是这些多少都有点炮打蚊子，小题大做。而且定时备份也不是很方便。既然配置文件都很小，其实就是个文本文件，那有个万能免费存储地 GitHub 就派上用场了。我们只要把配置文件定时 push 到 GitHub 即可，以后随时可以 clone 下来。

首先建立一个私密仓库，用来专门存放配置文件。其次通过批处理命令，将配置文件复制到本地仓库的文件夹下。最后设置定时任务。

折腾过程

新建仓库

这一步不用赘述了，主要就是要勾选私密仓库，保护隐私，一些配置文件可能会包含个人信息。

批处理

将仓库克隆到本地后就是个文件夹，这一步主要就是如何能把安装在不同位置的软件的配置文件，都汇集到这个仓库下。通过批处理命令可以快速，方便的完成。

echo Start backup config files! # 打印这句话

copy D:\Tools\MouseInc\MouseInc.json  D:\Develop\fxxk-config\mouseinc # 将前者复制到后者

copy D:\Tools\JD\Config.ini  D:\Develop\fxxk-config\jd

cd  /d D:\Develop\fxxk-config # 切换目录

# git推送的一些命令
git add .   
git commit -m "update"
git push

# 防止窗口闪退
pause

一些常用命令参考WindowDos 批处理指导。

定时任务

控制面板-管理工具 - 任务计划程序

Linux

sudo apt-get install clang-format

windows

每每到这时候就越能感受到用 Linux 作为开发环境的优势，Windows 安装就稍显复杂了。

1. 你可以选择安装完整的 LLVM，在bin目录可以看到clang-format.exe。安装完后，将 bin 目录添加到环境变量中。

2. 你也可以只下载clang-format.exe，从LLVM Snapshot Builds下载安装包。在下载页面的底部。同样你需要将单独下载的文件加入到环境变量中。

   

使用

入门使用

Linux 可以直接命令行，使用以 LLVM 代码风格格式化main.cpp, 结果直接写到main.cpp

clang g-format -i main.cpp -style=LLVM

进阶配置

如果每次编码都命令行执行一遍那也太麻烦了，而且每次修改也不止一个文件。最好的方式就是每次保存文件时自动格式化。比如 VSCode 已经内置了Clang-Format稍作配置即可实现，接下来介绍几种常见 IDE 如何配置Clang-Format。

VSCode

VSCode 最常用，因为内置了Clang-Format也最容易配置。

• 安装C/C++插件，Ctrl+Shift+X打开应用商店，搜索C/C++找到下图插件，安装后会自动安装Clang-Format程序，无需单独下载。默认安装路径为： C:\Users\(你的用户名)\.vscode\extensions\ms-vscode.cpptools-1.7.1\LLVM\bin\clang-format.exe。
  
• 打开设置页面（左下角齿轮 - 设置），搜索format，勾选Format On Save，每次保存文件时自动格式化文档。下方的设置是决定每次格式化是整个文档，还是做过修改的内容。默认是file，对整个文档进行格式化。
  
• 仍在设置页面搜索Clang，配置如下。.clang-format文件最后详解。
  
• 效果图
  

QtCreator

• 安装Beautifier插件：帮助（Help）-关于插件（About Plugins）- Beautifier勾选，重启 QtCreator。
  
• 工具（Tool）- Beautifier，配置如图。该配置，保存文档时自动格式化，并选择Clang-Format作为格式化工具。
  
  配置Clang-Format程序路径，如果开头已经apt install安装过，这里会自动补全。
  
• Use predefined style可以选择内置的一些代码风格，如LLVM，Google等。
• Use customized style使用自定义的一些代码风格。点击添加（Add）将配置文件粘贴进去即可，具体配置文件见最后。
• 别忘了点击OK保存。

Eclipse

• 安装cppstyle插件：Help - Eclipse Marketplace - 搜索cppstyle。

• 下载cpplint。 可以去github上下载cpplint的源码，下载完之后解压放到某个目录下。

• 在Window - Preferences - C/C++ - CppStyle页面把clang-format的路径添加进去，然后把cpplint的目录指向刚才下载的styleguide目录下的cpplint/cpplint.py就可以了。勾选下面的Enable cpplint，Run clang-format on file save，然后点击Apply and Close保存修改并退出。如下图所示。

  

• 此时再保存代码，将会出现如下错误，因为我们还未给当前项目编写配置文件.clang-format。将最后一章提到的配置文件放到当前项目的下即可，程序会自动搜索。

  Cannot find .clang-format or _clang-format configuration file under any level parent directories of path.
  Clang-format will default to Google style.
  

配置简介

上文多次提到了.clang-format配置文件，该文件决定了代码如何格式化，现在来介绍如何使用该文件。

导出.clang-format文件

如果重新编写一份配置文件，需要考虑的东西太多，clang-format内置了一些常见风格，我们可以根据已有的配置文件稍作修改，形成自己的代码风格。所以我们先导出一份内置的配置文件。

clang-format -style=可选格式名 -dump-config > .clang-format
# 可选格式最好写预设那那几个写最接近你想要的格式。比如我想要接近 Google C++ style 的。我就写-style=google

各个选项的含义

这里给出了配置的含义，感兴趣也可以查看官方文档，还提供了一些有案例，描述更清晰。

一些比较明显的代码分格区别

# 括号是分行，还是不分行，只有当 BreakBeforeBraces 设置为 Custom 时才有效
BraceWrapping:
  AfterCaseLabel:  true
  # class 定义后面
  AfterClass:      true
  # 控制语句后面
  AfterControlStatement: true
  AfterEnum:       true
  AfterFunction:   true
  AfterNamespace:  true
  AfterObjCDeclaration: true
  AfterStruct:     true
  AfterUnion:      true
  AfterExternBlock: true
  BeforeCatch:     true
  BeforeElse:      true
  # 缩进大括号，if else 语句后面的括号缩进
  IndentBraces:    false
  SplitEmptyFunction: true
  SplitEmptyRecord: true
  SplitEmptyNamespace: true
BreakBeforeBinaryOperators: None
BreakBeforeBraces: Custom

# tab 宽度
TabWidth: 4

# 换行缩进字符数
IndentWidth:     4

# 宏定义对齐
AlignConsecutiveMacros: AcrossEmptyLinesAndComments

基于LLVM代码风格修改的个人使用版本：

---
Language:        Cpp
# BasedOnStyle:  LLVM
AccessModifierOffset: -2
AlignAfterOpenBracket: Align
# 宏定义对齐
AlignConsecutiveMacros: AcrossEmptyLinesAndComments
AlignConsecutiveAssignments: true
AlignConsecutiveDeclarations: true
AlignConsecutiveBitFields: true
AlignEscapedNewlines: Right
AlignOperands:   true
AlignTrailingComments: true
AllowAllArgumentsOnNextLine: true
AllowAllConstructorInitializersOnNextLine: true
AllowAllParametersOfDeclarationOnNextLine: true
AllowShortBlocksOnASingleLine: Never
AllowShortCaseLabelsOnASingleLine: false
# 是否允许短方法单行，只有一行的函数将不会分行，直接写在函数名后
AllowShortFunctionsOnASingleLine: false
AllowShortLambdasOnASingleLine: All
AllowShortIfStatementsOnASingleLine: Never
AllowShortLoopsOnASingleLine: false
AlwaysBreakAfterDefinitionReturnType: None
AlwaysBreakAfterReturnType: None
AlwaysBreakBeforeMultilineStrings: false
AlwaysBreakTemplateDeclarations: MultiLine
BinPackArguments: true
BinPackParameters: true
# 括号是分行，还是不分行，只有当 BreakBeforeBraces 设置为 Custom 时才有效
BraceWrapping:
  AfterCaseLabel:  true
  # class 定义后面
  AfterClass:      true
  # 控制语句后面
  AfterControlStatement: true
  AfterEnum:       true
  AfterFunction:   true
  AfterNamespace:  true
  AfterObjCDeclaration: true
  AfterStruct:     true
  AfterUnion:      true
  AfterExternBlock: false
  BeforeCatch:     true
  BeforeElse:      true
  # 缩进大括号
  IndentBraces:    false
  SplitEmptyFunction: true
  SplitEmptyRecord: true
  SplitEmptyNamespace: true
BreakBeforeBinaryOperators: None
BreakBeforeBraces: Custom
BreakBeforeInheritanceComma: false
BreakInheritanceList: BeforeColon
BreakBeforeTernaryOperators: true
BreakConstructorInitializersBeforeComma: false
BreakConstructorInitializers: BeforeColon
BreakAfterJavaFieldAnnotations: false
BreakStringLiterals: true
ColumnLimit:     100
CommentPragmas:  '^ IWYU pragma:'
CompactNamespaces: false
ConstructorInitializerAllOnOneLineOrOnePerLine: false
ConstructorInitializerIndentWidth: 4
ContinuationIndentWidth: 4
Cpp11BracedListStyle: true
DeriveLineEnding: true
DerivePointerAlignment: false
DisableFormat:   false
ExperimentalAutoDetectBinPacking: false
FixNamespaceComments: true
ForEachMacros:
  - foreach
  - Q_FOREACH
  - BOOST_FOREACH
IncludeBlocks:   Preserve
IncludeCategories:
  - Regex:           '^"(llvm|llvm-c|clang|clang-c)/'
    Priority:        2
    SortPriority:    0
  - Regex:           '^(<|"(gtest|gmock|isl|json)/)'
    Priority:        3
    SortPriority:    0
  - Regex:           '.*'
    Priority:        1
    SortPriority:    0
IncludeIsMainRegex: '(Test)?$'
IncludeIsMainSourceRegex: ''
IndentCaseLabels: false
IndentGotoLabels: true
IndentPPDirectives: None
# 换行缩进字符数
IndentWidth:     4
IndentWrappedFunctionNames: false
JavaScriptQuotes: Leave
JavaScriptWrapImports: true
KeepEmptyLinesAtTheStartOfBlocks: true
MacroBlockBegin: ''
MacroBlockEnd:   ''
MaxEmptyLinesToKeep: 1
NamespaceIndentation: None
ObjCBinPackProtocolList: Auto
ObjCBlockIndentWidth: 0
ObjCSpaceAfterProperty: false
ObjCSpaceBeforeProtocolList: true
PenaltyBreakAssignment: 2
PenaltyBreakBeforeFirstCallParameter: 19
PenaltyBreakComment: 300
PenaltyBreakFirstLessLess: 120
PenaltyBreakString: 1000
PenaltyBreakTemplateDeclaration: 10
PenaltyExcessCharacter: 1000000
PenaltyReturnTypeOnItsOwnLine: 60
PointerAlignment: Right
ReflowComments:  true
SortIncludes:    true
SortUsingDeclarations: true
SpaceAfterCStyleCast: false
SpaceAfterLogicalNot: false
SpaceAfterTemplateKeyword: true
SpaceBeforeAssignmentOperators: true
SpaceBeforeCpp11BracedList: false
SpaceBeforeCtorInitializerColon: true
SpaceBeforeInheritanceColon: true
SpaceBeforeParens: ControlStatements
SpaceBeforeRangeBasedForLoopColon: true
SpaceInEmptyBlock: false
SpaceInEmptyParentheses: false
SpacesBeforeTrailingComments: 1
SpacesInAngles:  false
SpacesInConditionalStatement: false
SpacesInContainerLiterals: true
SpacesInCStyleCastParentheses: false
SpacesInParentheses: false
SpacesInSquareBrackets: false
SpaceBeforeSquareBrackets: false
Standard:        Latest
StatementMacros:
  - Q_UNUSED
  - QT_REQUIRE_VERSION
TabWidth:        8
UseCRLF:         false
UseTab:          Never
...

格式化最新的commit代码

clang-format还提供一个clang-format-diff.py脚本，用来格式化patch，code review提交代码前，跑一遍下面的代码。

// 格式化最新的 commit，并直接在原文件上修改
git diff -U0 HEAD^ | clang-format-diff.py -i -p1

常见问题

如何看懂官方文档并编写配置文件

官方文档里有各种设置的示例代码，即使不知道想要的格式化是哪个配置参数，翻一翻官方文档是示例大概率能找到。那么找到了想要的配置参数，如何在文件里配置呢？

以宏定义对齐为例。我们想要宏定义的值保持对齐的状态，如下一节图片所示。可以翻一遍官方文档，可以发现这个示例代码对应的参数可能是我们想要的，AlignConsecutiveMacros翻译为对齐连续的宏定义。那应该八九不离十了。

找到了参数如何编写配置文件呢？可以继续看这个参数下面的更多示例，每一个示例都对应一个配置可能值Possible values。

• ACS_None (in configuration: None) Do not align macro definitions on consecutive lines. ACS_None为这个配置的缩写，None表示在配置文件里的值。该配置表示不对宏定义进行对齐操作，在配置文件里可以添加如下：

  AlignConsecutiveMacros: None
  

• ACS_Consecutive (in configuration: Consecutive) Align macro definitions on consecutive lines. This will result in formattings like:

  #define SHORT_NAME       42
  #define LONGER_NAME      0x007f
  #define EVEN_LONGER_NAME (2)
  
  #define foo(x) (x * x)
  /* some comment */
  #define bar(y, z) (y + z)
  

  ACS_Consecutive为这个配置的缩写，Consecutive表示在配置文件里的值。该配置表示对连续的宏定义进行对齐，在配置文件里可以添加如下：

  AlignConsecutiveMacros: Consecutive
  

宏定义对齐失效

# 宏定义对齐
AlignConsecutiveMacros: AcrossEmptyLinesAndComments

使用宏定义对齐更详细的配置，可以参考官方文档。使用该配置一定要使用等宽的字体，否则配置生效但是显示不正确。 比如我是用微软雅黑字体作为编码字体，因为该字体每个字符不等宽，导致格式化正确，但是显示不正确。

如果将字体换位等宽字体如常用的Consolas，就可以正常显示。

主题：evan

主题：dallas

主题：robbyrussell

如果原先其他电脑安装过

把.oh-my-zsh整个文件夹，.zshrc，.zsh_history复制到/home/user/目录；

安装zsh

sudo apt install zsh

切换shell

chsh -s /bin/zsh

source ~/.zshrc

即可使用。所有配置都会和原先一样。

如果是新安装

官方方法，curl和wget二选一即可

curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh
wget -O- https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh

应该也有人和我一样，可能会遇到连接 GitHub 失败的问题，要不就是 SSL 验证失败，要不就是连接无响应。可以更换下面的方法。

# 先下载
git clone git://github.com/robbyrussell/oh-my-zsh.git ~/.oh-my-zsh
## 再替换
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

重启终端即可成功。

如果无法访问 GitHub，其实oh-my-zsh并不需要安装，完整的工程就是oh-my-zsh本体，只要想办法把整个工程下载下来，并重命名为oh-my-zsh即可。所以找找 gitee 有没有相关工程。这也是为什么从旧电脑里直接复制.oh-my-zsh就能用的原因。

插件安装

自动补全命令

git clone https://github.com/zsh-users/zsh-autosuggestions ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions

plugins=(
        zsh-autosuggestions
        )

彩色ls

sudo apt install lsd

如果没有软件包，说明系统版本老旧，可以直接前往https://github.com/lsd-rs/lsd/releases下载二进制包安装：

sudo dpkg -i lsd-musl_1.1.5_amd64.deb

添加别名：

alias ls='lsd'
alias l="ls -l"
alias ll='ls -al'
alias la='ls -a'
alias lt='ls --tree'

命令行命令高亮

git clone https://github.com/zdharma-continuum/fast-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/fast-syntax-highlighting

plugins=(
        fast-syntax-highlighting
        )

别名提示纠正

如果命令有缩写别名，提示下次使用建议的别名。

git clone https://github.com/MichaelAquilina/zsh-you-should-use.git  ~/.oh-my-zsh/custom/plugins/you-should-use

plugins=(
        git
        extract
        sudo
        z
        thefuck
        zsh-autosuggestions
        you-should-use
        fast-syntax-highlighting
        )

问题

oh-my-zsh.sh parse error near `«<'

一般是在更新oh-my-zsh时出现，因为更新相当于就是从远程拉取了内容，可能本地的oh-my-zsh.sh脚本自己做了修改与远程冲突了。只要退回上个版本，重新拉取就可以了。

cd $ZSH
git reset --hard HEAD^
git pull --rebase

如果本地修改了一些内容需要保留，可以打开oh-my-zsh.sh看看冲突在哪，自己做个备份，保存一下。