{"version":"https://jsonfeed.org/version/1.1","title":"方寸之間 - 居善地，心善淵，與善仁，言善信，正善治，事善能，動善時。","home_page_url":"https://smj.im","feed_url":"https://smj.im/feed.json","items":[{"id":"/blog/repair-archlinux-kernel","url":"/blog/repair-archlinux-kernel","title":"修复 Arch Linux 的内核缺失问题","content_html":"## 起因\n\n早上打开电脑，Terminal 久违地更新一下系统，因为太久没更新，很多要更新的包，所以更新的时候打开浏览器去做别的事了，结果还没看两分钟，电脑突然黑屏了。。。什么反应都没有，但是能听到电脑还在转，也没多想，我就直接强制关机了。结果，再启动电脑，进入 grub 界面，直接不动了（一般默认 5s 自动选择），手动选择，提示：\n\n```\nLoading kernel linux-zen\nerror: file '/boot/vmlinuz-linux-zen' not found\nLoading initial ramdisk\nerror: you need to load the kernel first\nPress any key to continue...\n```\n\n猜测应该是因为更新内核的时候电脑被强制关机导致内核出问题了。在 Arch Linux BBS 上找到了一些解决方案，这里记录一下。\n\n> 我使用的是`linux-zen`内核，所以后面的相关内容都有`-zen`后缀，这个根据你自己的配置更改，一般安装的都是`linux`内核，去掉`-zen`后缀即可。\n\n## 解决方案\n\n### 使用 Arch Linux 安装介质\n\n1. 进入 live 环境后，连接网络，我用的是 iwd\n\n```shell\n[root@archiso]# iwctl\n[iwd]# station wlan0 connect wifi-ssid # 连接指定 Wi-Fi\n[iwd]# station wlan0 show # 确认是否连接成功\n[iwd]# exit\n```\n\n2. 挂载`/`和`boot`分区\n\n```shell\nmount /dev/sdaX /mnt\nmount /dev/sdaY /mnt/boot\n```\n\n3. chroot 系统，重新安装内核\n\n```shell\narch-chroot /mnt\npacman -S linux-zen\n```\n\n4. 重新生成 grub 引导\n\n```shell\ngrub-mkconfig -o /boot/grub/grug.cfg\n```\n\n5. 取消挂载分区，重启\n\n```sh\nexit\numount -R /mnt\nreboot\n```\n\n启动之后，就可以正常进入系统了。\n\n### grub 命令行\n\n这个方法和上面的类似，不过不用使用安装介质\n\n#### 确认`/`分区位置\n\n1. 使用`ls`列出电脑上所有硬盘，输出类似：\n\n```sh\ngrub>ls\n(hd0) (hd0, gpt1) ...... (hd1, gpt4)\n```\n\n2. 确认`/`分区，可以使用`cat`/`ls`命令+`Tab`测试，例如：\n\n```sh\ngrub>ls (hd0,gpt3)/ TAB\nboot usr ....\n```\n\n上面的输出说明`(hd0,gpt3)`是 `/` 分区。\n\n#### 手动加载内核\n\n1. 设置根分区和 grub 路径前缀\n   假设`(hd0,gpt3)`是根分区：\n\n```shell\ngrub>set root=(hd0,gpt3)\ngrub>set prefix=(hd0,gpt3)/boot/grub\n```\n\n2. 加载内核和系统镜像\n\n```shell\ngrub>cat (hd0,gpt3)/boot/grub/grub.cfg #确认`/`分区的设备名称，假设是`/dev/sda3`\ngrub>linux /boot/vmlinuz-linux-zen root=/dev/sda3\ngrub>initrd /boot/initrd-linux-zen.img\n```\n\n3. 启动系统\n\n```shell\ngrub>boot\n```\n\n4. 重新配置 grub\n   启动之后，按照[第一种方法](#使用-arch-linux-安装介质)的第 2、4、5 步，在命令行下重新生成一下 grub.cfg 文件即可。\n\n## 参考链接\n\n[https://bbs.archlinux.org/viewtopic.php?id=274616](https://bbs.archlinux.org/viewtopic.php?id=274616)\n\n[https://wiki.archlinux.org/title/GRUB#Using_the_command_shell](https://wiki.archlinux.org/title/GRUB#Using_the_command_shell)","date_published":"2023-08-20T01:20:07.000Z"},{"id":"/blog/build-vim-from-source","url":"/blog/build-vim-from-source","title":"安装定制化 Vim","content_html":"以前在使用 Vim 编写代码的时候就发现，Vim\nyank 的内容无法直接进入系统剪切板，稍微 Google 了以下发现好像需要使用第三方软件（Linux 上的 xclip 或者 MacOS 上的 pbcopy），懒得折腾，就新开一个 Terminal，然后 cat 出来文件内容，拷贝需要的内容然后使用（没想到吧;D）。\n\n最近在折腾 Vim 环境的时候，又发现了这个问题，这下不能忍了，所以索性找找有没有简单的解决方法。最后勉强找到了几个我认为比较简单的解决方法。\n\n## 0. 确认是否带有剪切板特性\n\n```bash\nvim --version | grep clipboard\n```\n\n如果输出`+clipboard`代表有剪切板特性，恭喜你，可以直接下拉进入文末；如果出现`-clipboard`则说明没有，那你可以接着往下看。\n\n## 1. 使用 gvim\n\n直接安装 gvim，带有命令行版本的 Vim 是支持剪切板特性的。\n\n```bash\nsudo pacman -S gvim\n```\n\n## 2. 使用 Arch Linux 社区的第三方源仓库\n\n> 鲁迅曾说：遇事不决，上 Arch wiki。\n\n官方 wiki 的 Vim 界面提到了一个 Unofficial Repository\n`herecura`，这是一个个人维护的源仓库，里面是一些个人编译的 Linux 软件。\n\n将以下内容加入`/etc/pacman.conf`：\n\n```txt title='/etc/pacman.conf'\n[herecura]\nServer = https://repo.herecura.eu/$repo/$arch\n```\n\n然后安装`vim-cli`：\n\n```bash\nsudo pacman -Syu\nsudo pacman -S vim-cli\n```\n\n## 3. AUR 安装\n\n- 如果你对 AUR 了解比较多，可以尝试自己构建 PKGBUILD 文件。\n\n- 如果不了解也没关系，我们可以直接找现成的。可以选择直接修改 Arch Linux 官方的 PKGBUILD，在这基础上加入 clipboard 功能支持。\n\ni. 克隆官方的 Vim 包构建仓库：\n\n```bash\ngit clone https://gitlab.archlinux.org/archlinux/packaging/packages/vim.git\n```\n\nii. 修改`PKGBUILD`文件，修改`--with-x`为`yes`，为了节省时间，可以去掉 gvim 的构建。\n\n<details>\n<summary>点击这里查看修改后的`PKGBUILD`内容</summary>\n\n<!-- [点击这里复制](https://pb.oii.im/R66p) -->\n\n```txt title='PKGBUILD'\npkgbase=vim\npkgname=('vim' 'vim-runtime')\npkgver=9.0.1678\n_versiondir=90\npkgrel=1\npkgdesc='Vi Improved, a highly configurable, improved version of the vi text editor'\nurl='https://www.vim.org'\narch=('x86_64' 'x86_64_v3')\nlicense=('custom:vim')\nmakedepends=('glibc' 'libgcrypt' 'gpm' 'python' 'ruby' 'libxt' 'gtk3' 'lua'\n         'gawk' 'tcl' 'zlib' 'libcanberra')\nsource=(https://github.com/vim/vim/archive/v${pkgver}/${pkgbase}-${pkgver}.tar.gz fix-perl-build.patch\n    vimrc\n    archlinux.vim\n    vimdoc.hook)\nsha256sums=('e0b52a997b4f6180c5d8a5dae717075d99650c3e2e7761d1878a3dd7011ec315'\n        'f79c2afd26bbe0b21375293203d8f0e8dad2424146014ceafc4e8eca6ecf7d39'\n        'b16e85e457397ab2043a7ee0a3c84307c6b4eac157fd0b721694761f25b3ed5b'\n        'cc3d931129854c298eb22e993ec14c2ad86cc1e70a08a64496f5e06559289972'\n        '8e9656934d9d7793063230d15a689e10455e6db9b9fe73afa0f294792795d8ae')\nsha512sums=('c5ffb7ca56ff4eee70f06599dd84db2eb28ddadac229d4f7faf01174805923636a4ce61486bdf5a47910c929613dc9b9290dfc9288006222b4bc4ac891548bb8'\n        '184dd232db5b4a346e9751e58ad0a9b2f60d50d1a2aa2050415d288445606d80c239745f0d8987ff822d2acf6826104a81f8e59c8f1785095d1f319c0fe4abf0'\n        '4b5bed0813f22af9e158ea9aa56a4a9862dd786ba2d201f20159ccf652da6190164aaed0b6b7217d578f7b25c33a8adcc307bfcf3caa8d173a7ff29e2a00fee7'\n        'fe091d289d876f45319c898f6021ef86d6a238b540c225a279c46efc5c36fa7d868cd0cee73a111811c4be90df160f85340bb251be3a437727dbe5c699950363'\n        'a02ad0d66f300160911aeb81d8886c6c558436ac4ee3fcd161dd65c6b1e5d1f41b9005a7f5bb5ba68d57027fc1c8e43daabf055bd6207fb5a216a67f758df8d1')\n\nprepare() {\n  (cd vim-${pkgver}/src\npatch -Np2 -i ../../fix-perl-build.patch\n# define the place for the global (g)vimrc file (set to /etc/vimrc)\nsed -E 's|^.*(#define SYS_.*VIMRC_FILE.*\").*$|\\1|g' -i feature.h\nsed -E 's|^.*(#define VIMRC_FILE.*\").*$|\\1|g' -i feature.h\nautoconf\n  )\n  cp -a vim-${pkgver} gvim-${pkgver}\n}\n\nbuild() {\n  echo \"Building vim...\"\n  (cd vim-${pkgver}\n./configure \\\n  --prefix=/usr \\\n  --localstatedir=/var/lib/vim \\\n  --with-features=huge \\\n  --with-compiledby='Arch Linux' \\\n  --enable-gpm \\\n  --enable-acl \\\n  --with-x=yes \\ # 这里改为 yes\n  --disable-gui \\\n  --enable-multibyte \\\n  --enable-cscope \\\n  --enable-netbeans \\\n  --enable-perlinterp=dynamic \\\n  --enable-python3interp=dynamic \\\n  --enable-rubyinterp=dynamic \\\n  --enable-luainterp=dynamic \\\n  --enable-tclinterp=dynamic \\\n  --disable-canberra\nmake\n  )\n}\n\ncheck() {\n  cd vim-${pkgver}\n  TERM=xterm make -j1 test\n}\n\npackage_vim-runtime() {\n  pkgdesc+=' (shared runtime)'\n  optdepends=('sh: support for some tools and macros'\n          'python: demoserver example tool'\n          'gawk: mve tools upport')\n  backup=('etc/vimrc')\n\n  cd vim-${pkgver}\n\n  make -j1 VIMRCLOC=/etc DESTDIR=\"${pkgdir}\" install\n  # man and bin files belong to 'vim'\n  rm -r \"${pkgdir}\"/usr/share/man/ \"${pkgdir}\"/usr/bin/\n\n  # Don't forget logtalk.dict\n  install -Dm 644 runtime/ftplugin/logtalk.dict \\\n\"${pkgdir}\"/usr/share/vim/vim${_versiondir}/ftplugin/logtalk.dict\n\n  # rc files\n  install -Dm 644 \"${srcdir}\"/vimrc \"${pkgdir}\"/etc/vimrc\n  install -Dm 644 \"${srcdir}\"/archlinux.vim \\\n\"${pkgdir}\"/usr/share/vim/vimfiles/archlinux.vim\n\n  # no desktop files and icons\n  rm -r \"${pkgdir}\"/usr/share/{applications,icons}\n\n  # license\n  install -dm 755 \"${pkgdir}\"/usr/share/licenses/vim-runtime\n  ln -s /usr/share/vim/vim${_versiondir}/doc/uganda.txt \\\n\"${pkgdir}\"/usr/share/licenses/vim-runtime/license.txt\n\n  # pacman hook for documentation helptags\n  install -Dm 644 \"${srcdir}\"/vimdoc.hook \"${pkgdir}\"/usr/share/libalpm/hooks/vimdoc.hook\n}\n\npackage_vim() {\n  # TODO: move perl back into optdeps after --enable-perlinterp=dynamic\n  #       starts working again (https://github.com/vim/vim/issues/10512)\n  depends=(\"vim-runtime=${pkgver}-${pkgrel}\" 'gpm' 'acl' 'glibc' 'libgcrypt' 'zlib' 'perl')\n  optdepends=('python: Python language support'\n          'ruby: Ruby language support'\n          'lua: Lua language support'\n          #'perl: Perl language support'\n          'tcl: Tcl language support')\n  conflicts=('gvim' 'vim-minimal')\n  provides=('xxd' 'vim-minimal' 'vim-plugin-runtime')\n  replaces=('vim-minimal')\n\n  cd vim-${pkgver}\n  make -j1 VIMRCLOC=/etc DESTDIR=\"${pkgdir}\" install\n\n  # provided by (n)vi in core\n  rm \"${pkgdir}\"/usr/bin/{ex,view}\n\n  # delete some manpages\n  find \"${pkgdir}\"/usr/share/man -type d -name 'man1' 2>/dev/null | \\\nwhile read _mandir; do\ncd \"${_mandir}\"\nrm -f ex.1 view.1 # provided by (n)vi\nrm -f evim.1    # this does not make sense if we have no GUI\n  done\n\n  # Runtime provided by runtime package\n  rm -r \"${pkgdir}\"/usr/share/vim\n\n  # remove gvim.desktop as not included\n  rm \"${pkgdir}\"/usr/share/applications/gvim.desktop\n\n  # license\n  install -Dm 644 runtime/doc/uganda.txt \\\n\"${pkgdir}\"/usr/share/licenses/${pkgname}/license.txt\n}\n# vim: ts=2 sw=2 et:\n```\n\n</details>\n\niii. 构建并安装：\n\n```bash\nmakepkg -si\n```\n\n## 4. 源码安装\n\n0. 安装依赖\n\n```bash\nsudo pacman -S glibc libgcrypt gpm python ruby libxt gtk3 lua gawk tcl zlib gettext pkgconfig\n# 需要音频支持的，安装这个依赖\nsudo pacman -S libcanberra\n```\n\n1. 克隆源码\n\n```bash\ngit clone https://github.com/vim/vim.git\n```\n\n2. 配置\n\n```shell\n./configure --prefix=/usr --localstatedir=/var/lib/vim \\\n    --with-features=huge --enable-gpm --enable-acl --with-x=yes \\\n    --disable-gui --enable-multibyte --enable-cscope \\\n    --disable-netbeans --enable-perlinterp=dynamic \\\n    --enable-python3interp=dynamic --enable-rubyinterp=dynamic \\\n    --enable-luainterp=dynamic --mandir=/usr/share/man\n    #################### 需要音频支持的加入以下配置：\n    --enable--canberra\n```\n\n3. 编译生成\n\n```bash\n# 默认生成\nmake\n\n# 测试\nmake test\n\n# 添加额外配置\nmake reconfig\n\n# 测试\nmake test\n\n# 安装\nsudo make install\n```\n\n## 5. 测试\n\n查看 patch 版本及是否包含 clipboard 特性\n\n```bash\n$ vim --version | grep patch\nIncluded patches: 1-1683\n\n$ vim --version | grep clipboard\n+clipboard         +keymap            +printer           +vertsplit\n+eval              -mouse_jsbterm     -sun_workshop      +xterm_clipboard\n```\n\n## 6. 参考链接\n\n[https://github.com/vim/vim](https://github.com/vim/vim)\n\n[https://github.com/ycm-core/YouCompleteMe/wiki/Building-Vim-from-source](https://github.com/ycm-core/YouCompleteMe/wiki/Building-Vim-from-source)\n\n[https://gitlab.archlinux.org/archlinux/packaging/packages/vim/-/blob/main/PKGBUILD](https://gitlab.archlinux.org/archlinux/packaging/packages/vim/-/blob/main/PKGBUILD)","date_published":"2023-08-10T08:07:52.000Z"},{"id":"/blog/raspberrypi-setup-openwrt-guide","url":"/blog/raspberrypi-setup-openwrt-guide","title":"树莓派配置旁路由过程记录","content_html":"## 引言\n\n~~树莓派是一款功能强大的微型计算机，广泛应用于物联网、嵌入式系统等领域。除了作为单独的计算设备使用外，树莓派还可以通过配置为旁路由，实现局域网内的网络管理和控制。~~\n\n又翻出来一台吃灰的树莓派，不知道做什么了，想试着做做旁路由,感受一下不一样的上网体验~。\n\n## 准备工作\n\n在开始配置旁路由之前，你需要准备以下材料和环境：\n\n- 一台树莓派（我用的是树莓派 4B）\n- 一张 SD 卡（越大越好）\n- 一根网线\n- 一台电脑（用于配置树莓派）\n- 一个可用的无线网络\n\n## 烧录固件\n\n1. 下载固件：我使用的是开源版的[`immortalwrt`](https://github.com/immortalwrt/immortalwrt)，从以下地址下载自编译的 openwrt 的固件：\n   [https://downloads.immortalwrt.org/releases/21.02.6/targets/bcm27xx/bcm2711/immortalwrt-21.02.6-bcm27xx-bcm2711-rpi-4-ext4-factory.img.gz](https://downloads.immortalwrt.org/releases/21.02.6/targets/bcm27xx/bcm2711/immortalwrt-21.02.6-bcm27xx-bcm2711-rpi-4-ext4-factory.img.gz)\n\n![image](https://imgcdn.smj.im/JL916hIjhZU/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzgxNWQ1ZTY3LndlYnA)\n\n2. 烧录固件：使用烧录工具将固件写入 SD 卡，推荐使用[balenaEtcher](https://etcher.balena.io/#download-etcher)（UI 美观）或者 [rufus](https://rufus.ie/en/)（轻量简洁），二者均开源免费。\n\n## 连接树莓派\n\n有两种方式连接树莓派：\n\n1. 使用电脑打开默认 UI 网页：http://192.168.1.1， 默认账户为：root，密码为：password，登陆后建议修改默认账户密码（有提示指引）。\n2. 通过 SSH 进入，`ssh root@192.168.1.1`连接到树莓派命令行终端。\n\n## 修改 LAN 口参数\n\n为了实现旁路由的功能，我们需要把树莓派的 LAN 口的 IP 地址改为静态地址。对于静态 IP 的选择，我们需要知道上级路由器的 IP 子网，这个可以登录到路由器后台查看，或者查看连接到路由器的其他设备（如手机）的 IP 地址。\n我的上级路由器 IP 为：192.168.0.1，那么子网范围就是 192.168.0.[1~255]，我们可以任意设置一个 2-255 的 IP，但是前提是该 IP 未被分配出去，你可以通过`ping`IP 来查看是否存在，如果提示`Destination host unreachable.`，说明该 IP 不存在，可以使用。当然，你也可以使用其他 IP 扫描工具来测试。\n\n这里我们使用 192.168.0.123 作为树莓派的静态 IP 地址。\n\n---\n\n<details>\n<summary>更简单的配置方法</summary>\n\n配置完之后，动了动脑子，感觉这两步可以何在一起直接在配置文件中修改，或者在 OpenWrt 控制台的`网络->接口->LAN`中修改。虽然我没试过（累了不想动了），但是我验证了配置文件，我觉得没毛病。\n\n**🚨 以下均为合理推测 xD🚨**\n\n<details>\n<summary>方法 1：直接修改网络配置文件</summary>\n网络配置文件位于`/etc/config/network`路径下，可以使用文本编辑器（如 vi 或 nano）进行编辑。\n\n首先，使用以下命令进入网络配置文件：\n\n```shell\nvi /etc/config/network\n```\n\n然后，更改 LAN 接口的 IP 地址，你可以在配置文件中找到以下行：\n\n```shell\nconfig interface 'lan'\n    option ipaddr '192.168.1.1'\n```\n\n将`config interface 'lan'`的值更改为我们需要的配置参数\n\n```shell\nconfig interface 'lan'\n    option type 'bridge'\n    option ifname 'eth0'\n    option proto 'static'\n    option netmask '255.255.255.0'\n    option ip6assign '60'\n    option ipaddr '192.168.0.123'\n    option gateway '192.168.0.1'\n    option broadcast '192.168.0.255'\n    option dns '192.168.0.1'\n```\n\n保存并退出文件。\n\n接下来，重新启动网络服务以使更改生效：\n\n```shell\n/etc/init.d/network restart\n```\n\n</details>\n<br/>\n<details>\n<summary>方法 2：直接在 OpenWrt 控制界面修改</summary>\n\n修改设置参数如下：\n![image](https://imgcdn.smj.im/uXeyVrFKtIA/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzdlNjFmZjE1LndlYnA)\n\n  </details>\n\n</details>\n\n---\n\n**以下我配置的时候，参考的方法：**\n\n### 修改 IP 地址\n\n> 如果你是使用网页连接的树莓派，可以从`系统->TTYD 终端`页面进入树莓派的命令行。\n\n在命令行终端输入一下命令：\n\n```shell\nuci set network.lan.ipaddr=192.168.0.123\nuci commit network\n/etc/init.d/network restart\n```\n\n### 修改网关及 DNS\n\n修改好 IP 地址之后，我们需要修改一些其他的 IP 参数来保证网络的正常运行。\n\n断开并重连电脑与树莓派的连接，如果搜不到树莓派的 WiFi 网络，树莓派重启一下应该就好了（我配置的时候用的 win10，断开之后就检测不到了，重启下就好了，不知道是我的原因还是系统原因。。。）。\n\n浏览器打开 OpenWrt 的界面（http://192.168.0.123），输入默认账户 root，密码 password，进入 web 界面后，先根据指引修改登录的账户密码。\n\n首先，进入`网络->接口`页面，选中修改`LAN`接口:\n\n```\n传输协议：静态地址\n\nIPV4 地址：192.168.0.123\n\nIPV4 子网掩码: 255.255.255.0\n\nIPV4 网关：192.168.0.1 （上级路由 IP）\n\nIPV4 广播：192.168.0.255 （把上级路由 IP 最后一段改为 255）\n\nDNS 地址：192.168.0.1\n```\n\n然后，勾选下方基本设置中的`忽略此接口`。\n\n<details>\n<summary>查看图片说明</summary>\n\n![image](https://imgcdn.smj.im/uXeyVrFKtIA/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzdlNjFmZjE1LndlYnA)\n\n</details>\n\n最后，点击`保存&应用`。\n\n到这一步，树莓派的内部配置基本已经完成，接下来我们断开电脑与树莓派的连接，将树莓派的网口接入上级路由器的 LAN 口即可，为了保证正常工作，可以手动重启一下树莓派。\n\n## 客户端配置\n\n然后是客户端的配置，对于每一个需要使用旁路由的设备，我们都需要修改为静态 IP 地址，分配一个路由器子网内的 IP 即可，以上文 IP 网段为例，我们可以使用`192.168.0.199`。\n\n我们以设置 Windows11 连接到旁路由为例，\n\n```\nIPV4 地址：192.168.0.199\n\nIPV4 子网掩码: 255.255.255.0\n\nIPV4 网关：192.168.0.123 （树莓派 IP）\n\nDNS 服务器：192.168.0.123 （树莓派 IP）\n```\n\n<details>\n<summary>查看配置图片说明</summary>\n\n> Win 11\n\n![image](https://imgcdn.smj.im/gIYodQqvExo/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E2YTNkZTg5LndlYnA)\n\n</details>\n\n设置保存之后，我们来验证一下是否成功，打开`cmd`输入`ipconfig`,查看 WiFi 网卡的基本信息，如果输入类似以下内容，代表静态 IP 配置成功：\n\n```\nWireless LAN adapter Wi-Fi:\n\n   Connection-specific DNS Suffix  . :\n   Link-local IPv6 Address . . . . . : fe80::687b:87f3:b17b:5c1%19\n   IPv4 Address. . . . . . . . . . . : 192.168.0.199\n   Subnet Mask . . . . . . . . . . . : 255.255.255.0\n   Default Gateway . . . . . . . . . : 192.168.0.123  #主要是这里\n```\n\n以防万一，我们打开浏览器，访问一个网站，如果能够正常打开，说明配置成功。\n\n---\n\n以上，使用树莓派作为旁路由的基本流程就结束了，之后你可以根据自己的需求去定制各种功能，当然，我使用的这个`immoralwrt`，里面已经内置了很多功能（**有魔法，dddd**），你可以自由开启关闭。\n\n版本不同可能初始项不同，但是都可以在软件包(`系统->软件包`)中/手动下载安装.\n\n<details>\n<summary>├── 状态</summary>\n  │  ├── 概况<br/>\n  │  ├── 防火墙<br/>\n  │  ├── 路由表<br/>\n  │  ├── 系统日志<br/>\n  │  ├── 内核日志<br/>\n  │  ├── 系统进程<br/>\n  │  ├── 实时信息<br/>\n  │  ├── 实时监控<br/>\n  │  ├── WireGuard 状态<br/>\n  │  ├── Online User<br/>\n  │  ├── 负载均衡<br/>\n  │  └── 释放内存<br/>\n</details>\n<details>\n<summary>├── 系统</summary>\n  │  ├── Web 管理<br/>\n  │  ├── 系统<br/>\n  │  ├── 管理权<br/>\n  │  ├── 软件包<br/>\n  │  ├── TTYD 终端<br/>\n  │  ├── 启动项<br/>\n  │  ├── 计划任务<br/>\n  │  ├── 挂载点<br/>\n  │  ├── 磁盘管理<br/>\n  │  ├── LED 配置<br/>\n  │  ├── 备份 / 升级<br/>\n  │  ├── 自定义命令<br/>\n  │  ├── 定时重启<br/>\n  │  ├── 文件传输<br/>\n  │  ├── Argon 主题设置<br/>\n  │  └── 重启<br/>\n</details>\n<details>\n<summary>├── 服务</summary>\n  │  ├── PassWall<br/>\n  │  ├── AdGuard Home<br/>\n  │  ├── 上网时间控制<br/>\n  │  ├── 微信推送<br/>\n  │  ├── Adblock<br/>\n  │  ├── OpenClash<br/>\n  │  ├── 动态 DNS<br/>\n  │  ├── WiFi 计划<br/>\n  │  ├── SmartDNS<br/>\n  │  ├── WatchCat<br/>\n  │  ├── 网络唤醒<br/>\n  │  ├── Tinyproxy<br/>\n  │  ├── UPnP<br/>\n  │  ├── KMS 服务器<br/>\n  │  ├── Shairplay<br/>\n  │  ├── Frps<br/>\n  │  ├── Nps 内网穿透<br/>\n  │  ├── Frp 内网穿透<br/>\n</details>\n<details>\n<summary>├── 网络存储</summary>\n  │  ├── 文件助手<br/>\n  │  ├── 文件浏览器<br/>\n  │  ├── NFS 管理<br/>\n  │  ├── 储存同步<br/>\n  │  ├── FTP 服务器<br/>\n  │  ├── 网络共享<br/>\n  │  ├── Aria2 配置<br/>\n  │  ├── Transmission<br/>\n  │  ├── PCHiFi 数字转盘遥控<br/>\n  │  ├── 挂载 SMB 网络共享<br/>\n  │  ├── MJPG-streamer<br/>\n  │  ├── Rclone<br/>\n  │  └── BaiduPCS Web<br/>\n</details>\n<details>\n<summary>├── VPN</summary>\n  │  ├── PPTP VPN 服务器<br/>\n  │  ├── IPSec VPN 服务器<br/>\n  │  ├── OpenVPN 服务器<br/>\n  │  └── ZeroTier<br/>\n</details>\n<details>\n<summary>├── 网络</summary>\n  │  ├── 接口<br/>\n  │  ├── 无线<br/>\n  │  ├── 访客网络<br/>\n  │  ├── DHCP/DNS<br/>\n  │  ├── 主机名<br/>\n  │  ├── IP/MAC 绑定<br/>\n  │  ├── 静态路由<br/>\n  │  ├── 防火墙<br/>\n  │  ├── 诊断<br/>\n  │  ├── SQM QoS<br/>\n  │  ├── UDP 工具<br/>\n  │  ├── Socat<br/>\n  │  ├── 负载均衡<br/>\n  │  └── Turbo ACC 网络加速<br/>\n</details>\n<details>\n<summary>├── 带宽监控</summary>\n  │  ├── 显示<br/>\n  │  ├── 配置<br/>\n  │  ├── 备份<br/>\n  │  └── 实时流量监测<br/>\n</details>\n\n└── 退出\n\n## 参考资料\n\n[https://doc.openwrt.cc](https://doc.openwrt.cc)\n\n[https://github.com/immortalwrt/immortalwrt](https://github.com/immortalwrt/immortalwrt)\n\n[https://github.com/SuLingGG/OpenWrt-Rpi/wiki](https://github.com/SuLingGG/OpenWrt-Rpi/wiki/)\n\n[https://linux-command-list.vercel.app](https://linux-command-list.vercel.app/)\n\n## 配置 openclash\n\n这里记录一下一些 openclash 配置项。\n\n### 插件配置\n\n带星号标红的是必须要确认的项，其他基本保持默认即可，也可根据自己的需求更改。\n\n- `模式设置`：运行模式建议`使用 Fake-IP 增强模式`，性能更好。\n- `流量控制`：可以勾选`实验性：绕过中国大陆 IP`\n- `DNS 设置`：本地 dns 劫持选择`使用 dnsmasq 转发`\n- `流媒体增强`：根据个人需求配置，我没需求所以没改。\n- `黑白名单`：根据个人需求配置，我没需求所以没改。\n- `外部控制`：clash 的 UI 面板，设置一下登录密码就行。\n- `IPv6 设置`：根据个人需求配置，我没需求所以没改。\n- `第三方规则订阅`：使用了内置的第三方规则集的，可以配置一下自动更新。\n- `GEO 数据库订阅`：GEO 数据库的订阅及自动更新\n- `大陆白名单订阅`：配置白名单列表订阅及自动更新\n- `定时重启`：设置定时重启\n- `版本更新`：更新内核的界面，使用 meta 内核首次设置需要下载安装\n- `开发者选项`：大佬专属界面，不知道做什么的，之后有机会研究一下\n- `调试日志`：debug 时候用\n\n顺便分享一下我的配置，也防止我自己时间久了就忘记了：\n\n<details>\n<summary>🔔多图预警</summary>\n\n  <details>\n  <summary>插件设置</summary>\n\n![模式设置](https://imgcdn.smj.im/QqJSBjxZSK8/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzljZTUxZjQyLndlYnA)\n\n![流量控制](https://imgcdn.smj.im/yPjkLW0YO2g/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzlmYTkzYjQ0LndlYnA)\n\n![DNS 设置](https://imgcdn.smj.im/5VOWrtscZu0/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzljNTg3ODQ1LndlYnA)\n\n![版本更新](https://imgcdn.smj.im/CNVO9NT1KBA/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzlmZmM2NDgyLndlYnA)\n\n  </details>\n  <details>\n  <summary>覆写设置</summary>\n\n![DNS 设置](https://imgcdn.smj.im/kRlVSk8H14E/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzllNDhhYmNhLndlYnA)\n\n![meta 设置](https://imgcdn.smj.im/RGbJ_bFS278/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzllOThhYjUwLndlYnA)\n\n![规则设置](https://imgcdn.smj.im/6t16nf_vQPY/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzllZjFlMTRhLndlYnA)\n\n![第三方规则集](https://imgcdn.smj.im/G2-ItMjvTU0/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzlmNTAwZGMyLndlYnA)\n\n  </details>\n  <details>\n  <summary>规则附加</summary>\n\n![规则附加](https://imgcdn.smj.im/c-gux2dwaAU/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzlhYWI1MjdiLndlYnA)\n\n  </details>\n</details>","date_published":"2023-08-04T23:12:03.000Z"},{"id":"/blog/cloudflare-tunnel-guide","url":"/blog/cloudflare-tunnel-guide","title":"Cloudflare Tunnel 不完全上手指南","content_html":"最近在树莓派上整了几个 web 服务，不过只能在本地使用，无法通过外网访问，所以试着使用 Cloudflare Tunnel 来进行内网穿透，这里记录下我的操作过程。\n\n我的硬件配置\n\n> 树莓派 4B+Ubuntu 系统\n\n## 安装 cloudflared\n\n要在 Raspberry Pi 上设置 Cloudflare 隧道，我们将依赖一个名为“ `Cloudflared` ”的软件，Cloudflared 是在 本地网络 和 Cloudflare 网络之间创建和维护安全隧道的软件。有两种安装方法。\n\n### 方法 1：使用 Cloudflare 存储库\n\n1.  获取 Cloudflared 存储库的 GPG 密钥\n\n```bash\ncurl -L https://pkg.cloudflare.com/cloudflare-main.gpg | sudo tee /usr/share/keyrings/cloudflare-archive-keyring.gpg >/dev/null\n```\n\n2. 将 Cloudflared 存储库添加到软件源\n\n```bash\necho \"deb [signed-by=/usr/share/keyrings/cloudflare-archive-keyring.gpg] https://pkg.cloudflare.com/cloudflared $(lsb_release -cs) main\" | sudo tee  /etc/apt/sources.list.d/cloudflared.list\n```\n\n3. 更新软件包缓存并安装`cloudflared`：\n\n```bash\nsudo apt update\nsudo apt install cloudflared\n```\n\n### 方法 2：直接使用官方 deb 包\n\n使用以下在 Github 的[Release](https://github.com/cloudflare/cloudflared/releases)界面下载最新版 deb 包，并使用`dpkg`进行安装：\n\n```bash\nwget -q https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-arm64.deb && sudo dpkg -i cloudflared-linux-arm64.deb\n```\n\n_注意树莓派 4B 安装_`_arm64_`_版本。_\n\n## 配置账号\n\n命令行执行以下命令，按照引导进行账号验证：\n\n```bash\ncloudflared tunnel login\n```\n\n## 创建隧道\n\n执行以下命令，创建一个 tunnel：\n\n```bash\ncloudflared tunnel create <tunnel-name>\n```\n\n运行上面的命令后，您将看到类似于下面的消息\n\n```bash\nTunnel credentials written to /home/pi/.cloudflared/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.json. cloudflared chose this file based on where your origin certificate was found. Keep this file secret. To revoke these credentials, delete the tunnel.\n\nCreated tunnel pimytunnel with id XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\n```\n\n这一步在创建 tunnel 的同时，还生成一个 tunnel 的 UUID，一个凭证文件以及一个`.cfargotunnel.com` 的子域名，UUID 以及凭证文件将在之后配置文件时使用，务必记住 UUID 以及凭证文件的路径（在默认路径中，后面会提到）。\n\n也使用以下命令验证是否创建成功：\n\n```bash\ncloudflared tunnel list\n```\n\n### 详细配置隧道\n\n配置文件的默认路径有 3 个，分别是：\n\n1.  `~/.cloudflared`\n2.  `/etc/cloudflared`\n3.  `/usr/local/etc/cloudflared`\n\n这里我们使用当前用户目录，即`~/.cloudflared`，我们在该目录下面创建一个配置文件，命名为`config.yml`，并填入之前创建的 tunnel 时的生成的配置信息：\n\n```bash\ntunnel: <Tunnel-UUID>\ncredentials-file: /home/pi/.cloudflared/<Tunnel-UUID>.json\n\ningress:\n    - hostname: test.example.com\n      service: http://localhost:80\n    - hostname: example.com\n      service: https://localhost:8000\n    - service: http_status:404\n```\n\n然后按照配置文件的格式配置自己的 web 服务的主机名和端口，每个规则一般包含`hostname`和`service`两部分，注意最后一行的`- service: http_status:404`，我们可以发现没有 hostname 部分，这并不是错误，而是`cloudflared`的特殊规则，主要是用来匹配所有流量，是必须要有的。\n\n这和`cloudflared`匹配规则有关，当 `cloudflared` 收到传入请求时，它会从上到下评估每个入口规则，以找到与请求匹配的规则。规则可以匹配传入请求的主机名或路径，或两者。如果所有规则都不匹配，就会匹配最后一条规则。\n\n## 路由内网服务流量\n\n使用以下命令分配一个 CNAME 记录，将流量指向您的隧道子域。\n\n```bash\ncloudflared tunnel route dns <UUID or NAME> <hostname>\n\n# example\ncloudflared tunnel route dns pi test.example.com\n```\n\n## 运行隧道\n\n执行以下命令，将 cloudflared 连接到 Cloudflare 的网络，Cloudflared 会从默认位置检索配置文件，即 `~/.cloudflared/config.yml`\n\n```bash\ncloudflared tunnel run <UUID or NAME>\n```\n\n如果你的配置文件不在默认路径，可以使用`--config`选项来运行隧道：\n\n```bash\ncloudflared tunnel --config /path/your-config-file.yaml run <UUID or NAME>\n```\n\n## 检查隧道参数\n\n至此，隧道配置完成，可以执行下面的命令来获得刚刚创建的隧道的信息：\n\n```bash\ncloudflared tunnel info\n```\n\n其他一些常用的命令：\n\n| Functions    | Commands                              |\n| ------------ | ------------------------------------- |\n| 创建隧道     | cloudflared tunnel run <_NAME_>       |\n| 隧道列表     | cloudflared tunnel list               |\n| 停止隧道     | cloudflared tunnel stop <_NAME_>      |\n| 重新启动隧道 | cloudflared tunnel restart <_NAME_>   |\n| 删除隧道     | cloudflared tunnel delete <_NAME_>    |\n| 强制删除隧道 | cloudflared tunnel delete -f <_NAME_> |\n| 显示隧道信息 | cloudflared tunnel info <_NAME_>      |\n\n## 将隧道作为服务运行\n\n将 Tunnel 安装为系统服务，允许 Tunnel 在启动时作为启动守护进程自动运行。默认情况下，Tunnel 希望在默认目录 `~/.cloudflared/config.yml` 中找到配置文件，但要将 Tunnel 作为服务运行，我们需要将 config.yml 文件移动到 `~/etc/cloudflared/` 中。\n\n使用 `mv` 命令来移动配置文件\n\n```bash\nsudo mv /home/pi/.cloudflared/config.yml /etc/cloudflared/\n```\n\n然后执行以下命令安装服务：\n\n```bash\nsudo cloudflared service install\n```\n\n启动服务：\n\n```bash\nsystemctl start cloudflared\n```\n\n检查服务运行状态：\n\n```bash\nsystemctl status cloudflared\n```\n\n## 踩坑\n\n启动隧道服务时遇到的一个问题：\n\n> failed to sufficiently increase receive buffer size (was: 208 kiB, wanted: 2048 kiB, got: 416 kiB).\n\n解决方法：\n\n```bash\nsudo sysctl -w net.core.rmem_max=2500000\n```\n\n## 参考\n\n[https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/)\n\n[https://github.com/quic-go/quic-go/wiki/UDP-Receive-Buffer-Size](https://github.com/quic-go/quic-go/wiki/UDP-Receive-Buffer-Size)","date_published":"2023-04-01T13:04:52.000Z"},{"id":"/blog/unlock-new-bing-ai","url":"/blog/unlock-new-bing-ai","title":"解除 New Bing 地区和浏览器限制的方法","content_html":"## Part I：解除地区限制\n\n最近，由于不可描述的原因，在大陆地区使用 New Bing 时会出现：\"Sorry,looks like your network settings are preventing access to this feature.\"的问题。\n![image](https://imgcdn.smj.im/AtKDQOMmNbw/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2ExNzMwMDQyLndlYnA)\n\n一个比较简单的解决方案：修改请求 `header` 中`X-Forwarder-For`字段的 ip 地址。\n\n具体操作步骤如下：\n\n0. 设置 bing 账户的地区为大陆以外的地区，例如美国。\n\n1. 安装浏览器插件\n   Firefox: [ModHeader](https://microsoftedge.microsoft.com/addons/detail/modheader-modify-http-h/opgbiafapkbbnbnjcdomjaghbckfkglc) or [Header Editor](https://microsoftedge.microsoft.com/addons/detail/header-editor/afopnekiinpekooejpchnkgfffaeceko)\n   Chromium Based(Edge/Chrome): [ModHeader](https://microsoftedge.microsoft.com/addons/detail/modheader-modify-http-h/opgbiafapkbbnbnjcdomjaghbckfkglc) or [Header Editor](https://microsoftedge.microsoft.com/addons/detail/header-editor/afopnekiinpekooejpchnkgfffaeceko)\n\n1. 查找美国 ip 段或者 ip 地址，记录一个位于的美国 ip 地址，例如：`1.32.232.xxx`是一个美国 ip 段，其中的`xxx`可以是 255 以内的任何值。\n\n1. 配置插件\n   修改请求 header 中的`X-Forwarder-For`字段，设置值为刚刚找到的 ip 地址`1.32.232.123`\n   设置匹配的 url 为所有`bing.com`的请求：`.*://www.bing.com/.*`\n\n**Header Editor**配置示例\n\n![image](https://imgcdn.smj.im/1S8BSyZ-fuo/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2EwYmU1ZjM3LndlYnA)\n\n**ModHeader**配置示例\n\n![image](https://imgcdn.smj.im/m5_76NFlV6I/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2ExMWJhMjdlLndlYnA)\n\n按照上面的步骤设置之后，应该就可以使用 New Bing 了。\n\n![image](https://imgcdn.smj.im/25kMIHxcBWg/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzdmZmFmNzY1LndlYnA)\n\n## Part II：解除浏览器限制\n\n又因为各种原因，如果想要使用 New Bing，必须使用微软自家的 Edge 浏览器，虽然很强大，但是我用习惯了 Firefox，所以不想切换。但是也不想为了使用这个功能而来回切换浏览器，太麻烦了。\n\n所以这里给出一个解决方案：更改浏览器的 UA(UserAgent)。\n\n具体操作：\n\n1. 下载[User-Agent Switcher and Manager](https://addons.mozilla.org/en-US/firefox/addon/user-agent-string-switcher/?utm_content=addons-manager-reviews-link&utm_medium=firefox-browser&utm_source=firefox-browser)插件\n2. 按照下图切换为 Edge 浏览器 UA，点击 Apply\n   ![image](https://imgcdn.smj.im/Tf4Ywvq9uJg/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzgzZmYxYmMxLndlYnA)\n\n现在应该可以在 Firefox 使用 New Bing 了。\n![image](https://imgcdn.smj.im/1rjo4Ext6C4/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzcxYmViM2NmLndlYnA)","date_published":"2023-03-29T11:00:28.000Z"},{"id":"/blog/frp-tutorial","url":"/blog/frp-tutorial","title":"FRP 上手教程","content_html":"## 前言\n\n最近把在角落里吃灰的树莓派拿了出来，搭建了一个 wordpress 网站，感觉还不错，不过因为连的是家里的 WiFi，所以只能内网访问，所以就准备用内网穿透工具配置一下外网访问。之前内网穿透都是用的 Cloudflare 的 tunnel，免费，配置很简单，而且直接上自家的 CDN 网络，但是由于众所周知的原因，Cloudflare 的服务在国内访问速度感人，但是勉强还能用。不过最近在 Github 上的 Trending 里看到了这个[frp](https://github.com/fatedier/frp)，看了一下文档，发现这个工具配置起来超简单，刚好有台服务器，所以就直接上手了。\n\n个人配置\n\n> Client: Raspberrypi 4B + Ubuntu 20.04\n>\n> Server: Ubuntu 20.04\n\n## 安装配置 frp\n\n### 服务器端配置\n\n下载解压 frp 文件，注意安装包的架构：\n\n```bash\nwget https://github.com/fatedier/frp/releases/download/v0.46.1/frp_0.46.1_linux_amd64.tar.gz\n\ntar zxvf frp_0.46.1_linux_amd64.tar.gz\n\ncd frp_0.46.1_linux_arm64/\n```\n\n配置流程稍稍与客户端配置不同，但是更简单，只需要编辑`frps.ini`配置文件，设置监听 HTTP 请求端口，这里我使用的 8080 端口：\n\n```ini title='frps.ini'\n[common]\nbind_port = 7000 # frp 服务的监听端口\nvhost_http_port = 8080\n```\n\np.s. 不要忘记开放服务器的防火墙端口。\n\n### 客户端配置\n\n下载解压 frp 文件，因为我用的是树莓派，所以下载 arm64 的包：\n\n```bash\nwget https://github.com/fatedier/frp/releases/download/v0.46.1/frp_0.46.1_linux_arm64.tar.gz\n\ntar zxvf frp_0.46.1_linux_arm64.tar.gz\n```\n\n编辑`frpc.ini`配置文件，设置服务器的 IP 地址`a.b.c.d`及本地机器上 Web 服务监听的端口，并绑定自定义域名：\n\n```ini title='frpc.ini'\n[common]\nserver_addr = a.b.c.d\nserver_port = 7000\n\n[web]\ntype = http\nlocal_port = 3000\ncustom_domains = www.yourdomain.com #这里设置域名\n```\n\n到这里就可以使用了，分别启动服务端和客户端即可。\n\n```bash\n# 服务端\n./frps -c ./frps.ini\n\n# 客户端\n./frpc -c ./frpc.ini\n```\n\n通过`http://www.yourdomain.com`即可访问 web 服务。p.s. 不要忘记将`www.yourdomain.com`的域名 A 记录映射到服务器的 IP。\n\n## Caddy 配置\n\n不过因为我的服务器上还部署了其他的 web 服务，使用了 caddy 进行反向代理，所以还需要一点额外的配置。编辑 caddy 的配置文件`/etc/caddy/Caddyfile`，添加新域名的反向代理：\n\n```ini\nwww.yourdomain.com {\nreverse_proxy localhost:8080\n}\n```\n\n重新启动 caddy 服务：\n\n```bash\nsudo systemctl restart caddy\n```\n\n现在就可以通过`https://www.yourdomain.com`访问内网的 web 服务了，而且 Auto HTTPS！！\n\n## 参考\n\n[https://github.com/fatedier/frp/](https://github.com/fatedier/frp/)\n\n[https://gofrp.org/docs/](https://gofrp.org/docs/)","date_published":"2023-03-25T10:47:15.000Z"},{"id":"/blog/linux-nohup-and-uses","url":"/blog/linux-nohup-and-uses","title":"深入理解 Linux nohup 命令","content_html":"## 前言\n\n当我们在 Linux 或 Unix 系统上执行一个长时间运行的命令或脚本时，我们通常会遇到一个问题，那就是在终端关闭或者退出后，该进程也会随之停止运行。在这种情况下，我们需要一种方式来让进程在后台运行，而不受终端关闭的影响。这时，nohup 命令就派上用场了。\n\n## nohup 是什么？\n\n`nohup`是 Linux 和 Unix 系统中的一个命令，其作用是在终端退出时，让进程在后台继续运行。它的全称为“no hang up”，意为“不挂起”。`nohup`命令可以让你在退出终端或关闭 SSH 连接后继续运行命令。\n\n## nohup 语法规则\n\nnohup 命令的基本语法如下：\n\n```bash\nnohup COMMAND [ARGS ...] [> output-file 2> error-file] &\n```\n\n其中的参数含义如下：\n\n- `COMMAND`：需要在后台运行的命令或脚本。\n- `ARGS`：命令或脚本的参数。\n- `> output-file`：输出重定向到指定的文件中。\n- `2> error-file`：错误信息重定向到指定的文件中。\n- `&`：将命令放在后台运行。\n\nnohup 命令的执行过程分为以下几个步骤：\n\n1.  nohup 命令将当前 shell 的标准输入、标准输出和标准错误输出全部重定向到`/dev/null`设备中，避免被关闭终端的信号所中断。\n2.  nohup 命令将进程放到后台执行，并将进程的 PID 输出到终端。\n3.  进程开始执行，并将标准输出和标准错误输出重定向到指定的文件中。\n4.  用户可以退出终端或关闭终端窗口，进程仍然在后台运行。\n\n## nohup 使用方法\n\n使用 nohup 命令非常简单，按照上面的基本语法即可。以下是一些 nohup 命令的用法示例：\n\n### 后台运行命令\n\n要在后台运行命令，只需要在命令行中输入以下命令即可：\n\n```bash\nnohup COMMAND &\n```\n\n例如，在后台运行一个 Bash 脚本：\n\n```bash\nnohup bash test.sh &\n```\n\n### 标准输出重定向到文件\n\n```bash\nnohup bash test.sh > stdout.txt &\n```\n\n### 标准错误输出重定向到文件\n\n```bash\nnohup bash test.sh 2> stderr.txt &\n```\n\n### 将标准输出和标准错误输出都重定向到文件\n\n1. 重定向到同一文件\n\n```bash\nnohup bash test.sh > output.txt 2>&1 &\n```\n\n2. 重定向到不同文件\n\n```bash\nnohup bash test.sh > stdout.txt 2> stderr.txt &\n```\n\n3. 一个[更为复杂的例子](https://en.wikipedia.org/wiki/Nohup#Overcoming_hanging)，重定向标准输入（stdin）：\n\n```bash\nnohup ./myprogram > foo.out 2> foo.err < /dev/null &\n```\n\n这里多出来一个`< /dev/null`，意思是将标准输入重定向到`/dev/null`，以确保程序不会从标准输入中读取任何数据。\n\n这个是为了解决一个实际问题：SSH 会话常常拒绝注销（或者挂起），因为它不愿意去丢失与后台 job(s)进行交互的数据。当遇到这个问题的时候，可以使用上面的命令，通过三次重定向来解决。\n\n### nohup 后台进程管理\n\n使用 `jobs` 命令可以查看当前 shell 中后台运行的任务列表，包括任务编号、状态和命令。\n\n例如，我们在后台执行一个`sleep 1000`命令，使用`jobs`命令查看：\n\n```bash\n$ jobs\n[1]+  Running                 nohup sleep 1000 &\n```\n\n其中，方括号中的数字表示任务编号，加号或减号表示任务的优先级，`Running` 表示任务正在后台运行。除此之外，还有其他可能的状态，包括 `Stopped`（已停止）、`Done`（已完成）等。\n\n我们还可以使用 `fg` 命令将一个后台任务移动到前台继续运行，例如：\n\n```bash\n$ fg %1\n```\n\n这个命令会将任务编号为 1 的任务移动到前台，继续执行。如果希望将任务暂停或恢复，可以使用 `Ctrl-Z` 键，在当前 shell 中发送 `SIGTSTP` 信号。\n\n```bash\n$ fg %1\nnohup sleep 1000\n\n^Z\n[1]+  Stopped                 nohup sleep 1000\n```\n\n此时如果想要恢复运行，可以使用`bg`命令：\n\n```bash\n$ bg %1\n[1]+ nohup sleep 1000 &\n```\n\n如果想要杀死该任务，可以使用`kill`命令：\n\n```bash\n$ kill %1\n[1]+  Terminated              nohup sleep 1000\n```\n\n如果你想杀死所有后台任务，但是又觉得一个个地比较麻烦，可以使用`disown`命令来解决：\n\n```bash\n$ disown -a\n```\n\n这个命令可以杀死所有后台任务，但不会有任何提示，你可以通过`jobs`命令来确认。\n\n## 总结\n\n`nohup`命令可以在后台运行程序，即使终端关闭或断开与远程服务器的连接也不会影响程序的运行。通过`nohup`命令启动的进程会忽略所有终端信号，因此即使使用`Ctrl+C`关闭终端，进程也不会停止。可以使用`jobs`命令查看后台运行的进程，并使用`fg`命令将进程切换到前台运行。\n\n`nohup`非常适合用来执行一些需要长时间运行的脚本或程序，比如 Web 服务器，数据库等。但需要注意的是，`nohup`命令并不是完全避免了进程被中断的可能，例如系统崩溃、进程错误等情况仍可能导致进程的中断。\n\n## 参考\n\n[https://en.wikipedia.org/wiki/Nohup](https://en.wikipedia.org/wiki/Nohup)","date_published":"2023-02-23T18:13:56.000Z"},{"id":"/blog/what-is-cpp-smart-pointer","url":"/blog/what-is-cpp-smart-pointer","title":"C++智能指针是什么","content_html":"## 引言\n\nC++是一种广泛使用的编程语言，它允许程序员使用动态分配的内存。然而，手动管理内存可能会导致一些严重的问题，如内存泄漏和悬空指针。为了解决这些问题，C++引入了智能指针的概念。智能指针是一种特殊的指针类型，它可以自动管理内存并确保在不需要时释放内存。智能指针在 C++程序中的使用已经变得越来越普遍，例如在 STL 容器中使用的智能指针、COM 接口编程等。\n\n本文将介绍智能指针的概念、类型以及实现原理，帮助大家更好地理解和应用智能指针。\n\n## 基本概念\n\n**智能指针**是一种 C++语言特有的指针，它是对常规指针的封装，提供了自动内存管理的功能，能够在对象不再被使用时自动释放其所占用的内存，避免了手动管理内存所带来的错误和麻烦。智能指针的设计思想是资源管理类（**RAII**）的一种应用，通过将对象的生命周期与智能指针的生命周期绑定，实现对对象的自动管理。\n\n与常规指针相比，智能指针具有以下特点：\n\n1. 自动管理内存，不需要手动释放内存；\n2. 可以记录指针的引用计数，并自动管理对象的生命周期；\n3. 可以模拟对象拷贝的效果，并保证在析构时不会释放同一块内存两次；\n4. 可以通过指定删除器（deleter）来实现自定义资源的管理。\n\n然而，智能指针也有一些缺点：\n\n1. 额外的开销：智能指针在实现上需要额外的开销来管理指针的生命周期，这可能会导致一些性能问题。\n2. 循环引用问题：在使用 shared_ptr 时，如果存在循环引用的情况，即两个或多个对象互相持有 shared_ptr 指针，可能会导致内存泄漏。\n3. 无法处理非堆内存对象：智能指针只适用于堆内存对象，无法管理栈内存或全局变量等非堆内存对象。\n4. 不支持数组：智能指针只能管理单个对象，无法管理数组。如果需要管理数组，需要使用专门的数组智能指针。\n\n**智能指针的生命周期**由其作用域和引用计数共同决定。当智能指针对象超出作用域时，会自动释放其所指向的内存，从而避免了内存泄漏的问题。而当多个智能指针指向同一个对象时，其引用计数会增加，当引用计数为 0 时，对象才会被释放。也就是说，智能指针的作用域和生命周期是自动管理的，能够有效避免内存泄漏和其他内存管理问题的出现。\n\n## 智能指针类型\n\nC++中常见的智能指针类型有 unique_ptr、shared_ptr 和 weak_ptr。\n\n1. unique_ptr\n   unique_ptr 是一种独占智能指针，它以独占所有权的方式管理资源。这意味着，每个资源只能由一个 unique_ptr 所拥有，一旦 unique_ptr 被销毁，它所拥有的资源也会被释放。unique_ptr 是 C++11 标准中新增的特性，它提供了更高效和更安全的资源管理方式。\n\n2. shared_ptr\n   shared_ptr 是一种共享智能指针，它允许多个 shared_ptr 共享同一个资源，这个资源会在所有引用它的 shared_ptr 对象被销毁后才被释放。shared_ptr 通过使用引用计数的方式来追踪资源的使用情况，一旦引用计数为 0，资源会被释放。与 unique_ptr 不同，shared_ptr 可以传递拥有权，并且可以从裸指针或者其他 shared_ptr 对象构造出来。\n\n3. weak_ptr\n   weak_ptr 是一种弱引用智能指针，它是 shared_ptr 的一种扩展，但它并不对资源进行引用计数。它只能从一个 shared_ptr 对象中构造而来，并且不能直接操作被管理的资源。一般情况下，我们**使用 weak_ptr 来解决 shared_ptr 的循环引用问题**。\n\n## 使用技巧\n\n- 尽量使用`unique_ptr`：在不需要共享所有权的情况下，尽量使用 unique_ptr。它可以确保指针所有权唯一，避免内存泄漏的发生，并且具有良好的性能。\n\n- 使用`shared_ptr`管理共享资源：在需要多个对象共享同一个资源时，应该使用`shared_ptr`。`shared_ptr`使用引用计数技术，可以确保资源只有在最后一个拥有者被销毁时才会被释放。\n\n- 使用`make_shared`或`make_unique`创建智能指针：在创建智能指针时，应该尽可能地使用 `make_shared` 或 `make_unique` 函数，而不是直接使用 new 操作符。这样可以减少内存分配的开销，并且可以避免内存泄漏的发生。\n\n- 不要使用智能指针数组：智能指针不支持管理动态数组，因此在需要管理数组的情况下，应该使用标准库中的容器类，如`vector`。\n\n- 避免使用裸指针：尽可能地避免使用裸指针，因为它们很容易被误用。尤其是在使用智能指针时，应该尽量避免将裸指针和智能指针混合使用。\n\n- 不要将智能指针转换为裸指针：在使用智能指针时，应该尽可能地避免将智能指针转换为裸指针。如果必须要进行转换，应该使用 get 函数来获取裸指针，而不是直接使用智能指针的地址。\n\n- 将智能指针传递给函数时应该使用`const`引用：当需要将智能指针作为参数传递给函数时，应该尽量使用`const`引用，以避免不必要的拷贝和内存分配。\n\n## 注意事项\n\n1. 注意循环引用问题\n   shared_ptr 是一种智能指针类型，它可以在多个指针之间共享所指向的对象。但是，如果存在循环引用，就可能导致内存泄漏的问题。\n   循环引用指的是两个或多个对象之间相互引用，导致它们之间的引用计数无法达到零，从而导致内存泄漏。为了避免循环引用，可以采用如下几种方法：\n\n- 使用 weak_ptr 来打破循环引用\n- 尽量避免循环引用的发生\n- 使用标准库提供的容器，如 std::list 或 std::vector，而不是手动管理内存\n\n2. 注意线程安全问题\n   多线程环境下，使用智能指针需要注意线程安全问题。如果多个线程同时访问同一个智能指针，可能会导致竞争条件的问题。为了避免这种问题，可以采用如下几种方法：\n\n- 使用原子操作来保证线程安全\n- 使用互斥锁来保证线程安全\n- 避免多线程同时访问同一个智能指针\n\n3. 避免内存泄漏和悬空指针\n   智能指针的主要作用是管理动态分配的内存，避免内存泄漏和悬垂指针。但是，如果使用不当，仍然可能发生这些问题。为了避免内存泄漏和悬垂指针，应该遵循以下几点：\n\n- 使用智能指针来管理动态分配的内存\n- 不要使用裸指针和 delete 来管理内存\n- 不要手动释放智能指针管理的内存\n\n## 示例\n\n```cpp\n#include <iostream>\n#include <memory>\n\nusing namespace std;\n\nclass MyClass {\npublic:\nvoid print() {\n    cout << \"Hello from MyClass!\" << endl;\n}\n};\n\nvoid test_unique_ptr() {\nunique_ptr<MyClass> p(new MyClass());\np->print();\n}\n\nvoid test_shared_ptr() {\nshared_ptr<MyClass> p(new MyClass());\np->print();\n}\n\nvoid test_weak_ptr() {\nshared_ptr<MyClass> p1(new MyClass());\nweak_ptr<MyClass> p2(p1);\nif (!p2.expired()) {\n    shared_ptr<MyClass> p3 = p2.lock();\n    p3->print();\n}\n}\n\nint main() {\ntest_unique_ptr();\ntest_shared_ptr();\ntest_weak_ptr();\nreturn 0;\n}\n\n```\n\n上述代码中，我们定义了一个名为 MyClass 的类，其实例拥有一个 print() 方法，用于打印一条消息。\n\n接着，我们定义了三个测试函数：test_unique_ptr()、test_shared_ptr() 和 test_weak_ptr()，分别使用了 unique_ptr、shared_ptr 和 weak_ptr 智能指针类型。\n\n在 test_unique_ptr() 中，我们使用了 unique_ptr，它拥有独占的所有权，用于管理 MyClass 类型的实例。我们使用 new 运算符来创建这个实例，然后使用箭头操作符访问它的 print() 方法。\n\n在 test_shared_ptr() 中，我们使用了 shared_ptr，它可以与其他 shared_ptr 共享同一个实例。我们同样使用 new 运算符创建 MyClass 类型的实例，并传递给 shared_ptr，它会自动跟踪实例的引用计数。同样，我们使用箭头操作符访问实例的 print() 方法。\n\n在 test_weak_ptr() 中，我们定义了一个 shared_ptr 类型的实例 p1，然后创建了一个指向它的 weak_ptr 类型的实例 p2。由于 weak_ptr 并不会增加引用计数，因此它不能直接访问 MyClass 实例，需要先通过 lock() 方法获取一个 shared_ptr 类型的实例 p3，然后才能使用箭头操作符访问实例的 print() 方法。\n\n通过上述示例，我们可以看到不同类型的智能指针的使用方法和特点。需要注意的是，在实际开发中，我们需要根据具体的场景和需求，选择最合适的智能指针类型，以达到最佳的效果。\n\n## 总结\n\n智能指针是一种 C++中常用的内存管理工具，能够自动管理对象的生命周期，有效避免内存泄漏和资源占用等问题。本文主要介绍了普通指针和智能指针的区别，以及智能指针的分类和特点。我们对每种类型进行了介绍和比较，指出了它们的适用场景和注意事项。\n\n在实际应用中，我们应该根据具体场景选择合适的智能指针类型，并注意避免智能指针的陷阱，如循环引用和多线程环境下的竞争问题。同时，我们还可以利用智能指针的一些高级用法和技巧，如自定义删除器和指针转换操作等。总之，智能指针是 C++中一个非常实用的工具，能够帮助我们更加高效地管理内存和资源。\n\n## 术语\n\nRAII（Resource Acquisition Is Initialization）是一种 C++编程技术，它利用对象的生命周期来管理资源，包括内存、文件、网络连接等。智能指针就是利用 RAII 技术来管理内存资源的一种实现。\n\nRAII 技术的基本原则是：在构造函数中获取资源，在析构函数中释放资源。智能指针通过在析构函数中释放资源，实现了自动管理内存资源的功能。\n\n## 参考\n\n[https://learn.microsoft.com/en-us/cpp/cpp/smart-pointers-modern-cpp?view=msvc-170](https://learn.microsoft.com/en-us/cpp/cpp/smart-pointers-modern-cpp?view=msvc-170)","date_published":"2023-02-23T18:13:31.000Z"},{"id":"/blog/how-pgp-works","url":"/blog/how-pgp-works","title":"PGP 工作原理详解","content_html":"## 前言\n\n最近在浏览[博客](https://www.stephendiehl.com/blog/disconnect.html)的时候发现博主的 PGP Key 页面，虽然之前知道是用于邮件通信加密的，但是具体原理及使用却不太清楚，所以找了时间查阅了相关资料，整理一下 PGP 加密的一些内容。\n\n## PGP 定义\n\nPretty Good Privacy（PGP）是一个[加密程序](https://en.wikipedia.org/wiki/Encryption_software)，为[数据通信](https://en.wikipedia.org/wiki/Data_communication)提供[加密](https://en.wikipedia.org/wiki/Cryptographic)[隐私](https://en.wikipedia.org/wiki/Privacy)和[身份验证](https://en.wikipedia.org/wiki/Authentication)。PGP 用于对文本、电子邮件、文件、目录和整个磁盘分区进行签名、加密和解密，并提高电子邮件通信的安全性。PGP 加密使用[散列](https://en.wikipedia.org/wiki/Cryptographic_hash_function)，[数据压缩](https://en.wikipedia.org/wiki/Data_compression)，[对称密钥加密](https://en.wikipedia.org/wiki/Symmetric-key_cryptography)，最后是[公钥加密](https://en.wikipedia.org/wiki/Public-key_cryptography)的串行组合。其中最关键的是两种形式的加密的组合：对称密钥加密(Symmetric Cryptography)和非对称密钥加密(Asymmetric cryptography)。\n\n## PGP 工作原理\n\n在实现 PGP 加密的过程中，首先使用对称密钥加密算法对原始数据进行加密。对称密钥加密算法包括 DES、AES、Blowfish 等，这些算法能够快速地加密和解密数据，但是需要发送方和接收方之间共享密钥。\n\n为了避免在网络上传输密钥，PGP 使用了公钥加密算法。公钥加密算法是一种使用不同的密钥加密和解密的算法，其中公钥用于加密，而私钥用于解密。公钥加密算法包括 RSA、DSA 等，这些算法具有极高的安全性，但是加密和解密速度比对称密钥加密算法慢得多。\n\nPGP 将对称密钥加密，并使用接收方的公钥进行加密。这种方式可以保证密钥的安全性，同时可以确保只有接收方可以解密对称密钥，从而保护了数据的机密性。接收方使用自己的私钥对加密的对称密钥进行解密，然后使用对称密钥对数据进行解密。这种方式既可以保护数据的安全性，也可以提高加解密的速度。\n\n![PGP 工作原理示意](https://imgcdn.smj.im/9mzFtLAbszk/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2EwNTVhNDIxLndlYnA)\n\nPGP 使用两种类型的加密算法来保护数据：对称密钥加密和公钥加密。对称密钥加密是一种使用相同密钥加密和解密的算法，因此在加密和解密之间需要共享密钥。而公钥加密则是一种使用不同的密钥加密和解密的算法，其中公钥用于加密，而私钥用于解密。下面我将简单介绍一下这两种算法的工作原理。\n\n### 对称密钥加密\n\n对称密钥加密是一种使用相同密钥加密和解密的算法，因此在加密和解密之间需要共享密钥。对称密钥加密的过程如下：\n\n1. 发送方选择一个加密密钥，并使用它将原始数据加密。\n2. 加密后的数据被发送到接收方。\n3. 接收方使用相同的密钥将加密的数据解密。\n\n尽管对称密钥加密非常高效，但它有一个明显的缺点，即需要在发送方和接收方之间共享密钥。如果这个密钥被黑客或其他人获取，数据将无法得到保护。为了解决这个问题，PGP 使用了另一种加密算法：公钥加密。\n\n### 公钥加密\n\n公钥加密是一种使用不同的密钥加密和解密的算法，其中公钥用于加密，而私钥用于解密。公钥加密的过程如下：\n\n1. 发送方获取接收方的公钥，并使用它将对称密钥加密。\n2. 加密后的对称密钥和加密后的数据被发送到接收方。\n3. 接收方使用自己的私钥将加密的对称密钥解密。\n4. 接收方使用解密后的对称密钥将加密的数据解密。\n\n公钥加密允许发送方使用接收方的公钥加密数据，而无需共享对称密钥。这样，即使黑客获得了加密后的数据，也无法使用它，因为他们没有接收方的私钥来解密对称密钥。\n\n### PGP 示例\n\n我用常用的加密电子邮件来举个例子，具体的工作流程是：\n\n用户 A 要给用户 B 发送邮件。\n\n1.  用户 B 生成一对密钥（公钥和私钥），将公钥发送给用户 A。\n2.  PGP 软件使用算法生成一个随机的会话密钥，这个密钥是一个很大的数字，而且只使用一次。\n3.  用户 A 用刚刚生成的密钥，加密邮件，并使用用户 B 的公钥对该密钥进行加密。\n4.  最后，用户 A 将加密的邮件及密钥发送给用户 B，用户 B 使用自己的私钥进行解密，得到会话密钥，进而可以解密完整的邮件。\n\n## PGP 加密用途\n\nPGP 有三个主要用途：\n\n- **发送和接收加密电子邮件。**\n- 验证向您发送此消息的人员的身份，即**数字签名验证**。\n- 加密数据。\n\n其中，发送安全电子邮件 - 是迄今为止 PGP 的主要应用。数字签名是一种基于公钥加密的技术，用于证明信息的发送者身份和信息完整性，以及防止信息被篡改。发送方使用自己的私钥对消息的摘要进行加密，生成数字签名。接收方使用发送方的公钥对数字签名进行解密，并生成消息的摘要，比对两个摘要是否一致，来验证消息的完整性和身份。如果数字签名验证失败，则说明消息可能被篡改或者来自伪造的发送方。\n\n## 总结\n\nPGP 使用对称密钥加密算法保护数据机密性，使用公钥加密算法保护对称密钥的安全性，使用数字签名技术验证消息的完整性和身份。这种结合了对称密钥和公钥加密的方法，可以在安全性和效率之间取得平衡。PGP 已经成为一种被广泛应用的数据加密和数字签名的标准，保护了用户的隐私和安全。\n\n## Reference\n\n[Pretty Good Privacy - Wikipedia](https://en.wikipedia.org/wiki/Pretty_Good_Privacy)\n\n[What is PGP Encryption and How Does It Work? | Varonis](https://www.varonis.com/blog/pgp-encryption/)\n\n[Public Key Cryptography Simply Explained | Hacker Noon](https://hackernoon.com/public-key-cryptography-simply-explained-e932e3093046)","date_published":"2023-02-18T07:59:25.000Z"},{"id":"/blog/restore-windows-efi-partion","url":"/blog/restore-windows-efi-partion","title":"如何恢复 Windows EFI 分区","content_html":"最近在电脑上安装了最新的 Arch Linux，这次不同于之前，使用了 Gnome 的桌面环境，用起来还不错，所以就按照我之前的配置文件，光速配置了一下电脑。然而当我配置 Windows 双启动的时候，却找不到 Windows 的 EFI 分区了，很奇怪，我的两个系统安装在两个硬盘里，所以不存在我误操作删除 EFI 分区的问题。而且我在 Linux 系统还能挂载 Windows 的数据，数据也没有丢失。\n\n然后我尝试搜索问题出现的原因，没找到，不过却找到了解决方案，方法倒是不是特别难，用到了一个 Windows 的[bcdboot](https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/bcdboot-command-line-options-techref-di)命令，这里记录一下。\n\n## 操作流程\n\n第一步，准备一个 Windows 的安装介质，推荐使用[Ventoy](https://www.ventoy.net/)，开源免费，甚至不用格式化 U 盘！！\n\n第二步，boot 进 live 安装系统，依次点击`Repair Computer > Troubleshoot > Advanced > Command Prompt`\n\n第三步，进入命令提示符后，使用以下命令显示分区：\n\n```bash\n$ diskpart // 运行 diskpart\ndiskpart> list disk  // 列出所有硬盘，每个硬盘都有一个编号（e.g. 0/1/2）\ndiskpart> sel disk <disk_id> // 选择 Windows 系统 EFI 分区所在的硬盘，如果不存在，则需要手动创建，具体下方`UPDATED`的详细说明\ndiskpart> list partition // 列出所有分区\ndiskpart> sel partition <id> // 选择 EFI 分区\ndiskpart> assign letter=F // 分配 EFI 一个新盘符\ndiskpart> exit //退出\n$ bcdboot C:\\Windows /s F: /f ALL // 创建所有 Windows boot files 到 F 盘\n$ reboot //重启即可正常进入 Windows\n```\n\n## 额外操作\n\nUPDATED：\n\n最近因为某种情况，Windows 启动项又消失了，这次甚至连 EFI 分区都没有了，所以又折腾了很久，这里再更新一下。\n如果出现 EFI 分区直接消失的情况，可以通过重建 EFI 分区来解决，以下是具体操作步骤：\n\n```shell\n// 创建 EFI 类型的新分区\ndiskpart> create partition efi size=100\n// 格式化\ndiskpart> format quick fs=fat32 label=\"System\"\n//分配卷标\ndiskpart> assign letter=L\ndiskpart> exit\nX:Resources> bcdboot C:\\Windows /s F: /f UEFI\n```\n\n如果最后提示以下内容，说明成功创建：\n\n```shell\nBoot files successfully created.\n```\n\n此时退出 CMD，然后重启电脑，进入 BIOS，应该就能看到 Windows 的启动选项了。\n\np.s. 有的时候，这里分配给 Windows 的系统分区的 letter 可能不是`C`，你要自己确认一下，可以使用`list\npartition`命令来查看具体在哪个分区（一般都有 label，比如`系统`或者`OS`之类的），确认之后，再执行上面的`bcdboot`，否则会创建失败。\n\n## 总结\n\n总的来说，EFI 分区消失并不是什么太大问题，恢复起来也不是很麻烦，但是每次出现这个问题就很困扰，我到现在都不知道具体什么原因引起的，猜测应该是跟双系统有关，但是我的双系统在不同的硬盘里，很奇怪。","date_published":"2023-02-08T11:03:34.000Z"},{"id":"/blog/scaleway-ipv6-server-use-guide","url":"/blog/scaleway-ipv6-server-use-guide","title":"Scaleway IPV6 server 申请及使用攻略","content_html":"前段时间偶然发现了 scaleway 这个服务商，它提供了一个 ipv6 服务器(1C1M)，一个月只要 0.4 欧，一年换算下来才 30 多 RMB。简直不要太划算，所以就立马着手进行操作，这里记录一下操作流程。\n\n## 需求条件\n\n> 一台能够接入 ipv6 网络的电脑\n>\n> 一个 cloudflare 账号\n>\n> 一个 scaleway 账号（注册时需要支持外币的信用卡）\n\n由于我的家用网络没有 ipv6（刚开始不知道没有 ipv6，一直失败给我整麻了），所以我是用一台支持 ipv6 的服务器作为跳板来进行操作的。\n\n## 下载命令行工具\n\n使用 scaleway 官方 api 进行服务器相关操作\n\n下载命令行工具\n\n```bash\nwget https://github.com/scaleway/scaleway-cli/releases/download/v2.10.0/scaleway-cli_2.10.0_linux_amd64 -O /usr/local/bin/scw\n```\n\n赋予可执行权限\n\n```bash\nchmod +x /usr/local/bin/scw\n```\n\n生成 ssh 密钥对（optional）\n\n如果你已经有了密钥对，可以不用再申请\n\n```bash\nssh-keygen -t ed25519 -C \"ipv6 test\"\n```\n\n测试是否安装成功\n\n执行以下命令，若无错误提示即成功\n\n```bash\nscw -h\n```\n\n## API key 申请\n\n我们需要申请一个 API 密钥用来在命令行登陆验证账号\n\n浏览器打开 [https://console.scaleway.com/project/credentials](https://console.scaleway.com/project/credentials)，如图点击按钮申请\n\n![image](https://imgcdn.smj.im/OLmvrdS-ZPM/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzc4ZDk2MTM5LndlYnA)\n\n然后输入用途描述，可以随便写\n\n![image](https://imgcdn.smj.im/AIuO81Sn8N8/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzc2Y2VkYThjLndlYnA)\n\n点击生成之后会出现下面的窗口，复制其中的`Secret Key`字段（注意这个字段只出现一次，如果忘记需要重新申请），点击`OK`即可。\n\n![image](https://imgcdn.smj.im/mNUJf7peV0w/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzcyNTczOTQwLndlYnA)\n\n## 初始化配置\n\n执行`scw init`初始化设置\n\n```bash\nroot@Cloud:~# scw init\n\n                               @@@@@@@@@@@@@@@.\n                             @@@@@@@@@@@@@@@@@@@@        __          __  _\n                             @@@               @@@@      \\ \\        / / | |\n                             @@@    @@@@@@@     .@@@      \\ \\  /\\  / /__| | ___ ___  _ __ ___   ___\n                             @@@   @@@@@@@@      @@@       \\ \\/  \\/ / _ \\ |/ __/ _ \\| '_ ` _ \\ / _ \\\n                             @@@   @@@           @@@        \\  /\\  /  __/ | (_| (_) | | | | | |  __/\n                             @@@   @@@     @@@   @@@         \\/  \\/ \\___|_|\\___\\___/|_| |_| |_|\\___|\n                             @@@   @@@     @@@   @@@                                         _  _\n                             @@@           @@@   @@@                                        | |(_)\n                             @@@      .@@@@@@@   @@@             ___   ___ __      __   ___ | | _\n                             @@@      @@@@@@@    @@@            / __| / __|\\ \\ /\\ / /  / __|| || |\n                              @@@.               @@@            \\__ \\| (__  \\ V  V /  | (__ | || |\n                               @@@@@@.         .@@@@            |___/ \\___|  \\_/\\_/    \\___||_||_|\n                                  @@@@@@@@@@@@@@@@.\n\n------------------------------------------------------------------------------------------------------------------------------------------\n\nEnter a valid secret-key:  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\n\nTo improve this tool we rely on diagnostic and usage data.\nSending such data is optional and can be disabled at any time by running \"scw config set send-telemetry=false\".\nDo you want to send usage statistics and diagnostics? (Y/n): n\n\nTo fully enjoy Scaleway CLI we recommend you install autocomplete support in your shell.\nDo you want to install autocomplete? (Y/n): n\nCreating new config at /root/.config/scw/config.yaml\nConfig saved at /root/.config/scw/config.yaml:\naccess_key: SCWHDEBGKTK0J4A13FV8\nsecret_key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\ndefault_organization_id: 00000000-0000-0000-0000-000000000000\ndefault_project_id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\ndefault_region: fr-par\ndefault_zone: fr-par-1\n\nAn SSH key is required if you want to connect to a server. More info at https://www.scaleway.com/en/docs/configure-new-ssh-key\nWe found an SSH key in ~/.ssh/id_ed25519.pub. Do you want to add it to your Scaleway account? (Y/n): Y\n\n✅ Initialization completed with success.\n```\n\n按照提示输入生成的 API 密钥/是否同意分析匿名数据/是否安装命令行自动补全，根据需求输入`Y`/`N`就行，至于最后一步是否添加 SSH key 到账户，建议选择`Y`，否则需要自己手动在[网页控制台](https://console.scaleway.com/project/credentials)添加。\n\n到这里所有的账户配置就已经完成了，接下来就是申请服务器了，这个就很简单了。\n\n## 申请服务器\n\n建议申请荷兰的服务器，法国的很难申请，要看运气。\n\n```bash\nscw instance server create type=STARDUST1-S zone=nl-ams-1 image=debian_bullseye root-volume=l:10G name=Debian ip=none ipv6=true project-id=8c2b7b55-a411-4720-8f40-204bb89aa557\n```\n\n这里会提示一串服务器相关信息，无论你是否申请成功。\n\n执行下面的命令测试是否安装成功\n\n```bash\nroot@cloud:~# scw instance server list zone=nl-ams-1\nID                                    NAME    TYPE         STATE    ZONE      PUBLIC IP  PRIVATE IP   TAGS  IMAGE NAME\nxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  Debian  STARDUST1-S  running  nl-ams-1  -          10.19.68.73  []    Debian Bullseye\n```\n\n如果状态是 starting，稍等几秒再执行一次。\n\n如果状态是 running，说明安装成功。\n\n如果状态是 archived，说明创建失败，删除然后重新申请即可。\n\n```bash\nssh-keygen -t ed25519\n\nscw init\n\n6d40b8e5-2797-4527-b8ce-2a2cfc41ad18\n\nscw instance server create type=STARDUST1-S zone=nl-ams-1 image=debian_bullseye root-volume=l:10G name=Debian ip=none ipv6=true project-id=8c2b7b55-a411-4720-8f40-204bb89aa557\n\nscw instance server create type=STARDUST1-S zone=fr-par-1 image=debian_bullseye root-volume=l:10G name=Debian ip=none ipv6=true project-id=8c2b7b55-a411-4720-8f40-204bb89aa557\n```\n\n## 配置服务器\n\n### ssh 连接服务器\n\n服务器的 ipv6 地址可以在网页控制台查看，与一般服务器连接不一样的是，scaleway 的服务器只支持使用 public key 来进行验证登陆，不支持密码登陆。\n\n```bash\nroot@cloud:~# ssh-agent bash\nroot@cloud:~# ssh-add\nEnter passphrase for /root/.ssh/id_ed25519:\nIdentity added: /root/.ssh/id_ed25519 (root@racknerd-07bcb2)\nroot@cloud:~# ssh root@<ipv6 address>\nLinux Debian 5.10.0-20-cloud-amd64 #1 SMP Debian 5.10.158-2 (2022-12-13) x86_64\n\nThe programs included with the Debian GNU/Linux system are free software;\nthe exact distribution terms for each program are described in the\nindividual files in /usr/share/doc/*/copyright.\n\nDebian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent\npermitted by applicable law.\nroot@Debian:~#\n```\n\n### 使用 WARP 获取 ipv4\n\n这里我是用的开源脚本进行安装配置的，使用起来很简单\n\n运行安装脚本 按照提示操作即可\n\n<details>\n<summary>安装过程(较长)</summary>\n\n```bash\nroot@Debian:~# wget -N https://raw.githubusercontent.com/fscarmen/warp/main/menu.sh && bash menu.sh\n Language:\n 1. English (default)\n 2. 简体中文\n\n Choose: 2\n\n 所有依赖已存在，不需要额外安装\n\n 检查环境中……\n 本项目专为 VPS 添加 wgcf 网络接口，详细说明: [https://github.com/fscarmen/warp]\n 脚本特点:\n     • 支持 WARP+ 账户，附带第三方刷 WARP+ 流量和升级内核 BBR 脚本\n     • 普通用户友好的菜单，进阶者通过后缀选项快速搭建\n     • 智能判断操作系统: Ubuntu 、Debian 、CentOS、 Alpine 和 Arch Linux，请务必选择 LTS 系统\n     • 支持硬件结构类型: AMD、 ARM 和 s390x\n     • 结合 Linux 版本和虚拟化方式，自动优选 4 个 WireGuard 方案。网络性能方面: 内核集成 WireGuard > 安装内核模块 > wireguard-go\n     • 智能判断 WGCF 作者 github 库的最新版本 （Latest release）\n     • 支持 WARP Linux Socks5 Client\n     • 输出执行结果，提示是否使用 WARP IP ，IP 归属地和线路提供商\n\n======================================================================================================================\n\n 脚本版本:2.46   功能新增:通过 [warp s 4/6/d] 来切换 IPv4 / IPv6 的优先级别\n 系统信息:\n     当前操作系统:Debian GNU/Linux 11 (bullseye)\n     内核:5.10.0-20-cloud-amd64\n     处理器架构:amd64\n     虚拟化:kvm\n     IPv4:\n     IPv6: 2001:bc8:1830:224::1    Scaleway\n     WARP 网络接口未开启\n     Client 未安装\n     WireProxy 未安装\n\n======================================================================================================================\n\n 1.  为 NAT IPv4 添加 WARP IPv4 网络接口 (bash menu.sh 4)\n 2.  为 NAT IPv4 添加 WARP IPv6 网络接口 (bash menu.sh 6)\n 3.  为 NAT IPv4 添加 WARP 双栈网络接口 (bash menu.sh d)\n 4.  打开 WARP (warp o)\n 5.  安装 CloudFlare Client 并设置为 Proxy 模式 (bash menu.sh c)\n 6.  更换支持 Netflix 的 IP (warp i)\n 7.  永久关闭 WARP 网络接口，并删除 WARP、 Linux Client 和 WireProxy (warp u)\n 8.  刷 WARP+ 流量 (warp p)\n 9.  升级内核、安装 BBR、DD 脚本 (warp b)\n 10. 同步最新版本 (warp v)\n 11. WARP 解锁 Netflix 等流媒体专业一键(支持多平台、多方式和 TG 通知)\n 12. 安装 iptable + dnsmasq + ipset，让 WARP IPv4 only 接管流媒体流量 (不适用于 IPv6 only VPS) (bash menu.sh e)\n 13. 安装 wireproxy，让 WARP 在本地创建一个 socks5 代理 (bash menu.sh w)\n 14. 安装 CloudFlare Client 并设置为 WARP 模式 (bash menu.sh l)\n 0.  退出脚本\n\n 请选择: 3\n\n 如有 WARP+ 或 Teams 账户请选择\n 1. 使用免费账户 (默认)\n 2. WARP+\n 3. Teams\n\n 请选择: 1\n\n 请选择优先级别:\n 1. IPv4\n 2. IPv6\n 3. 使用 VPS 初始设置 (默认)\n\n 请选择: 3\n\n 进度 1/3: 安装系统依赖……\n\n--2023-02-03 07:45:30--  https://github.com/ViRb3/wgcf/releases/download/v2.2.15/wgcf_2.2.15_linux_amd64\nResolving github.com (github.com)... failed: No address associated with hostname.\nwget: unable to resolve host address ‘github.com’\n--2023-02-03 07:45:30--  https://raw.githubusercontent.com/fscarmen/warp/main/wgcf/wgcf_2.2.15_linux_amd64\nResolving raw.githubusercontent.com (raw.githubusercontent.com)... 2606:50c0:8000::154, 2606:50c0:8001::154, 2606:50c0:8002::154, ...\nConnecting to raw.githubusercontent.com (raw.githubusercontent.com)|2606:50c0:8000::154|:443... connected.\nHit:1 http://ppa.launchpad.net/scaleway/stable/ubuntu focal InRelease\nGet:2 https://dl.cloudsmith.io/public/caddy/stable/deb/debian any-version InRelease [7,505 B]\nHit:3 http://security.debian.org/debian-security bullseye-security InRelease\nHit:4 http://deb.debian.org/debian bullseye InRelease\nHit:5 http://deb.debian.org/debian bullseye-updates InRelease\n0% [Waiting for headers]200 OK\nLength: 8687616 (8.3M) [application/octet-stream]\nSaving to: ‘/usr/bin/wgcf’\n\n/usr/bin/wgcf              100%[======================================>]   8.29M  --.-KB/s    in 0.04s\n\n2023-02-03 07:45:31 (196 MB/s) - ‘/usr/bin/wgcf’ saved [8687616/8687616]\n\nHit:6 http://deb.debian.org/debian bullseye-backports InRelease\nFetched 7,505 B in 1s (9,123 B/s)\nReading package lists... Done\nBuilding dependency tree... Done\nReading state information... Done\n7 packages can be upgraded. Run 'apt list --upgradable' to see them.\nW: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Packages (main/binary-all/Packages) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Translations (main/i18n/Translation-en_US) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Translations (main/i18n/Translation-en) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Packages (main/binary-amd64/Packages) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Packages (main/binary-all/Packages) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Translations (main/i18n/Translation-en_US) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nW: Target Translations (main/i18n/Translation-en) is configured multiple times in /etc/apt/sources.list:7 and /etc/apt/sources.list.d/backports.list:1\nReading package lists... Done\nBuilding dependency tree... Done\nReading state information... Done\niptables is already the newest version (1.8.7-1).\nnet-tools is already the newest version (1.60+git20181103.0eebece-1).\nnet-tools set to manually installed.\nThe following packages will be REMOVED:\n  resolvconf\nThe following NEW packages will be installed:\n  bind9-dnsutils dnsutils openresolv\nThe following packages will be upgraded:\n  bind9-libs\n1 upgraded, 3 newly installed, 1 to remove and 6 not upgraded.\nNeed to get 2,120 kB of archives.\nAfter this operation, 975 kB of additional disk space will be used.\nGet:1 http://deb.debian.org/debian bullseye/main amd64 openresolv all 3.12.0-1 [25.4 kB]\nGet:2 http://security.debian.org/debian-security bullseye-security/main amd64 bind9-libs amd64 1:9.16.37-1~deb11u1 [1,424 kB]\nGet:3 http://security.debian.org/debian-security bullseye-security/main amd64 bind9-dnsutils amd64 1:9.16.37-1~deb11u1 [404 kB]\nGet:4 http://security.debian.org/debian-security bullseye-security/main amd64 dnsutils all 1:9.16.37-1~deb11u1 [267 kB]\nFetched 2,120 kB in 1s (1,920 kB/s)\napt-listchanges: Reading changelogs...\n(Reading database ... 34802 files and directories currently installed.)\nRemoving resolvconf (1.87) ...\n\n 进度 2/3: 已安装 WGCF\n\n                   resolvconf.postrm: Reboot recommended\n(Reading database ... 34785 files and directories currently installed.)\nPreparing to unpack .../bind9-libs_1%3a9.16.37-1~deb11u1_amd64.deb ...\nUnpacking bind9-libs:amd64 (1:9.16.37-1~deb11u1) over (1:9.16.33-1~deb11u1) ...\nSelecting previously unselected package bind9-dnsutils.\nPreparing to unpack .../bind9-dnsutils_1%3a9.16.37-1~deb11u1_amd64.deb ...\nUnpacking bind9-dnsutils (1:9.16.37-1~deb11u1) ...\nSelecting previously unselected package dnsutils.\nPreparing to unpack .../dnsutils_1%3a9.16.37-1~deb11u1_all.deb ...\nUnpacking dnsutils (1:9.16.37-1~deb11u1) ...\nSelecting previously unselected package openresolv.\nPreparing to unpack .../openresolv_3.12.0-1_all.deb ...\nUnpacking openresolv (3.12.0-1) ...\nSetting up bind9-libs:amd64 (1:9.16.37-1~deb11u1) ...\nSetting up openresolv (3.12.0-1) ...\nInstalling new version of config file /etc/dhcp/dhclient-enter-hooks.d/resolvconf ...\nInstalling new version of config file /etc/network/if-down.d/resolvconf ...\nInstalling new version of config file /etc/network/if-up.d/000resolvconf ...\nInstalling new version of config file /etc/ppp/ip-down.d/000resolvconf ...\nInstalling new version of config file /etc/ppp/ip-up.d/000resolvconf ...\nSetting up bind9-dnsutils (1:9.16.37-1~deb11u1) ...\nSetting up dnsutils (1:9.16.37-1~deb11u1) ...\nProcessing triggers for libc-bin (2.31-13+deb11u5) ...\nProcessing triggers for man-db (2.9.4-2) ...\nReading package lists... Done\nBuilding dependency tree... Done\nReading state information... Done\nThe following NEW packages will be installed:\n  wireguard-tools\n0 upgraded, 1 newly installed, 0 to remove and 6 not upgraded.\nNeed to get 86.2 kB of archives.\nAfter this operation, 327 kB of additional disk space will be used.\nGet:1 http://deb.debian.org/debian bullseye/main amd64 wireguard-tools amd64 1.0.20210223-1 [86.2 kB]\nFetched 86.2 kB in 0s (196 kB/s)\nSelecting previously unselected package wireguard-tools.\n(Reading database ... 34824 files and directories currently installed.)\nPreparing to unpack .../wireguard-tools_1.0.20210223-1_amd64.deb ...\nUnpacking wireguard-tools (1.0.20210223-1) ...\nSetting up wireguard-tools (1.0.20210223-1) ...\nwg-quick.target is a disabled or a static unit, not starting it.\nProcessing triggers for man-db (2.9.4-2) ...\n 创建快捷 warp 指令成功\n 运行 WARP\n 后台获取 WARP IP 中,最大尝试 5 次……\n 第 1 次尝试\n 已成功获取 WARP 网络\n\n==============================================================\n\n IPv4: 104.28.219.140 ( WARP IPv4 ) 荷兰  Cloudflare\n IPv6: 2a09:bac1:5540::14:2a2 ( WARP IPv6 ) 荷兰  Cloudflare\n 恭喜！WARP 已开启，总耗时:33 秒， 脚本当天运行次数:1100，累计运行次数:2032952\n IPv6 优先\n\n==============================================================\n\n 再次运行用 warp [option] [lisence]，如\n\n warp h (帮助菜单）\n warp n (获取 WARP IP)\n warp o (临时 warp 开关)\n warp u (卸载 WARP 网络接口和 Socks5 Client)\n warp b (升级内核、开启 BBR 及 DD)\n warp a (更换账户为 Free，WARP+ 或 Teams)\n warp p (刷 WARP+流量)\n warp v (同步脚本至最新版本)\n warp r (WARP Linux Client 开关)\n warp 4/6 (WARP IPv4/IPv6 单栈)\n warp d (WARP 双栈)\n warp c (安装 WARP Linux Client，开启 Socks5 代理模式)\n warp l (安装 WARP Linux Client，开启 WARP 模式)\n warp i (更换支持 Netflix 的 IP)\n warp e (安装 Iptables + dnsmasq + ipset 解决方案)\n warp w (安装 WireProxy 解决方案)\n warp y (WireProxy socks5 开关)\n warp s 4/6/d (优先级: IPv4 / IPv6 / VPS default)\n```\n\n</details>\n\n<br>\n\n<details>\n<summary>图示流程</summary>\n\n![image](https://imgcdn.smj.im/M-4q9aCCNXg/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E4NWIyMzIxLndlYnA)\n\n![image](https://imgcdn.smj.im/z1xeZTHDifQ/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E4YjlhZTM3LndlYnA)\n\n![image](https://imgcdn.smj.im/-AKg4jOXyyg/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E4Mzg1MDg4LndlYnA)\n\n![image](https://imgcdn.smj.im/xbT17PVfgec/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E4ODJmZTY0LndlYnA)\n\n![image](https://imgcdn.smj.im/MQZFVbuZOPI/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E3ZWViYzA3LndlYnA)\n\n</details>\n\n## 测试是否配置成功\n\n执行`ip addr`，如果出现了一个 wgcf 的网卡，说明配置成功，或者直接执行`ping -4 google.com`测试能 ping 通。\n\n```bash\nroot@Debian:~# ping -4 google.com\nPING  (142.251.36.14) 56(84) bytes of data.\n64 bytes from ams15s44-in-f14.1e100.net (142.251.36.14): icmp_seq=1 ttl=119 time=2.40 ms\n64 bytes from ams15s44-in-f14.1e100.net (142.251.36.14): icmp_seq=2 ttl=119 time=2.62 ms\n64 bytes from ams15s44-in-f14.1e100.net (142.251.36.14): icmp_seq=3 ttl=119 time=2.78 ms\n64 bytes from ams15s44-in-f14.1e100.net (142.251.36.14): icmp_seq=4 ttl=119 time=2.68 ms\n```\n\n到这里所有都配置成功了。接下来的使用就和一个普通的服务器没有太大区别了，你可以用来做任何事情，我是用来运行一个没人看的[博客](https://smj.im)，套上 CF 速度感觉还不错:）","date_published":"2023-02-03T02:45:13.000Z"},{"id":"/blog/signature-invalid-when-upgrading-archlinux","url":"/blog/signature-invalid-when-upgrading-archlinux","title":"Arch Linux 升级系统提示签名无效","content_html":"今天升级系统的时候，竟然升级失败了，提示：\n\n```bash\nerror: PackageName: signature from \"User <email@archlinux.org>\" is invalid\nerror: failed to commit transaction (invalid or corrupted package (PGP signature))\nErrors occurred, no packages were upgraded.\n```\n\n我瞬间懵逼了，因为是第一次碰到这个问题，用了这么久，从未出现过这个问题，所以就马上 Google 类似问题\n发现是 keyring 的问题，所以就试着直接先更新 keyring\n\n```sh\nsudo pacman -Sy archlinux-keyring\n```\n\n然而并没有什么卵用，然后在 archlinux 的论坛找到了一个和我完全一样问题的答案，直接重置所有 cache 然后重置`pacman-key`\n\n```sh\nsudo pacman -Sc\nsudo rm -r /etc/pacman.d/gnupg\nsudo pacman-key --init\nsudo pacman-key --populate\nsudo pacman -Sy archlinux-keyring\nsudo pacman -Syu\n```\n\n**reference**\n\n[https://wiki.archlinux.org/title/Pacman/Package_signing#Troubleshooting](https://wiki.archlinux.org/title/Pacman/Package_signing#Troubleshooting)","date_published":"2023-01-05T06:00:01.000Z"},{"id":"/blog/resolve-noise-issue-in-archlinux","url":"/blog/resolve-noise-issue-in-archlinux","title":"Arch Linux 音响有杂音的解决办法","content_html":"> Arch Linux 台式机（AMD）\n\n最近安装完新系统之后，在配置电脑的时候发现电脑的音响在不播放声音的时候会出现`puta puta`的声音。\n\n### 原因\n\n某些驱动模块会在声卡闲置时关闭它以节约用电。\n\n### 解决办法\n\n方法 1：\n\n在`/etc/modprobe.d`目录下新建一个`disablePowerSaving.conf`文件，写入以下内容\n\n```txt title='disablePowerSaving.conf'\noptions snd_hda_intel power_save=0\n```\n\n重启电脑应该就可解决，如果还有噪音，可能还需要禁用声卡控制器的省电功能：\n\n````txt title='disablePowerSaving.conf'\noptions snd_hda_intel power_save=0 power_save_controller=N\n```\n\n方法 2：\n\n还有另外一种方法，就是添加内核参数：\n\n```txt\nmodprobe snd_hda_intel power_save=0\n```\n\n我使用的是 GRUB 引导，编辑`/etc/default/grub`文件，将上述内容附加在`GRUB_CMDLINE_LINUX_DEFAULT`的值后面，然后重新生成 grub 配置：\n\n```shell\ngrub-mkconfig -o /boot/grub/grub.cfg\n```\n\n### 参考\n\n[https://wiki.archlinux.org/title/Advanced_Linux_Sound_Architecture/Troubleshooting#Pops_when_starting_and_stopping_playback](https://wiki.archlinux.org/title/Advanced_Linux_Sound_Architecture/Troubleshooting#Pops_when_starting_and_stopping_playback)\n\n[https://docs.kernel.org/sound/designs/powersave.html](https://docs.kernel.org/sound/designs/powersave.html)\n\n[https://bbs.archlinux.org/viewtopic.php?id=267838](https://bbs.archlinux.org/viewtopic.php?id=267838)","date_published":"2022-07-04T02:20:22.000Z"},{"id":"/blog/how-to-change-archlinux-kernel","url":"/blog/how-to-change-archlinux-kernel","title":"Arch Linux 如何切换内核","content_html":"## Notice\n\n切换内核不是一件容易的事。我建议你有一个实际的理由这样做，而不仅仅是实验/为了好玩。虽然这本身并不是一个困难的过程。因为 linux 发行版通常设置为与特定内核配合使用。虽然有些不像其他发行版那样与内核紧密相连，但许多发行版维护者选择特定的内核是有原因的。Arch Linux 发行版不像 Ubuntu，RHEL 发行版等那样与特定的内核绑定。所以我使用 ArchLinux 来进行演示。\n\n这里列举目前 ArchLinux 官方支持的内核：\n\n- **Stable** — 原版的 Linux 内核以及模块, 使用了一些补丁。\n\n[https://www.kernel.org/](https://www.kernel.org/) || linux\n\n- **Hardened** — 更加注重安全的 Linux 内核，采用一系列 [加固补丁](https://github.com/thestinger/linux-hardened) 以减少内核和用户空间产生漏洞的风险。和 [linux](https://archlinux.org/packages/?name=linux) 相比，还启用了一些加固选项，比如用户命名空间(同时通过补丁禁用未授权用户的访问)、审计以及 [SELinux](https://wiki.archlinux.org/title/SELinux)\n\n[https://github.com/anthraxx/linux-hardened](https://github.com/anthraxx/linux-hardened) || linux-hardened\n\n- **Longterm** — 包含了长期支持的 Linux 内核和内核模块。\n\n[https://www.kernel.org/](https://www.kernel.org/) || linux-lts\n\n- **Zen Kernel** — 一些内核黑客合作的结果，提供了适合日常使用的优秀内核。 更多详情请参见 [https://liquorix.net](https://liquorix.net/) (为 Debian 提供了基于 Zen 内核的二进制文件).\n\n[https://github.com/zen-kernel/zen-kernel](https://github.com/zen-kernel/zen-kernel) || linux-zen\n\n## 切换内核\n\n### Step 1 检查安装的内核和版本\n\n首先，使用以下命令检查当前安装的内核和版本：\n\n```\n$ uname -r\n5.17.5-zen1-1-zen\n```\n\n可以看出，我使用的是`linux-zen`内核。\n\n### Step 2 安装新内核\n\n然后，选择你需要切换的内核安装，比如说，我们要安装原版 linux 内核：\n\n```shell\nsudo pacman -S linux linux-headers\n```\n\n### Step 3 卸载现在使用的内核\n\n使用以下命令进行卸载（根据自身情况更改内核名称）：\n\n```shell\nsudo pacman -Rs linux-zen linux-zen-headers\n```\n\n### Step 4 更新 boot loader 的配置\n\n我使用的是 GRUB，使用以下命令更新：\n\n```shell\nsudo grub-mkconfig -o /boot/grub/grub.cfg\n```\n\n最后，您需要做的就是重新启动系统就可以更新到新的内核。\n\n只是要切换内核的话，到这里就结束了。但是如果你想在必要的时候，可以很快地使用不同的内核，则只需删除 Step 3 即可。但是，为了切换内核操作方便，我们可以对 GRUB 的配置文件进行一些更改。\n\n首先，使用编辑器打开`/etc/default/grub`文件：\n\n```shell\nsudo vim /etc/default/grub\n```\n\n接下来，我们将更改以下选项。根据你使用的基于 Arch 的发行版，这些设置可能有不同的顺序，已经正确设置，或者可能需要取消注释。具体根据自身情况确定。\n\n```ini title='/etc/default/grub'\nGRUB_DEFAULT=saved\nGRUB_SAVEDEFAULT=true\nGRUB_DISABLE_SUBMENU=y\n\n# 含义\n# GRUB_DEFAULT — Default boot selection.\n# GRUB_SAVEDEFAULT — GRUB to remember the last selection.\n# GRUB_DISABLE_SUBMENU — Disable submenus.\n```\n\n到这里就结束了，现在，我们就可以在 GRUB 引导界面进行内核的选择，而且 GRUB 会默认记住上次的选择，而不需要你每次都要进行选择操作。\n\n## Reference\n\n[https://wiki.archlinux.org/title/Kernel](https://wiki.archlinux.org/title/Kernel)[How to Switch your Linux Kernel in Arch Linux](https://medium.com/codex/how-to-switch-your-linux-kernel-in-arch-linux-5a39569161d9)","date_published":"2022-05-08T02:14:12.000Z"},{"id":"/blog/django-timezone-error-solution","url":"/blog/django-timezone-error-solution","title":"Django 项目时区更改错误的解决方案","content_html":"### **TL;DR**\n\n1. 修改 Django 项目的`TIME_ZONE`设置为`Asia/Shanghai`\n2. 填充 MySQL 时区表：`mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql`\n3. 向 MySQL 全局配置文件的`mysqld`中添加`default-time-zone='Asia/Shanghai'`；或者在 MySQL shell 中执行`SET GLOBAL time_zone = 'Asia/Shanghai';`\n4. 向 Django 项目设置中的`DATABASES`字段添加时区，并设置为`Asia/Shanghai`\n5. (optional)更新已经存在数据的时间：`update blog_article set column_name=DATE_ADD(column_name, INTERVAL 8 HOUR);`\n\n### 正文\n\n### 起因\n\n今天在博客迁移服务器之后，突然想起来之前部署的时候，使用的是之前服务器的时区（UTC），没有使用 CST，就想着把时区改一下，不然挺不方便，而且看着挺难受的。修改的时候碰到了一些问题，这里记录一下解决方案以及一些个人感想。\n\n### 尝试\n\n最开始，我觉得修改时区应该很简单，直接修改一下 Django 的时区设置即可。然而一个报错直接给我整不会了。\n\n![image](https://imgcdn.smj.im/XlP_Bs7mSZI/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E0MDI1MmQ5LndlYnA)\n\n根据错误提示，我推测应该是 MySQL 的时区设置也不对，也要更新一下时区，然后直接在 mysql 配置文件中设置了 CST 时区：\n\n```\ndefault-time-zone='Asia/Shanghai'\n```\n\n重启 MySQL，竟然失败了？！！！\n\n```\nRestarting mysql (via systemctl): mysql.serviceJob for mysql.service failed because the control process exited with error code.\nSee \"systemctl status mysql.service\" and \"journalctl -xe\" for details.\n failed!\n```\n\n不知道什么原因，这个方法不行，就在网上找到了另一个如何设置 MySQL 时区的[答案](https://stackoverflow.com/questions/930900/how-do-i-set-the-time-zone-of-mysql)，发现了另一种解决方法，在 MySQL 的 shell 中更新全局变量`@@global.time_zone`。所以删除了之前添加的时区配置，进入 MySQL shell 中进行设置：\n\n```\nSET @@global.time_zone = '+08:00';\n```\n\n然后，输出时区设置：\n\n```shell\nmysql> SELECT @@global.time_zone;\n+--------------------+\n| @@global.time_zone |\n+--------------------+\n| +08:00             |\n+--------------------+\n1 row in set (0.00 sec)\n```\n\n感觉设置成功了，然后尝试运行服务，发现还是同样的错误。明明时区设置成功了，为什么不生效呢？\n\n### 答案？\n\n然后突然想到一个问题，我直接 Google 报错信息不就行了？果然，立刻就发现了一个[答案](https://stackoverflow.com/questions/40792628/django-mysql-database-returned-an-invalid-datetime-value)，直接使用这个命令就能搞定：\n\n```\nmysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql\n```\n\n动手试了一下，发现还真的可以，只不过会提示一些 Warning 信息：\n\n```shell\nWarning: Unable to load '/usr/share/zoneinfo/iso3166.tab' as time zone. Skipping it.\nWarning: Unable to load '/usr/share/zoneinfo/leap-seconds.list' as time zone. Skipping it.\nWarning: Unable to load '/usr/share/zoneinfo/leapseconds' as time zone. Skipping it.\nWarning: Unable to load '/usr/share/zoneinfo/tzdata.zi' as time zone. Skipping it.\nWarning: Unable to load '/usr/share/zoneinfo/zone.tab' as time zone. Skipping it.\nWarning: Unable to load '/usr/share/zoneinfo/zone1970.tab' as time zone. Skipping it.\n```\n\n问题来了，为什么呢？虽然这样可以，但是不知道原因，心里有点不舒服，所以就查了官方文档。然后在[这里](https://dev.mysql.com/doc/refman/8.0/en/time-zone-support.html)中找到了答案：\n\n> Several tables in the mysql system schema exist to store time zone information . The MySQL installation procedure creates the time zone tables, but does not load them. To do so manually, use the following instructions.\n\n根据上面这句话我们可以很容易发现，MySQL 安装过程创建时区表，但不会加载它们，需要我们手动加载。加载方法也很简单，就是我们上面提到的那行命令：\n\n```shell\nmysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql\n```\n\n其中，`mysql_tzinfo_to_sql`y 用来读取系统的时区文件并从中生成 SQL 语句。 `mysql`y 用来处理这些语句以加载时区表。\n\n有一点要注意的是，上面的命令会加载`/usr/share/zoneinfo`下的所有时区信息，所以如果你不想这样的话，也可以选择加载自己需要的时区，命令的基本格式是：\n\n```bash\nmysql_tzinfo_to_sql tz_file tz_name | mysql -u root -p mysql\n```\n\n比如：只加载`Asia/Shanghai`时区，可以使用下面的命令：\n\n```shell\nmysql_tzinfo_to_sql /usr/share/zoneinfo/Asia/Shanghai ‘Asia/Shanghai’ | mysql -u root -p mysql\n```\n\n在更新时区表后，重新启动`mysqld`以确保它不会继续提供过时的时区配置。\n\n然后在 MySQL shell 中确认一下是否成功：\n\n```sql\nmysql> SELECT * FROM mysql.time_zone_name;\n+---------------+--------------+\n| Name          | Time_zone_id |\n+---------------+--------------+\n| Asia/Shanghai |         1    |\n+---------------+--------------+\n1 row in set (0.01 sec)\n\nmysql> SELECT @@global.time_zone;\n+--------------------+\n| @@global.time_zone |\n+--------------------+\n| Asia/Shanghai      |\n+--------------------+\n1 row in set (0.00 sec)\n```\n\n更新完 MySQL 时区设置，然后重新进入 admin 界面，时间已经改变成了 CST 时区时间。\n\n此外，在文档中我还找到了设置时区为`Asia/Shanghai`导致 MySQL 启动失败的原因：\n\n> Note\n>\n> Named time zones can be used only if **the time zone information tables in the** `**mysql**` **database** have been created and populated. Otherwise, use of a named time zone results in an error:\n>\n> ```\n> mysql> SET time_zone = 'UTC';\n> ERROR 1298 (HY000): Unknown or incorrect time zone: 'UTC'\n> ```\n\n我们从上面的粗体部分可以发现：之前之所以设置`Asia/Shanghai`不生效是因为**MySQL 仅当数据库中的时区信息表已创建并填充时，才能使用命名时区。**因为刚开始没有填充时区表，MySQL 不知道 Asia/Shanghai 代表什么意思，所以才会出错无法启动 MySQL 服务。\n\n### 测试\n\n尝试创建了一篇文章，发现时间也是对的，感觉到这里应该没什么问题了。但是，有点强迫症的我还是进入 MySQL 查看了一下数据，结果。。。数据库中的时间竟然还是 UTC 时间？？\n\n虽然还是没有成功，但是现在有一点可以确认的是，MySQL 的配置已经没有了问题，所以失败的原因出在了 Django 配置上。然后直接查看官方文档，在[其中](https://docs.djangoproject.com/en/4.0/topics/i18n/timezones/)找到了原因。\n\n> When support for time zones is enabled, Django stores datetime information in UTC in the database, uses time-zone-aware datetime objects internally, and translates them to the end user’s time zone in templates and forms.\n\n换句话说，只要是项目使用时区支持，那么，无论你设置什么时区，Django 在数据库中存储数据默认都是使用 UTC 时间。所以，如果想要更改 Django 存储数据的时区，还需要在 setting 中的 `DATABASES` 里，将`TIME_ZONE`选项设置为你想要的时区。\n\n更新了 Django 项目的配置，然后重新启动，进入 admin 界面，时间没问题，然后进入 MySQL shell 查看时间列，也没问题。终于，终于成功了！！！\n\n### 收尾\n\n当然，还有一步，那就是更新 MySQL 数据库中已经存在的数据的时间，这个直接在原来的时间上加 8 小时即可：\n\n```sql\nupdate blog_article set column_name=DATE_ADD(column_name, INTERVAL 8 HOUR);\n```\n\n### 想法\n\n最后，虽然这只是个小问题，也解决了，但是也让我有点意识到了自己的一些不好的思维方式，本来只需要直接查找一下类似的错误，很快就能找到解决方案。","date_published":"2022-03-04T02:03:26.000Z"},{"id":"/blog/linux-windows-dual-boot-tutorial","url":"/blog/linux-windows-dual-boot-tutorial","title":"超简单的 Arch Linux + Windows 双启动教程","content_html":"> OS：Arch Linux + Windows 10\n>\n> bootloader：GRUB\n\n因为偶尔仍然要使用 Windows 做些事情，之前每次都是通过 GURB 的界面退出操作进行重新选择，很是麻烦，所以就尝试进行配置 Arch Linux+Windows 的双启动。用的工具是 os-prober，操作很简单。\n\n1、首先安装`os-prober`：\n\n```shell\n[root@archlinux /]# pacman -S os-prober\n```\n\n2、检查磁盘分区，确认 Windows 的安装位置（根据自己的安装情况选择磁盘设备，我这里是`/dev/sda`）：\n\n```shell\n[root@archlinux /]# fdisk -l /dev/sda\nDisk /dev/sda: 223.6 GiB, 240057409536 bytes, 468862128 sectors\nDisk model: KINGSTON SA400S3\nUnits: sectors of 1 \\* 512 = 512 bytes\nSector size (logical/physical): 512 bytes / 512 bytes\nI/O size (minimum/optimal): 512 bytes / 512 bytes\nDisklabel type: gpt\nDisk identifier: 78241A73-6994-4D0B-9FCB-433076B5EC41\n\nDevice       Start       End   Sectors  Size Type\n/dev/sda1     2048   1023999   1021952  499M Windows recovery environment\n/dev/sda2  1024000   1228799    204800  100M EFI System\n/dev/sda3  1228800   1261567     32768   16M Microsoft reserved\n/dev/sda4  1261568 468860927 467599360  223G Microsoft basic data\n```\n\n3、找到 Windows 的 EFI 分区之后，挂载它以确保`os-prober`可以发现：\n\n```shell\n[root@archlinux /]# mount /dev/sda2 /mnt/\n[root@archlinux /]# ls -l /mnt/\ntotal 1\ndrwxr-xr-x 4 root root 1024 Feb 23 10:24 EFI\n```\n\n4、然后执行`os-prober`：\n\n```shell\n[root@archlinux /]# os-prober\n/dev/sda2@/EFI/Microsoft/Boot/bootmgfw.efi:Windows Boot Manager:Windows:efi\n```\n\n5、当然，为了安全起见，首先执行下面命令，备份原有的 boot 配置：\n\n```shell\n[root@archlinux /]# cp /boot/grub/grub.cfg /boot/grub/grub.cfg.bak\n```\n\n6、然后，重新生辰 GRUB 配置文件：\n\n```shell\n[root@archlinux /]# grub-mkconfig -o /boot/grub/grub.cfg\nGenerating grub configuration file ...\nFound linux image: /boot/vmlinuz-linux\nFound initrd image: /boot/initramfs-linux.img\nFound fallback initrd image(s) in /boot: initramfs-linux-fallback.img\nFound Windows Boot Manager on /dev/sda2@/EFI/Microsoft/Boot/bootmgfw.efi\ndone\n```\n\n7、最后重启电脑就可以在 GRUB 界面直接选择想要进入的操作系统了。","date_published":"2022-02-23T12:59:03.000Z"},{"id":"/blog/config-firewall-using-ufw-on-ubuntu-server","url":"/blog/config-firewall-using-ufw-on-ubuntu-server","title":"使用 UFW 配置 Linux 防火墙","content_html":"大部分主流的服务器提供商（腾讯云、阿里云等），防火墙的配置很简单，只要在控制面板设置就行。服务器上设置与否无所谓。但是如果有一台便宜的 VPS，想在上面整点东西，这个时候为了数据安全的因素，就不得不手动配置了。\n\n**UFW** 代表 **Uncomplicated Firewall** ，是用于管理 `iptables`(`netfilter`) 防火墙规则的对用户更加友好的前端工具，它是 Ubuntu 的默认防火墙配置工具。\n\n### 列出 UFW 规则\n\n您可以通过以下命令检查 UFW 的状态并列出所有规则：\n\n```bash\nsudo ufw status\n```\n\n如果未启用 UFW，则会显示：\n\n```bash\nStatus: inactive\n```\n\n如果已经启用，则 UFW 处于活动状态，输出将打印所有活动防火墙规则的列表：\n\n```bash\nStatus: active\n\nTo                        Action      From\n--                        ------      ----\n22/tcp                    ALLOW      Anywhere\n22/tcp (v6)                ALLOW      Anywhere (v6)\n```\n\n如果想要获得额外信息，可以使用`status verbose`：\n\n```bash\nsudo ufw status verbose\n```\n\n输出将包含有关日志记录，默认策略和新配置文件的信息：\n\n```bash\nStatus: active\nLogging: on (low)\nDefault: deny (incoming), allow (outgoing), disabled (routed)\nNew profiles: skip\n\nTo                        Action      From\n--                        ------      ----\n22/tcp                    ALLOW      Anywhere\n22/tcp (v6)                ALLOW      Anywhere (v6)\n```\n\n如果想要得到所有活动规则的顺序和 ID，可以使用`status numbered`：\n\n```bash\nsudo ufw status numbered\n```\n\n输出则会显示以下内容：\n\n```bash\nStatus: active\n\n To                         Action      From\n --                         ------      ----\n[ 1] 22/tcp                     ALLOW IN    Anywhere\n[ 2] 22/tcp (v6)                ALLOW IN    Anywhere (v6)\n```\n\n### 添加 UFW 规则\n\n添加规则很简单，不过在添加之前，首先确认 UFW 是否开启。\n\n例如，如果你要添加打开`12345`端口的规则，键入以下命令即可：\n\n```bash\nsudo ufw allow 12345\n```\n\n拒绝：\n\n```bash\nsudo ufw deny 12345\n```\n\n### 删除 UFW 规则\n\n有两种方法可以删除 UFW 规则：\n\n- 按规则编号\n- 按规则格式","date_published":"2022-01-31T02:25:02.000Z"},{"id":"/blog/a-special-hash-in-git","url":"/blog/a-special-hash-in-git","title":"Git 中的一个特殊 hash","content_html":"最近了解了一点 Git 的内部原理，看到了一个特殊的 hash，所以写了这一篇文章来分享自己的看法。\n\n==============\n\n既然你读这篇文章，那就意味着你应该比较熟悉 Git 的一系列操作，不过，在你使用 Git 的时候，你有没有遇到以下 hash：\n\n```txt\n4b825dc642cb6eb9a060e54bf8d69288fbee4904\n```\n\n可能你会觉得 git 中的每个对象都有一个 hash 值，谁会注意 hash 的数值。确实，没有人会注意。\n\n但是上面的这个 hash 确实是一个很特别的 hash，接下来就来说明为什么这个 hash 是一个特殊的存在。\n\n## git 中 hash 从哪里来？\n\n每个 git 存储库，即使是空存储库也将包含这段 hash。这可以通过 git show 验证：\n\n```shell\n$ git show 4b825dc642cb6eb9a060e54bf8d69288fbee4904\ntree 4b825dc642cb6eb9a060e54bf8d69288fbee4904\n```\n\n那么这个 hash 是从哪里来的呢？在这之前我们需要了解一点 Git 的知识：_Git 的核心部分是一个简单的键值对数据库（key-value data store）。 你可以向 Git 仓库中插入任意类型的内容，它会返回一个唯一的键，通过该键可以在任意时刻再次取回该内容。_\n\n我们可以使用`git hash-object`命令来存储一个对象并获取该对象的键。\n\n```shell\n$ echo 'test' | git hash-object -w --stdin\n9daeafb9864cf43055ae93beb0afd6c7d144bfa4\n```\n\nGit 内部存储的数据类似下面这样，其中每个对象都有其对应的 hash 值：\n\n![image](https://imgcdn.smj.im/OClXf55Gamg/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2RlZmE3MGM2LndlYnA)\n\n_ps：如果你仍然好奇，Pro Git 的_ _[Git Internals](https://git-scm.com/book/en/v2/Git-Internals-Git-Objects)_ _章节有更多详细介绍。_\n\n那么接下来说正题，这个特殊 hash 是如何产生的呢？它实际上是一棵空树的哈希值。可以通过为空字符串的`/dev/null`创建对象哈希来验证：\n\n```shell\n$ git hash-object -t tree /dev/null\n4b825dc642cb6eb9a060e54bf8d69288fbee4904\n//或者\n$ echo -n '' | git hash-object -t tree --stdin\n4b825dc642cb6eb9a060e54bf8d69288fbee4904\n```\n\n## 空树 hash 的特殊用处\n\n空树 hash 可以与`git diff`一起使用。例如，如果你想检查目录中的空白错误，您可以使用 `--check` 选项并将 HEAD 与空树进行比较：\n\n```shell\n$ echo \"test  \" > readme.md\n$ git add . && git commit -m \"init\"\n[master 6d8e897] init\n 1 file changed, 1 insertion(+), 3 deletions(-)\n$ git diff $(git hash-object -t tree /dev/null) HEAD --check -- readme.md\nreadme.md:1: trailing whitespace.\n+test\n```\n\n在编写 `git hooks` 时，空树 hash 也非常有用。一个相当常见的用法是在使用类似于以下的代码在接受新提交之前验证它们：\n\n```shell\nfor changed_file in $(git diff --cached --name-only --diff-filter=ACM HEAD)\ndo\n  if ! validate_file \"$changed_file\"; then\n    echo \"Aborting commit\"\n    exit 1\n  fi\ndone\n```\n\n如果有以前的提交，这可以正常工作，但是如果没有提交，则 `HEAD` 引用将不存在。为了解决这个问题，可以在检查初始提交时使用空树 hash：\n\n```shell\nif git rev-parse --verify -q HEAD > /dev/null; then\n  against=HEAD\nelse\n  # Initial commit: diff against an empty tree object\n  against=\"$(git hash-object -t tree /dev/null)\"\nfi\n\nfor changed_file in $(git diff --cached --name-only --diff-filter=ACM \"$against\")\ndo\n  if ! validate_file \"$changed_file\"; then\n    echo \"Aborting commit\"\n    exit 1\n  fi\ndone\n```\n\n## 参考\n\n[https://git-scm.com/book/en](https://git-scm.com/book/en)\n\n[https://floatingoctothorpe.uk/2017/empty-trees-in-git.html](https://floatingoctothorpe.uk/2017/empty-trees-in-git.html)","date_published":"2022-01-30T02:23:03.000Z"},{"id":"/blog/understanding-mysql-transaction","url":"/blog/understanding-mysql-transaction","title":"深入理解数据库事务","content_html":"## 定义\n\n事务(Transaction)在计算机术语中是数据库管理系统执行过程中的一个由一个有限的数据库操作序列构成的逻辑单位。 在数据库中以一致模式完成的任何逻辑计算都称为事务。\n\n## 性质\n\n数据库事务通常包含了一个序列的对数据库的读/写操作。包含有以下两个目的：\n\n1.  提供可靠的工作单元，可以从故障中正确恢复并保持数据库一致，即使在系统故障的情况下（执行停止（完全或部分）并且对数据库的许多操作仍未完成且状态不明时）。\n2.  提供并发访问数据库的程序之间的隔离,以防止彼此的操作互相干扰。如果没有提供这种隔离，程序的结果可能是错误的。\n\n当事务被提交给了数据库管理系统（DBMS），则 DBMS 需要确保该事务中的所有操作都成功完成且其结果被永久保存在数据库中，如果事务中有的操作没有成功完成，则事务中的所有操作都需要回滚，回到事务执行前的状态；同时，该事务对数据库或者其他事务的执行无影响，所有的事务都好像在独立的运行。\n\n## ACID 特性\n\n根据定义，数据库事务必须是**原子**的（它必须是完整的或没有任何影响）、**一致**的（它必须符合数据库中现有的约束）、**隔离**的（它不能影响其他事务）和**持久**的（它必须写入持久存储）。数据库从业者经常使用首字母缩写词 **ACID** 来指代数据库事务的这些属性。\n\n- **原子性（Atomicity）**：事务作为一个整体被执行，包含在其中的对数据库的操作要么全部被执行，要么都不执行。\n- **一致性（Consistency）**：事务应确保数据库的状态从一个一致状态转变为另一个一致状态。*一致状态*的含义是数据库中的数据应满足完整性约束，即系统获得有效的新状态或保持在先前状态。\n- **隔离性（Isolation）**：处理过程中事务与其他事务分开，一个事务的执行不应影响其他事务的执行。\n- **持久性（Durability）**：已被提交的事务对数据库的修改应该永久保存在数据库中，即使在系统出现故障后系统仍保持有效状态。\n\n## 示例\n\n张三要在商店购买 100 元的东西，当中至少包括两个操作：\n\n1.  张三账户减少 100 元\n2.  商店账户增加 100 元\n\n**原子性：**\n\n数据库管理系统就要确保以上两个操作（整个“事务”）都能完成，或一起取消；否则就会出现 100 元平白消失或出现的情况。\n\n**一致性：**\n\n交易完成，张三账户减少 100 元，商店账户增加 100 元\n\n交易失败，张三账户和商店账户不变\n\n**隔离性：**\n\n如果张三在支付的同时，李四也在支付（是 50 元），那么即使李四取消支付，只要张三支付成功，商店账户也会增加 100 元，即不会影响张三的支付。\n\n**持久性：**\n\n交易完成，二者账户变化生效（写入数据库）\n\n## 参考\n\n[http://www.hollischuang.com/archives/898](http://www.hollischuang.com/archives/898)\n\n[https://zh.wikipedia.org/wiki/数据库事务](https://zh.wikipedia.org/wiki/%E6%95%B0%E6%8D%AE%E5%BA%93%E4%BA%8B%E5%8A%A1)\n\n[https://en.wikipedia.org/wiki/Database_transaction](https://en.wikipedia.org/wiki/Database_transaction)","date_published":"2021-06-20T05:03:39.000Z"},{"id":"/blog/diffrence-between-crlf-and-lf","url":"/blog/diffrence-between-crlf-and-lf","title":"CRLF 和 LF 之间的区别与联系","content_html":"## CRLF 与 LF：换行到底是什么？\n\n要真正理解 CRLF 与 LF 换行的问题，我们需要复习一些排版历史。\n\n人们使用字母、数字和符号来相互交流。但是计算机只能理解和处理数字。由于计算机上的文件由人类可读的字符串组成，因此我们需要一个允许我们在这两种格式之间来回转换的系统。 ASCII 标准就是这样的系统——它将 A 和 z 等字符映射到数字，弥合了人类语言和计算机语言之间的鸿沟。\n\n有趣的是，ASCII 标准不仅仅适用于字母和数字等可见字符。某个子集是控制字符，也称为非打印字符。它们不用于渲染可见字符；相反，它们用于执行独特的操作，例如删除前一个字符或插入换行符。\n\nLF 和 CR 就是两个这样的控制字符，它们都与文件中的行尾有关。它们的历史可以追溯到打字机时代，因此我将简要介绍其工作原理，以便了解为什么我们有两个不同的控制字符而不是一个。然后，我们将看看这如何影响开发人员的体验。\n\n### LF：换行\n\n**LF**（Line Feed）代表“换行”，但你可能更熟悉术语换行符（转义序列 \\\\n）。简单地说，这个字符代表一行文本的结束。在 Linux 和 Mac 上，这相当于新文本行的开始。这种区别很重要，因为 Windows 不遵循此约定。我们了解回车之后再讨论为什么不同。\n\n### CR：回车\n\n**CR**（Carriage Return）代表回车（转义序列\\\\r），将光标移动到当前行的开头。终端上的下载进度条就是通过 CR 实现的，通过使用回车符，你的终端可以通过将光标返回到当前行的开头并覆盖任何先前呈现的文本来将文本动画化。\n\n#### 打字机和回车（CR）\n\n将一张纸固定在称为托架的机械卷上，为设备送入一张纸。每次击键时，打字机都会使用墨水在您的纸张上打印字母，将笔架向左移动以确保键入的下一个字母会出现在前一个字母的右侧。\n\n当然，一旦当前行的空间用完，打字员就需要向下移动到纸张上的下一行。这是通过旋转滑架将纸张相对于打字机的“笔”向上移动一定距离来完成的。但是还需要重置托架（carriage），以便键入的下一个字符将与纸张的左侧边距对齐。换句话说，打字员需要某种方式将托架返回到其起始位置。而这正是回车的工作：一个金属杆连接到托架的左侧，当推动时，将托架返回到其起始位置。\n\n#### 电传打字机和回车换行（CRLF）\n\n进入 20 世纪初，出现了电传打字机。基本上，它的工作方式与手动打字机相同，除了不是打印到物理纸上，而是通过传输器通过物理电线或无线电波将消息发送给接收方。\n\n虽然打印方式不同，但是同样需要使用换行符 (LF) 和回车符 (CR)，而且这些设备需要同时使用换行符 (LF) 和回车符 (CR) 以允许打字员从下一行文本的开头输入。毕竟手动打字机就是这样工作的，只是它没有任何“字符”的概念，因为它是一种机械操作的设备。\n\n我们可以将 LF 和 CR 视为代表水平或垂直方向上的独立运动，而不是同时代表两者，这样更容易将其形象化。为了实现这个功能，电传打字机在一些最早的操作系统中设定了 CRLF 行尾的标准，比如流行的 MS-DOS。将 CR 代表“回车”——CR 控制字符将打印头（“回车”）返回到第 0 列，而无需推进纸张。 LF 代表“换行”——LF 控制字符在不移动打印头的情况下将纸张前进一行。因此，如果您想将打印头返回到第 0 列（准备打印下一行）并推进纸张（以便在新纸上打印），则需要 CR 和 LF。\n\nMS-DOS 使用 CRLF 的两个字符组合来表示文件中的行尾，现代 Windows 计算机一直使用 CRLF 作为行尾。同时，从一开始，Unix 就使用 LF 来表示行尾，为了一致性和简单性而放弃了 CRLF。 Apple 最初仅在 Mac Classic 上使用 CR，但最终在 OS X 上改用了 LF，与 Unix 一致。\n\n虽然这似乎是操作系统之间的差异，但 CRLF 与 LF 的这个问题已经引起人们很长时间的头痛。其实按照今天的标准 CRLF 是多余的——同时使用回车和换行是假设你受到打字机的物理限制，你必须明确地向上移动你的纸，然后重置移动到左边距。但是对于电子文件，将换行符定义为隐式完成换行和回车的工作就足够了。换句话说，只要操作系统定义换行符表示下一行从开头开始而不是从某个任意的列偏移处开始，那么除了换行之外，我们不需要显式回车——一个符号可以完成两者的工作。\n\n现在我们知道 CRLF 和 CR 是如何起源的，接下来我们来学习以下怎么处理相关的问题。\n\n## 检查和转换行尾（在 Bash 中）\n\n在 bash 中，你可以使用带有 A 标志的 cat 查看特定文件的行尾：\n\n如果文件使用 CRLF，您将在每行末尾看到字符串 `^M$`，其中 `^M` 表示回车，`$` 表示换行。下面是一个示例：\n\n```shell\nline one^M$\nline two^M$\nline three^M$\n```\n\n如果文件使用 LF，那么您只会看到美元符号：\n\n```shell\nline one$\nline two$\nline three$\n```\n\nps: 你可以使用[dos2unix](https://linux.die.net/man/1/dos2unix)命令行程序将文件从 CRLF 转换为 LF。\n\n## Git 中的行尾\n\n诚然，这需要很多背景知识！但这是值得的，因为我们终于准备好讨论与 git 相关的行尾（以及如何在任何给定的代码库中解决 CRLF 与 LF 的问题）。\n\n我们从前面可以知道 CRLF 和 LF 是不同的字符表示，因此缺少通用行结尾为 git 等版本控制软件带来了麻烦，这类软件依赖于非常精确的字符比较来确定文件自上次签入以来是否发生了变化。如果开发人员使用 Windows 并且另一个使用 Mac 或 Linux，他们每个人都保存和提交相同的文件，他们可能会在他们的 git diff 中看到行结束更改——从 CRLF 到 LF 的转换，反之亦然。由于单字符更改，这会导致不必要的麻烦，非常烦人。\n\n### 使用 `core.autocrlf` 在 Git 中配置行尾\n\n可以使用`core.autocrlf`配置告诉 git 如何处理系统上的行尾。可以通过以下命令完成：\n\n```shell\ngit config --global core.autocrlf [true|false|input]\n```\n\n注意，false 值会关闭行尾转换，这通常是不可取的，除非是团队中的每个人都使用相同的操作系统。当然，我觉得这种情况很少发生，所以慎用（除非你使用 .gitattributes 配置，在这种情况下，它会优先于你的 git 配置——稍后会详细介绍）。\n\n所以，一般来说我们只有两个选择：`autocrlf true` 和 `autocrlf input`。这两者有什么区别？\n\n#### `autocrlf true`\n\n当 autocrlf 为 true 时（git 默认行为），文件将使用 git 在本地检出为 CRLF，但是每当你提交文件时，CRLF 的所有实例都将替换为 LF。基本上，此设置可确保你的代码库在所有文件的最终版本中始终使用 LF，但在获取时在本地使用 CRLF。这是 Windows 开发人员的推荐设置，因为 CRLF 是 Windows 的本机行结尾。\n\n如果使用此选项，则每次在 Windows 上暂存文件以进行提交时可能会看到下面警告：\n\n```bash\nwarning: CRLF will be replaced by LF in <file-name>.\nThe file will have its original line endings in your working directory.\n```\n\n这并不是说出现问题， Git 只是警告你，根据此设置的预期行为，你的 CRLF 行结尾将在提交时规范化为 LF。\n\n#### `autocrlf input`\n\n使用 `autocrlf input`，文件在提交时转换为 LF，但在获取时不会转换为任何内容。因此名称为“输入”——你得到是你最初输入的内容。如果一个文件最初被 Windows 开发人员意外提交为 CRLF，你会在本地看到它是 CRLF（如果你修改它，你会强制它变成 LF）。如果文件最初是作为 LF 添加的，您会看到它是 LF。这通常是一件好事，因为这意味着你将始终在代码库中获得 LF 行结尾（假设你从一开始就使用它）。\n\ninput 和 true 之间的唯一区别是输入不会在本地获取时处理行尾。这是 Mac/Linux 开发人员的推荐设置，因为这些操作系统默认使用 LF。\n\n## 使用 .gitattributes 在 Git 中规范行尾\n\n在你的 repo 的根目录创建一个 .gitattributes 文件来一劳永逸地行尾不一致的问题。 Git 会读取此文件并在您本地获取或提交文件时应用其规则，确保无论每个开发人员如何在本地配置 git 或他们使用什么操作系统，都强制执行行尾约定。\n\n### 一个简单的 .gitattributes 配置\n\n这是一个 .gitattributes 文件，应该涵盖大多数用例：\n\n```bash\n# We'll let Git's auto-detection algorithm infer if a file is text. If it is,\n# enforce LF line endings regardless of OS or git configurations.\n* text=auto eol=lf\n\n# Isolate binary files in case the auto-detection algorithm fails and\n# marks them as text files (which could brick them).\n*.{png,jpg,jpeg,gif,webp,woff,woff2} binary\n```\n\n提交该文件并将其推送到远程服务器。\n\ngit 使用一种简单的算法来检测你的 repo 中的特定文件是文本文件还是二进制文件（例如，可执行文件、图像或字体文件）。默认情况下，此算法用于比较已更改的文件，但它也可以用于强制行尾约定。\n\n这就是上面配置中 `text=auto` 的作用——它告诉 git 应用其自动检测算法来确定文件是否是文本文件。然后， `eol=lf` 告诉 git 在本地获取和提交时强制执行文本文件的 LF 行结尾。这适用于 Windows 和 Linux，因为现在大多数跨平台文本编辑器都支持 LF。\n\nGit 的自动检测算法相当准确，但如果它无法正确区分文本文件和二进制文件（如图像或字体文件），我们也可以将文件的子集显式标记为二进制文件以避免作为文本文件处理他们。这可以用下面的代码实现：\n\n```shell\n*.{png,jpg,jpeg,gif,webp,woff,woff2} binary\n```\n\n现在，提交此文件后，最后一步是重新规范化所有在添加 `.gitattributes` 之前已签入 git 的文件的所有行尾。你可以使用以下命令执行此操作：\n\n```bash\ngit add --renormalize .\n```\n\n这会根据 `.gitattributes` 配置中定义的规则重新格式化所有文件。如果先前提交的文件在 git 的索引中使用 CRLF 并且由于此重新规范化而转换为 LF，则它们的行尾将在索引中更新，并且这些文件将暂存以进行提交。唯一要做的就是提交这些更改并将它们推送到远程存储库。之后引入的新文件，其行尾都将作为 LF 签入（和签出）。\n\n#### Git 行尾：工作树与索引\n\n提交这些重新规范化的文件时，您可能会看到以下消息：\n\n```shell\nwarning: CRLF will be replaced by LF in <file-name>.\nThe file will have its original line endings in your working directory.\n```\n\n这是预期的行为——CRLF 将成为 Git 索引中的 LF，这意味着当你将这些文件推送到你的存储库时，它们将在你的远程代码库中具有 LF 行结尾。任何后来提取或获取该代码的人都会在本地看到 LF 行结尾。\n\n但是 git 实际上并没有更改文件的本地文件（即其工作树中的那些）的行尾。因此，警告消息的最后一点表示刚刚重新规范化的文件仍会继续在本地使用 CRLF。\n\n### 在 Git 中验证任何文件的行尾\n\n如果想在所有这些步骤之后仔细检查 Git 索引中的文件是否使用正确的行结尾，可以运行以下命令：\n\n```bash\ngit ls-files --eol\n```\n\n这将显示 git 正在跟踪的所有文件的行尾信息，格式如下：\n\n```shell\ni/lf    w/crlf  attr/text=auto eol=lf   file.txt\n```\n\n从左到右分别是：\n\n- i：索引中的行尾（被推送到你的仓库的行）。应该是 LF。\n- w：工作树中的行尾（可能是 CRLF，但如果索引是 LF 也可以）。\n- attr：适用于此文件的 `.gitattributes` 规则。\n- 文件名。\n\n或者，你可以在将代码推送到远程后，通过在 Windows 机器上重新克隆您的存储库来仔细检查 git 是否正确规范了您的行尾。你应该看到文件的索引和工作树副本都使用 LF 而不是 CRLF（假设 LF 是您选择规范化行尾的方式）。\n\n## `.editorconfig` 文件\n\n从技术上讲，一个 `.gitattributes` 文件是你执行代码库远程副本上显示的行尾所需的全部内容。但是，正如我们在上面看到的，你可能仍然会在本地看到你创建的文件的 CRLF 行结尾，因为 .gitattributes 不会告诉 git 更改文件的工作副本。\n\n当然，这并不意味着 git 的规范化过程不起作用。但是，如果你还使用 ESLint 和 Prettier 对代码进行 linting，这可能会很烦人，在这种情况下，它们会不断抛出错误并告诉您删除那些额外的 CR：\n\n![image](https://imgcdn.smj.im/85L4tLdw1cE/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwNDJiZjJhNzBjLndlYnA)\n\n所以，你可以使用 `.editorconfig` 文件更进一步；这是一个与编辑器无关的项目，旨在创建用于自定义任何给定文本编辑器行为的标准化格式。许多文本编辑器（包括 `VS Code`，`IDEA`，`GitHub`）支持并自动读取此文件（如果存在）。你可以将这样的内容放在工作区的根目录中，你可以在[这里](https://editorconfig.org)深入了解：\n\n```shell title='.editorconfig'\nroot = true\n\n[*]\nend_of_line = lf\n\n```\n\n除了一堆其他设置之外，你还可以指定应用于通过此文本编辑器创建的任何新文件的行尾。这样，如果使用 VS Code 在 Windows 上创建一个新文件，你将始终在工作树中看到行结尾为 LF。\n\n## 参考\n\n[https://stackoverflow.com/a/56858538/5323344](https://stackoverflow.com/a/56858538/5323344)\n\n[https://www.aleksandrhovhannisyan.com/blog/crlf-vs-lf-normalizing-line-endings-in-git/](https://www.aleksandrhovhannisyan.com/blog/crlf-vs-lf-normalizing-line-endings-in-git/)\n\n[https://editorconfig.org/](https://editorconfig.org/)","date_published":"2021-06-14T10:52:39.000Z"},{"id":"/blog/how-update-dns-works","url":"/blog/how-update-dns-works","title":"DNS 的更新是如何工作的？","content_html":"> 最近看到大神的一篇关于[DNS 的文章](https://jvns.ca/blog/how-updating-dns-works)，感觉很不错，所以自己翻译了一下。\n> 如有错误，欢迎指正。\n\n我已经看到很多人对更新站点的 DNS 记录以更改 IP 地址感到困惑。为什么这么慢？是否真的需要等待 2 天才能更新所有内容？为什么有些人看到新 IP，有些人看到旧 IP？发生了什么？\n\n这里记录一下更新 DNS 背后所发生了些什么。\n\n## DNS 的分类：递归 vs 权威 DNS 服务器\n\n首先，我们需要解释一些有关 DNS 的知识。DNS 服务器有两种：**权威**服务器和**递归**服务器。\n\n**权威**DNS 服务器（也称为**名称服务器**）具有一个负责其每个域名的 IP 地址数据库。例如，github.com 的权威 DNS 服务器是 ns-421.awsdns-52.com。你可以通过 dig 命令来获取 github.com 的 IP。\n\n```sh\ndig @ns-421.awsdns-52.com github.com\n```\n\n**递归**DNS 服务器本身对谁拥有什么 IP 地址一无所知。它们通过询问正确的权威 DNS 服务器来确定域名的 IP 地址，然后缓存该 IP 地址，以防再次被问到。8.8.8.8 是递归 DNS 服务器。\n\n当人们访问你的网站时，他们可能正在对递归 DNS 服务器进行 DNS 查询。那么，递归 DNS 服务器如何工作？让我们来看看！\n\n## 递归 DNS 服务器如何查询 github.com？\n\n我们来看一个递归 DNS 服务器（如 8.8.8.8）在你请求 github.com 的 IP 地址（A 记录）时的功能的示例。首先–如果已经缓存了某些内容，它将为您提供缓存的内容。但是，如果所有缓存均已过期怎么办？这是发生了什么：\n\n**步骤 1**：在源代码中硬编码根 DNS 服务器的 IP 地址。您可以在[unbound 的源代码中](https://github.com/NLnetLabs/unbound/blob/6e0756e819779d9cc2a14741b501cadffe446c93/iterator/iter_hints.c#L131)看到这一点。假设`198.41.0.4`从开始就选择。这是这些硬编码 IP 地址的[正式来源](https://www.iana.org/domains/root/files)，也称为“根目录提示文件”。\n\n**步骤 2**：向根域名服务器查询`github.com`。\n\n我们可以大致再现发生的情况`dig`。这给我们提供了一个新的权威名称服务器：`.com`IP 的名称服务器`192.5.6.30`。\n\n```sh\n$ dig @198.41.0.4 github.com\n...\ncom.            172800  IN  NS  a.gtld-servers.net.\n...\na.gtld-servers.net.    172800  IN  A   192.5.6.30\n...\n```\n\nDNS 响应的详细信息比这要复杂一些–在这种情况下，其中有一个具有一些 NS 记录的授权部分，而另一个具有 A 记录的部分，因此您无需进行额外的查找即可获得这些名称服务器 IP 地址。\n\n（实际上，它已经有 99.99％的时间已经缓存了`.com`名称服务器的地址，但是我们假装实际上是从头开始的）\n\n**步骤 3**：向`.com`域名服务器查询有关`github.com`。\n\n```shell\n$ dig @192.5.6.30 github.com\n...\ngithub.com.        172800  IN  NS  ns-421.awsdns-52.com.\nns-421.awsdns-52.com.    172800  IN  A   205.251.193.165\n...\n```\n\n我们有一个新的 IP 地址要询问！这是`github.com`的名称服务器。\n\n**步骤 4**：向`github.com`域名服务器询问有关`github.com`。\n\n```shell\n$ dig @205.251.193.165 github.com\n\ngithub.com.        60  IN  A   140.82.112.4\n```\n\nOK！我们现在有一个`github.com`的`A`记录！现在，递归名称服务器具有`github.com`的 IP 地址，可以将其返回给您。它通过仅硬编码几个**IP 地址**即可完成所有这些操作：即根名称服务器的地址。\n\n## 如何查看所有递归 DNS 服务器： `dig+trace`\n\n当我想查看解析一个域名时递归 DNS 服务器将执行的操作，我运行以下命令:\n\n```shell\n$ dig @8.8.8.8 +trace github.com\n```\n\n这显示了它请求的所有 DNS 记录，从根 DNS 服务器开始--我们刚刚完成的所有 4 个步骤。\n\n## 如何更新 DNS 记录\n\n既然我们了解了 DNS 工作原理，那么让我们更新一些 DNS 记录，看看会发生什么。\n\n更新 DNS 记录时，有两个主要选项：\n\n1. 保持相同的名称服务器\n2. 更改名称服务器\n\n### 关于 TTL\n\n这里我们先说明一下 TTL 这个概念，我们之前说过递归 DNS 服务器将缓存记录直到它们过期，而决定记录是否应过期的方式是查看其**TTL(Time To Live)**。\n\n下面的示例中，A 记录 github 的名称服务器为其 DNS 记录返回的 TTL 为`60`，这意味着 60 秒：\n\n```shell\n$ dig @205.251.193.165 github.com\ngithub.com.        60  IN  A   140.82.112.4\n```\n\n这是一个非常短的 TTL，*从理论上讲，*如果每个人的 DNS 实施都遵循[DNS 标准，](https://tools.ietf.org/html/rfc1035)则意味着如果 Github 决定更改 IP 地址`github.com`，则每个人都应在 60 秒内获得新的 IP 地址。让我们看看实际情况如何。\n\n### 选项 1：在相同的名称服务器上更新 DNS 记录\n\n首先，我更新了我的名称服务器（Cloudflare），使其具有新的 DNS 记录：映射`test.jvns.ca`到的 A 记录 `1.2.3.4`。\n\n```shell\n$ dig @8.8.8.8 test.jvns.ca\ntest.jvns.ca.        299 IN  A   1.2.3.4\n```\n\n这会立即生效！根本不需要等待，因为`test.jvns.ca`在可以缓存之前没有 DNS 记录。但是看起来新记录被缓存了大约 5 分钟（299 秒）。\n\n那么，如果我们尝试更改该 IP 怎么办？我将其更改为`5.6.7.8`，然后运行了相同的 DNS 查询。\n\n```shell\n$ dig @8.8.8.8 test.jvns.ca\ntest.jvns.ca.        144 IN  A   1.2.3.4\n```\n\n嗯，好像 DNS 服务器的`1.2.3.4`记录仍在缓存 144 秒。有趣的是，如果我`8.8.8.8`多次查询实际上却得到不一致的结果–有时它会给我新的 IP，有时会给我旧的 IP，我想是因为 8.8.8.8 实际上将负载平衡到一堆不同的后端，每个后端都有自己的缓存。\n\n我等了 5 分钟后，所有`8.8.8.8`缓存均已更新，并且始终返回新`5.6.7.8`记录。不得不说，这相当的快！\n\n### 你不能总是依靠 TTL\n\n与大多数 Internet 协议一样，并非所有内容都遵循 DNS 规范。某些 ISP DNS 服务器将缓存记录的时间长于 TTL 指定的时间，例如 2 天而不是 5 分钟。人们总是可以在/etc/hosts 中对旧 IP 地址进行硬编码。\n\n在使用 5 分钟的 TTL 更新 DNS 记录时，我期望在实践中会发生的事情是，很大比例的客户端会迅速（例如在 15 分钟之内）移到新 IP，然后会有一些慢的客户端在接下来的几天内会慢慢更新。\n\n### 选项 2：更新名称服务器\n\n我们已经看到，当您在不更改名称服务器的情况下更新 IP 地址时，许多 DNS 服务器将很快获取新 IP。但是，如果您更改名称服务器会怎样？\n\n我不想更新我的博客的域名服务器，所以不是我用不同的域名然后用在[HTTP 杂志](https://wizardzines.com/zines/http/)作为示例：`examplecat.com`。\n\n以前，我的名称服务器设置为 dns1.p01.nsone.net。我决定将它们切换到 Google 的名称服务器-`ns-cloud-b1.googledomains.com`等等。\n\n进行更改后，我的域名注册商有点不愉快地弹出了消息-“对 examplecat.com 的更改已保存。它们将在接下来的 48 小时内生效。” 然后，我为该域设置了一个新的 A 记录，使其指向`1.2.3.4`\n\nOK，让我们看看是否有任何作用：\n\n```shell\n$ dig @8.8.8.8 examplecat.com\nexamplecat.com.        17  IN  A   104.248.50.87\n```\n\n没变化。如果我询问其他 DNS 服务器，它将返回新 IP 地址：\n\n```shell\n$ dig @1.1.1.1 examplecat.com\nexamplecat.com.        299 IN  A   1.2.3.4\n```\n\n但是 8.8.8.8 仍然毫无变化。即使我在 5 分钟前刚刚更改它，1.1.1.1 能看到新 IP 的原因大概是以前没有人向 1.1.1.1 询问过 examplecat.com，因此它的缓存中没有任何内容。\n\n## 名称服务器的 TTL 更长\n\n我的注册服务商说“这将花费 48 小时”的原因是 NS 记录上的 TTL（这是递归名称服务器如何知道要询问哪个名称服务器）更长！\n\n新的域名服务器肯定会返回新的 IP 地址 `examplecat.com`\n\n```shell\n$ dig @ns-cloud-b1.googledomains.com examplecat.com\nexamplecat.com.        300 IN  A   1.2.3.4\n```\n\n但是还记得当我们查询`github.com`域名服务器时发生了什么吗？\n\n```shell\n$ dig @192.5.6.30 github.com\n...\ngithub.com.        172800  IN  NS  ns-421.awsdns-52.com.\nns-421.awsdns-52.com.    172800  IN  A   205.251.193.165\n...\n```\n\n172800 秒是 48 个小时！因此，与不更改名称服务器而仅更新 IP 地址相比，名称服务器更新通常需要更长的时间才能从缓存中到期并传播使用。\n\n## 域名服务器如何更新？\n\n当我更新的域名服务器时`examplecat.com`，发生的事情是 `.com`域名服务器获得了`NS`新域名的新记录。像这样：\n\n```shell\ndig ns @j.gtld-servers.net examplecat.com\n\nexamplecat.com.        172800  IN  NS  ns-cloud-b1.googledomains.com\n```\n\n但是，新的 NS 记录如何到达那里？发生的事情是，我通过在网站上更新**域名**告诉**域名注册商**我希望新的域名服务器是什么，然后域名注册商告诉`.com`域名服务器进行更新。\n\n对于`.com`，这些更新发生的速度非常快（在几分钟之内），但是我认为对于其他一些 TLD，TLD 域名服务器可能无法尽快应用更新。\n\n## 程序的 DNS 解析器库可能还会缓存 DNS 记录\n\n实际中可能不遵守 TTL 的另一个原因：许多程序需要解析 DNS 名称，并且某些程序还将无限期地将 DNS 记录缓存在内存中（直到程序重新启动）。\n\n例如，AWS 有一篇关于[为 DNS 名称查找设置 JVM TTL](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/java-dg-jvm-ttl.html)的文章。我没有编写太多可以自己进行 DNS 查找的 JVM 代码，但是通过对 JVM 和 DNS 的一些仔细研究，似乎可以配置 JVM，以便它无限期地缓存每个 DNS 查找。（例如[此 elasticsearch 问题](https://github.com/elastic/elasticsearch/issues/16412)）\n\n_p.s. TTL 不能说明 DNS 工作原理的全部–即使像 8.8.8.8 这样的主要 DNS 服务器，某些递归 DNS 服务器也绝对不尊重 TTL。因此，即使您只是用短的 TTL 更新 A 记录，实际上还是很有可能在一两天内收到对旧 IP 的一些请求。_\n\n## 参考\n\n[https://jvns.ca/blog/how-updating-dns-works](https://jvns.ca/blog/how-updating-dns-works)","date_published":"2021-06-09T02:06:04.000Z"},{"id":"/blog/linux-cron-tutorial","url":"/blog/linux-cron-tutorial","title":"浅析 Linux 的 cron 命令","content_html":"Cron 是 Linux 一个很有用的工具，也是开发人员最喜欢的工具，因为它可以让你使用通用脚本和特定于任务的脚本在特定的时间段、日期和间隔自动运行命令。有了该描述，你可以想象系统管理员如何使用它来自动执行备份任务、目录清除、通知等。\n\nCron 作业在后台运行，并不断检查`/etc/crontab`文件，`/etc/cron.*/`和`/var/spool/cron/`目录。我们最好不要直接编辑 cron 文件，因为每个用户都有唯一的 crontab。\n\n那你应该如何创建和编辑 cron 作业？我们可以使用 crontab 命令。crontab 是用于创建，编辑，安装，卸载和列出 cron 作业的方法。\n\n创建和编辑 cron 作业的命令是相同而且很简单。而且更酷的是，你无需在创建新文件或编辑现有文件后重新启动 cron。\n\n```bash\n$ crontab -e\n```\n\n### **Cron 语法**\n\n就像使用任何语言一样，当你了解**cron**的语法时，使用**cron**会容易得多，它的语法有两种格式：\n\n```bash\nA B C D E USERNAME /path/to/command arg1 arg2\nOR\nA B C D E USERNAME /root/backup.sh\n```\n\n以上 cron 语法的说明：\n\n- **A：分钟**范围：**0 – 59**\n- **B：时间**范围：**0 – 23**\n- **C：天数**范围：**1 – 31**\n- **D：月**范围：**1 – 12** or **JAN-DEC**\n- **E：星期几**：**0 – 6** or **SUN-SAT，Sunday=0 or 7**。\n- **USERNAME：** 用户名\n- **/path/to/command** – 你要计划的脚本或命令的名称\n\n形象一点表示就是：\n\n```txt\n┌───────────── minute (0 - 59)\n│ ┌───────────── hour (0 - 23)\n│ │ ┌───────────── day of the month (1 - 31)\n│ │ │ ┌───────────── month (1 - 12 or JAN-DEC)\n│ │ │ │ ┌───────────── day of the week (0 - 6 or SUN-SAT, Sunday=0 or 7)\n│ │ │ │ │\n│ │ │ │ │\n│ │ │ │ │\n* * * * *\n```\n\n此外，Cron 使用 3 个运算符，可以在字段中指定多个值：\n\n1.  **星号`(*)`**：指定字段的所有可能值，`* * * * *` 在每天的每分钟运行。\n2.  **逗号`(,)`**：指定值列表，`2,10 4,5 * * *`在每天第 4 和第 5 小时的第 2 和第 10 分钟运行。\n3.  **破折号`(-)`**：指定值范围，`0 4-6 * * *` 在第 4、5、6 小时的第 0 分钟运行。\n4.  **分隔符`(/)`**：指定步长值，`20/15 * * * *` 从第 20 分钟到第 59 分钟每隔 15 分钟运行（第 20、35 和 50 分钟）。\n\nCron 的语法和运算符大概就这么多，下面展示一些 cron 示例。\n\n### **Cron 工作示例**\n\n运行 cron 命令的第一步是使用以下命令安装 crontab：\n\n```sh\ncrontab -e\n```\n\n在每天**凌晨 3 点**运行`/root/backup.sh`：\n\n```bash\n0 3 * * * /root/backup.sh\n```\n\n在每个月的第二天的**下午 4:30**运行`script.sh`：\n\n```bash\n30 16 2 * * /path/to/script.sh\n```\n\n在每周工作日的晚上**10 点**运行`/scripts/phpscript.php`：\n\n```bash\n0 22 * * 1-5 /scripts/phpscript.php\n```\n\n在每天的午夜，凌晨 2 点和凌晨 4 点后的**23 分钟**，运行`perlscript.pl`：\n\n```bash\n23 0-23 / 2 * * * /path/to/perlscript.pl\n```\n\n每个星期日的 04:05 运行 Linux 命令：\n\n```bash\n5 4 * * sun /path/to/linuxcommand\n```\n\n### **Cron 选项**\n\n列出 cron 作业。\n\n```sh\ncrontab -l\n# OR\ncrontab -u username -l\n```\n\n删除所有 crontab 作业。\n\n```sh\ncrontab -r\n```\n\n删除特定用户的 Cron 作业。\n\n```sh\ncrontab -r -u username\n```\n\n### **Crontab 中的字符串**\n\n字符串是开发人员最喜欢的东西，因为它们通过消除重复的书写来帮助节省时间。Cron 具有特定的字符串，可用于更快地创建命令：\n\n1.  `@hourly`：每小时运行一次，即\"**0 \\* \\* \\* \\***\"\n2.  `@midnight`：每天运行一次，即\"**0 0 \\* \\* \\***\"\n3.  `@daily`：与午夜相同\n4.  `@weekly`：每周运行一次，即\"**0 0 \\* \\* 0**\"\n5.  `@monthly`：每月运行一次，即\"**0 0 1 \\* \\*\"**\n6.  `@annually`：每年运行一次，即\"**0 0 1 1 \\***\"\n7.  `@yearly`：与**@annually**相同\n8.  `@reboot`：每次启动时运行一次\n\n例如，这是每天备份系统的方法：\n\n```bash\n@daily /path/to/backup/script.sh\n```\n\n至此，你已经拥有使用**Cron**创建和管理系统任务所需的全部内容。现在，你可以开始使用计划的命令来设置和维护多个环境。\n\n当你对 Crontab 的工作方式了解得足够多时，可以使用这些漂亮的[Crontab 生成器实用程序](https://www.tecmint.com/online-cron-job-generator-and-tester-for-linux/)免费生成 crontab 行。\n\n另外，你可以在[此处](https://help.ubuntu.com/community/CronHowto)阅读 Ubuntu 的有关如何使用 Cron 的文章。\n\n## **参考**\n\n[https://www.tecmint.com/create-and-manage-cron-jobs-on-linux/](https://www.tecmint.com/create-and-manage-cron-jobs-on-linux/)\n\n[https://docs.github.com/en/free-pro-team@latest/actions/reference/events-that-trigger-workflows](https://docs.github.com/en/free-pro-team@latest/actions/reference/events-that-trigger-workflows)","date_published":"2020-12-03T03:54:58.000Z"},{"id":"/blog/quickly-locate-early-commits-in-github","url":"/blog/quickly-locate-early-commits-in-github","title":"如何快速查看 github 代码库中早期 commits","content_html":"如果你想要学习一个开源库，最好的方法就是从头开始看源码，所以你可能想要从第一次 commit 开始看。有的人可能觉得很简单啊，进入 commit 页面直接翻到最后一页就好了啊。的确，如果是你看的是一个小的项目，提交次数不会太多，你可能翻几页就到最后了，可是，如果是像 Linux 这种项目，将近 100k 次提交，手动翻页翻到明年了。。。\n\n![image](https://imgcdn.smj.im/LJgAR6AN2-Q/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwNDQxYmI5YzIwLndlYnA)\n\n![image](https://imgcdn.smj.im/Cbp9x_kGFf4/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwNDQzYjA5ZTFjLndlYnA)\n\n这时候就需要一个简单的方法能够定位到第一次 commit。\n\n所以第一个想法就是在 URL 上操作，仔细观察对比之后可以发现，GitHub 的翻页是根据 commit 的 SHA 值来定位的，\n\n第二页的 url 是\n\n[https://github.com/torvalds/linux/commits/master?after=127c501a03d5db8b833e953728d3bcf53c8832a9+34&branch=master](https://github.com/torvalds/linux/commits/master?after=127c501a03d5db8b833e953728d3bcf53c8832a9+34&branch=master)\n\n仔细观察其中的`127c501a03d5db8b833e953728d3bcf53c8832a9`是最新一次 commit 的 SHA 值，后面还有一个`+34`就是定位到第 36 次(因为是 after1+34，所以要是 36)的 commit。所以要定位到 Linux 的第一次 commit 就可以把+34 改为+967826(967828-2)\n\n![image](https://imgcdn.smj.im/HovZeN1h_WI/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwNDQ0ZThkNzkyLndlYnA)\n\n到这里就成功定位到第一次 commit 了，当然，以此类推，你可以定位到任何一个 commit。","date_published":"2020-12-03T02:32:58.000Z"},{"id":"/blog/deploy-a-url-shortener-using-github","url":"/blog/deploy-a-url-shortener-using-github","title":"黑科技：使用 GitHub 搭建自己的短链接服务","content_html":"前两天偶然在 GitHub 发现一个挺有意思的项目，可以不依赖自己的服务器、数据库来构建一个短链接服务。自己尝试了一下，还挺简单的。这里记录一下自己的构建流程，感兴趣的小伙伴可以自己尝试一下。\n\n## Prerequisites\n\n1. 新建两个 GitHub 仓库，一个用来做服务器存储源码、提供服务(url_shortener)，一个用来做数据库存储链接(url_shortener_db)\n2. 注册一个域名（可选），如果没有的话，可以直接使用 GitHub pages 的域名(`username.github.io`)。不过我是用了自己注册的域名：blog.johan.zone\n\n## 获取及配置源码\n\n首先，你需要获取这个服务的源代码，你可以直接 fork 这个[源码仓库](https://github.com/nelsontky/gh-pages-url-shortener)，当然也欢迎 fork 我的[代码仓库](https://github.com/baddate/url_shortener)。\n\n然后，克隆自己的仓库到本地(当然，你也可以直接在 GitHub 网页上操作)，修改`404.html`文件的`GITHUB_ISSUES_LINK`字段，指向自己的`url_shortener_db`仓库，这个仓库的`issues`就是作为存储你的链接的数据库：\n\n```js\nvar GITHUB_ISSUES_LINK =\n\"https://api.github.com/repos/username/repo-name/issues/\";\n```\n\n_注意把上面的`username` `repo-name`替换为自己的用户名及仓库名。还有，**最后的`/`不要漏掉**，这是获取链接的关键_\n\n## 配置 GitHub Pages\n\n接下来就是配置 Github Pages 了，这部分也很简单。\n\n点击仓库的`Settings`选项，找到其中的`GitHub Pages`部分，然后配置`Source`中的分支：\n![image](https://imgcdn.smj.im/K5vzdENiHt8/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzdmNWIwN2JhLndlYnA)\n\n下面的部分根据自己需要选择：\n\n### 如果你不使用自己的域名\n\n1. 删除仓库中的`CNAME`文件\n2. 把`404.html`文件中的`var PATH_SEGMENTS_TO_SKIP = 0;`改为`var PATH_SEGMENTS_TO_SKIP = 1;`\n3. 到这里就结束了，你可以直接跳到[下一部分](#测试效果)\n\n### 如果你用了自己的域名\n\n1. 到你的域名服务商，添加一个 CNAME 解析，域名指向`username.github.io`，注意替换`username`为自己的 GitHub 用户名\n2. 等待几分钟（域名解析生效需要时间，所以最好提前做），再进入到 github pages 部分，键入你自己的域名，最好勾选**Enforce HTTPS**，然后点击`Save`，刷新页面，会显示下面的内容:\n   ![image](https://imgcdn.smj.im/v0jwJk1l1-w/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E1MDhlMzBkLndlYnA)\n3. 把`CNAME`文件中的域名更改为你配置好的域名\n4. 到此，就配置完成了，接下来可以测试一下\n\n## 测试效果\n\n1. 在你开始作为数据库的 GitHub 仓库创建一个 issue，标题就是你需要缩短的链接，其他什么都不需要做，直接 Submit 就行了。\n\n2. 等待一会儿，然后在浏览器查询链接`https://<your-domain>/<issue-no>`。例如：`https://tldr.plus/2`，点击这个链接会跳转到我的博客。其中的`tldr.plus`是我的域名，`1`代表 issue 的楼层数。\n\n## 总结\n\n如果大家觉得麻烦，也可以使用我搭建的服务，你可以点击[这里](https://github.com/baddate/url_shortener_db/issues/new)提供链接。\n\n有人在[这里](https://github.com/nelsontky/gh-pages-url-shortener/issues/5#issuecomment-728040879)给了一个比较好的解释，大家可以参考一下。\n\n## 参考\n\n[https://github.com/nelsontky/gh-pages-url-shortener](https://github.com/nelsontky/gh-pages-url-shortener)","date_published":"2020-12-01T08:25:45.000Z"},{"id":"/blog/build-site-with-franklin","url":"/blog/build-site-with-franklin","title":"Build site with Franklin.jl","content_html":"## Forward\n\n> [Franklin.jl](https://franklinjl.org/) is a simple, customisable static site generator oriented towards technical blogging and light, fast-loading pages.\n\nAt first, I want to learning Julia with a small open source project, smaller and better. Then I search on github with topic`#julia`, and I find this tool. As I learned about it on its site, I think I can use this for my massively personal site(maybe it is beautiful, but too complex), and learning Julia when rebuilding my site.\n\nTherefore, I write this tutorial as my beginning.\n\nLast but not least, Franklin.jl has many features:\n\n- Augmented markdown allowing definition of LaTeX-like commands,\n\n- Easy inclusion of user-defined div-blocks,\n\n- Maths rendered via KaTeX, code via highlight.js both can be pre-rendered,\n\n- Can live-evaluate Julia code blocks,\n\n- Live preview of modifications,\n\n- Simple optimisation step to compress and pre-render the website,\n\n- Simple publication step to deploy the website,\n\n- Straightforward integration with Literate.jl.\n\n## Setup Environment\n\n1. Download Julia from [official site](https://julialang.org/downloads/) for your OS.\n2. Install it.\n3. Open julia REPL.\n4. Then excute `using Pkg; Pkg.add(Franklin)`\n\n## Start building\n\n1. New a site with the following scripts:\n\n```julia\njulia> using Franklin\njulia> newsite(\"mySite\", template=\"pure-sm\")\n✓ Website folder generated at \"mySite\" (now the current directory).\n→ Use serve() from Franklin to see the website in your browser.\n```\n\nOnce you excuted the command above, this Julia REPL workspace will be in your site folder.\n\n2. Start local server for debug:\n\n```julia\njulia> serve()\n→ Initial full pass...\n→ Starting the server...\n✓ LiveServer listening on http://localhost:8000/ ...\n  (use CTRL+C to shut down)\n```\n\nyou can get this page in your browser:\n![Franklin Example](https://imgcdn.smj.im/NxjpUWRXcRU/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzc4NTQzNWVkLndlYnA)\n_note: this `mySite` folder will be created in your current directory. You can check your current directory with`pwd()`._\n\n## Site Structure\n\n### Page structure\n\nyour `mySite` folder structure like this:\n\n```txt\n├─.github\n│  └─workflows\n├─_assets\n│  └─scripts\n│      └─output\n├─_css\n├─_layout\n├─_libs\n│  ├─highlight\n│  ├─katex\n│  │  └─fonts\n│  └─pure\n└─__site\n├─assets\n│  ├─menu1\n│  │  ├─code\n│  │  │  └─output\n│  │  └─output\n│  └─scripts\n│      └─output\n├─css\n├─layout\n├─libs\n│  ├─highlight\n│  ├─katex\n│  │  └─fonts\n│  └─pure\n├─menu1\n├─menu2\n├─menu3\n└─tag\n    ├─code\n    ├─image\n    └─syntax\n```\n\nThe `.github` folder is generated for Github Actions, you can config some fields for your customization.Fox example, you can change trigger branch from `dev` to your **workspace branch** like `master`.\n\n```diff\nname: Build and Deploy\non:\n  push:\nbranches:\n-      - dev\n+      - master\n```\n\nThen you should change another **BRANCH**(I named it as site branch) field here:\n\n```diff\n- name: Build and Deploy\n  uses: JamesIves/github-pages-deploy-action@releases/v3\n  with:\n    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n-       BRANCH: master\n+       BRANCH: dev\n    FOLDER: __site\n```\n\n_NOTE: you must keep the site branch **different from** the workspace branch(in the case it's `master`), because you site files will be generated on `dev` branch_\n\nIf you use config above, your `master` branch is your workspace branch and your `dev` branch is your Github Pages site branch.\n\n## Deploying on GitHub\n\n### local config\n\n1. Create a personal repo on github, named `username.github.io`, or you can name it whatever you want to if you have a domain.\n\n2. Open local folder you created with Franklin before with bash or any other shell.\n\n3. Follow these steps below to config your repo: \\\n   i)`git remote add origin URL_TO_YOUR_REPO` \\\n   ii)`git add . && git commit -m \"initial files\"` \\\n   iii)`git push -u origin master`\n\n### github config\n\n1.  Open `Settings` on your repo page, and scrolling down until you find `GitHub Pages` option.\n\n2.  Config it as below:\n![Github Pages on Settings](https://imgcdn.smj.im/G4xyiShA8_A/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzdmMjA3M2VhLndlYnA)\n\n    note: you must make the branch __same__ as the **site branch** in the `deploy.yml`\n\n**DONE!**\n\nYou can find some examples of websites using Franklin.jl from [Franklin.jl](https://github.com/tlienart/Franklin.jl).\n\nBy the way, I following this [blog site](https://abhishalya.github.io/) as templates and customizing it. It is a very simple and wonderful site.\n\nPlease email me if there are any errors.\n\n## REFERENCE\n\n[https://franklinjl.org/](https://franklinjl.org/)\n\n[https://github.com/abhishalya/abhishalya.github.io](https://github.com/abhishalya/abhishalya.github.io)\n\n[https://docs.github.com/](https://docs.github.com/en/free-pro-team@latest/github/working-with-github-pages)","date_published":"2020-11-03T11:03:03.000Z"},{"id":"/blog/iwd-tutorial","url":"/blog/iwd-tutorial","title":"iwd 的使用教程","content_html":"## **介绍**\n\n**iNet Wireless Daemon**（iwd） 项目旨在为基于 Linux 的设备提供全面的 Wi-Fi 连接解决方案，由 Intel 团队进行维护开发。该项目的核心目标是通过不依赖于任何外部库，并最大限度地利用 Linux 内核提供的功能来优化资源利用率：存储、运行时内存和链路时间成本。是一个仅依赖于 Linux 内核和运行时 C 库的自包含环境（self-contained environment）。 项目架构 iwd 的基本架构如下图所示：\n\niwd 需要使用 ell（Embedded Learning Library）这个库来进行编译守护进程和控制实用程序的开发版本。 iwd 将 Linux 内核的 crypto 子系统用于所有加密操作，不使用*OpenSSL*或任何其他用户空间加密库。\n\n![image](https://imgcdn.smj.im/5-REEnEjdQQ/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzg0Y2QxZWJjLndlYnA)\n\n## **安装**\n\n直接使用各个发行版自带的包管理器下载即可，这里以 arch 系的`pacman`为例：\n\n```shell\npacman -S iwd\n```\n\n安装完软件包之后，直接使用`systemctl enable iwd.service`命令启动 iwd 服务。\n\n### **基本使用方法**\n\n启动`iwctl` 键入以下命令进入交互式命令行：\n\n```shell\n$ iwctl\n[iwd]#\n```\n\n注意：这里的`[iwd]#`是交互式命令行的提示符。\n\n### **连接到网络**\n\n首先，如果你不知道无线设备名称，使用下面的命令列出所有 Wi-Fi 设备：\n\n```shell\n[iwd]# device list\n```\n\n然后，要扫描网络：\n\n```shell\n[iwd]# station device scan\n```\n\n然后，您可以列出所有可用的网络：\n\n```shell\n[iwd]# station device get-networks\n```\n\n最后，要连接到网络：\n\n```shell\n[iwd]# station device connect SSID\n```\n\n如果你想要手动断开网络链接，使用以下命令：\n\n```shell\n[iwd]# station device disconnect\n```\n\n要列出以前已连接到的网络：\n\n```shell\n[iwd]# known-networks list\n```\n\n要忘记已知网络：\n\n```shell\n[iwd]# known-networks SSID forget\n```\n\n要显示 WiFi 设备的详细信息（如 MAC 地址）：\n\n```shell\n[iwd]# device device show\n```\n\n要显示连接状态，包括 Wi-Fi 设备的连接网络：\n\n```shell\n[iwd]# station device show\n```\n\n如果你想进行其他操作，可以在交互式命令行中输入`help`获取帮助信息。\n\n## **进阶使用**\n\n### **使用内置的网络配置**\n\niwd 内置**DHCP 客户端以及静态配置 IP 地址**的功能，所以你可以不用使用独立的 dhcpd 软件包来管理网络。 如果使用 iwd 的网络配置功能，需要编辑`/etc/iwd/main.conf`并添加以下部分（如果不存在就手动创建）：\n\n```txt title='main.conf'\n[General]\nEnableNetworkConfiguration=true\n```\n\n### **MAC 地址随机化**\n\n**01. 基本方法**\n\nIWD 在版本初期已经支持将 MAC 地址随机化了，不过刚开始在 IWD 的整个生命周期内仅对地址随机化了一次。在 1.6 版本中，添加了基于每个网络的随机地址的功能。这个功能可以在 IWD 的主配置文件（默认为`/etc/iwd/main.conf`）中启用此功能：\n\n```txt title='main.conf'\n[General]\nAddressRandomization=network\n```\n\n> p.s.如果设置*AddressRandomization=once\\_\\_，MAC 地址只在 iwd 启动或硬件启动时第一次被检测到时随机化一次*；如果设置 AddressRandomization=disabled，显而易见，就是不隐藏 MAC 地址，使用真实地 MAC 地址。\n\n其实这个时候的 MAC 地址并不是真正意义上的随机，而是伪随机，因为这个 MAC 地址是使用 SHA256 摘要从永久适配器地址和所连接的 SSID 生成的--这也就意味着，如果使用同一个网络所随机化生成的 MAC 地址是一样的。通常来说，对于普通用户来说已经足够了。\n\n**02. 高级方法**\n\n如果你想使用 IWD 来完全随机化你的 MAC 地址，那么可以使用`AlwaysRandomizeAddress`选项来生成。\n\n```txt title='main.conf'\nAlwaysRandomizeAddress=true\n```\n\n**03. 设定随机化范围**\n\niwd 配置中还有一个`AddressRandomizationRange`选项，用来控制地址的哪一部分是随机化的，那一部分是真实的。\n\n当你把“`AddressRandomizationRange`”设置为“`nic`”时，仅 NIC 特定的字节（最后**3 个**字节）是随机的。有一点要注意，随机范围限制为 00:00:01 至 00：00：FE。物理网卡的 mac 地址用于前 3 个字节。\n\n当使用“`AddressRandomizationRange`”设置为“`full`”时，MAC 地址的 6 个字节都是随机","date_published":"2020-10-05T09:31:36.000Z"},{"id":"/blog/powerful-uml-tools","url":"/blog/powerful-uml-tools","title":"超好用的 UML 工具推荐","content_html":"废话不说, 直入主题\n\n## draw.io\n\n这个是我一直在用的一个在线 UML 工具，超级好用。 支持多种导入格式：\n\n![1701253417977.webp](https://imgcdn.smj.im/zRamkSZrJkM/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTE2MGYxZGFhLndlYnA)\n\n当然还支持导出，如果你想自定义一些导出参数，选择 advanced 选项进行导出前的配置：\n\n![1701253509237.webp](https://imgcdn.smj.im/xuq0M6lq7zs/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTE4ZmJmYjUzLndlYnA)\n\n支持多种存储方式：**Google Drive**、**Onedrive**、**Dropbox**、**GitHub**、**GitLab**以及**存储到本地**。\n\n![1701253552563.webp](https://imgcdn.smj.im/CTgcScrnn04/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTFiMzVjZjlhLndlYnA)\n\n支持各种形状，不仅可以画电路图：\n\n![1701253580545.webp](https://imgcdn.smj.im/eqjqeLkCR40/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTFkMWNkOWNhLndlYnA)\n\n还支持手绘风格的流程图，字体的话，可以通过更换字体格式为 Comic Sans MS 来实现手写体：\n\n![1701253614499.webp](https://imgcdn.smj.im/0LN6l1KVHes/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTFmMjU3MjBiLndlYnA)\n\n最最最强大的是，现在还**支持导入.VSDX 文件**来进行编辑，不过导出还有点问题，过一段时间更新了应该就解决这个 bug 了。 之前只有 web 版，最近好像又更新出了桌面版，网站一直在推荐，大致看了看介绍，感觉就是把 web 封装起来了，不过还没用过，不知道体验怎么样，毕竟 web 版已经满足我的所有需求了:)\n\n## Excalidraw\n\n这个之前写文章的时候经常用，功能比较简单，只支持简单的导入导出，而且还有一个最大的特点（其实也算缺点）只支持手绘风格，支持中文，但是中文字体不是手绘体，换句话说，就是只支持英文的手写体。\n\n![1701253631626.webp](https://imgcdn.smj.im/5s5FhTbNnaM/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTIwNDQxOTM2LndlYnA)\n\n如果要导入的话，支持.json 格式以及.ezcalidraw 格式的文件导入，虽然比较少，但是呢，其实使用这个也绘制不了太复杂的图，而且一般用这个也是即画即用、即用即画。即使你想之后再绘制或者更改，使用工具自带的.ezcalidraw 这个格式也够用了。支持导出的格式也只支持 PNG、SVG，哦，还支持剪切板导出，如果你想，还能加个官方水印。\n\n![1701253648748.webp](https://imgcdn.smj.im/XE43Ck-eHRc/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTIxNWE2ZmVkLndlYnA)\n\n导出界面\n\n![1701253670884.webp](https://imgcdn.smj.im/OZFDrkfu-vI/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTIyYTczNWVjLndlYnA)\n\n剪切板导出效果\n\n比较惊喜的是，还支持链接共享，不过不知道链接有效期是多久，个人猜测应该是永久有效的吧，毕竟是加密上传到服务器的。\n\n![1701253689851.webp](https://imgcdn.smj.im/qSYXTZ1SdwI/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTIzZTkxYjdhLndlYnA)\n\n链接分享界面\n\n下面的链接是我测试的用例，有兴趣的童鞋可以点下看看是不是还在： [https://excalidraw.com/#json=5748441833537536,nnQpSKFk4pLbb209saLfEg](https://excalidraw.com/#json=5748441833537536,nnQpSKFk4pLbb209saLfEg)\n最最最让人意外的是，竟然还**支持多人协作**！！！这是最让我意外的的一个功能好吧，我只能说，太强了！\n\n![1701253730403.webp](https://imgcdn.smj.im/gdTiyxGpN4o/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTI2ZTk3MGMwLndlYnA)\n\n## ASCII FLOW\n\n一个文字风格的制图软件，功能及其简约，你能想到的冗余功能这里一个都没有。有些你需要高级功能，这里其实也没有。。。所以我为什么还要推荐它呢，我比较喜欢的一点就是，比较独特的 ASCII 风格。而且，绘制时的动画及手感也让我很喜欢，最重要的一点是，这个界面对我来说也极具吸引力！不过这点可能因人而异，但我觉得你只要用它，就会体会到它的魅力。\n\n![1701253806723.webp](https://imgcdn.smj.im/uBWphgH-zEw/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTJiMmE3MDljLndlYnA)\n\n不过比较遗憾的一点吧算是，这个工具*对中文支持不太好*，如果连续输入多个汉字就会挤在一起，但是一个一个输入没问题 🙄，主要是因为汉字太宽了，要占 2 格才能显示完全，所以连续输入会重叠在一起。\n\n![1701253838826.webp](https://imgcdn.smj.im/psFs-B4bV4k/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTJkN2FhMmFhLndlYnA)\n\n当然，如果你不喜欢这种 ASCII 风格的框线，你可以自己在这里更改：\n\n![1701253859885.webp](https://imgcdn.smj.im/f4htqEsrOk8/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTY3MTJlNTZkMmUzLndlYnA)\n\n注意一点，如果你要拖动画面更改聚焦点的话，需要先按着 CTRL 键再拖动鼠标才行。其他一些技巧，你可以点击界面右上角的 ❓ 来自己了解。 btw，上面提到的工具都是**开源**的哦，至于地址，emmm，你猜在哪？我不会告诉你在文末的!\n\n---\n\n有些人可能觉得微软的 Visio 也很强大啊，为什么不推荐呢？是的，我知道啊，但是我就不推荐，你奈我何？？ 哈哈哈，开个玩笑哈，我不推荐用这个，只是因为它是要**收费**的啊，你总不能让我用盗版吧？我可不是那样的人呢(手动狗头。而且，Visio 太臃肿了(学校的教育版)！！！不适合我这种追求极简生活的人。","date_published":"2020-10-04T02:36:28.000Z"},{"id":"/blog/archlinux-installation-guide","url":"/blog/archlinux-installation-guide","title":"ArchLinux 安装配置笔记 (Updated)","content_html":"import BlogPostCard from '~/components/widgets/BlogPostCard.astro'\n\n## 前言\n\n自从 3 月份从 Arch 换到 Fedora 系统之后，刚开始感觉还不错，因为大部分东西都已经帮你搞定了，自己只要会用就可以了，但是用的久了，感觉 Fedora 的软件包管理器真心不如 Arch 的 pacman 好用，有些中文软件在仓库中根本找不到，自己配置起来很麻烦，但是如果用 Arch 的话，构建起来就很简单了，所以最终还是决定重新拥抱 Arch。\n刚一开始我还准备按照我之前总结的安装记录进行安装，毕竟当时记录的还是很详细的，但是没想到刚进入 Live 系统就碰到了一个难题：`wifi-menu`命令不存在！ ！ EXCUSE ME?? 我明明验证过镜像完整性的，没问题啊，这是怎么回事？还好，机智的我知道这里面有问题，查阅了一点资料之后就发现(这里不得不吹一波 Arch 的用户社区，真心给力，盲猜是最活跃的 Linux 发行版社区)原来是官方弃用了，改用`iwd`+`systemd-networkd`来管理网络了，莫得办法，那就换吧，查了查 iwd 的基本命令使用，发现还挺简单的，一次配置，永久使用，比` wifi-menu`用起来要流畅许多！\n\n---\n\narchlinux 的 iso 镜像文件自 2020.06.01 开始改了很多东西，大概就这几个方面：\n\n1. archiso 默认的 shell 是 zsh，不再是 bash 了。\n2. archlinux 摒弃了之前的`wifi-menu`，改为使用 iwd 来管理网络。\n3. 对于镜像源的管理，采用 reflector 进行管理，终于不用去手动更改镜像源的位置了，使用 reflector 一条命令就搞定了。\n\n## 必需条件\n\n1. 一台可以使用的电脑\n2. 一个 4G 以上内存的 USB 存储器\n3. 一个可以查看本文的电子设备:)\n\n## 制作 USB 启动盘\n\n1. 首先在[这里](https://www.archlinux.org/download/)找一个延迟低的官方镜像站下载 ArchLinux 的 iso 镜像，我下载的是最新版本，参数如下:\n\n- Current Release: 2020.07.01\n- Included Kernel: 5.7.6\n- ISO Size: 647.0 MB\n\n2. 在镜像站下载 PGP 签名，然后使用`gpg`验证签名确保镜像完整性以及安全性，命令如下: `gpg --keyserver-options auto-key-retrieve --verify archlinux-version-x86_64.iso.sig`\n\n3. 然后使用磁盘烧录工具将镜像写入你的 USB 存储器。 Linux 系统建议使用`dd`这个神器。 Windows 系统的话，建议使用开源软件`rufus`，最好不要使用那个 UltralISO，很容易出问题。\n\n## 开始安装\n\n### 验证启动模式\n\n进入 Live 环境然后验证你的机器的启动模式是 UEFI 还是 BIOS 模式，以下方式二选一：\n\n```bash\n# 有输出说明是 UEFI 模式\nls /sys/firmware/efi/efivars\n\n# 输出 64/32 说明是对应的 UEFI 模式，否则是 BIOS 模式\ncat /sys/firmware/efi/fw_platform_size\n```\n\n### 连接网络\n\n_前面已经说过了，Archiso 的默认的无线网络管理改为 `iwd` 了，所以这里就讲一下如何使用 `iwd` 连接 wifi_，如果想深入了解一下`iwd`，可以参考我写的另一篇文章\n\n<BlogPostCard slug=\"iwd-tutorial\" collectionType=\"blog\" hideImage />\n\n1. 在终端中输入`iwctl`进入 iwd 提示符：\n\n```bash\n[root@archiso~] iwctl\n[iwd#]\n```\n\n2. 在`[iwd#]`中输入`device list`查询机器的网卡设备。\n3. 使用以下命令查询附近可用的 wifi 网络：\n\n```bash\n[iwd#] station <devicename> scan\n[iwd#] station <devicename> get-networks # 显示扫描的结果\n```\n\n4. 在提示符中输入`station <devicename> connect <wifi-ssid>`连接 wifi 网络，如果 wifi 加密，会提示你输入密码\n\n### 更新系统时间\n\n使用`timedatectl`命令来确保时间是同步的：\n\n```bash\ntimedatectl set-ntp true\ntimedatectl status # 确保设置成功\n```\n\n### 磁盘分区\n\n首先使用`lsblk`或者其他磁盘工具（例如`fdisk`）查看磁盘设备：\n\n```bash\nlsblk\n// or\nfdisk -l\n```\n\n然后使用`fdisk`或者`cfdisk`创建磁盘分区，这里有一点要注意的是，在创建分区的时候， **必需要确保有一个 root 分区`/`** ，此外，对于 UEFI 模式的设备还需要一个额外的 EFI 系统分区，我的分区方式如下：\n\n| 挂载点    | 分区类型             | 大小                    |\n| --------- | -------------------- | ----------------------- |\n| /mnt/boot | EFI system partition | 1G                      |\n| /mnt      | Linux x86-64 root    | 32G                     |\n| swap      | Linux swap           | 16G                     |\n| /home     | Linux home           | Remainder of the device |\n\n无论是`fdisk`还是`cfdisk`，用起来都很简单，所以这里不再具体介绍了，想要具体了解的可以查阅[fdisk 官方文档](https://wiki.archlinux.org/index.php/Fdisk)、[cfdisk 官方文档](https://wiki.archlinux.org/index.php/Cfdisk)。对于新人小白，个人推荐`cfdisk`，有一个伪图形界面，很容易上手。\n\n### 格式化分区\n\n按照上面的步骤建立好分区之后，我们需要将每个分区用对应的文件系统进行格式化。\n\n我的分区名称对应的挂载点\n\n| 挂载点    | 分区名称  |\n| --------- | --------- |\n| /mnt/boot | /dev/sda1 |\n| /mnt      | /dev/sda2 |\n| swap      | /dev/sda3 |\n| /home     | /dev/sda4 |\n\n对于 root 分区、home 分区等直接使用`ext4`文件系统进行初始化：\n\n```bash\nmkfs.ext4 /dev/sda2\nmkfs.ext4 /dev/sda4\n```\n\n如果你的机器是 UEFI 启动模式，使用以下命令初始化 EFI 系统分区：\n\n```bash\nmkfs.fat -F32 /dev/sda1\n```\n\n对于交换分区，不能使用上述命令进行格式化，而需要使用`mkswap`将其初始化：\n\n```bash\nmkswap /dev/sda3\n```\n\n### 挂载分区\n\n首先挂载`root`分区：\n\n```bash\nmount /dev/sda2 /mnt\n```\n\n对于其他分区（swap 分区除外，不需要），需要自己手动创建挂载点：\n\n```bash\nmount --mkdir /dev/sda1 /mnt/boot\nmount --mkdir /dev/sda4 /mnt/home\n```\n\n挂载交换分区：\n\n```bash\nswapon /dev/sda3\n```\n\n### 选择镜像源\n\n文件`/etc/sudo pacman.d/mirrorlist`定义了软件包会从哪个镜像源下载。~~在 Live 启动的系统上，所有的镜像都被启用。~~ 在列表中越前的镜像在下载软件包时有越高的优先权。你可以相应的修改文件`/etc/sudo pacman.d/mirrorlist`，并将地理位置最近的镜像源挪到文件的头部来保证下载速度。而且这个文件接下来还会被 pacstrap 拷贝到新系统里，在这里设置好之后就可以一劳永逸了。\n\n手动修改文件或者可以使用 `reflector`，执行下面的命令会自动修改 mirrorlist：\n\n```bash\nreflector -c cn -p https --ipv4 -l 5 --save /etc/sudo pacman.d/mirrorlist\n```\n\n> [!NOTE]\n> 感觉这一步其实现在可以省略了，因为现在在 live 环境中使用`reflector`进行镜像的管理，貌似你一连接网络，live 系统会自动执行 reflector 命令来帮你选择镜像源，默认的是根据下载速率进行排序，感兴趣的小伙伴可以自己确认一下（连接网络之前备份一下`/etc/sudo pacman.d/mirrorlist`文件，然后连接网络之后，使用`diff`对比前后两个文件的差异）。\n\n### 安装必需软件包\n\n使用 archiso 内置的脚本`pacstrap`安装一些基本的软件包、内核及常规的硬件固件：\n\n```bash\npacstrap /mnt base linux linux-firmware base-devel\n```\n\n> 这里要注意的是，上面的命令并不包括所有的基本程序，如网络管理程序、文本编辑器等，如果你想安装这些程序，可以将名字添加到`pacstrap`后，并用空格隔开。你也可以在 Chroot 进新系统后使用`pacman`手动安装软件包或组。\n\n### 配置系统\n\n#### 生成 fstab 文件\n\n用以下命令生成`fstab`文件，其中`-U`选项用来设置 UUID：\n\n```bash\ngenfstab -U /mnt >> /mnt/etc/fstab\n```\n\n然后使用`cat /mnt/etc/fstab`命令检查以下文件是否正确（每个分区占一行，查看是否包含所有分区）\n\n#### 进入到安装的系统\n\n```bash\narch-chroot /mnt\n```\n\n#### 安装文本编辑器\n\n现在的新系统连默认的文本编辑器`nano`都没有了，所以需要自己手动安装一个，不然后面的一些配置无法实现，所以我选择最强的`vim`：\n\n```bash\npacman -S vim\n```\n\n#### 时区\n\n使用下面的命令设置时区：\n\n```bash\nln -sf /usr/share/zoneinfo/Region/City /etc/localtime\n```\n\n然后使用`hwclock`生成`/etc/adjtime`文件：\n\n```bash\nhwclock --systohc\n```\n\n#### 本地化设置\n\n> 本地化的程序与库若要本地化文本，都依赖[Locale](https://wiki.archlinux.org/index.php/Locale)，后者明确规定地域、货币、时区日期的格式、字符排列方式和其他本地化标准等等。在下面两个文件设置：`locale.gen`与`locale.conf`。\n\n1. 首先编辑`/etc/locale.gen`文件，然后将需要的地区的注释移除，建议将`en_US UTF-8`和`zh_CN UTF-8`都取消注释。\n2. 执行`locale-gen`命令生成 locale。\n3. 创建`locale.conf`文件并编辑`LANG`这一变量（将系统 locale 设置为`en_US.UTF-8`，系统的`Log`就会用英文显示，这样更容易问题的判断和处理。）：\n\n```bash title='locale.conf'\nLANG=en_US.UTF-8\n```\n\n_这里最好不要设置为中文 locale，会导致 TTY 乱码_\n\n#### 网络设置\n\n1. 创建`/etc/hostname`文件设置主机名\n2. 配置`/etc/hosts`文件，将以下内容添加进去：\n\n```txt title='/etc/hosts'\n127.0.0.1 localhost\n::1 localhost\n127.0.1.1 myhostname.localdomain myhostname\n```\n\n_note: 如果系统有一个永久的 IP 地址，请使用这个永久的 IP 地址而不是 127.0.1.1。_\n\n#### 设置 root 密码\n\n使用`passwd`命令设置 root 密码即可。\n\n这里不得不说一句，使用 arch 是真的让人舒服的一批，不会出现一些令人无语的问题，我还记得第一次使用 linux 的时候，用的是 fedora，当时想要使用`su `进入 root，但是发现需要密码，但是我不记得安装的时候设置过 root 密码啊，后来查阅了一些资料才发现，fedora 并没有设置 root 密码，需要自己手动设置（使用`sudo passwd root`）。\n\n#### 安装及配置引导程序\n\n> [!IMPORTANT]\n> 安装引导程序之后才能进入系统\n\n##### 微码更新\n\n安装 GRUB**之前**建议安装对应 CPU 的 ucode，例如我的是 amd 的 CPU，所以安装的是：\n\n```bash\npacman -S amd-ucode\n# 如果是 Intel 的 CPU\npacman -S intel-ucode\n```\n\n这样在下面生成 GRUB 的配置文件的时候，会包含进去这部分。\n\n##### GRUB 引导程序\n\n我用的引导程序是[GRUB](https://wiki.archlinux.org/index.php/GRUB)，首先安装必要的软件包：\n\n```bash\npacman -S grub efibootmgr\n```\n\n这里详细介绍一下 UEFI 系统如何安装配置 GRUB：\n\n1. 首先使用以下命令安装到系统：\n\n```bash\ngrub-install --target=x86_64-efi --efi-directory=/boot --bootloader-id=ArchLinux\n```\n\n_note: 因为我的 EFI 分区在`/boot`目录下，所以上述命令的`--efi-directory`参数就设置为`/boot`_\n\n2. 使用`grub-mkconfig `生成 grub 配置文件：\n\n```bash\ngrub-mkconfig -o /boot/grub/grub.cfg\n```\n\n#### 安装 wifi 网络管理工具\n\n推荐使用`iwd`，命令简单方便又强大：\n\n```bash\npacman -S iwd\n```\n\n#### 重启\n\n1. 输入`exit`或按`Ctrl+d`退出`chroot`环境\n2. 用`umount -R /mnt`手动卸载被挂载的分区\n3. 执行`reboot`重启系统\n\n## 再配置新系统\n\n> 因为还没有设置普通用户，所以重启后需要使用 `root` 来进入新系统\n\n### 添加普通用户\n\n1. 使用以下命令添加一个用户\n\n```bash\nuseradd -m -G \"附加组\" -s \"登陆 shell\" \"用户名\"\n```\n\n其中：\n\n- `-m`/`--create-home`：创建用户主目录/home/[用户名]\n- `-G`/`--groups`：用户要加入的附加组列表；使用逗号分隔多个组，不要添加空格；如果不设置，用户仅仅加入初始同名组。\n- `-s`/`--shell`：用户默认登录 shell 的路径\n\n2. 赋予用户 root 权限\n\n- 安装 sudo 软件包: `sudo pacman -S sudo`\n- 在`/etc/sudoers`文件中的`root ALL=(ALL) ALL`行下添加`yourname ALL=(ALL) ALL`，如果是多用户，可以加入`wheel`组，赋予该组成员`sudo`权限：`%wheel ALL=(ALL) ALL`\n\n### 配置网络\n\n_如果你没有安装 wifi 网络管理工具，或者你安装的工具需要 gui 支持，~~那么恭喜你，你的系统还是无法联网，恭喜你可以重新体验一次完整的 archlinux 安装流程:)~~，则需要重新 USB 进入安装系统，`arch-chroot`新系统然后安装一个 `Wi-Fi` 网络管理工具。_\n\n如果你按照我上面写的安装了 wifi 工具`iwd`，那么你还需要做一些额外的工作才能正常使用它：\n\n1. 启动 iwd 服务，为了以后的使用，建议直接设置为开机自启动，详细方法可以参考[systemd](https://wiki.archlinux.org/index.php/Systemd#Using_units)\n\n```bash\nsystemctl start iwd.service # 启动服务\nsystemctl enable iwd.service # 开机自启动服务\n```\n\n2. 因为 `iwd` 默认使用的是系统的 DHCP 和 DNS 服务器，所以**你还需要启动`systemd-networkd.service`和`systemd-resolved.service`才行，因为新系统默认不会自启动这两个服务，需要你手动开启**。当然，你也可以使用`iwd`内置的 DHCP 服务器，开启方法可以参考我之前写的一篇[文章](./iwd-tutorial)。\n\n到这里你才能正常使用`iwd`这个工具，具体使用方法可以参考前文[网络设置](#网络设置)部分\n\n### 安装显示服务器\n\n因为个人比较喜欢 i3，所以我安装的是 xorg，你也可以选择新的显示协议`wayland`。\n使用下面的命令安装开源的 `xorg`\n\n```bash\n# 安装所有 xorg 相关包\nsudo pacman -S xorg\n\n# 以下命令可以只安装必要的 xorg 包，可以避免不必要的包的安装，\nsudo pacman -S xorg-server\n# 但是有些可能其他功能需要的包会缺失，导致功能不完善\n# 所以如果你不太理解这其中的关系，建议除了 xorg-server 之外，也安装 xorg-apps 包组\nsudo pacman -S xorg-server xorg-apps\n```\n\n### 安装显卡驱动\n\n我的机器使用的是 ASUS 的 AMD 显卡`6700XT-TUF`。\n\n对于 AMD 显卡，安装开源的 amdgpu 驱动：\n\n```bash\nsudo pacman -S xf86-video-amdgpu\n```\n\n_p.s. AMD 的显卡驱动有点问题，会导致系统不稳定黑屏/卡死/卡顿等问题，所以可能需要一些额外的配置，这部分我会单独写出来_\n\n对于 NVIDIA 显卡，安装开源驱动`nouveau`即可：\n\n```bash\nsudo pacman -S mesa xf86-video-nouveau\n```\n\n### 安装桌面环境\n\n> 前面说了，我比较喜欢 i3，所以我通常不会安装类似 gnome，kde 这种集成的桌面环境。\n\n### 安装窗口管理器\n\n安装 `i3-wm` 包组：\n\n```bash\nsudo pacman -S i3-wm\n# 推荐安装 i3lock，可以很方便的集成锁屏功能\nsudo pacman -S i3lock\n```\n\nTODO：配置\n\n### 安装显示管理器\n\n> [!WARNING]\n>\n> 如果使用 wayland 协议的管理器，推荐安装`sddm`\n\n由于只安装了一个窗口管理器 i3，并不包含显示管理器(DM)，所以还需要自己选择一个 DM 进行安装，我选择的是`lightdm`：\n\n1. 安装 lightdm 和 greeter：\n\n```bash\nsudo pacman -S lightdm\n# 安装默认的 greeter\nsudo pacman -S lightdm-gtk-greeter\n```\n\n2. 设置为开机自启动：\n\n```bash\nsystemctl enable lightdm.service\n```\n\n> [!TIP]\n> 如果你安装的不是`lightdm-gtk-greeter`，还需要额外的配置，编辑`/etc/lightdm/lightdm.conf`设置默认的 greeter：\n>\n> ```ini\n> [Seat:*]\n> ...\n> greeter-session=<lightdm-greeter-name>\n> ...\n> ```\n\n## 个性化系统\n\n> [!TIP]\n> 如果你使用的是 i3，第一次登录进入 gui 之后，会提示你初始化一个配置，选择 mod 键（一路回车 mod 是 win 键）。打开命令行的默认快捷键是`$mod + return`。\n>\n> 快捷键/自启动的配置都是基于`i3`的配置。\n\n### 安装 AUR 助手\n\n因为有一些软件包并没有收录进官方的仓库里，所以为了安装方便，最好安装一个 AUR 助手，推荐`paru`，rust 语言写的，用起来很方便，性能也很好。\n\n```bash\n#首先安装一些构建软件必需的包\nsudo pacman -S --needed base-devel\ngit clone https://aur.archlinux.org/paru.git\ncd paru\nmakepkg -si\n```\n\n之后，就可以使用`paru`来安装一些非官方的包了，命令行参数和官方的`pacman`基本一致。\n\n### 安装中文输入法\n\narchlinux 中文输入法框架有`fcitx`/`ibus`/`fcitx5`，其中`fcitx5`貌似是刚刚出现的，之前没见过，所以我就试了试，安装配置起来还挺简单的：\n\n1. 安装`fcitx5`软件包\n2. 创建`~/.pam_environment`并配置环境变量：\n\n```txt title='~/.pam_environment'\nGTK_IM_MODULE DEFAULT=fcitx\nQT_IM_MODULE DEFAULT=fcitx\nXMODIFIERS DEFAULT=@im=fcitx\nSDL_IM_MODULE=fcitx\nGLFW_IM_MODULE=ibus\n```\n\n安装中文输入法引擎`fcitx5-rime`\n\n```bash\nsudo pacman -S fcitx5-rime\n```\n\n安装[雾凇拼音](https://github.com/iDvel/rime-ice)词库（optional），该词库并没有在官方仓库，需要在 AUR 仓库安装：\n\n```bash\nparu -S rime-ice-git\n```\n\n### 安装浏览器\n\n```bash\nsudo pacman -S firefox\n```\n\nnote: 安装 Firefox 浏览器的时候会让你选择一种字体以及 jack 音频连接套件，我选择的是`ttf-dejavu`和`pipewire-jack`（选这个是因为我的音频配置是基于`pipewire`的）。\n\n### 安装 Terminal\n\ni3 默认的是`xterm`，功能简单，外观一般，推荐`alacritty`或者`kitty`，还有一个`wezterm`，和`alacirtty`一样都是 rust 的，性能方面没的说，配置用的 lua，不过我用习惯了`alacritty`懒得换了。\n\n```bash\nsudo pacman -S alacritty\n```\n\n### 安装字体\n\n```bash\n# 英文字体\nsudo pacman -S ttf-dejavu ttf-ibm-plex ttf-roboto ttf-fira-code ttf-fira-sans\n# 中文字体\nsudo pacman -S noto-fonts-cjk\n# 表情符号\nsudo pacman -S noto-fonts-emoji ttf-joypixels\n\n```\n\n**编程字体**推荐：\n手动安装，在[这个网站里](https://www.nerdfonts.com/)选择自己喜欢的`nerdfonts`下载下来，放入`~/.local/share/fonts/`目录下，个人比较喜欢`FiraCode`，`Hack`，`Jetbrains`系列。\n\n`Vercel`新开源的字体也很不错，推荐使用，在[这里](https://vercel.com/font)下载。\n\n### 安装 zsh\n\n安装一个好看而且功能强大的 shell 很有必要，比如说 zsh。配置 zsh 的话，我推荐使用[oh my zsh](https://github.com/ohmyzsh/ohmyzsh)这个框架个性化 zsh，配置 zsh 起来简单方便。\n\n1. 安装 zsh\n2. 使用 curl 安装 ohmyzsh，这个脚本还可以帮你自动更改默认的 shell\n\n```bash\nsh -c \"$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n```\n\np.s. 手动更换默认 shell 的方法：`sudo chsh -s /usr/bin/zsh <username>`\n\n自定义配置 zsh，推荐使用`Oh My Zsh`框架，简单易上手，具体可以参考 ohmyzsh 的[官方 wiki](https://github.com/ohmyzsh/ohmyzsh/wiki)。\n\n### 安装文件管理器\n\n我个人比较喜欢`thunar`（XFCE 的内置文件管理器，很轻便，功能也很强大，支持分屏，`F3`是分屏快捷键）。\n\n```bash\nsudo pacman -S thunar\n```\n\n#### 配置相关特性\n\nthunar 还有两个推荐安装的 feature 插件`thunar-archive-plugin`和`thunar-volman`，分别用来处理压缩包和硬盘分区。\n\n```bash\nsudo pacman -S thunar-archive-plugin thunar-volman\n```\n\n安装压缩插件还需要一些压缩/解压缩工具：\n\n```bash\nsudo pacman -S zip p7zip unzip\n```\n\n推荐安装一个图形化压缩工具，用来文件管理器的右键菜单，推荐`xarchiver`，gnome 的`file-roller`，二选一即可：\n\n```bash\nsudo pacman -S xarchiver file-roller\n```\n\n###\n\n自动检测及挂载设备功能：\n\n```bash\nsudo pacman -S gvfs\n```\n\n缩略图功能：\n\n```bash\nsudo pacman -S tumbler\n```\n\n### 程序启动器 rofi\n\n相比于`i3`默认的`dmenu`，更美观的程序启动器，高度自定义\n\n```bash\nsudo pacman -S rofi\n```\n\n修改`i3`配置文件，添加快捷键：\n\n```bash\nbindsym $mod+d exec rofi -show drun\n```\n\n### 状态栏 polybar\n\n窗口状态栏，比 i3 内置的功能更强大，自定义化程度超高。\n\n```bash\nsudo pacman -S polybar\n```\n\n加入 `i3` 自启动\n\n```txt\nexec_always --no-startup-id polybar barname\n```\n\n复制示例模板：\n\n```bash\nsudo cp /etc/polybar/config.ini ~/.config/polybar/config.ini\n```\n\n然后基于模板自定义，具体可以参考官方[ `wiki` ](https://github.com/polybar/polybar/wiki)页面。\n\n### 安装截图工具\n\n推荐`flameshot`，操作简单且功能强大。\n\n```bash\nsudo pacman -S flameshot\n```\n\n配置快捷键：\n\n```ini\nbindsym $mod+Shift+x exec flameshot gui\n```\n\n默认显示系统托盘图标（与 polybar 无痛衔接）\n\n### 配置音频\n\n使用`pipewire`框架，安装相关包：\n\n```bash\nsudo pacman -S pipewire pipewire-audio pipewire-pulse pipewire-alsa pipewire-jack\n```\n\n其中蓝牙相关的功能在`pipewire-audio`中。\n\n会话管理器和 GUI 工具:\n\n```bash\nsudo pacman -S wireplumer helvum\n```\n\npulse 音频管理器：\n\n```bash\nsudo pacman -S pavucontrol\n```\n\n### 系统主题\n\n`WhiteSur`系列主题，包含鼠标/图标/GTK 主题。\n\n可以在 GitHub 下载/freedesktop.org 下载\n\n手动下载并放入对应路径下：\n\n| 主题 | 路径        |\n| ---- | ----------- |\n| 鼠标 | `~/.icons`  |\n| GTK  | `~/.themes` |\n| 图标 | `~/.icons`  |","date_published":"2020-07-05T01:14:36.000Z"},{"id":"/blog/integrate-julia-into-jupyter-notebook","url":"/blog/integrate-julia-into-jupyter-notebook","title":"如何将 Julia 添加到 Jupyter Notebook","content_html":"> Julia 是一门灵活的动态语言,适合用于科学计算和数值计算,并且性能可与传统的静态类型语言媲美。JupyterNotebook 是目前最流行的数据科学 Web 程序，功能涵盖数据清理和转换，数值模拟，统计建模，数据可视化，机器学习等。\n\n本文使用 IJulia 将 Julia 集成到 Jupyter 交互式环境中。假设你已经安装好了 Julia 和 Jupyter 环境。\n\n## 第一步\n\n在命令行键入 julia，运行 Julia 程序，出现以下提示:\n\n```julia\n$ julia\n   _       _ _(_)_     |  Documentation: https://docs.julialang.org\n  (_)     | (_) (_)    |\n   _ _   _| |_  __ _   |  Type \"?\" for help, \"]?\" for Pkg help.\n  | | | | | | |/ _` |  |\n  | | |_| | | | (_| |  |  Version 1.4.2 (2020-05-23)\n _/ |\\__'_|_|_|\\__'_|  |  Official https://julialang.org/ release\n|__/                   |\n\njulia>\n```\n\n## 第二步\n\n在提示符 julia>后键入以下内容安装**IJulia**：\n\n```julia\nusing Pkg\nPkg.add(\"IJulia\")\n```\n\n## 第三步\n\n安装完成后，在提示符中键入以下内容启动带有 Julia 环境的 Jupyter Notebook：\n\n```julia\nusing IJulia\nnotebook()\n```\n\n_p.s._ 如果你想使用最新的 Jupyter Lab，可以使用 jupyterlab()命令替换上面的 notebook()命令。\n\n## 第四步\n\n上面的 notebook()命令会启动 Jupyter Notebook，然后点击 New 选择 New 文件的类型为 Julia 1.4.2，即可编写 julia 代码：\n\n![image](https://imgcdn.smj.im/kQUUmYLdNts/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzgxMGIxM2NmLndlYnA)\n\n例如，使用 println 函数打印 hello, julia!：\n\n![image](https://imgcdn.smj.im/B_CYXz3DWhk/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E1Yjg3OWNlLndlYnA)","date_published":"2020-06-29T01:26:11.000Z"},{"id":"/blog/feynman-technique","url":"/blog/feynman-technique","title":"费曼技巧：最好的学习方式","content_html":"## 写在前面\n\n最近读书的时候偶然发现了费曼技巧，所以查阅了一些资料，找到了这篇文章，写的还不错，就翻译了一下给大家看看，原文在[这里](https://fs.blog/2012/04/feynman-technique/)。\n\n其实费曼技巧原理很简单，当时了解到的时候，就感觉有点像我给自己的父母去解释一些新的概念的时候的思路：用简单的语言去解释一些较为复杂的概念，在这个思路的转换期间，你也就学会了这个概念。\n\n---\n\n_如果你正在寻找一种方法来增强你的学习并变得更聪明，那么费曼技术可能就是绝对学习任何东西的最佳方法。_\n\n**费曼技巧(Feynman Technique)**有四个步骤：\n\n1. 选择想学习的概念\n2. 假装正在将其教给小孩子\n3. 找出解释中的空白(gaps,自己不理解的部分)；回到原始资料，以更好地理解它。\n4. 查看并简化（可选）\n\n---\n\n如果你不学习，就表示停滞不前。但是，我们如何获得关于所学知识的反馈？以及我们如何去学习新的学科并找出我们现有知识中的空白？\n\n## 两种知识\n\n费曼了解[了解某事和知道某事的名字之间的区别](https://fs.blog/2015/01/richard-feynman-knowing-something/)，这是他成功的最重要原因之一。我们大多数人专注于[错误的知识类型](https://fs.blog/2015/09/two-types-of-knowledge/)。第一种知识集中在知道事物的名称，即所谓的事物名称。第二种知识重点是实际了解一些东西，即了解一些东西。\n\n> “说自己知道自己的想法但无法表达的人通常不知道自己的想法。” —莫蒂默·阿德勒\n\n## 费曼技巧\n\n### 第一步：教给孩子(Teach it to a child)\n\n取出一张空白的纸。在顶部写下你要学习的主题。现在，把你要了解的所有知识写出来，就像在教给孩子一样。不是你的聪明成人朋友，而是 12 岁的孩子，而且他的词汇量和注意力跨度足以理解基本概念和关系。\n\n事实证明，我们欺骗自己的方法之一就是我们使用了复杂的词汇和行话，以掩盖我们缺乏理解的事实。\n\n当你以一种可以让孩子理解的简单语言从头到尾写下一个想法时，你会强迫自己更深入地理解该概念，并简化这些想法之间的关系和联系。其中一些可能很容易理解。在这些地方你可以清楚地了解该主题。在其他时候，你会很挣扎。这些是你在理解上有一些空白的地方。\n\n### 第二步：检查(Review)\n\n只有当你遇到知识上的空白时，即你忘记了重要的东西，无法解释它，或者只是在思考一些因素如何相互作用时，才能真正开始学习。\n\n既然你已经知道自己陷于何处，那就回到原始资料重新学习它，直到可以用基本术语进行解释。当你可以不加专业术语地阐述自己的理解时，就可以表明自己真正理解它了。这是学习新知识所必需要的努力，如果你跳过这一步会导致“已经理解了“的错觉。\n\n确定自身的理解范围还可以限制您可能犯的错误，并增加应用知识时获得成功的机会。\n\n### 第三步：组织和简化(Organize and Simplify)\n\n现在，你有了一组手工制作的笔记。检查它们，以确保你没有错误地从原始资料中借用任何专业术语。将它们整理成一个简单的解释，你可以说出来给自己听。如果阐述的不简单或听起来令人困惑，则表明你对该领域的理解仍需要一些努力。\n\n如果你一遍又一遍地遵循这种方法去学习新的知识，最终将得到一个装订满各种主题页的活页夹。如果你每年花费一些时间整理这种活页夹，你会发现你已经学会了很多东西。\n\n### 第四步：可选：传播(Transmit)\n\n如果你真的想确定自己的理解力，那就把它说给某个人听（最好是对这门学科了解甚少的人，或者找到那个 12 岁的孩子！）。对你掌握的知识的最终考验是你将知识传达给他人的能力。\n\n---\n\n*费曼技巧*不仅是学习的绝妙方法，而且还是进入不同思维方式的窗口，可让你将想法分解并从头开始进行重构。你不仅可以加强自己的学习，而且还可以加强他们的学习。重要的是，以这种方式处理问题可以使你了解那些不知道他们自己在说什么的人。（请参阅[贝茨模拟](https://fs.blog/2016/12/batesian-mimicry/)）Feynman 的方法直观地认为，智力是成长的过程，与 Carol Dweck 的著作很好地吻合，后者很好地描述了[固定和成长心态之间的差异](https://fs.blog/2015/03/carol-dweck-mindset/)。","date_published":"2020-06-24T02:12:13.000Z"},{"id":"/blog/how-to-create-linux-desktop-entry","url":"/blog/how-to-create-linux-desktop-entry","title":"How to Create Linux Desktop Entry","content_html":"1. create a file named `yourappname.desktop` in `/usr/share/applications/` directory or `~/.local/share/applications/`.\n2. input the following lines:\n\n```desktop title='yourappname.desktop'\n[Desktop Entry]\nType=Application\nTerminal=false\nExec=/path/to/app\nName=app\nComment=app comment\nIcon=/path/to/app/icon\n```","date_published":"2020-03-13T13:34:52.000Z"},{"id":"/blog/make-a-todo-bot-with-github-actions","url":"/blog/make-a-todo-bot-with-github-actions","title":"Make a TODO robot with Github Actions","content_html":"## What's Github Actions\n\n[Github Actions](https://github.com/features/actions) is a **CI**(continuous integration) and **CD**(continuous deployment) service that help you automate your software development workflows in the same place you store code and collaborate on pull requests and issues. It was launched in October 2018 and was officially available to all users in November 2019. With Github Actions you can write individual tasks, called _actions_, and combine them to create a custom workflow. _Workflows_ are custom automated processes that you can set up in your repository to build, test, package, release, or deploy any code project on GitHub.\n\nYou can create workflows using actions defined in your repository, open source actions in a public repository on GitHub, or a published Docker container image. But _workflows in forked repositories don't run by default._ If you don't want to create your actions by yourself, you can discover actions in the [GitHub Marketplace](https://github.com/marketplace?type=actions), also you can share your actions with the Marketplace.\n\nOk, now let's go.\n\n## Getting started\n\nWe can get this _Send Mail_ Actions from [here](https://github.com/marketplace/actions/send-email) or [source](https://github.com/dawidd6/action-send-mail). It help us send email to our inbox.\n\n## Configuring Github Actions\n\nWe should create a directory named `.github/workflows` to store our workflow files at the root of our repository. In `.github/workflows`, add a `.yml` or `.yaml` file for our workflow. For example, `.github/workflows/auto.yml`.\n\n### First we set a trigger\n\n```yaml\nname: GitHub Actions Email Bot\n\non:\nschedule:\n  - cron: '0 22 * * *'\n```\n\nIn the above code, `name` is actions description, `on` is the trigger condition. We use the POSIX cron syntax to schedule the workflow. It is triggered at 6:00am(UTC+8) everyday.\n\n### Next writing a TODO list and converting it from markdown to html\n\n```yaml\nruns-on: ubuntu-latest\nsteps:\n  - name: Checkout\nuses: actions/checkout@v2.0.0\n  - name: Get pandoc\nrun: sudo apt-get install pandoc\n  - name: Convert My TODO List\nrun: pandoc ./TODO.md > todo.html\n```\n\n### Last configuring the send email actions\n\n```yaml\n- name: Send email\n  uses: dawidd6/action-send-mail@v1.3.0\n  with:\nserver_address: smtp.gmail.com\nserver_port: 465\nusername: ${{ secrets.MAIL_USERNAME }}\npassword: ${{ secrets.MAIL_PASSWORD }}\nsubject: My TODO List\nbody: file://todo.html\nto: test@example.com\nfrom: TODO List Notification\ncontent_type: text/html\n```\n\nFor security, we should set our email `username` and `password` in the `settings/secrets` menu of the project. I set my email username like `MAIL_USERNAME`, password like `MAIL_PASSWORD`.\n\nNow we can receive a TODO list email every morning.\n\n---\n\nThis is my full `todo.yaml`:\n\n```yaml\nname: GitHub Actions Email Bot\n\non:\n  schedule:\n- cron: '0 22 * * *'\n\njobs:\n  Todo_bot:\nruns-on: ubuntu-latest\nsteps:\n  - name: Checkout\n    uses: actions/checkout@v2.0.0\n  - name: Get pandoc\n    run: sudo apt-get install pandoc\n  - name: Get My TODO List\n    run: pandoc ./TODO.md > result.html\n  - name: Send email\n    uses: dawidd6/action-send-mail@v1.3.0\n    with:\n      server_address: smtp.gmail.com\n      server_port: 465\n      username: ${{ secrets.MAIL_USERNAME }}\n      password: ${{ secrets.MAIL_PASSWORD }}\n      subject: TODO List\n      body: file://result.html\n      to: test@example.com\n      from: TODO List Notification\n      content_type: text/html\n```","date_published":"2020-01-03T10:35:00.000Z"},{"id":"/blog/cpp-oop-concepts","url":"/blog/cpp-oop-concepts","title":"C++继承 多态 虚函数","content_html":"## 继承\n\n### 访问控制和继承\n\n| 访问     | public | protected | private |\n| -------- | ------ | --------- | ------- |\n| 同一个类 | yes    | yes       | yes     |\n| 派生类   | yes    | yes       | no      |\n| 外部的类 | yes    | no        | no      |\n\n一个派生类继承了所有的基类方法，但下列情况除外：\n\n- 基类的构造函数、析构函数和拷贝构造函数。\n- 基类的重载运算符。\n- 基类的友元函数。\n\n### 一个问题\n\n```cpp\nclass A{\nprivate:\nint a;\nchar b;\n};\n\nclass B: public A{\npublic:\nchar getc(){return this->c;}\nprivate:\nchar c='j';\n};\n\nint main() {\nB test;\ncout<<test.getc()<<endl;\ncout<<sizeof(int)<<endl;\n// output is 4\ncout<<sizeof(char)<<endl;\n// output is 1\ncout<<sizeof(test)<<endl;\n// output is 8\n}\n```\n\n> 如果把 A 的 private 属性 a,b 变成 public 属性，那么 test 的 size 就变成了 12\n\n### 继承类型\n\n- **公有继承（public）：**当一个类派生自**公有**基类时，基类的**公有**成员也是派生类的**公有**成员，基类的**保护**成员也是派生类的**保护**成员，基类的**私有**成员不能直接被派生类访问，但是可以通过调用基类的**公有**和**保护**成员来访问。\n- **保护继承（protected）：** 当一个类派生自**保护**基类时，基类的**公有**和**保护**成员将成为派生类的**保护**成员。\n- **私有继承（private）：**当一个类派生自**私有**基类时，基类的**公有**和**保护**成员将成为派生类的**私有**成员。\n\n在多继承时，如果省略继承方式，默认为 private\n\n## 多态\n\nC++多态性是通过虚函数来实现的\n\n多态与非多态的实质区别就是函数地址是早绑定还是晚绑定。如果函数的调用，在编译器编译期间就可以确定函数的调用地址，并生产代码，是静态的，就是说地址是早绑定的。而如果函数调用的地址不能在编译器期间确定，需要在运行时才确定，这就属于晚绑定。\n\n### 多态的四种形式\n\n多态总体上分为：编译时的多态（静态多态）和运行时的多态（动态多态）。又被细分为：**参数多态**，**包含多态**，**过载多态**，**强制多态**。前两种为通用多态，后两种为特定多态。\n\n1. 参数多态：采用参数化模板，通过给出不同的类型参数，使得一个结构有多种类型。如 C++语言中的函数模板和类模板属于参数多态。参数多态又叫静态多态，它的执行速度快，异常少，调用在编译时已经确定。参数多态是应用比较广泛的一种多态，被称为最纯的多态。\n2. 包含多态：在许多语言中都存在，最常见的例子就是子类型化，即一个类型是另外一个类型的子类型。一般需要进行运行时的类型检查，属于动态多态。包含多态的基础是虚函数。虚函数是引入了派生概念后用来表现基类和派生类的成员函数之间的一种关系。\n3. 过载多态：同一个名字在不同的上下文中所代表的含义不同。典型的例子是运算符重载和函数重载，属于静态多态。\n4. 强制多态：编译程序通过语义操作，把操作对象的类型强行加以变换，以符合函数或操作符的要求。程序设计语言中基本类型的大多数操作符，在发生不同类型的数据进行混合运算时，编译程序一般都会进行强制多态。程序员也可以显示地进行强制多态的操作。如 `int+double`，编译系统一般会把 int 转换为 double，然后执行 double+double 运算，这个 `int->double` 的转换，就实现了强制多态，即可是隐式的，也可显式转换。强制多态属于静态多态。\n\n### 相关概念\n\n**多态性**\n\n指相同对象收到不同消息或不同对象收到相同消息时产生不同的实现动作。C++支持两种多态性：编译时多态性，运行时多态性。**a、编译时多态性：通过重载函数实现 b、运行时多态性：通过虚函数实现**\n\n[https://blog.csdn.net/Hackbuteer1/article/details/7475622](https://blog.csdn.net/Hackbuteer1/article/details/7475622)\n\n## 虚函数\n\n### 定义\n\nC++中的虚函数的作用主要是实现了多态的机制。基类定义虚函数，子类可以重写该函数；在派生类中对基类定义的虚函数进行重写时，需要再派生类中声明该方法为虚方法。\n\n在派生类中重新定义基类中定义的虚函数时，会告诉编译器不要静态链接（又称早绑定：基类定义的函数没有使用 virtual 关键字，调用的函数被编译器设置为基类中的版本）到该函数。我们想要的是在程序中任意点可以根据所调用的对象类型来选择调用的函数，这种操作被称为**动态链接**，或**后期绑定**。\n\n虚函数只能借助于指针或者引用来达到多态的效果。\n\n当子类重新定义了父类的虚函数后，当父类的指针指向子类对象的地址时，[即 B b; A a = b;] 父类指针根据赋给它的不同子类指针，动态的调用子类的该函数，而不是父类的函数（不使用 virtual 方法，如果使用了**virtual**关键字，程序将根据**引用或指针**指向的 **对象类型**来选择方法，否则使用**引用类型或指针类型**来选择方法。），且这样的函数调用发生在运行阶段，而不是发生在编译阶段，称为**动态联编**。\n\n### 实例\n\n```cpp\nclass A\n{\npublic:\nvoid fee()\n{\n    cout<<\"Parent\"<<endl;\n}\nvirtual void foo()\n{\n    cout<<\"A::foo() is called\"<<endl;\n}\n};\nclass B:public A\n{\npublic:\nvoid fee()\n{\n    cout<<\"Child\"<<endl;\n}\nvirtual void foo()\n{\n    cout<<\"B::foo() is called\"<<endl;\n}\n};\n\nint main(void)\n{\nA *a = new B();\na->fee();   // 输出为：Parent\na->foo();   // 输出为：B::foo() is called\nreturn 0;\n}\n```\n\n### 虚函数底层实现机制\n\n**实现原理：虚函数表+虚表指针**\n\n编译器处理虚函数的方法是：\n\n为每个类对象添加一个隐藏成员，隐藏成员中保存了一个指向函数地址数组的指针，称为虚表指针（vptr），这种数组成为虚函数表（virtual function table, vtbl），即，**每个类使用一个虚函数表，每个类对象用一个虚表指针**。\n\n基类对象包含一个虚表指针，指向基类中所有虚函数的地址表。派生类对象也将包含一个虚表指针，指向派生类虚函数表。\n\n- 如果派生类重写了基类的虚方法，该派生类虚函数表将保存重写的虚函数的地址，而不是基类的虚函数地址。\n- 如果基类中的虚方法没有在派生类中重写，那么派生类将继承基类中的虚方法，而且派生类中虚函数表将保存基类中未被重写的虚函数的地址。注意，如果派生类中定义了新的虚方法，则该虚函数的地址也将被添加到派生类虚函数表中。\n\n![image](https://imgcdn.smj.im/0z47rGMqOqE/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E2NTcxZThhLndlYnA)\n\n```cpp\nclass A {\npublic:\nvirtual void vfunc1();\nvirtual void vfunc2();\nvoid func1();\nvoid func2();\nprivate:\nint m_data1, m_data2;\n};\n\nclass B : public A {\npublic:\nvirtual void vfunc1();\nvoid func1();\nprivate:\nint m_data3;\n};\n\nclass C: public B {\npublic:\nvirtual void vfunc2();\nvoid func2();\nprivate:\nint m_data1, m_data4;\n};\n```\n\n类 A 是基类，类 B 继承类 A，类 C 又继承类 B：\n\n![image](https://imgcdn.smj.im/gi5tcRUKq6E/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzgxYTI5MGFkLndlYnA)\n\n## 纯虚函数\n\n### 定义\n\n纯虚函数是在基类中声明的虚函数，它在基类中没有定义，但要求任何派生类都要定义自己的实现方法。在基类中实现纯虚函数的方法是在函数原型后加“=0”：`virtual void funtion1()=0`\n\n声明了纯虚函数的类是一个抽象类。所以，用户不能创建类的实例，只能创建它的派生类的实例。派生类仅仅只是继承函数的接口，必须实现函数才能使用。\n\n### 抽象类\n\n抽象类是一种特殊的类，它是为了抽象和设计的目的为建立的，它处于继承层次结构的较上层。\n\n1. 抽象类的定义：称带有纯虚函数的类为抽象类。\n2. 抽象类的作用：抽象类的主要作用是将有关的操作作为结果接口组织在一个继承层次结构中，由它来为派生类提供一个公共的根，派生类将具体实现在其基类中作为接口的操作。所以抽象类实际上刻画了一组子类的操作接口的通用语义，这些语义也传给子类，子类可以具体实现这些语义，也可以再将这些语义传给自己的子类。\n3. 使用抽象类时注意：\n\n- 抽象类只能作为基类来使用，其纯虚函数的实现由派生类给出。如果派生类中没有重新定义纯虚函数，而只是继承基类的纯虚函数，则这个派生类仍然还是一个抽象类。如果派生类中给出了基类纯虚函数的实现，则该派生类就不再是抽象类了，它是一个可以建立对象的具体的类。\n- 抽象类是不能定义对象的。\n\n## Conclusion\n\n在有动态分配堆上内存的时候，析构函数必须是虚函数，但没有必要是纯虚的。友元不是成员函数，只有成员函数才可以是虚拟的，因此友元不能是虚拟函数。但可以通过让友元函数调用虚拟成员函数来解决友元的虚拟问题。\n\n析构函数应当是虚函数，将调用相应对象类型的析构函数，因此，如果指针指向的是子类对象，将调用子类的析构函数，然后自动调用基类的析构函数。\n\n## Reference\n\n[https://blog.csdn.net/Hackbuteer1/article/details/7558868](https://blog.csdn.net/Hackbuteer1/article/details/7558868)\n\n[https://blog.csdn.net/iFuMI/article/details/51088091](https://blog.csdn.net/iFuMI/article/details/51088091)","date_published":"2019-12-29T02:02:05.000Z"},{"id":"/blog/cpp-inline-keyword","url":"/blog/cpp-inline-keyword","title":"C++ inline 关键字详解","content_html":"当程序执行函数调用指令时，CPU 将存储该函数调用后指令的内存地址，将函数的参数复制到堆栈上，最后将控制权转移到指定的函数。然后，CPU 执行函数代码，将函数返回值存储在预定义的内存位置/寄存器中，并将控制权返回给调用函数。如果函数的执行时间少于从调用者函数到被调用函数（被调用者）的切换时间，则这可能会成为开销。对于大型函数和/或执行复杂任务的函数，与函数运行所花费的时间相比，函数调用的开销通常微不足道。但是，对于小型的常用功能，进行函数调用所需的时间通常比实际执行函数代码所需的时间多得多。对于小功能，由于小功能的执行时间少于切换时间，因此会产生开销。\n\nC++提供了 inline 函数，以减少函数调用的开销。内联函数是在调用时在行中扩展的函数。调用内联函数时，将在内联函数调用时插入或替换内联函数的整个代码。替换由 C ++编译器在编译时执行。如果内联函数很小，则可以提高效率。\n\ninline 函数看起来像函数，动作像函数，但是又比宏方便很多，调用 inline 函数省去了参数压栈、生成汇编语言的 CALL 调用、返回参数、执行 return 等过程所花费的额外开销。不过 inline 函数也有缺点：增加目标码的大小。因为 inline 函数的设计思想是对该函数的所有调用都用函数本身替换掉，和宏定义一样，但是比宏定义用起来要简单很多。而且 inline 的调试同样很难。\n\n所以，inline 函数对于函数体积很小，却又频繁调用这样的函数来说，可能比函数调用产生的代码更少，但是效率却不可同日而语。有一点需要注意的是：**inline 只是对编译器提出一个申请，并不是强制命令。编译器可以忽略内联请求。**在以下情况下，编译器可能不会执行内联：\n\n- 如果函数包含循环。（对于 while，do-while）\n- 如果函数包含静态变量。\n- 如果函数是递归的。\n- 如果函数的返回类型不是 void，并且函数主体中不存在 return 语句。\n- 如果函数包含 switch 或 goto 语句。\n\ninline 可以显示声明，也可以隐式声明。隐式声明方式是将函数定义在类定义之中（函数定义时没有 inline 关键字），编译器也会当作 inline 函数。另外，定义在类中的 friend 函数也会被隐式声明为 inline 函数。\n\n显式声明的时候必须与函数定义体放在一起才能使函数成为内联，仅将 inline 放在函数声明前面不起任何作用。定义函数内联的语法为：\n\n```shell\ninline return-type function-name(parameters)\n{\n    // function code\n}\n```\n\n此外，inline 函数通常放在头文件中，因为大多数 build environments 在编译期进行 inlining，编译器必须知道函数什么样子才能把*函数调用*替换成*函数本体。*\n\n大多数 virtual 函数不能 inlining：因为 virtual 知道运行时才知道调用哪个函数，而 inline 是在执行前进行替换。此外，编译器通常不会 inlining**_通过函数指针进行的调用，_**下面是一个实例：\n\n```shell\ninline void f() {...}      // assume compilers are willing to inline calls to f\nvoid (*pf)() = f;          // pf points to f\n...\nf();                      // this call will be inlined, because it's a \"normal\" call\npf();                     // this call probably won't be, because it's through              // a function pointer\n```\n\n**内联函数的优点：**\n\n1. 不会发生函数调用开销。\n2. 调用函数时，还节省了 push / pop 变量在栈上的开销。\n3. 它还节省了从函数返回调用的开销。\n4. 内联函数时，可以使编译器对函数主体执行特定于上下文的优化。对于正常的函数调用，这种优化是不可能的。通过考虑调用上下文和被调用上下文的流程可以获得其他优化。\n5. 内联函数可能对于嵌入式系统有用（如果很小），因为内联函数所产生的代码少于函数调用的前导和返回。\n\n**内联函数的缺点：**\n\n1. 内联函数中添加的变量消耗了额外的寄存器，在内联函数之后，如果要使用寄存器的变量编号增加，则它们可能会增加寄存器变量资源利用的开销。这意味着当在函数调用点替换内联函数主体时，该函数使用的变量总数也会被插入。因此，将用于变量的寄存器数量也将增加。因此，如果函数内联后的变量数急剧增加，则肯定会导致寄存器利用率增加。\n2. 如果使用太多的内联函数，则由于重复执行相同的代码，二进制可执行文件的大小将很大。\n3. 过多的内联也会降低指令 Cache 命中率，从而降低了从高速缓存到主存储器的指令获取速度。\n4. 如果有人更改了内联函数中的代码，则内联函数可能会增加编译时间开销，然后必须重新编译所有调用位置，这是因为编译器将需要再次替换所有代码以反映更改，否则它将继续使用旧功能。\n5. 内联函数对于许多嵌入式系统可能没有用。因为在嵌入式系统中，代码大小比速度更重要。\n6. 内联函数可能会导致崩溃，因为内联可能会增加二进制可执行文件的大小。内存溢出会导致计算机性能下降。\n\n**Note:**\n\n- 将大多数内联限制在小的，经常调用的函数中。这有助于调试和二进制可升级性，最大程度地减少潜在的代码膨胀，并最大程度地提高程序速度。\n- 不要仅仅因为函数模板出现在头文件中就声明 inline。\n\n**Reference**\n\n[Effective C++](https://www.amazon.com/Effective-Specific-Addison-Wesley-Professional-Computing/dp/0201924889)\n\n[https://www.geeksforgeeks.org/inline-functions-cpp/](https://www.geeksforgeeks.org/inline-functions-cpp/)","date_published":"2019-12-22T01:37:11.000Z"},{"id":"/blog/cpp-static-keyword","url":"/blog/cpp-static-keyword","title":"C++ Static 关键字详解","content_html":"C++的 static 有两种用法：面向过程程序设计中的 static(延续 C 语言)和面向对象程序设计中的 static。\n\n## 面向过程：\n\n1. 静态全局变量：\n   - 该变量在全局数据区分配内存；\n   - 未经初始化的静态全局变量会被程序自动初始化为 0（自动变量的值是随机的，除非它被显式初始化）；\n   - 静态全局变量在声明它的整个文件都是可见的，而在文件之外是不可见的；\n   - 静态全局变量不能被其它文件所用；\n   - 其它文件中可以定义相同名字的变量，不会发生冲突；\n2. 静态局部变量：\n   - 该变量在全局数据区分配内存；\n   - 静态局部变量在程序执行到该对象的声明处时被首次初始化，即以后的函数调用不再进行初始化；\n   - 静态局部变量一般在声明处初始化，如果没有显式初始化，会被程序自动初始化为 0；\n   - 它始终驻留在全局数据区，直到程序运行结束。但其作用域为局部作用域，当定义它的函数或语句块结束时，其作用域随之结束；\n3. 静态函数：\n   - 在函数的返回类型前加上 static 关键字,函数即被定义为静态函数。静态函数与普通函数不同，它只能在声明它的文件当中可见，不能被其它文件使用。\n   - 其它文件中可以定义相同名字的函数，不会发生冲突；\n\n## 面向对象\n\n1. 静态数据成员\n   - 对于非静态数据成员，每个类对象都有自己的拷贝。而静态数据成员被当作是类的成员。无论这个类的对象被定义了多少个，静态数据成员在程序中也只有一份拷贝，由该类型的所有对象共享访问。\n   - 静态数据成员存储在全局数据区。静态数据成员定义时要分配空间，所以不能在类声明中定义。\n   - 静态数据成员和普通数据成员一样遵从 public,protected,private 访问规则。\n   - 静态数据成员在全局数据区分配内存，属于本类的所有对象共享，所以，它不属于特定的类对象，在没有产生类对象时其作用域就可见，即在没有产生类的实例时，我们就可以操作它。\n   - 类的静态数据成员有两种访问形式:＜类对象名＞.＜静态数据成员名＞ 或 ＜类类型名＞::＜静态数据成员名＞\n   - 静态数据成员初始化的格式为:＜数据类型＞＜类名＞::＜静态数据成员名＞=＜值＞\n   - 静态数据成员主要用在各个对象都有相同的某项属性的时候。比如对于一个存款类，每个实例的利息都是相同的。所以，应该把利息设为存款类的静态数据成员。这有两个好处，第一，不管定义多少个存款类对象，利息数据成员都共享分配在全局数据区的内存，所以节省存储空间。第二，一旦利息需要改变时，只要改变一次，则所有存款类对象的利息全改变过来了;\n   - 同全局变量相比，使用静态数据成员有两个优势:\n 1. 静态数据成员没有进入程序的全局名字空间，因此不存在与程序中其它全局名字冲突的可能性;\n 2. 可以实现信息隐藏。静态数据成员可以是 private 成员，而全局变量不能;\n2. 静态数据函数\n   - 类体外的函数定义不能指定关键字 static;\n   - 静态成员之间可以相互访问，包括静态成员函数访问静态数据成员和访问静态成员函数;\n   - 非静态成员函数可以任意地访问静态成员函数和静态数据成员;\n   - 静态成员函数不能访问非静态成员函数和非静态数据成员;\n   - 调用静态成员函数，可以用成员访问操作符(.)和(->)为一个类的对象或指向类对象的指针调用静态成员函数，也可以直接使用如下格式:＜类名＞::＜静态成员函数名＞（＜参数表＞）调用类的静态成员函数;\n   - 由于没有 this 指针的额外开销，因此静态成员函数与类的全局函数相比速度上会有少许的增长;\n   - 静态成员函数可以继承和覆盖,但无法是虚函数\n\n## Rerference\n\n[https://www.cnblogs.com/beyondanytime/archive/2012/06/08/2542315.h](https://www.cnblogs.com/beyondanytime/archive/2012/06/08/2542315.html)","date_published":"2019-12-21T01:59:11.000Z"},{"id":"/blog/cpp-type-conversion","url":"/blog/cpp-type-conversion","title":"C++ type conversion notes","content_html":"## **string, char\\*, const char\\*, int type conversion**\n\n### [string to int/float/double](https://stackoverflow.com/questions/7663709/how-can-i-convert-a-stdstring-to-int)\n\n```cpp title=''\n//older version\natoi( str.c_str() )\n//------------------------------------------//\n// C++11\n// string -> integer\nint i = std::stoi(s);\n\n// string -> float\nfloat f = std::stof(s);\n\n// string -> double\ndouble d = std::stod(s);\n//------------------------------------------//\n#include <sstream>\n// string -> integer\nstd::istringstream ( str ) >> i;\n\n// string -> float\nstd::istringstream ( str ) >> f;\n\n// string -> double\nstd::istringstream ( str ) >> d;\n//------------------------------------------//\n// Boost's lexical_cast\n#include <boost/lexical_cast.hpp>\n#include <string>\n\nstd::string str;\n\ntry {\n    int i = boost::lexical_cast<int>( str.c_str());\n    float f = boost::lexical_cast<int>( str.c_str());\n    double d = boost::lexical_cast<int>( str.c_str());\n    } catch( boost::bad_lexical_cast const&amp;amp;amp; ) {\n        // Error management\n}\n```\n\n### [stringto char\\* or const char\\*](https://stackoverflow.com/questions/7352099/stdstring-to-char)\n\n[https://stackoverflow.com/questions/347949/how-to-convert-a-stdstring-to-const-char-or-char/4152881#4152881](https://stackoverflow.com/questions/347949/how-to-convert-a-stdstring-to-const-char-or-char/4152881#4152881)\n\n```cpp\nchar* strtoch(string str){\n    char *cstr = new char[str.length() + 1];\n    strcpy(cstr, str.c_str());\n    return cstr;\n}\n//------------------------------------------//\nstd::string x = \"hello world\";\nconst char* p_c_str = x.c_str();\nconst char* p_data = x.data();\n\nchar* p_writable_data = x.data(); // for non-const x from C++17\nchar* p_x0_rw = &x[0];  // compiles if x is not const...\n\n//------------------------------------------//\nstd::vector<char> cstr(str.c_str(), str.c_str() + str.size() + 1);\n// or\nstd::string str;\nstd::vector<char> writable(str.begin(), str.end());\nwritable.push_back('\\0');\n```\n\n### char\\* to int\n\n```cpp\n#include <stdlib.h>\n\nint atoi(const char *nptr);\nlong atol(const char *nptr);\nlong long atoll(const char *nptr);\nlong long atoq(const char *nptr);\n```\n\n### char to int\n\n```cpp\n// read the value as an ascii code\nchar a = 'a';\n// to\nint ia = (int)a;\n// or\nint ia = a;\n// or\nint num = static_cast<int>(letter); // if letter='a', num=97\n//------------------------------------------//\n//convert the character '0' -> 0, '1' -> 1, etc\nchar a = '4';\nint ia = a - '0'; // a - '0' is equivalent to ((int)a) - ((int)'0')\n```\n\n### [int to char](https://stackoverflow.com/questions/4629050/convert-an-int-to-ascii-character)\n\n```cpp\nint i = 49;\nchar c = i; // c='1' 49=1\nchar c = (char)i; // c='1' 49=1\nchar c = '0'+i; // c='a' 48+49=97=a\n```\n\n### [int to char\\*/cstring](http://www.cplusplus.com/reference/cstdlib/itoa/?kw=itoa)\n\n```cpp\nint i = 49;\nchar buffer[33];\nchar *c = itoa(i,buffer,10);\n```\n\n### [int to string](https://stackoverflow.com/questions/5590381/easiest-way-to-convert-int-to-string-in-c)\n\n```cpp\n#include <string>\n\nint i = 49;\n\nstd::string s = std::to_string(i);\n\n// or\nauto s = std::to_string(i);\n\n// or\nchar *intStr = itoa(i);\nstring str = string(intStr);\n\n// or\n\n#include <sstream>\n\nstringstream ss;\nss << a;\nstring str = ss.str();\n\n// or\n\n#include <sstream>\n\ntemplate <typename T>\nstd::string NumberToString ( T Number )\n{\n   std::ostringstream ss;\n   ss << Number;\n   return ss.str();\n}\n// or\n#include <boost/lexical_cast.hpp>\nint num = 4;\nstd::string str = boost::lexical_cast<std::string>(num);\n```","date_published":"2019-09-23T04:07:03.000Z"},{"id":"/blog/solution-for-_crt_secure_no_warnings","url":"/blog/solution-for-_crt_secure_no_warnings","title":"Solution for _CRT_SECURE_NO_WARNINGS error","content_html":"> platform: VS2019\n> os: win10\n\nProblem:\nAn error about `_CRT_SECURE_NO_WARNINGS` when I use the `std::localtime()` function for getting the current systime.\n\nSolution:\n\n1. Use an alternative feature function in C++.\n2. add this line at the first line.\n\n```cpp\n#define _CRT_SECURE_NO_WARNINGS\n```\n\n3. add `_CRT_SECURE_NO_WARNINGS` on the pre-processor(project>properties>C/C++>preprocessor)","date_published":"2019-07-10T13:45:00.000Z"},{"id":"/blog/ir-homework","url":"/blog/ir-homework","title":"IR Homework","content_html":"## ABSTRACT\n\n在 Web 搜索引擎中处理查询需要有效地使用硬件资源来应对用户流量的规模和动态。本文重点讨论了多线程处理查询，这些查询需要访问大型反向索引数据结构以获取一组文档，通过执行 WAND 运算符对它们进行排名，以获得前 K 个最相关的文档。以及在执行查询的同时解决在反向索引上插入新文档的问题。 我们提出了一种高效的策略来为查询和索引更新操作分配线程，这种策略适合于在查询处理的同时支持索引的更新。 我们提案的核心是一种简单的分类技术，旨在快速为查询操作分配线程。\n\n## Introduction\n\nWeb 搜索引擎中最耗时的任务是对用户查询的大量潜在答案的排名。其成本与在支持搜索引擎服务的处理器的分布式存储器集群中保持索引和压缩的 Web 样本的（通常是巨大的）大小成比例。每个处理器都保存一小部分 Web 样本，该样本在称为倒置文件或索引的数据结构中索引。基本上，反向文件由词汇表组成，该词汇表包含 Web 示例中找到的所有相关术语，并且对于每个术语，存在包含该术语的 Web 文档的列表以及诸如术语文档内频率的额外数据。该索引可以快速检索包含所有查询项的文档以及计算这些文档的分数所需的额外数据。分数越高，文档对于给定查询越相关。然后通过选择具有最高分数的 K 个文档来产生查询的答案。有几种方法可以为 Okapi BM25 等文档分配分数。\n\nWAND 运算符通过将与文档评分（例如，BM25）相关联的昂贵计算限制为仅几个文档，同时跳过没有机会进入前 K 个的文档，使得能够有效地执行文档排序过程。这使得文档评分成为一个进程，其运行时间成本是不可预测的，并且在查询中变化很大。不可能假设其成本与所涉及的文档列表的长度成比例。因此，在运行时以及在很短的几分之一秒内确定分配给 WAND 操作的线程数变成了一个非常重要的问题，因为总执行成本仅在查询完全已知时才知道在处理器中解决了。\n\n多线程查询处理的实用方法是让每个活动查询由单个线程顺序处理。由于 Web 搜索引擎始终包含大量活动查询，因此在不需要支持倒置文件中的并发更新时，这种方法在实践中非常有效。但是，当需要支持在倒置文件中插入新文档时，这种方法效率不高。在这种情况下，必须修改许多文档列表，并且由于人们倾向于在文档和查询中使用一组非常流行的术语，因为在处理查询和线程更新文档列表的线程之间的冲突读写操作可能会降低性能。\n\n[4]中提出的解决方案允许所有线程一次参与一个查询或索引更新的并行处理。由于传入的查询/更新请求是按顺序处理的，因此不会发生读取和写入冲突。当文档包含足够大的术语时，此策略是合适的，并且可以有效地使用所有线程来解析每个查询。但是，在许多情况下，WAND 需要一些线程来使用处理器中可用的所有线程所需的时间大约相同（甚至更短）。因此，这种方法不能扩展 WAND 查询，并且通常，它不能扩展到支持高效执行大量线程的处理器。\n\n请注意，在生产搜索引擎中，我们应该期望在索引更新之间使用可变大小的用户查询序列来处理工作负载。我们研究了几种利用这一事实的方法。例如，除了使用每个查询/更新操作的单个线程和锁定以防止读/写冲突的简单但效率低的策略之外，我们可以累积足够的更新操作以在索引更新期间保持所有线程忙，并快速处理批处理通过将一个或多个线程正确分配给单个查询来使查询保持繁忙，以便尽快使用每个批处理。在这种情况下，特别是对于小批量，每个查询分配一个线程不是一个好主意，因为查询解决方案时间的差异可能非常高，从而产生空闲线程，并且在许多情况下，顺序查询解决方案时间可能超过预先定义的时间作为设计要求对搜索引擎施加的查询响应时间的上限。\n\n在本文中，我们提出了一个有效解决 WAND 查询批处理问题的解决方案，每个 WAND 查询都有适当数量的线程来快速解决它们并避免在每个批处理结束时空闲线程。我们的解决方案基于工作单元中的查询分解，这些查询放在队列中，线程从这些队列中完成下一个工作。为了完成查询分解，我们提出了一种新的分类方案，该方案非常快速并且达到了合理的精度。根据该方案，我们提出了一种更新倒排文件的策略，该策略将处理并发查询/更新操作的整个任务转换为比以前的方法更有效的方法。\n\n本文的结构如下。第 2 节介绍相关工作。第 3 节描述了我们用于查询和文档插入的线程分配技术，以及我们的分类技术。第 4 节介绍绩效评估研究，第 5 部分介绍结论。\n\n## Related work\n\n现代搜索引擎使用倒排索引来加速文档搜索过程。倒排索引是一种简单的结构，它存储文档数据，允许快速查找和排列包含某些查询术语的集合的文档[10]。在倒排索引中，我们存储表示单个术语的倒排列表以及包含该特定术语的所有文档。文档由数字文档标识符（docID）表示，并且通常还存储每个特定文档中术语的频率（特定术语的该文档中出现的次数）。还可以存储附加信息，例如每个文档中术语的各个位置。还有许多压缩技术[9,3,2]用于以高效的方式存储倒排索引，这其中的许多压缩技术存储越来越多的 docID，以便只有 delta（docID 和前一个之间的差异）存储。\n\n确定可在 docID 有序索引中使用的前 K 个（top-K）文档的一种有效方法是 WAND [5]。WAND 算法将查询术语列表按每个查询术语的当前 docID 排序。该方法使用每个文档的分数的上限通过列表前进，并丢弃其分数不大于当前 top-K 文档中的最不相关候选者的那些，其得分是查询的当前阈值。因此，该算法仅计算那些不能被丢弃的候选者的完整分数，减少了为每个查询执行的计算总量。通过跳过整个发布列表块[6]和并行化[8]的处理来改进这种技术。\n\nWAND 使用基于文档的两级评估的排名。在第一级，它使用每个文档的分数的上限来尝试丢弃尽可能多的文档。在第二级，它计算通过第一级测试的文档的真实分数。为了使这个过程高效，它使用*堆数据结构*来存储到目前为止找到的最好的 top-K 文档。堆中排名最低的文档的分数被用作第一级评估的阈值，以丢弃不能作为最终前 K 文档的一部分的文档。这样可以实现高效的丢弃过程，确保在此过程中不会丢失相关文档。这意味着实现多线程 WAND 的两种方法。其中一个是使用本地堆（LH），每个线程一个，另一个是使用共享堆（SH）。在 LH 方案中，每个线程处理索引的一部分，同时保持本地堆与当前特定线程找到的当前 top-K 文档。在该过程结束时，每个线程的结果必须合并到一个结果集中。在 SH 方案中，每个线程处理索引的一部分并将文档存储在共享堆中。\n\n在共享堆方案中，不需要合并，并且丢弃过程往往更有效（因为具有更高分数的文档往往在堆上）。但是，必须通过原始锁(lock primitive,就这么翻译了)来控制对堆的访问。我们在第 4 节中描述的实验设置下进行了测试以比较两种方法的平均时间和效率，我们发现 SH WAND 通常对多线程 WAND 更有效[8]，见图 1。所以我们选择了共享堆 WAND 在我们的实验中使用。\n\n# PROPOSAL\n\n## Threads Management\n\n我们将倒排索引分区以通过为单个查询分配多个线程来执行多线程查询处理。为实现这一目标，我们将每个术语的列表划分为多个独立列表。分区数等于处理器中允许的最大线程数。要解析具有一定数量线程的查询，我们在参与线程之间分配不同的部分。但是，如果我们启动将解析单个查询的线程并等待它们在为其分配处理其他查询之前结束其工作，则会有空闲线程等待参与线程完成其工作，如图 2 所示。\n\n相反，我们建议通过在我们称之为**工作单元**的分解查询处理来增加维持所有线程忙于执行有用工作的机会，如图 3 所示。为此，我们将查询划分为多个独立单元，**这些单元等于分配的线程数**，并将这些单元存储在共享队列中。一旦线程完成其当前的工作单元，它就会从队列中获取下一个工作单元。对队列的访问由简单的锁定机制控制。这是可以接受的，因为我们感兴趣的是优化系统的查询吞吐量（每单位时间的查询），前提是单个查询响应时间不大于给定的边界。\n\n用于确定任何到达查询的工作单元数的分类方案是使我们的方案正常工作的关键参与者，因为查询处理时间可以显着地相互影响。在我们的方案中，可以使用大量线程来解决要求严格的查询以减少其处理时间，而需要很少工作的查询可以被调度为共享队列中的单个单元。问题是事先不知道查询的实际工作量。我们的分类方案设计用于预测运行时任何查询的不同线程数所需的工作量。它必须是在很短的时间内提供合理预测的快速方法。\n\n## A Simple and Fast Classiﬁcation Technique\n\n我们提出了一种简单的策略来确定分配给每个查询的正确线程数。与更复杂和精确的方法相比，该方法在查询时非常有效并产生了良好的结果（比较研究见第 4 节）。我们的分类方法背后的概念是，没有必要花费大量资源来预测查询运行时间，以估计查询的适当线程数。预测的目标实际上并不是知道真实的查询时间，而只是知道适当数量的线程。\n\n请注意，当使用太多线程来处理给定查询时，会出现显著的开销，特别是考虑到多线程 WAND 的平均效率对于大量线程而言往往较低（我们定义效率为最大线程工作除以平均线程工作）。通常，由于需要少量计算，因此可以处理大量快查询，因此无需使用多个线程来解决它们。此外，由于需要解析大量计算，因此处理的慢查询数量相对较少。查询分类的目标是识别慢查询以分配更多资源来解决它们。\n\n实现此识别的一种方法是使用机器学习技术来预测处理查询的成本。这可能涉及使用预测技术，范围从简单的线性模型到使用大量特征进行更精确预测的模型，甚至使用人工神经网络和其他复杂的机器学习技术。然而，这将需要预测每个不同数量的线程的查询时间，这可能导致需要为每个案例训练模型并且在查询到达时间对每个模型执行预测计算。然后，在查询时有效使用处理器线程的低成本启发式方法是为查询选择最小的线程数，以确保整个查询响应时间的上限。\n\n但是，对于慢查询，它必须至少引用与查询术语相关联的大型发布列表所代表的许多文档。即使其他方面影响查询成本，例如每个文档发布列表上的术语频率分布，以及查询术语之间的关系，但是查询引用许多文档是必要条件。考虑到这一事实，在我们的方法中，我们只使用查询项的数量和各个发布列表的长度总和来执行设置要分配给查询的线程数所需的分类。\n\n我们的技术首先确定查询中的术语数量，因为它是影响查询时间的重要因素。例如，在我们的实验数据（第 4 节）的示例中，我们发现，当使用一个线程顺序处理时，只有 4.8％的具有 2 个术语的查询花费超过 160 毫秒，而具有 5 个术语的 35％的查询需要类似时间。这部分是因为具有更多术语的查询往往需要审阅更多文档，但是由于他们使用包含所评估文档的所有相关术语的数据，因此计算得分的成本也更高。\n\n在每种情况下，我们独立地计算查询项列表长度的总和，并使用它们来确定应该分配给查询的线程数。这是通过使用之前在训练阶段确定的截止值（或阈值）来实现的。计算截止值，以便它们倾向于分配足够的线程，以确保查询花费的时间小于上限。这个界限可以定义为训练数据集中查询的平均连续运行时间的一到两倍之间的值。这种方法比上面描述的方法更不灵活，它包括测试几个线程，直到达到不超过上限的最小数量为止。在我们的案例中，在训练时确定了界限及其各自的界限值。但是，我们的方法比其他方法快了几个数量级，只给实际查询执行时间增加了几纳秒。\n\n为了确定适当的截止值，我们使用训练查询的样本，并计算每个线程数的实际执行时间。为了简单起见，我们只使用 2 的幂作为分配给查询的潜在线程数。因此，例如，对于一个高效地支持 16 个线程执行的处理器，我们有 5 类查询，根据 1、2、4、8 或 16 个线程是否实现了确保查询时间小于上限的最小线程数。\n\n在准备阶段，我们根据术语的数量分离训练查询，并且在每种情况下，我们独立地按列表的长度总和对它们进行排序。因此，我们获得了一组对（文档总数，线程数 ID）按文档总和排序，并且类 ID 等于所用线程数。对于此集合中文档总和的 4 个 cuto ff 值，我们可以将查询分为 5 个类，用于前一个支持 16 个线程的处理器示例。这可以扩展到任意数量的处理器线程（类），因为这些总和在实际 Web 样本中往往是非常大的值。\n\n为了确定 cuto ff 值，我们执行搜索过程以找到最大的 F-Score 的值。对于增加 cuto ff 值的任意初始化来定义每个类的限制，我们通过根据正确分类的查询数量计算 True Positive 案例，False Positive 案例和 False Negative 案例来确定所选择的 cuto ff 值集合的好坏程度。每节课。如前所述，当相关联的线程数是产生低于上限的查询执行时间的最小线程数时，认为查询被正确分类。通过这些计数，我们计算精度（真阳性除以真阳性和假阳性的总和）和召回（真阳性除以真阳性和假阴性的总和）。通过这种方式，平均 F-Score 被定义为 Precision 和 Recall 指标的调和平均值，因此我们只需寻找最大化类集平均 F-Score 的 cuto ff 值。\n\n网络搜索引擎用户倾向于使用极少数条款提交查询。我们通过定义由 1,2,3,4,5 和 5 个以上术语的查询组成的训练集来利用这一事实。对于每组，我们用上述方法获得 cuto ff 值的矢量。然后在查询运行时选择右侧集。\n\n## Dynamic Indexing\n\n我们研究的重点是优化处理节点的性能，该处理节点使用多个线程解析查询，并且还在主存中保持倒排索引更新。该节点必须允许向 Web 文档索引集中添加新文档。在标准实践中，我们假设 docID 是增加的整数，其中索引列表通过增加 docID 来保持排序，以实现其高效压缩[2]。\n\n在我们的实验中，我们省略了文档删除的情况，因为压缩索引列表的实现面临的困难超出了本文范围。 一种粗略但实用的方法是定期重建受影响的索引列表，并跟踪无效的 docID，以便在查询的文档排名过程中省略它们。\n\nWAND 同时处理查询中涉及的所有索引列表。 因此，在解决查询之前必须锁定所有这些索引列表。以相同的方式，如果正在修改查询中涉及的任何索引列表，则必须等待修改完成以继续处理查询。有几种方法可以处理潜在的读/写冲突。在下文中，我们描述了我们在应用领域中发现的最有效的策略。注意，通过使用数据库和操作系统文献中提出的并发控制策略（例如，读和写锁）来同时处理查询和索引更新的方法已经在[4]中进行了测试。\n\n我们设计了三种策略来解决新文档的插入问题，并根据不同的文档到达率评估它们的性能。我们称之为直接插入的第一种方法是安排将每个新文档作为工作单元插入队列中。任何空闲线程都可以使用此工作单元并在涉及的索引列表上执行插入过程。通过迭代新文档的每个术语，请求对要修改的列表的独占访问锁定，并在释放锁定并移动到下一个索引列表之前插入具有相应术语频率的新文档 docID 来解决插入。\n\n第二种方法，我们称之为批量插入，首先收集一定数量的新文档，然后构建临时子倒排索引。 在这种情况下，主索引中的插入过程比直接插入中的插入过程更有效，因为在新文档中出现多次的术语将具有在子倒排索引中具有多个文档的索引列表。 然后，将子索引插入类型工作单元插入队列中。 因此，当空闲线程占用该工作单元时，它仍然在插入所涉及的每个索引列表的文档，而其他线程继续同时解决查询。\n\n第三种方法类似于第二种方法，在临时子索引中为其组织收集了一定数量的文档，但是不是生成单个工作单元，而是将子索引术语加上它们各自的索引列表分布到多个工作单元中，这样所有线程都可以并行处理插入。 我们称这种方法为分布式批量插入(Distributed Batch Insertion)，它有望改进以前的方案，因为它可以消除来自查询和索引列表更新的独占访问锁之间的冲突。当所有线程在处理当前批次查询的同时完成所有线程时，实际上消除了冲突。\n\n在第二种和第三种情况下，插入过程比第一种情况要快得多，因为涉及的发布列表保持锁定在主索引中。 这是因为大部分处理时间都花费在构建子倒排索引上，因此一旦子发布列表准备插入，它们在相应主索引发布列表末尾的位置就会非常快速地执行，因为它需要的计算量要少得多。\n\n# EXPERIMENTAL EVALUATION\n\n我们使用来自 TREC GOV2 Collection 的 2500 万个文档中的 16 个线程来评估解决 WAND 查询的不同方法，并在每个实验中解决 50,000 个查询。 我们构建了一个倒排索引，其发布列表分为 16 个部分，可以在查询时分配给线程。使用 Simple 9 [1]作为代表性技术压缩索引，压缩比和解压缩速度之间具有良好的平衡。 所有实验均使用两个四核英特尔（R）Xeon（R）CPU E5620 @ 2.40GHz 处理器和 96GB RAM 进行。 我们使用 C ++实现了这些技术，并使用优化选项-O3 使用 g ++ 4.4.5 编译了代码。\n\n在实验中，我们使用主内存中的完整索引执行固定数量的查询（50,000）。在查询解决的同时，在索引中插入可变数量的文档，从 50 到 50,000 个文档。我们评估了处理文档插入（直接插入，批量插入和分布式批量插入）的三种技术的性能，并结合 4 种技术来确定每个查询使用的单位数。我们使用（a）每个查询 1 个单元（即用一个线程顺序解决每个查询），（b）完美估计器，其中查询时间事先已知，并且之前已用于确定满足条件的最小线程数查询响应时间的上限，（c）WAND 查询[7]中提出的多变量线性估计器，它估计我们使用它的顺序查询时间，如完全估计器的情况，以及（d）我们的简单分类器方法训练使用一组与实验中使用的查询不同的查询。\n\n在每种情况下，我们都测量了系统解决所有查询和插入所有文档所需的总时间。 图 4,5,6 和 7 显示了每种技术解决插入所花费的总时间，并结合了为查询分配单元的每种方法。图 8 显示了分布式批量插入的每个单元分配技术的总时间，因为它可以获得最佳结果。这个图省略了每个查询 1 个单元的情况，因为它没有达到良好的性能。结果表明，通过 Simple Classifier 结合 Distributed Batch Insertion 进行多线程处理是最佳选择。\n\n搜索引擎的设计要求是实现高吞吐量，其在先前的图中由完成该组操作所需的总时间表示。 另一个相关的设计要求是各个响应时间低于给定上限时间的查询的百分比。 在下文中，我们评估查询的 90Percentile 和 99-Percentile 时间限制值。 也就是说，我们显示最小时间限制值，以确保在比相应绑定值更短的时间内完全处理 90％和 99％的查询。\n\n如图 9 和 10 所示，通过使用每个查询 1 个单元的方法实现的查询时间限制值远远高于使用替代工作单元分配技术观察到的值。这进一步证明，这种方法虽然易于实施，但并不像其他替代方案那样有效，因此我们将其丢弃。\n\n图 11 至图 16 显示简单分类器策略在 99-百分位查询约束时间内具有竞争性，其中简单分类器和多线性估计技术之间的差异相当小。然而，当考虑如图 8 所示的总执行时间时，简单分类器优于多线性估计器，因为它引入查询处理的累积开销要低得多。\n\n# CONCLUSIONS\n\n本文重点讨论了在 Web 搜索引擎的倒排索引中执行更新的同时处理多线程查询的问题。我们已经提出了一种有效的策略来动态地分配线程，以根据它们的特定特征处理各个查询。我们将查询处理分解为多个工作单元，这些工作单元可以由多个线程并行处理。我们设计了一种简单的分类方法来确定每个查询的工作单元数，这种方法足够精确且比其他查询时间估计策略快得多。根据该方案，我们建议在执行实际索引更新并在所有线程之间分发整个插入任务之前，在子索引中预处理文档。总的来说，提出的方法是以两步方式进行，其中（1）通过在查询级别应用并行性使用所有线程处理一批待处理查询，随后（2）处理一组待处理发布列表更新。批量使用并行的所有线程。实验表明，这两步策略对搜索引擎查询吞吐量有积极影响，并确保查询时间的竞争上限。\n\n# REFERENCE\n\n[1] V. N. Anh and A. Moﬀat. Inverted index compression using word-aligned binary codes. Inf. Retr., 8(1):151–166, 2005.\n\n[2] D. Arroyuelo, S. Gonz´alez, M. Oyarzu´n, and V. Sepulveda. Document identiﬁer reassignment and run-length-compressed inverted indexes for improved search performance. In SIGIR, pages 173–182, 2013.\n\n[3] R. Baeza-Yates and B. Ribeiro-Neto. Modern Information Retrieval: The Concepts and Technology behind Search (ACM Press Books). Addison-Wesley Professional, 2011.\n\n[4] C. Bonacic, C. Garc´ıa, M. Marin, M. Prieto-Matias, and F. Tirado. Building eﬃcient multi-threaded search nodes. In CIKM, pages 1249–1258, 2010.\n\n[5] A. Z. Broder, D. Carmel, M. Herscovici, A. Soﬀer, and J. Zien. Eﬃcient query evaluation using a two-level retrieval process. In CIKM, pages 426–434, 2003.\n\n[6] S. Ding and T. Suel. Faster top-k document retrieval using block-max indexes. In SIGIR, pages 993–1002, 2011.\n\n[7] C. Macdonald, N. Tonellotto, and I. Ounis. Learning to predict response times for online query scheduling. In SIGIR, pages 621–630, 2012.\n\n[8] O. Rojas, V. Gil-Costa, and M. Marin. Eﬃcient parallel block-max wand algorithm. In Euro-Par, pages 394–405. 2013.\n\n[9] H. Yan, S. Ding, and T. Suel. Inverted index compression and query processing with optimized document ordering. In WWW, pages 401–410, 2009.\n\n[10] J. Zobel and A. Moﬀat. Inverted ﬁles for text search engines. ACM Comput. Surv., 38(2), July 2006.","date_published":"2019-03-26T14:17:03.000Z"},{"id":"/blog/customize-ubuntu-themes","url":"/blog/customize-ubuntu-themes","title":"Customize Ubuntu themes, icons and Shell","content_html":"## Pre-requirements\n\n1. gtk+3 [download](https://www.gtk.org/download/linux.php)\n2. gnome-tweak-tool\n   `sudo apt-get update` and `sudo apt-get gnome-tweak-tool`\n   ![Tweaks](https://imgcdn.smj.im/G4xyiShA8_A/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzdmMjA3M2VhLndlYnA)\n3. Install an gnome shell Extension\n   `sudo apt-get install gnome-shell-extensions`\n   **Reboot after executing this command**\n   Then you can find a extensions named _user themes_\n   Make it `on`\n   ![extensions](https://imgcdn.smj.im/9LIJHzrOwuY/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2E0NjJkMjc0LndlYnA)\n\n## Start!\n\n### Install an GTK+ themes\n\n1. Download themes files from [here](https://www.opendesktop.org/s/Gnome/p/1241688).\n   ![test](https://imgcdn.smj.im/tRwhcCYGrZc/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwMzg0MjhmMTU4LndlYnA)\n2. Decompression files use these commands\n   `xz -d filename.tar.xz`\n   `tar xvf filename.tar`\n   then you can see a folder on current directiry\n3. Move the folder to _themes_ folder\n   `sudo mv filename /usr/share/themes`\n4. Open Tweaks and change themes on _Appearence->Themes->Applications_\n   ![them-done](https://imgcdn.smj.im/ru985dee-Og/g:sm/f:avif/wm:0.5:soea/aHR0cHM6Ly9pbWFnZS5zbWouaW0vYmxvZy82NTYwM2ExZDdkYWYyLndlYnA)\n\n### Install macOS ICON\n\n1. Download file from [here](https://www.opendesktop.org/s/Gnome/p/1102582/)\n   similar to install themes\n2. Decompression files and move it to _/home/baddate/.icons_\n   **maybe you should press ctrl + h to show hidden file, if it doesn't exists, you can new one folder named** `.icon` **then move the icons foder**\n3. Go to Tweaks `Appearence` window and select `icon`.\n\n### Install mac similar Shell\n\n1. Download file from [here](https://www.opendesktop.org/s/Gnome/p/1013741/)\n2. Select `Sierra-compact-light.tar.xz` or`Sierra-compact-dark.tar.xz`.\n3. Decompression it and move it to /usr/share/themes.\n4. Go to Tweaks `Appearence` window and select `Shell`.\n\nThat's all.\nEnjoy your Ubuntu-Mac!","date_published":"2018-12-07T04:23:03.000Z"},{"id":"/blog/recover-win10-new-command","url":"/blog/recover-win10-new-command","title":"恢复右键菜单的新建命令","content_html":"> 有的时候我们会发现自己常用的“新建”文件类型丢失了，这时候我们可以修改注册表来添加找回。\n\n**假设丢失的是新建`.txt` 文件类型**\n\n1. 用记事本新建一个文本文件，命名为“ADDTXT.REG”\n2. 输入以下代码：\n\n```\nWindows Registry Editor Version 5.00\n[HKEY_CLASSES_ROOT\\.TXT\\ShellNew]\"NullFile\"=\"\"\n```\n\n3. 保存该文件并执行。\n\n**REFERENCE：**\n\n电脑爱好者 2018-12","date_published":"2018-08-12T10:07:23.000Z"},{"id":"/blog/build-site-with-hugo","url":"/blog/build-site-with-hugo","title":"Hugo+Github 搭建个人博客","content_html":"## 安装 Git\n\n1. 在[这个页面](https://git-scm.com/downloads)下载最新版的 Git。\n2. 然后按照 wizard 指引安装 Git。\n3. 配置环境变量\n\n```mermaid\ngraph LR\na[control panel] --> b[System and Security]\nb[System and Security] --> c[System]\nc[System] --> d[Advanced system settings]\nd[Advanced system settings] --> e[ENvirment Variables..]\ne[ENvirment Variables..] --> f[select Path then Edit]\nf[select Path then Edit] --> g[add git path]\ng[add git path] --> Done!\n```\n\n## 创建 GitHub 账号\n\n**这个自行[百度](http://www.baidu.com/) or [Google](https://www.google.com/)**\n\n## 安装 Hugo\n\n1. 从[Hugo Releases](https://github.com/gohugoio/hugo/releases)下载 Hugo 压缩包(记得注意系统位数是 32 or 64)\n2. 解压压缩包\n3. 配置环境变量(同上)\n\n当然还有其他方法，这边就暂时不介绍了，有兴趣的同学可以参考[这里](https://gohugo.io/getting-started/installing/).\n\n## 配置 Hugo\n\n### 创建网站\n\n使用`hugo new site sitename`命令来创建一个网站模板\n模板包含下面这些文件\n\n```txt\n├── archetypes\n├── content\n├── data\n├── layouts\n├── static\n├── themes\n└── config.toml\n```\n\n### 安装主题\n\n1. 在这个[Hugo 主题](https://themes.gohugo.io/)页面找一个喜欢的主题下载并安装。\n2. 下载的应该是一个压缩包，把它解压到`themes`这个文件夹里面。\n3. 接下来就是配置网站了，在上面我们可以发现有一个名为`config.toml`的文件，所以我们只要编辑这个文件就可以配置我们的网站了。\n\n我们上面只是下载解压了那个主题文件夹，并没有把它加载到我们的创建的网站上，所以这个时候我们只要在`config.toml`这个文件里添加一行`themes = \"theme_name\"`就搞定了。\n主题也安装好了，接下来就可以试试效果了：\n\n1. 我们在`content`文件夹里面新建一个文件夹，命名为`post`(一定要是这个名字哦，这个是默认的，如果要用其他名字，还需要在\\**config*文件里面添加一行代码，这里暂时不做讨论了)\n2. 在网站根目录(即: ./sitename 下)打开命令行(`win`+`R`,然后输入`cmd`), 输入`hugo server -t theme_name`\n3. 我们打开(http://localhost:1313)就可以看到了! 这个时候我们会发现多了一个`public`文件夹，这个文件夹包含了我们生成的网页内容\n   当然，这个时候才刚刚完成了一半，因为现在只有我们自己可以看到这个网页，别人是看不到的。所以，这个时候我们就要把它部署到服务器上了，服务器可以有好多选择，这里就只讨论 Github pages 了，毕竟是免费还不限流量的嘛！\n\n## 在 Github Pages 上部署\n\n### 创建 GitHub pages\n\n这个可以参考[官方教程](https://pages.github.com/)，就不赘述了，有疑问的同学可以私信我。\n\n### 在 Github 上托管\n\n1. 在 GitHub 上创建 `your-project-name` 代码仓库（它将用于托管 Hugo 的内容）\n2. 在 GitHub 上创建 `username.github.io` 代码仓库（它将用于托管 `public` 文件夹：静态的网站）\n3. `git clone <your-project-name-url> && cd <your-project-name>`\n4. 使用`hugo new site sitename`来创建网站，在`<your-project-name>`目录下。\n5. 让你的网站在本地生效，输入`hugo server -t theme_name`\n6. 看到效果后，我们这时候需要把`public`这个文件夹删除了\n7. `git submodule add git@github.com:<username>/<username>.github.io.git public` (这里又生成一个`public`文件夹，这就是我们的网页文件)\n8. 最后，我们添加一个脚本(deploy.sh)来帮我们简化操作\n\n```bash\n#!/bin/bash\n\necho -e \"\\033[0;32mDeploying updates to GitHub...\\033[0m\"\n\n# Build the project.\nhugo # if using a theme, replace by `hugo -t <yourtheme>`\n\n# Go To Public folder\ncd public\n# Add changes to git.\ngit add -A\n\n# Commit changes.\nmsg=\"rebuilding site `date`\"\nif [ $# -eq 1 ]\n  then msg=\"$1\"\nfi\ngit commit -m \"$msg\"\n\n# Push source and build repos.\ngit push origin master\n\n# Come Back\ncd ..\n```\n\n**到这里我们的个人网站就建成了！！！** 让我们马上看看效果吧(http://username.github.io/), 可能会有些延迟哦，要有耐心。","date_published":"2018-07-25T12:13:00.000Z"}]}