Void Fox

无人值守安装 Debian

Thu, 13 Mar 2025 15:00:00 +0800

1. 前言

Debian 的自动化安装主要通过 Preseed 技术实现，它允许用户在安装过程中自动填写配置参数，从而实现无人值守的全自动安装。Preseed 文件是一个包含安装选项的配置文件，适用于大规模部署或需要重复安装的场景（如服务器、虚拟机等）。

当前稳定版本的 Preseed 示例文件可从官方网站下载：https://www.debian.org/releases/stable/example-preseed.txt

其他版本示例文件可将链接中的 ‘stable’ 替换成目标版本代号即可，如 Debian 11 的版本代号为 bullseye，则链接为：https://www.debian.org/releases/bullseye/example-preseed.txt

2. 定制 preseed 文件

Preseed 示例文件中有完整的注释，本文不会一一说明，只说明一些在使用的时候需要注意的问题。

2.1. 语言、国家、本地化

示例文件的开头，有这样一段配置：

# Preseeding only locale sets language, country and locale.
d-i debian-installer/locale string en_US

# The values can also be preseeded individually for greater flexibility.
#d-i debian-installer/language string en
#d-i debian-installer/country string NL
#d-i debian-installer/locale string en_GB.UTF-8
# Optionally specify additional locales to be generated.
#d-i localechooser/supported-locales multiselect en_US.UTF-8, nl_NL.UTF-8

# Keyboard selection.
d-i keyboard-configuration/xkb-keymap select us
# d-i keyboard-configuration/toggle select No toggling

在实际使用的过程中发现，该配置并不会生效，在启动自动安装时，依然会询问并让用户选择语言、国家、本地化这些信息。

解决方法是在命令行参数中修改这些值，后文会具体说。

2.2. hostname

# Any hostname and domain names assigned from dhcp take precedence over
# values set here. However, setting the values still prevents the questions
# from being shown, even if values come from dhcp.
d-i netcfg/get_hostname string unassigned-hostname
d-i netcfg/get_domain string unassigned-domain

# If you want to force a hostname, regardless of what either the DHCP
# server returns or what the reverse DNS entry for the IP is, uncomment
# and adjust the following line.
#d-i netcfg/hostname string somehost

一开始我将 d-i netcfg/get_hostname string unassigned-hostname 这一行注释了，使用最好一行中的 d-i netcfg/hostname string somehost 设置 hostname。但实际安装时，依然会询问并让用户输入 hostname。

实际上只要使用 d-i netcfg/get_hostname string unassigned-hostname 这一行的配置设置 hostname 即可。

2.3. 硬盘分区

如果有多块硬盘（包括U盘），需要手动指定要分区的硬盘，我这边是选择第一块 NVMe 硬盘：

`1`	`d-i partman-auto/disk string /dev/nvme0n1`

分区方案配置：

d-i partman-auto/expert_recipe string                          \
    boot-root ::                                               \
        525 525 525 free                                       \
            $iflabel{ gpt }                                    \
            $primary{ } $bootable{ }                           \
            method{ efi } format{ }                            \
        .                                                      \
        500 1024000 -1 ext4                                    \
            $primary{ }                                        \
            method{ format } format{ }                         \
            use_filesystem{ } filesystem{ ext4 }               \
            mountpoint{ / }                                    \
        .                                                      \
        8590 8590 8590 linux-swap                              \
            $primary{ }                                        \
            method{ swap } format{ }                           \
        .

此处配置的分区方案为：500MiB EFI 分区，8GiB Swap 分区，剩余空间为根文件系统。
配置中的数字为 MB 单位，如 500 表示 500MB。3个数字分别表示最小大小、优先级大小、最大大小。负数表示剩余空间。安装程序会根据磁盘空间和优先级大小来决定分区的实际大小。

此处说明一下，为什么 500MiB 的分区大小要写成 525，这里涉及到单位转换的问题。1MB = 10^6 Byte，1MiB = 2^20 Byte，所以 525 ≈ 500 * 2^20 / 10^6。

2.4. 软件包选择

### Package selection
tasksel tasksel/first multiselect standard, web-server, kde-desktop

# Or choose to not get the tasksel dialog displayed at all (and don't install
# any packages):
#d-i pkgsel/run_tasksel boolean false

此处选择需要安装的其他软件包，如 web-server、kde-desktop 等等。

1
2

# Individual additional packages to install
d-i pkgsel/include string vim curl wget

此处选择需要额外安装的软件包，如 vim、curl、wget 等等。

2.5. 遥测数据收集

# You can choose, if your system will report back on what software you have
# installed, and what software you use. The default is not to report back,
# but sending reports helps the project determine what software is most
# popular and should be included on the first CD/DVD.
#popularity-contest popularity-contest/participate boolean false

这里默认是注释掉的，可以将最后一行的注释符号去掉，不然在安装过程中会提示用户选择是否愿意收集遥测数据。

2.6. 安装前命令

1
2
3

# This first command is run as early as possible, just after
# preseeding is read.
#d-i preseed/early_command string anna-install some-udeb

该配置是在安装前(在 preseed 文件读取后)将要执行的命令。

在实际使用过程中，发现如果待安装的硬盘中已经存在 EFI 分区，安装系统会自动将 EFI 分区挂载到 /media，导致在执行分区操作时会出现分区失败的情况，此处可以使用以下安装前命令来解决：

`1`	`d-i preseed/early_command string umount /media \|\| true;`

命令中 || true 是为了解决执行命令时，如果没有挂载 EFI 分区，会报错，所以加上 || true 是为了忽略报错，防止自动安装中断。

2.7. 安装后命令

# This command is run immediately before the partitioner starts. It may be
# useful to apply dynamic partitioner preseeding that depends on the state
# of the disks (which may not be visible when preseed/early_command runs).
#d-i partman/early_command \
#       string debconf-set partman-auto/disk "$(list-devices disk | head -n1)"
# This command is run just before the install finishes, but when there is
# still a usable /target directory. You can chroot to /target and use it
# directly, or use the apt-install and in-target commands to easily install
# packages and run commands in the target system.
#d-i preseed/late_command string apt-install zsh; in-target chsh -s /bin/zsh

该配置是在安装结束前将要执行的命令。此时 /target 目录是可用的，可以使用 chroot 命令进入 /target 目录，使用 apt-install 和 in-target 命令来安装软件和运行命令。

例如可以预先设置 apt 的源（因为安装结束后，源可能是 CDROM），使用以下命令：

d-i preseed/late_command string \
    in-target bash -c 'echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian bookworm main contrib non-free non-free-firmware" > /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian bookworm-updates main contrib non-free non-free-firmware" >> /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian bookworm-backports main contrib non-free non-free-firmware" >> /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware" >> /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb-src https://mirrors.tuna.tsinghua.edu.cn/debian bookworm main contrib non-free non-free-firmware" >> /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb-src https://mirrors.tuna.tsinghua.edu.cn/debian bookworm-updates main contrib non-free non-free-firmware" >> /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb-src https://mirrors.tuna.tsinghua.edu.cn/debian bookworm-backports main contrib non-free non-free-firmware" >> /etc/apt/sources.list'; \
    in-target bash -c 'echo "deb-src https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware" >> /etc/apt/sources.list';

3. 执行无人值守安装

进行无人值守安装时，Preseed 文件可以从 http 服务获取，也可以从文件系统中获取，也可以放在 initrd.gz中。
如果放在 initrd.gz 中，则每次修改 preseed 文件后，都要重新制作 initrd.gz，比较麻烦。

本人将 Debian 12 的 ISO 文件解压到 U 盘进行无人值守安装，所以将 preseed 文件放在 U 盘的根目录下。

安装引导启动时，会将 U 盘挂载到 /cdrom。在首屏安装方式选择时，按 C 快捷键，编辑启动参数，原始的启动参数可能为：

`1`	`/install.amd/vmlinuz vga=788 initrd=/install.amd/gtk/initrd.gz --- quiet`

修改为如下：

`1`	`/install.amd/vmlinuz vga=788 initrd=/install.amd/gtk/initrd.gz auto file=/cdrom/preseed.cfg --- quiet`

如果使用 http 服务器获取 preseed 文件，则修改为如下：

`1`	`/install.amd/vmlinuz vga=788 initrd=/install.amd/gtk/initrd.gz auto url=/cdrom/preseed.cfg --- quiet`

其中 auto 为 auto-install/enable 的别名，file 为 preseed/file 的别名，url 为 preseed/url 的别名。

但此时还不够，会出现 2.1. 语言、国家、本地化中说明的问题，会询问用户选择语言、国家、本地化这些，此时需要在启动参数中增加额外的参数，完整的启动参数为：

`1`	`linux /install.amd/vmlinuz vga=788 language=en country=CN locale=en_US.UTF-8 keymap=us priority=critical auto file=/cdrom/preseed.cfg --- quiet`

最后按照提示，按下快捷键 CTRL+X 使用修改的参数进行启动，即可开始无人值守安装。

3.1. 额外的配置

每次执行无人值守安装时，都需要手动修改启动参数，甚是麻烦，所以我们可以修改 grub 的配置文件，增加一个安装菜单选项。

grub 配置文件位于 [ISO 镜像文件根目录]/boot/grub/grub.cfg，在其中增加一个拥有子菜单的菜单项，这样我们可以通过子菜单，选择不同的 preseed 无人值守安装配置，示例如下：

submenu --hotkey=m 'Automated install ...' {
    set menu_color_normal=cyan/blue
    set menu_color_highlight=white/blue
    set theme=/boot/grub/theme/1-1
    set gfxpayload=keep
    menuentry 'Configuration 1' {
        set background_color=black
        linux    /install.amd/vmlinuz vga=788 language=en country=CN locale=en_US.UTF-8 keymap=us priority=critical auto file=/cdrom/preseed/conf1.cfg --- quiet 
        initrd   /install.amd/initrd.gz
    }
    menuentry 'Configuration 2' {
        set background_color=black
        linux    /install.amd/vmlinuz vga=788 language=en country=CN locale=en_US.UTF-8 keymap=us priority=critical auto file=/cdrom/preseed/conf2.cfg --- quiet 
        initrd   /install.amd/initrd.gz
    }
}

这样在安装引导启动时，就可以直接进入子菜单进行选择，而无需每次手动修改启动参数。

4. 参考链接

交叉编译 OpenOCD 到 Windows 使用

Mon, 02 Sep 2024 18:20:00 +0800

1. 准备工作

本文基于 openocd (commit: cbc32c3) 进行撰写，在 Linux 中使用 mingw32 将 OpenOCD 编译成 Win32 应用。

OpenOCD 依赖以下项目：

libusb
本文使用版本：1.0.26
hidapi
本文使用版本：0.13.1
libftdi1
本文使用版本：1.5
capstone
本文使用版本：4.0.2
libjaylink
本文使用版本：0.3.1
jimtcl
本文使用版本：0.83

上述依赖下载源码后解压备用。

2. 编译

使用下方脚本进行编辑。
该脚本参考了 xpack 的编译方式。
OpenOCD 的编译选项可参考该项目下的 configure 的 help 。

#!/bin/bash

BUILD_DIR=/path/to/openocd/build/dir

# set source env
export OPENOCD_SRC=/path/to/openocd
export LIBUSB1_SRC=/path/to/libusb-1.0.26
export HIDAPI_SRC=/path/to/hidapi-0.13.1
export LIBFTDI_SRC=/path/to/libftdi1-1.5
export CAPSTONE_SRC=/path/to/capstone-4.0.2
export LIBJAYLINK_SRC=/path/to/libjaylink-0.3.1
export JIMTCL_SRC=/path/to/jimtcl-0.83

# configure openocd
cd /path/to/openocd
./bootstrap

config_opts=()

config_opts+=("--disable-wextra")
config_opts+=("--disable-werror")
config_opts+=("--disable-gccwarnings")
config_opts+=("--disable-doxygen-html")
config_opts+=("--disable-doxygen-pdf")

config_opts+=("--enable-amtjtagaccel")
config_opts+=("--enable-angie")
config_opts+=("--enable-armjtagew")
config_opts+=("--enable-cmsis-dap")
config_opts+=("--enable-cmsis-dap-v2")
config_opts+=("--enable-dummy")
config_opts+=("--enable-esp-usb-jtag")
config_opts+=("--enable-ft232r")
config_opts+=("--enable-ftdi")
config_opts+=("--enable-gw16012")
config_opts+=("--enable-jlink")
config_opts+=("--enable-jtag_dpi")
config_opts+=("--enable-jtag_vpi")
config_opts+=("--enable-kitprog")
config_opts+=("--enable-nulink")
config_opts+=("--enable-opendous")
config_opts+=("--enable-openjtag")
config_opts+=("--enable-osbdm")
config_opts+=("--enable-parport")
config_opts+=("--enable-parport-giveio")
config_opts+=("--enable-presto")
config_opts+=("--enable-remote-bitbang")
config_opts+=("--enable-rlink")
config_opts+=("--enable-stlink")
config_opts+=("--enable-ti-icdi")
config_opts+=("--enable-ulink")
config_opts+=("--enable-usb-blaster")
config_opts+=("--enable-usb-blaster-2")
config_opts+=("--enable-usbprog")
config_opts+=("--enable-vdebug")
config_opts+=("--enable-vsllink")
config_opts+=("--enable-xds110")

config_opts+=("--disable-am335xgpio")          # only available on linux
config_opts+=("--disable-at91rm9200")          # only available on linux
config_opts+=("--disable-bcm2835gpio")         # only available on linux
config_opts+=("--disable-imx_gpio")            # only available on linux
config_opts+=("--disable-buspirate")           # not support by MinGW
config_opts+=("--disable-dmem")                # only available on linux
config_opts+=("--disable-parport-ppdev")       # only available on linux or freebsd
config_opts+=("--disable-rshim")               # only available on linux or freebsd
config_opts+=("--disable-sysfsgpio")           # only available on linux
config_opts+=("--disable-xlnx-pcie-xvc")       # only available on linux

# configure hidapi
cd $HIDAPI_SRC
./bootstrap

# configure libjaylink
cd $LIBJAYLINK_SRC
./autogen

# setup env
export MAKE_JOBS=16
export HOST=i686-w64-mingw32
export LIBUSB1_CONFIG="--enable-shared --disable-static"
export HIDAPI_CONFIG="--enable-shared --disable-static --disable-testgui"
export LIBFTDI_CONFIG="-DSTATICLIBS=OFF -DEXAMPLES=OFF -DFTDI_EEPROM=OFF"
export CAPSTONE_CONFIG="CAPSTONE_BUILD_CORE_ONLY=yes CAPSTONE_STATIC=yes CAPSTONE_SHARED=no"
export LIBJAYLINK_CONFIG="--enable-shared --disable-static"
export JIMTCL_CONFIG="--with-ext=json --minimal --disable-ssl"
export OPENOCD_CONFIG=${config_opts[@]}

cd $OPENOCD_SRC

# check if there is tag pointing at HEAD, otherwise take the HEAD SHA-1 as OPENOCD_TAG
OPENOCD_TAG="`git tag --points-at HEAD`"
[ -z $OPENOCD_TAG ] && OPENOCD_TAG="`git rev-parse --short HEAD`"
# check if there is tag pointing at HEAD, if so the release will have the same name as the tag,
# otherwise it will be named 'latest'
RELEASE_NAME="`git tag --points-at HEAD`"
[ -z $RELEASE_NAME ] && RELEASE_NAME="latest"
[[ $RELEASE_NAME = "latest" ]] && IS_PRE_RELEASE="true" || IS_PRE_RELEASE="false"

# set env and call cross-build.sh
export OPENOCD_TAG=$OPENOCD_TAG
mkdir -p $BUILD_DIR && cd $BUILD_DIR
bash $OPENOCD_SRC/contrib/cross-build.sh $HOST

[ $? -eq 0 ] || exit

# add missing dlls
cd $HOST-root/usr
cp `$HOST-gcc --print-file-name=libwinpthread-1.dll` ./bin/
# required by libftdi1.dll. For the gcc-mingw-10.3.x or later "libgcc_s_dw2-1.dll" will need to be copied.
cp `$HOST-gcc --print-file-name=libgcc_s_dw2-1.dll` ./bin/

# prepare the artifact
ARTIFACT="openocd-${OPENOCD_TAG}-${HOST}.tar.gz"
tar -czf $ARTIFACT *
echo "RELEASE_NAME=$RELEASE_NAME"
echo "IS_PRE_RELEASE=$IS_PRE_RELEASE"
echo "ARTIFACT_PATH=$PWD/$ARTIFACT

3. 使用

将 /path/to/openocd/build/dir/i686-w64-mingw32-root/usr/ 目录下的文件，拷贝至 Windows 中即可使用。

附1. 文章修订记录

2024-09-02
- 初次发表
2025-07-18
- 根据最新的 openocd 源码更新编译流程

大型项目使用 git merge 导致多文件混乱问题及解决

Wed, 10 Apr 2024 20:57:00 +0800

1. 原因

之前 clone 可以一个大型开源项目，自己创建了一个分支进行修改。
随着自己的分支和开源项目自身的迭代，自己每次都使用 merge 将远程的主分支合并到自己分支。最近由于隔了非常多版本没有合并，现在使用 merge 合并出现了大量冲突。
于是使用 git merge -X theirs [other_branch] 进行合并，该命令是在合并遇到冲突时，保留 [other_branch] 的改动，删除自己的改动。

合并过程顺利，但是实际出现了本不应该存在的文件，自己的分支没有创建过该文件，远程最新主分支也没有该文件，猜测可能是远程分支中途 commit 出现过该文件，但是在后续的迭代中又删除了该文件。

由于文件太多，不好一一比较删除，遂另寻他法。

2. 解决办法

先使用 git diff 创建差异文件，具体用法：

`1`	`git diff [待合并的分支] [想要被合并的分支] -- ':![排除的文件(夹)1，可使用通配符]' ':![排除的文件(夹)2，可使用通配符]' > /path/to/patch`

然后使用 git apply 应用差异，具体用法：

# 检查是否可以应用，无任何输出则表示可以应用
git apply --check /path/to/patch

# 应用差异 (先修复空格)
git apply --reject --whitespace=fix /path/to/patch

此时基本没太大问题，因为上面使用了 --whitespace=fix，有些末尾的空行等被删除了，此时再使用 git merge -X theirs [other_branch] 合并一次即可。

Buildroot 注解 1

Thu, 29 Jun 2023 15:35:00 +0800

1. 项目客制化

用户可以自定义的内容有：

配置 Buildroot，即 make menuconfig 的内容
配置其他组件，即 make linux-menuconfig、make busybox-menuconfig 等等
自定义已生成的文件系统：
- 添加或覆盖目标板文件系统的文件（通过宏 BR2_ROOTFS_OVERLAY）
- 修改或删除目标板文件系统的文件（通过宏 BR2_ROOTFS_POST_BUILD_SCRIPT）
- 在生成镜像文件前运行任意命令（通过宏 BR2_ROOTFS_POST_BUILD_SCRIPT）
- 修改文件权限和所属关系（通过宏 BR2_ROOTFS_DEVICE_TABLE）
- 添加自定义设备节点（devices node）（通过宏 BR2_ROOTFS_STATIC_DEVICE_TABLE）
添加自定义用户账户（通过宏 BR2_ROOTFS_USERS_TABLES）
在生成镜像文件后运行任意命令（通过宏 BR2_ROOTFS_POST_IMAGE_SCRIPT）
为某些软件包打补丁（通过宏 BR2_GLOBAL_PATCH_DIR）
添加自定义软件包

2. 官方推荐目录结构

+-- board/
|   +-- <company>/
|       +-- <boardname>/
|           +-- linux.config
|           +-- busybox.config
|           +-- <other configuration files>
|           +-- post_build.sh
|           +-- post_image.sh
|           +-- rootfs_overlay/
|           |   +-- etc/
|           |   +-- <some files>
|           +-- patches/
|               +-- foo/
|               |   +-- <some patches>
|               +-- libbar/
|                   +-- <some other patches>
|
+-- configs/
|   +-- <boardname>_defconfig
|
+-- package/
|   +-- <company>/
|       +-- Config.in (if not using a br2-external tree)
|       +-- <company>.mk (if not using a br2-external tree)
|       +-- package1/
|       |    +-- Config.in
|       |    +-- package1.mk
|       +-- package2/
|           +-- Config.in
|           +-- package2.mk
|
+-- Config.in (if using a br2-external tree)
+-- external.mk (if using a br2-external tree)
+-- external.desc (if using a br2-external tree)

2.1. 客制化内容

如果我们有多个相近的项目，可能会共用一些配置，我们不需要为每个项目都配置一遍相同的内容，可以使用以下结构进行配置：

+-- board/
    +-- <company>/
        +-- common/
        |   +-- post_build.sh
        |   +-- rootfs_overlay/
        |   |   +-- ...
        |   +-- patches/
        |       +-- ...
        |
        +-- fooboard/
            +-- linux.config
            +-- busybox.config
            +-- <other configuration files>
            +-- post_build.sh
            +-- rootfs_overlay/
            |   +-- ...
            +-- patches/
                +-- ...

例如需要为 fooboard 的软件包打补丁，可以进行如下配置：
BR2_GLOBAL_PATCH_DIR="board/<company>/common/patches board/<company>/fooboard/patches"

这样的情况，会先为公共部分（common）的软件包打补丁，然后为目标板（fooboard）的软件包打补丁。

BR2_ROOTFS_OVERLAY
BR2_ROOTFS_POST_BUILD_SCRIPT
BR2_ROOTFS_DEVICE_TABLE
BR2_ROOTFS_STATIC_DEVICE_TABLE
BR2_ROOTFS_USERS_TABLES
BR2_ROOTFS_POST_IMAGE_SCRIPT
BR2_GLOBAL_PATCH_DIR

上述宏都可使用此方式配置，以空格分隔，Buildroot 将从左到右顺序执行。

3. 保存 Buildroot 配置文件

使用 make savedefconfig 命令可以保存当前 .config 文件为 defconfig 文件。也可使用 BR2_DEFCONFIG 参数指定保存的位置，如 make savedefconfig BR2_DEFCONFIG=<path-to-defconfig>。

建议保存的位置为 configs/<boardname>_defconfig，保存在此位置的文件，可以被 make list-defconfigs 列处，并且可以使用 make <boardname>_defconfig 命令重新设为当前的待编译的配置文件。

4. 保存其他组件的配置文件

BusyBox、Linux kernel、U-Boot uClibc 等配置改变后，也需要保存。对此，Buildroot 也提供了便捷的命令来保存这些文件的修改。

make linux-update-defconfig 命令会将 Linux kernel 的配置文件保存在宏 BR2_LINUX_KERNEL_CUSTOM_CONFIG_FILE 指定的位置
make busybox-update-config 命令会将 BusyBox 的配置文件保存在宏 BR2_PACKAGE_BUSYBOX_CONFIG 指定的位置
make uclibc-update-config 命令会将 uClibc 的配置文件保存在宏 BR2_UCLIBC_CONFIG 指定的位置
make barebox-update-defconfig 命令会将 BareBox 的配置文件保存在宏 BR2_TARGET_BAREBOX_CUSTOM_CONFIG_FILE 指定的位置
make uboot-update-defconfig 命令会将 U-Boot 的配置文件保存在宏 BR2_TARGET_UBOOT_CUSTOM_CONFIG_FILE 指定的位置

5. 客制化已经生成的文件系统

Buildroot 官方推荐两种方式客制化文件系统：Root filesystem overlays 和 Post-build scripts。两种可以组合使用。

Root filesystem overlays (BR2_ROOTFS_OVERLAY)
Root filesystem overlays 是直接拷贝宏 BR2_ROOTFS_OVERLAY 指定路径下的文件至 rootfs 中的，并且是合并且覆盖的方式，即存在的文件会被替换，不存在的文件会被创建。版本控制文件（如：.git、.svn、.hg等）、.empty、以 ~ 结尾的文件将被排除，不进行拷贝。
可以指定多个 rootfs overlay 目录，见 2.1. 客制化内容
Post-build scripts (BR2_ROOTFS_POST_BUILD_SCRIPT)
Post-build scripts 是在 Buildroot 编译完所有的软件之后、生成 rootfs 镜像文件之前被执行的脚本。
同样可以指定多个脚本执行。
Buildroot 在执行这些脚本时，会传递一些参数进去：
- 宏 BR2_ROOTFS_POST_SCRIPT_ARGS 指定的参数
- $BR2_CONFIG Buildroot 配置文件 .config 的文件路径
- $CONFIG_DIR Buildroot 配置文件 .config 的所在目录
- $HOST_DIR 给目标板程序编写人员使用的工具的目录
- $STAGING_DIR 目标板编写程序所需用到的头文件、库文件等的目录
- $TARGET_DIR 目标板文件系统目录
- $BUILD_DIR 编译过程中使用的临时目录
- $BINARIES_DIR 二进制文件目录，即镜像文件所在的目录
- $BASE_DIR output 的目录，通常情况下是 $BUILD_DIR 的上一级目录

还有三种官方不推荐的修改文件系统的方式：

直接修改
自定义文件系统骨架(skeleton) (BR2_ROOTFS_SKELETON_CUSTOM)
Post-fakeroot scripts (BR2_ROOTFS_POST_FAKEROOT_SCRIPT)

附1：文章修订记录

2023-06-29
- 文章初次发表
2023-07-20
- 修正 4. 保存其他组件的配置文件中的描述错误

ERPNext 14 常规安装流程记录

Wed, 21 Jun 2023 11:58:37 +0800

1. 安装基础依赖

1
2
3

sudo apt update
sudo apt upgrade
sudo apt dist-upgrade

sudo apt install git python3 python3-pip \
    python3-venv software-properties-common \
    mariadb-server mariadb-client \
    redis-server curl nodejs npm xvfb \
    libfontconfig wkhtmltopdf \
    default-libmysqlclient-dev supervisor

2. 配置 Mariadb Server

2.1. 初始化 Mariadb

`1`	`sudo mysql_secure_installation`

2.2. 编辑配置文件

`1`	`sudo vim /etc/mysql/mariadb.conf.d/50-server.cnf`

[mysqld]
bind-address                   = 0.0.0.0    # 此处根据需要修改

character-set-client-handshake = FALSE
character-set-server           = utf8mb4
collation-server               = utf8mb4_unicode_ci

2.3. 重启 Mariadb 服务

重启服务，使配置文件生效。

`1`	`sudo systemctl restart mariadb`

3. 安装 Yarn

`1`	`sudo npm install -g yarn`

4. 配置 Redis

4.1. 新增两份配置

frappe-bench-redis-cache 和 frappe-bench-redis-queue 需要用到。

1
2

sudo cp /etc/redis/redis.conf /etc/redis/redis-frappe-queue.conf
sudo cp /etc/redis/redis.conf /etc/redis/redis-frappe-cahce.conf

修改 /etc/redis/redis-frappe-queue.conf 配置：

`1`	`port 11000`

修改 /etc/redis/redis-frappe-cache.conf 配置：

`1`	`port 13000`

4.2. 启动服务

1
2

sudo /usr/bin/redis-server /etc/redis/redis-frappe-queue.conf --daemonzie yes
sudo /usr/bin/redis-server /etc/redis/redis-frappe-cahce.conf --daemonzie yes

4.3. 检查服务是否启动

1
2

redis-cli -h localhost -p 11000 ping
redis-cli -h localhost -p 13000 ping

5. 使用 Frappe Bench 创建站点

5.1. 安装

`1`	`pip3 install frappe-bench ansible --break-system-packages`

5.2. 初始化 Frappe Bench

`1`	`bench init --frappe-branch version-14 frappe-bench`

5.3. 切换工作目录

`1`	`cd frappe-bench`

5.4. 修改用户目录权限

`1`	`sudo chmod -R o+rx /home/[frappe-user]/`

5.5. 创建新的站点

`1`	`bench new-site [your-site-name]`

6. 安装 ERPNext 和其他应用

6.1. 下载必要的应用

1
2
3

bench get-app payments
bench get-app --branch version-14 erpnext
bench get-app hrms

6.2. 安装应用

1
2

bench --site [your-site-name] install-app erpnext
bench --site [your-site-name] install-app hrms

7. 配置生产环境

7.1. 启用 scheduler 服务

`1`	`bench --site [your-site-name] enable-scheduler`

7.2. 关闭维护模式

`1`	`bench --site [your-site-name] set-maintenance-mode off`

7.3. 切换到生产环境配置

`1`	`sudo bench setup production [frappe-user]`

7.4. 配置 Nginx

`1`	`bench setup nginx`

7.5. 配置最终服务

`1`	`sudo supervisorctl restart all`

`1`	`sudo bench setup production [frappe-user]`

8. 访问 ERPNext

浏览器输入服务器IP即可访问，初始用户名为：Administrator，初始密码为安装 Frappe 时的密码。

附1：文章修订记录

2023-06-21
- 文章初次发表
2023-09-28
- 修正文中多处错误

在 Windows 自带输入法上使用小鹤双拼

Thu, 29 Dec 2022 17:36:00 +0800

系统自带输入法对我而言已经完全足够了，但是没有内置“小鹤双拼”的方案，每次到新的电脑都要在输入法设置里一个一个按键绑定，较为繁琐。

偶然的机会发现可以直接在注册表里添加键值，步骤如下：

打开注册表编辑器
进入如下路径：HKEY_CURRENT_USER\Software\Microsoft\InputMethod\Settings\CHS
新建 字符串值
- 名称为 UserDefinedDoublePinyinScheme{X}，其中 {X} 为数字，一般做序号用，如：UserDefinedDoublePinyinScheme0
- 数据值为 小鹤双拼*2*^*iuvdjhcwfg^xmlnpbksqszxkrltvyovt，“小鹤双拼”为自定义方案的名称，“2”为零声母模式，后面的估计是按声韵母排序绑定到每个键的顺序。
在输入法里将“小鹤双拼”设为默认即可

Linux termios 结构体注解

Mon, 05 Dec 2022 19:17:40 +0800

1. 结构体定义

该结构体定义在头文件 <termios.h> 中，至少包含以下成员：

tcflag_t c_iflag;      /* input modes */
tcflag_t c_oflag;      /* output modes */
tcflag_t c_cflag;      /* control modes */
tcflag_t c_lflag;      /* local modes */
cc_t     c_cc[NCCS];   /* special characters */

2. 结构体成员注解

2.1. 输入模式标志 `c_iflag`

c_iflag 用于设置终端 I/O 的输入参数，标志宏定义如下：

IGNBRK
忽略输入时的中断（BREAK）条件
BRKINT
1. 如果设置了 IGNBRK ，则忽略中断；
2. 如果没有设置 IGNBRK ，但设置了 BRKINT ，那么中断（BREAK）会导致输入输出队列被冲洗（flush）；如果终端是前台进程组，中断（BREAK）将会向该终端发送 SIGINT 信号；
3. 如果 IGNBRK 和 BRKINT 都未设置，中断（BREAK）字符将被读取为空字节（’\0’）；如果设置了 PARMAR 标志，那么它将被读取为序列 \377 \0 \0。
IGNPAR
忽略帧错误和校验错误
PARMRK
（待补充）
INPCK
使能输入奇偶校验
ISTRIP
有效输入字节被剥离为 7 位
INLCR
将输入的 NL 转换为 CR
IGNCR
忽略输入时的 CR
ICRNL
将输入的 CR 转换为 NL （除非设置了 IGNCR ）
IUCLC
（不属于 POSIX）在输入时将大写字符转换成小写
IXON
在输出上使能 XON/XOFF 流控制
IXANY
输入任何字符都将重启停止的输出
IXOFF 在输入上使能 XON/XOFF 流控制
IMAXBEL
（不属于 POSIX）输入队列已满时响铃；Linux 没有实现该标志位
IUTF8
（不属于 POSIX）输入为 UTF8 字符

2.2. 输出模式标志 `c_oflag`

c_oflag 用于设置终端 I/O 的输出参数，标志宏定义如下：

OPOST
使能实现定义（implementation-defined）的输出处理（？）
OLCUC
（不属于 POSIX）在输出时将大写字符转换成小写
ONLCR
在输出时将 NL 转换成 CR-NL
OCRNL
在输出时将 CR 转换成 NL
ONOCR
不在第 0 列输出 CR
ONLRET
不输出 CR
OFILL
以发送填充字符代替使用定时进行延时
OFDEL
填充字符设为 ASCII DEL (0177)，如果未设置，则为 ASCII NULL (’\0’)；Linux 没有实现该标志位
NLDLY
（待补充）
CRDLY
（待补充）
TABDLY
（待补充）
BSDLY
（待补充）
VTDLY
（待补充）
FFDLY
（待补充）

2.3. 控制模式标志 `c_cflag`

c_cflag 用于设置终端 I/O 的控制参数，标志宏定义如下：

CBAUD
（不属于 POSIX）波特率掩码（ 4 + 1 位）。[要求 _BSD_SOURCE 或 _SVID_SOURCE]
CBAUDEX
（不属于 POSIX）额外的波特率掩码（ 1 位），包含在 CBAUD 中。 [要求 _BSD_SOURCE 或 _SVID_SOURCE]
CSIZE
字符大小掩码，值为 CS5、CS6、CS7 或 CS8
CSTOPB
将停止位设为 2 位，如果未设置，则为 1 位
CREAD
启用接收器
PARENB 使能对输出的奇偶校验生成和对输入的奇偶校验检查
PARODD
使能奇校验，如果未设置，则为偶校验
HUPCL
（待补充）
CLOCAL
忽略解制解调器状态行
LOBLK
（待补充）
CIBAUD
（不属于 POSIX）输入波特率掩码
CMSPAR
（不属于 POSIX）（待补充）
CRTSCTS
（不属于 POSIX）启用硬件 RTS/CTS 流控制

2.4. 本地模式标志 `c_lflag`

c_lflag 用于设置终端 I/O 的本地参数，标志宏定义如下：

ISIG
当接收到 INTR、QUIT、SUSP 或 DSUSP 字符时，产生相应的信号
ICANON
使能规范模式
XCASE
（不属于 POSIX）（待补充）
ECHO
使能回显
ECHOE
如果设置了 ICANON，则 ERASE 字符将可视地擦除字符
ECHOK
如果设置了 ICANON，则 KILL 字符将可视地擦除当前行
ECHONL
如果设置了 ICANON，则回显 NL 字符（ ECHO 是否设置都有效）
ECHOCTL
（不属于 POSIX）如果设置了 ECHO，则除 TAB、NL、START 和 STOP 外的特殊终端字符，都回显为 ^X，例如 0x08 (BS) 将回显为 ^H
ECHOPRT
如果设置了 ICANON 和 ECHO，则 ERASE 字符使所有正被擦除的字符按它们被擦除的方式打印
ECHOKE
如果设置了 ICANON，则按照 ECHOE 和 ECHOPRT 指定的方式来回显行中的每个字符
DEFECHO
（不属于 POSIX）仅在进程正在读取时回显；Linux 没有实现该标志位
FLUSHO
（不属于 POSIX）（待补充）
NOFLSH
（不属于 POSIX）（待补充）
TOSTOP
（待补充）
PENDIN
（不属于 POSIX）（待补充）
IEXTEN
（不属于 POSIX）（待补充）

2.5. 终端特殊字符定义数组 `c_cc`

VDISCARD
VDSUSP
VEOF
VEOL
VEOL2
VERASE
VINTR
VKILL
VLNEXT
VMIN
VQUIT
VPEPRINT
VSTART
VSTATUS
VSTOP
VSUSP
VSWTCH
VTIME
VMERASE

移植 OpenSSH

Fri, 30 Jul 2021 19:08:55 +0800

1. 准备工作

OpenSSH 依赖 zlib、OpenSSL。

源码下载：

zlib
zlib.net
OpenSSL
openssl.org
OpenSSH
mirrors.aliyun.com

本文基于 zlib-1.2.11、openssl-1.1.1k、openssh-8.6p1 撰写。

2. 交叉编译

2.1. zlib

2.1.1. 配置 Makefile

1
2
3

CHOST=arm-linux \
./configure \
--prefix=/path/to/install

CHOST
zlib 的 configure 使用此变量自动配置交叉编译工具的前缀，按上述配置，即自动将交叉编译工具名称设为 arm-linux-gcc、arm-linux-ld 等。

2.1.2. 编译与安装

`1`	`make && make install`

将安装在 --prefix 所指定的目录。

2.2. OpenSSL

参考之前的文章移植 OpenSSL。

2.3. OpenSSH

2.3.1. 配置 Makefile

CC=arm-linux-gcc \
./configure \
--host=arm-linux \
--with-libs \
--with-zlib=/path/to/zlib/install \
--with-ssl-dir=/path/to/openssl/install \
--disable-etc-default-login

CC
指定交叉编译工具。
--host
目标平台，交叉编译时需指定。
--with-zlib
指定 zlib 的安装位置。
--with-ssl-dir
指定 openssl 的安装位置，如果 openssl 下有共享库，则编译时自动使用 openssl 的共享库（按照上述配置情况下），否则使用静态库。

此处使用默认路径，不设置 –prefix。

2.3.2. 编译

make

注意：这里不要安装。

3. 在目标板上使用

3.1. 安装至目标板

3.1.1. 准备工作

确保目标板上有以下目录，没有则创建
- /usr/libexec
- /usr/local/bin
- /usr/local/etc

在目标板 /etc/passwd 文件中添加一行

`1`	`sshd:x:74:74:Privilege-separated SSH:/var/empty/sshd:/sbin/nologin`

设置 root 用户密码（已设置则忽略）
1

passwd -a md5 root

3.1.2. 拷贝程序至目标板

将 OpenSSH 交叉编译后的文件（在 openssh-8.6p1 根目录）拷贝至目标板相应目录

文件名	目标板目录
sftp-server	/usr/libexec
ssh-keysign	/usr/libexec
sshd	/usr/local/bin
ssh	/usr/local/bin
scp	/usr/local/bin
sftp	/usr/local/bin
ssh-add	/usr/local/bin
ssh-agent	/usr/local/bin
ssh-keygen	/usr/local/bin
ssh-keyscan	/usr/local/bin
sshd_config	/usr/local/etc
ssh_config	/usr/local/etc

此为默认路径，若在配置时设定了相关目录，则按设定修改。

在目标板建立软链

cd /usr/bin
ln -s ../local/bin/sshd && \
ln -s ../local/bin/ssh && \
ln -s ../local/bin/scp && \
ln -s ../local/bin/sftp && \
ln -s ../local/bin/ssh-add && \
ln -s ../local/bin/ssh-agent && \
ln -s ../local/bin/ssh-keygen && \
ln -s ../local/bin/ssh-keyscan

修改目标板上的 sshd_config 文件
原内容：

...
#Port 22
...
#PermitRootLogin prohibit-password
...

修改为：

...
Port 22
...
PermitRootLogin yes
...

3.2. 建立工作目录

在目标板上建立工作目录

1
2

mkdir /var/run
mkdir -p /var/empty/sshd

确保目标板 /var/empty/sshd 的权限为 755
1

chmod -R 755 /var/empty

在目标板上挂载 devpts

1
2

mkdir /dev/pts
mount devpts -t devpts /dev/pts

3.3. 生成密钥

1
2
3

cd /usr/local/etc
ssh-keygen -t ed25519 -f ssh_host_ed25519_key -N ""
ssh-keygen -t ed25519 -f ssh_host_key -N ""

3.4. 开启 sshd

`1`	`/usr/sbin/sshd`

移植 Paho MQTT

Tue, 13 Jul 2021 14:24:40 +0800

1. 准备工作

1.1. 下载源码

两种方式下载源码:

git clone
直接下载指定 tag 源码

对于第 1 种方式，会把历史 commit 都 clone 下来，对于立项久远、社区活跃的项目来说，体积较大，加之 github 在国内访问不稳定，而且只是使用不是开发，所以这里选择第 2 种方式。

在其项目 Release 页找到最新的 Release Tag，下载 Source code。

1.2. 安装依赖

`1`	`apt install build-essential gcc make cmake cmake-gui cmake-curses-gui`

如果需要使用 SSL 功能，则还需要预先交叉编译 OpenSSL，可参考之前的文章移植 OpenSSL。

如果需要生成文档，还需要安装 doxygen 和 graphhviz：

`1`	`apt install doxygen graphviz`

2. 配置 Makefile

2.1. 修改交叉编译工具链

新建一个目录作为编译用目录，拷贝 paho.mqtt 源码目录下 cmake 目录内的 toolchain.linux-arm11.cmake 至编译用目录，修改以下内容为自己的交叉编译工具链：

`1`	`SET(CMAKE_C_COMPILER arm-linux-gnueabihf-gcc)`

2.2. 生成 Makefile

cmake \
-DPAHO_WITH_SSL=TRUE \
-DPAHO_BUILD_SAMPLES=TRUE \
-DPAHO_BUILD_DOCUMENTATION=TRUE \
-DPAHO_HIGH_PERFORMANCE=TRUE \
-DOPENSSL_ROOT_DIR=/path/to/openssl/install/root \
-DCMAKE_TOOLCHAIN_FILE=/path/to/toolchain.linux-arm11.cmake \
/path/to/paho.mqtt.c/source

参数	默认值	描述
PAHO_BUILD_SHARED	TRUE	编译成共享库
PAHO_BUILD_STATIC	FALSE	编译成静态库
PAHO_HIGH_PERFORMANCE	FALSE	高性能模式，如果设为 TRUE 则编译时 debug 追踪等功能将会被排除
PAHO_WITH_SSL	FALSE	开启 SSL 功能
OPENSSL_ROOT_DIR	“”	OpenSSL 安装目录
PAHO_BUILD_DOCUMENTATION	FALSE	生成文档
PAHO_BUILD_SAMPLES	FALSE	编译示例

如果 OPENSSL_ROOT_DIR 目录内含有共享库，那么编译完成的 paho.mqtt 共享库需要依赖 OpenSSL 的共享库。

3. 编译

make

如果遇到 ld: cannot find -lanl 的错误，则需要在源码目录下，找到 src/CMakeLists.txt，将其中的以下内容注释（使用 # 注释）：

FIND_LIBRARY(LIB_ANL anl)
IF(LIB_ANL)
    SET(LIBS_SYSTEM "${LIBS_SYSTEM}" anl)
ENDIF()

然后重新生成一次 Makefile。原因是 libanl 只支持 glibc。

3.1. 打包（可选）

`1`	`make package`

移植 OpenSSL

Tue, 13 Jul 2021 10:11:05 +0800

1. 源码

官网：https://www.openssl.org/source/

2. 配置 Makefile

./Configure linux-armv4 \
--cross-compile-prefix=arm-linux- \
--prefix=/path/to/install \
no-asm shared no-async

linux-armv4
从 config 文件来看，armv[1-3] 使用 linux-generic32，armv[7-9] 使用 linux-armv4。
no-asm
不使用汇编代码；从 INSTALL 文件得知，建议 debug 期间使用，生产环境不使用。
shared
生成共享库。
no-async
uclibc/musll-ibc 等库不提供 ucontext 库，所以无法使用异步操作。

此配置是基于 openssl-1.1.1k 所写，不同版本可能会有差异，具体查看源码目录下的 INSTALL 文件。

3. 编译与安装

`1`	`make && make install`

最终程序将安装在 --prefix 所指定的目录中。

通过 KMS 激活 Windows 和 Office

Sun, 30 Jun 2019 22:52:13 +0800

1. 准备工作

确定自己的是 VOL 版 Windows 或者 Office
找到对应版本（专业版、教育版等）的 VOL 密钥
可参考 Windows 和 Office KMS 密钥

2. 激活 Windows

管理员权限运行 CMD 或 PowerShell
安装产品密钥( xxxxx 表示对应自己版本的密钥)
1

slmgr /ipk xxxxx
设置 KMS 服务器
1

slmgr /skms example.com:1688
激活 Windows
1

slmgr /ato
查看激活信息
1

slmgr /dlv

更多命令及命令帮助直接输入 slmgr。

3. 激活 MS Office

管理员权限运行 CMD 或 PowerShell
进入 Office 安装的根路径
（以 64 位 Office 2016 默认安装路径为例：C:\Program Files\Microsoft Office\Office16）
1

cd C:\Program Files\Microsoft Office\Office16
安装产品密钥( xxxxx 表示对应自己版本的密钥)
1

cscript ospp.vbs /inpkey:xxxxx

设置 KMS 服务器

`1`	`cscript ospp.vbs /sethst:example.com:1688`

激活 Office
1

cscript ospp.vbs /act

自用 vim 配置文件

Sun, 30 Jun 2019 21:51:18 +0800

自用的 vim 配置，方便以后新装系统使用。

.vimrc 配置如下：

colorscheme inkpot

filetype on
syntax on
set nu
set autoindent  " 自动缩进
set cindent  " 针对C语言自动缩进
set smartindent  " 智能对齐
set tabstop=4  " 缩进时4个空格长度
set softtabstop=4  " 退格退回缩进长度
set shiftwidth=4  " 每一级缩进的长度
set expandtab  " 用空格代替制表符缩进
set showmatch  " 自动匹配括号

" 状态栏
set laststatus=2
set statusline=%F%m%r%h%w\ [FORMAT=%{&ff}]\ [TYPE=%Y]\ [ASCII=\%03.3b]\ [HEX=\%02.2B]\ [POS=%04l,%04v][%p%%]\ [LEN=%L]

" 配置括号自动补全
inoremap ( ()<Esc>i
inoremap [ []<Esc>i
inoremap { {<CR>}<Esc>O
autocmd Syntax html,vim inoremap < <lt>><Esc>i| inoremap > <c-r>=ClosePair('>')<CR>
inoremap ) <c-r>=ClosePair(')')<CR>
inoremap ] <c-r>=ClosePair(']')<CR>
inoremap } <c-r>=CloseBracket()<CR>
inoremap " <c-r>=QuoteDelim('"')<CR>
inoremap ' <c-r>=QuoteDelim("'")<CR>

function ClosePair(char)
    if getline('.')[col('.') - 1] == a:char
        return "\<Right>"
    else
        return a:char
    endif
endf

function CloseBracket()
    if match(getline(line('.') + 1), '\s*}') < 0
        return "\<CR>}"
    else
        return "\<Esc>j0f}a"
    endif
endf

function QuoteDelim(char)
    let line = getline('.')
    let col = col('.')
    if line[col - 2] == "\\"
        return a:char
    elseif line[col - 1] == a:char
        return "\<Right>"
    else
        return a:char.a:char."\<Esc>i"
    endif
endf

配色方案 inkpot 来自 Vivify。

树莓派备忘

Sun, 30 Jun 2019 21:27:10 +0800

1. 无显示器/键鼠初始化配置

1.1. 开启 sshd

在 PC 上部署完 Raspbian 系统至 TF 卡上后，在 boot 分区根目录新建一个名为 ssh 的空文件即可在树莓派启动后开启 Raspbian 的 sshd 服务。
树莓派默认账户：pi，默认密码：raspberry。

1.2. 配置 WLAN

在 PC 上部署完 Raspbian 系统至 TF 卡后，在 boot 分区根目录新建一个名为 wpa_supplicant.conf 的文本文件，在文件中输入一下内容：

country=CN            # 国家/地区
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1

network={
    ssid="WiFi-Name"  # WiFi 名称
    psk="12345678"    # WiFi 密码
    key_mgmt=WPA-PSK  # 加密方式
    priority=1        # 优先级，数字越大优先级越高
    scan_ssid=1       # 连接隐藏 WiFi 加上此行，否则不加或设为 0
}

2. 其他配置

2.1. 配置程序自启

Demo 如下：

[Unit]
Description=demo service

[Service]
Type=forking
ExecStart=/path/to/your/bin
StandardOutput=syslog
StandardError=inherit
User=nobody  <= 以 nobody 用户身份运行

[Install]
WantedBy=multi-user.target

移动/复制到 /usr/lib/systemd/system/ 目录下，运行 # systemctl enable demo.service 即可开启该服务。

在树莓派上搭建 Samba 服务

Thu, 23 May 2019 21:25:02 +0800

1. 安装 Samba

`1`	`sudo apt sintall samba`

2. 编辑配置文件

/etc/samba/smb.conf

# Global parameters
[global]
    log file = /var/log/samba/log.%m
    max log size = 50
    syslog = 0
    panic action = /usr/share/samba/panic-action %d
    usershare allow guests = Yes
    load printers = No  # 没有打印机，不需要加载
    client max protocol = SMB3  # 设置客户端最大协议版本
    client min protocol = SMB2  # 设置客户端最小协议版本
    server min protocol = SMB2  # 服务器最小协议版本
    map to guest = Bad User
    obey pam restrictions = Yes
    pam password change = Yes
    passwd chat = *Enter\snew\s*\spassword:* %n\n *Retype\snew\s*\spassword:* %n\n *password\supdated\ssuccessfully* .
    passwd program = /usr/bin/passwd %u
    security = USER  # 开启非匿名访问
    server role = standalone server
    unix password sync = Yes
    dns proxy = No
    idmap config * : backend = tdb

# 共享文件夹名称
[myshares]
    comment = my shares
    path = /mnt/hdd # 此处为需要共享的目录
    read only = No
    writeable = yes # 开启可写( testparm 默认不显示 )

关于 Samba 协议版本：由于 Windows 10 已经默认不支持 SMBv1 了 ( 仍可通过「启用或关闭 Windows 功能」来开启对 SMBv1 的支持 )，所以这里将协议版本设置为 SMBv2 。

2.1. 测试配置是否正确

`1`	`testparm`

3. 建立 Samba 账户

3.1. 新建系统账户

待创建的 Samba 账户必须已经在 Linux 中存在；此处也可直接用已经存在的账户，不要新建。

1
2
3

sudo useradd -G users smb
sudo passwd smb
(输入两次密码，此为 Linux 账户的密码，非 Samba 账户的访问密码)

3.2. 使用 pdbedit 新增 Samba 账户

1
2

sudo pdbedit -a -u smb
(接下来输入 smb 的密码)

3.2.1. 查询目前已经存在的 Samba 账号

`1`	`pdbedit -L`

3.2.2 修改密码

`1`	`smbpasswd smb`

4. 重启 Samba 服务确保新配置生效

`1`	`systemctl restart smbd.service && systemctl restart nmbd.service`

5. 其他

5.1. 关于挂载 NTFS 的移动硬盘遇到的坑

使用 sudo mount /dev/sda1 /mnt/hdd 挂载以后，发现登录 Samba 后无法写入，总是提示没有权限。几番折腾发现是 Linux 内核对 NTFS 文件系统的支持不足，只支持读取，要写入的话需要安装第三方 NTFS 支持包 ntfs-3g，安装后在挂载时加上参数 -t ntfs-3g 即可。

Windows 环境下通过 Vagrant 安装 Homestead

Thu, 12 Oct 2017 12:00:00 +0800

1. 简介

Laravel 为开发者提供了一套完善的重量级本地开发环境 Laravel Homestead。

Laravel Homestead 实际是一个打包好各种 Laravel 开发所需软件和工具的 Vagrant 盒子（关于 Vagrant 盒子的释义请参考 Vagrant 官方文档），该盒子为我们提供了一个优秀的开发环境，有了它，我们不再需要在本地环境安装 PHP、Composer、Nginx、MySQL、Memcached、Redis、Node 等其它工具软件，我们也完全不用再担心误操作搞乱操作系统因为 Vagrant 盒子是一次性的，如果出现错误，可以在数分钟内销毁并重新创建该 Vagrant 盒子！

Homestead 可以运行在 Windows、Mac 以及 Linux 等主流操作系统上，预装的软件和工具列表如下：

Ubuntu 16.04

Git

PHP 7.1

Nginx

MySQL

MariaDB

SQLite 3

Postgres

Composer

Node（With Yarn, Bower, Grunt, and Gulp）

Redis

Memcached

Beanstalkd

Mailhog

ngrok

引用自[ Laravel 5.5 文档 ] 快速入门重量级开发环境：Homestead 安装使用详细教程

2. 准备工作

需要先安装的软件：

Vagrant
Oracle VM VirtualBox
可选，Vagrant 支持的虚拟机有: Parallels, VirtualBox, VMWare_Desktop。本文选用VirtualBox。
Git For Windows
主要是用到 Git Bash，如果你已经有替代的软件，可以不用安装。注意：Windows 的 CMD 是不行的。

可提前下载的文件：

laravel/homestead
由于官方 box 源都在境外，国内网络在线安装可能会不稳定，有文章说在线安装时不支持断点续传的，所以可以先自行用下载工具下好，具体链接为: https://atlas.hashicorp.com/laravel/boxes/homestead/versions/3.1.0/providers/virtualbox.box，其中 3.1.0 为版本号，可自行在根据情况替换。

3. 安装

在装备儿工作都做好以后，就可以开始安装了。

如无特殊说明，都可使用 CMD 或者 Git Bash 键入命令，尽量使用 Git Bash，本文使用 $ 来表示 Bash 下的命令，复制命令的时候请勿将 $ 一起复制。首先使用 Git Bash 键入以下命令生成 ssh 密钥：

1
2

$ cd ~
$ ssh-keygen -t rsa

一路回车即可。

默认安装会将 box 安装在 C:\Users\你的用户名\ 下的，如果你像我 C 盘容量紧缺的情况下，可以更改 Vagrant 的 HOME 路径，将 box 安装到其他地方，更改方法为计算机 > 右键 > 属性 > 高级系统设置 > 高级 > 环境变量 > 新建，变量名：VAGRANT_HOME，变量值：目标路径。改完需要重启一次计算机才能生效。

3.1. 安装 Homestead Vagrant Box

如果你是使用在线安装，可直接键入以下命令：

`1`	`$ vagrant box add laravel/homestead`

然后出现选择虚拟机，本文使用的是 VirtualBox ，键入2，回车，然后等待下载完成。

如果使用离线安装，在 C:\Users\你的用户名\ 下新建 metadata.json 文件，输入如下内容：

{
    "name": "laravel/homestead",
    "versions": [{
        "version": "3.1.0",
        "providers": [{
            "name": "virtualbox",
            "url": "file:///path/to/boxfile"
        }]
    }]
}

其中 version 根据实际情况填写，下载的是 3.1.0 就填入 3.1.0， url 填写已经下载的 box 的路径，比如在 D 盘根目录，就填写 file://D:/virtualbox.box 。

保存后键入以下命令：

1
2

$ cd ~
$ vagrant box add metadata.json

等待载入完毕。

若键入：

`1`	`$ vagrant box list`

显示结果：

`1`	`laravel/homestead(virtualbox, 3.1.0)`

则说明已经安装成功。

3.2. 安装 Homestead

通过克隆 Laravel 的 Github 代码来安装 Homestead :

1
2

$ cd ~
$ git clone https://github.com/laravel/homestead.git Homestead

克隆完成后进入 Homestead 目录进行初始化：

$ cd Homestead

// Mac/Linux...
$ bash init.sh

// Windows...
init.bat

4. 配置 Homestead

初始化完成后，使用文本编辑器打开 ../Homestead/ 目录下的 Homestead.yaml 。

4.1. 配置系统资源

ip: "192.168.10.10"
memory: 2048
cpus: 1
provider: virtualbox

这几行配置的是：虚拟机 IP 、虚拟机可使用的内存大小、虚拟机可使用的 CPU 数量、使用的虚拟机环境。可根据实际情况修改。

4.2. 配置共享文件夹

1
2
3

folders:
    - map: D:/Laravel/code
      to: /home/vagrant/code

这项配置的是本地与虚拟机共享的目录，如果需要增加共享文件夹的数量，可按格式自行填写即可。

4.3. 配置 Homestead 的 Nginx

1
2
3

sites:
    - map: homestead.app
      to: /home/vagrant/code/project/public

通过 sites 属性可以很方便地将站点映射到虚拟机的指定目录下，而不需要进入虚拟手动修改 Nignx 的配置。如果你打算在同一个Homestead同时开发多个项目，可以按照相同格式添加更多映射。

4.3.1. 配置本机 Host

使用管理员权限用文本编辑器将 C:\Windows\System32\drivers\etc路径下的 hosts 文件打开，向末尾添加一行：

`1`	`192.168.10.10 homestead.app`

以后你就可以直接在浏览器中输入 http://homestead.app 访问你的项目站点了。

4.4. 配置数据库

1
2

databases:
    - homestead

本项默认数据库名为 homestead ，使用的数据库为 MySQL ，默认用户名 homestead ，默认密码 secret ，如果需要增加数据库，同样按照格式添加一个数据库名即可，Homestead 将自动为你创建。

5. 启动虚拟系统

安装和配置都完成了，接下来就可以启动 Vagrant Box 了：

1
2

$ cd ~/Homestead/
$ vagrant up

等待虚拟机启动完成。接下来就可以使用 SSH 工具登陆虚拟机了，或者使用 Vagrant 自带的命令登陆亦可：

`1`	`$ vgrant ssh`

6. 其他操作

如果你修改了配置文件 Homestead.yaml ，只需要执行以下命令即可生效：

`1`	`$ vagrant reload --provision`

关闭虚拟机：

`1`	`$ vagrant halt`

销毁虚拟机：

`1`	`$ vagrant destroy 虚拟机名`

虚拟机状态：

`1`	`$ vagrant global-status`

更多高级玩法可以参考 Vagrant 官方文档。

Windows 和 Office KMS 密钥

Tue, 14 Mar 2017 12:00:00 +0800

GVLK (Generic Volume License Key) 是用于 KMS 客户端的通用序列号。这里提供部分微软官方公布的 Windows 10 / Windows 11 / Office 2013 / Office 2016 / Office 2019 / Office LTSC 2021 / Office LTSC 2024 的 GVLKs ，可用于 KMS 激活。

Office 的 GVLKs 只能用于 VOL 版!

Windows 10/11

产品	GVLK
Windows 10/11 Pro	W269N-WFGWX-YVC9B-4J6C9-T83GX
Windows 10/11 Pro N	MH37W-N47XK-V7XM9-C7227-GCQG9
Windows 10/11 Pro for Workstations	NRG8B-VKK3Q-CXVCJ-9G2XF-6Q84J
Windows 10/11 Pro for Workstations N	9FNHH-K3HBT-3W4TD-6383H-6XYWF
Windows 10/11 Pro Education	6TP4R-GNPTD-KYYHQ-7B7DP-J447Y
Windows 10/11 Pro Education N	YVWGF-BXNMC-HTQYQ-CPQ99-66QFC
Windows 10/11 Education	NW6C2-QMPVW-D7KKK-3GKT6-VCFB2
Windows 10/11 Education N	2WH4N-8QGBV-H22JP-CT43Q-MDWWJ
Windows 10/11 Enterprise	NPPR9-FWDCX-D2C8J-H872K-2YT43
Windows 10/11 Enterprise N	DPH2V-TTNVB-4X9Q3-TJR4H-KHJW4
Windows 10/11 Enterprise G	YYVX9-NTFWV-6MDM3-9PT4T-4M68B
Windows 10/11 Enterprise G N	44RPN-FTY23-9VTTB-MP9BX-T84FV
Windows 10/11 Enterprise LTSC 2019/2021/2024	M7XTQ-FN8P6-TTKYV-9D4CC-J462D
Windows 10/11 Enterprise N LTSC 2019/2021/2024	92NFX-8DJQP-P6BBQ-THF9C-7CG2H
Windows 10/11 Enterprise 2015 LTSB	WNMTR-4C88C-JK8YV-HQ7T2-76DF9
Windows 10/11 Enterprise 2015 LTSB N	2F77B-TNFGY-69QQF-B8YKP-D69TJ

注意：带 N 的版本去掉了 Windows Media Player 播放器
家庭版不需要 KMS

Office 2013

产品	GVLK
Office 2013 Professional Plus	YC7DK-G2NP3-2QQC3-J6H88-GVGXT
Office 2013 Standard	KBKQT-2NMXY-JJWGP-M62JB-92CD4
Project 2013 Professional	FN8TT-7WMH6-2D4X9-M337T-2342K
Project 2013 Standard	6NTH3-CW976-3G3Y2-JK3TX-8QHTT
Visio 2013 Professional	C2FG9-N6J68-H8BTJ-BW3QX-RM3B3
Visio 2013 Standard	J484Y-4NKBF-W2HMG-DBMJC-PGWR7
Access 2013	NG2JY-H4JBT-HQXYP-78QH9-4JM2D
Excel 2013	VGPNG-Y7HQW-9RHP7-TKPV3-BG7GB
InfoPath 2013	DKT8B-N7VXH-D963P-Q4PHY-F8894
Lync 2013	2MG3G-3BNTT-3MFW9-KDQW3-TCK7R
OneNote 2013	TGN6P-8MMBC-37P2F-XHXXK-P34VW
Outlook 2013	QPN8Q-BJBTJ-334K3-93TGY-2PMBT
PowerPoint 2013	4NT99-8RJFH-Q2VDH-KYG2C-4RD4F
Publisher 2013	PN2WF-29XG2-T9HJ7-JQPJR-FCXK4
Word 2013	6Q7VD-NX8JD-WJ2VH-88V73-4GBJ7

Office 2016

产品	GVLK
Office Professional Plus 2016	XQNVK-8JYDB-WJ9W3-YJ8YR-WFG99
Office Standard 2016	JNRGM-WHDWX-FJJG3-K47QV-DRTFM
Project Professional 2016	YG9NW-3K39V-2T3HJ-93F3Q-G83KT
Project Standard 2016	GNFHQ-F6YQM-KQDGJ-327XX-KQBVC
Visio Professional 2016	PD3-PC-RHNGV-FXJ29-8JK7D-RJRJK
Visio Standard 2016	7WHWM-4T7MP-G96JF-G33KR-W8GF4
Access 2016	GNH9Y-D2J4T-FJHGG-QRVH7-QPFDW
Excel 2016	9C2PK-NWTVB-JMPW8-BFT28-7FTBF
OneNote 2016	DR92N-9HTF2-97XKM-XW2WJ-XW3J6
Outlook 2016	R69KK-NTPKF-7M3Q4-QYBHW-6MT9B
PowerPoint 2016	J7MQP-HNJ4Y-WJ7YM-PFYGF-BY6C6
Publisher 2016	F47MM-N3XJP-TQXJ9-BP99D-8K837
SKype for Business 2016	869NQ-FJ69K-466HW-QYCP2-DDBV6
Word 2016	WXY84-JN2Q9-RBCCQ-3Q3J3-3PFJ6

Office 2019

产品	GVLK
Office Professional Plus 2019	NMMKJ-6RK4F-KMJVX-8D9MJ-6MWKP
Office Standard 2019	6NWWJ-YQWMR-QKGCB-6TMB3-9D9HK
Project Professional 2019	B4NPR-3FKK7-T2MBV-FRQ4W-PKD2B
Project Standard 2019	C4F7P-NCP8C-6CQPT-MQHV9-JXD2M
Visio Professional 2019	7TQNQ-K3YQQ-3PFH7-CCPPM-X4VQ2
Access 2019	9N9PT-27V4Y-VJ2PD-YXFMF-YTFQT
Excel 2019	TMJWT-YYNMB-3BKTF-644 FC-RVXBD
Outlook 2019	7HD7K-N4PVK-BHBCQ-YWQRW-XW4VK
PowerPoint 2019	RRNCX-C64HY-W2MM7-MCH9G-TJHMQ
Publisher 2019	G2KWX-3NW6P-PY93R-JXK2T-C9Y9V
Skype for Business 2019	NCJ33-JHBBY-HTK98-MYCV8-HMKHJ
Word 2019	PBX3G-NWMT6-Q7XBW-PYJGG-WXD33

Office LTSC 2021

产品	GVLK
ffice LTSC Standard 2021	KDX7X-BNVR8-TXXGX-4Q7Y8-78VT3
Project Professional 2021	FTNWT-C6WBT-8HMGF-K9PRX-QV9H8
Project Standard 2021	J2JDC-NJCYY-9RGQ4-YXWMH-T3D4T
Visio LTSC Professional 2021	KNH8D-FGHT4-T8RK3-CTDYJ-K2HT4
Visio LTSC Standard 2021	MJVNY-BYWPY-CWV6J-2RKRT-4M8QG
Access LTSC 2021	WM8YG-YNGDD-4JHDC-PG3F4-FC4T4
Excel LTSC 2021	NWG3X-87C9K-TC7YY-BC2G7-G6RVC
Outlook LTSC 2021	C9FM6-3N72F-HFJXB-TM3V9-T86R9
PowerPoint LTSC 2021	TY7XF-NFRBR-KJ44C-G83KF-GX27K
Publisher LTSC 2021	2MW9D-N4BXM-9VBPG-Q7W6M-KFBGQ
Skype for Business LTSC 2021	HWCXN-K3WBT-WJBKY-R8BD9-XK29P
Word LTSC 2021	TN8H9-M34D3-Y64V9-TR72V-X79KV

Office LTSC 2024

产品	GVLK
Office LTSC Professional Plus 2024	XJ2XN-FW8RK-P4HMP-DKDBV-GCVGB
Office LTSC Standard 2024	V28N4-JG22K-W66P8-VTMGK-H6HGR
Project Professional 2024	FQQ23-N4YCY-73HQ3-FM9WC-76HF4
Project Standard 2024	PD3TT-NTHQQ-VC7CY-MFXK3-G87F8
Visio LTSC Professional 2024	B7TN8-FJ8V3-7QYCP-HQPMV-YY89G
Visio LTSC Standard 2024	JMMVY-XFNQC-KK4HK-9H7R3-WQQTV
Access LTSC 2024	82FTR-NCHR7-W3944-MGRHM-JMCWD
Excel LTSC 2024	F4DYN-89BP2-WQTWJ-GR8YC-CKGJG
Outlook LTSC 2024	D2F8D-N3Q3B-J28PV-X27HD-RJWB9
PowerPoint LTSC 2024	CW94N-K6GJH-9CTXY-MG2VC-FYCWP
Skype for Business LTSC 2024	4NKHF-9HBQF-Q3B6C-7YV34-F64P3
Word LTSC 2024	MQ84N-7VYDM-FXV7C-6K7CC-VFW9J

附部分 Office2016 VOL 下载地址

Office 2016 Pro Plus 64位

文件名: SW_DVD5_Office_Professional_Plus_2016_64Bit_ChnSimp_MLF_X20-42426.ISO
文件大小: 1123452928 字节
MD5: 60DC8B1892F611E41140DD3631F39793
SHA1: AEB58DE1BC97685F8BC6BFB0A614A8EF6903E318
CRC32: 8D8AC6D1
下载地址: ed2k://|file|SW_DVD5_Office_Professional_Plus_2016_64Bit_ChnSimp_MLF_X20-42426.ISO|1123452928|31087A00FF67D4F5B4CBF4AA07C3433B|/

Office 2016 Pro Plus 32位

文件名: SW_DVD5_Office_Professional_Plus_2016_W32_ChnSimp_MLF_X20-41351.ISO
文件大小: 986441728 字节
MD5: 49D97BD1B4DFEAAA6B45E3DD3803DAC1
SHA1: 0218F50774AAB63AF7755B0986CDB9972B853E44
CRC32: FF96B0B5
下载地址: ed2k://|file|SW_DVD5_Office_Professional_Plus_2016_W32_ChnSimp_MLF_X20-41351.ISO|986441728|2DE74581C10096137481873B3AD57D43|/

Office 2016 Project Pro 64位

文件名: SW_DVD5_Project_Pro_2016_64Bit_ChnSimp_MLF_X20-42676.ISO
文件大小: 647157760 字节
MD5: B872E55B8F4A8791D65BCF1DB46D1DCB
SHA1: 3C180FDAF91DBD0CB767BD040B42B0599FC53438
CRC32: 6AB6A570
下载地址: ed2k://|file|SW_DVD5_Project_Pro_2016_64Bit_ChnSimp_MLF_X20-42676.ISO|647157760|0BBBF20CA3A5F61A819586ADCE6E4DCB|/

Office 2016 Project Pro 32位

文件名: SW_DVD5_Visio_Pro_2016_64Bit_ChnSimp_MLF_X20-42759.ISO
文件大小: 714913792 字节
MD5: 93BEB874F5A5870D5854519856047103
SHA1: 71E082174812F748AB1A70CA33E6004E1E1AACA8
CRC32: F813794B
下载地址: ed2k://|file|SW_DVD5_Project_Pro_2016_W32_ChnSimp_MLF_X20-41511.ISO|555210752|CA3BD5F8C7B3E263105B041DDD4104AB|/

Office 2016 Visio Pro 64位

文件名: SW_DVD5_Visio_Pro_2016_64Bit_ChnSimp_MLF_X20-42759.ISO
文件大小: 714913792 字节
MD5: 93BEB874F5A5870D5854519856047103
SHA1: 71E082174812F748AB1A70CA33E6004E1E1AACA8
CRC32: F813794B
下载地址: ed2k://|file|SW_DVD5_Visio_Pro_2016_64Bit_ChnSimp_MLF_X20-42759.ISO|714913792|FC930AB97B366B3595FC2F28ABAC2A6F|/

Office 2016 Visio Pro 32位

文件名: SW_DVD5_Visio_Pro_2016_W32_ChnSimp_MLF_X20-41580.ISO
文件大小: 609447936 字节
MD5: 96E008B110F308F1E424D11964D82CE0
SHA1: 780046411EB18874AA2DA7E4A11322557EB00D92
CRC32: 42E1653D
下载地址: ed2k://|file|SW_DVD5_Visio_Pro_2016_W32_ChnSimp_MLF_X20-41580.ISO|609447936|91EB248558F236AA66D234EA03FAD9A9|/

文章修订记录

2017-03-14
- 初次发表
2025-08-12
- 增加 Windows 11 GVLK
- 增加 Office LTSC 2021/2024 GVLK

Void Fox

无人值守安装 Debian

1. 前言

2. 定制 preseed 文件

2.1. 语言、国家、本地化

2.2. hostname

2.3. 硬盘分区

2.4. 软件包选择

2.5. 遥测数据收集

2.6. 安装前命令

2.7. 安装后命令

3. 执行无人值守安装

3.1. 额外的配置

4. 参考链接

交叉编译 OpenOCD 到 Windows 使用

1. 准备工作

2. 编译

3. 使用

附1. 文章修订记录

大型项目使用 git merge 导致多文件混乱问题及解决

1. 原因

2. 解决办法

Buildroot 注解 1

1. 项目客制化

2. 官方推荐目录结构

2.1. 客制化内容

3. 保存 Buildroot 配置文件

4. 保存其他组件的配置文件

5. 客制化已经生成的文件系统

附1：文章修订记录

ERPNext 14 常规安装流程记录

1. 安装基础依赖

2. 配置 Mariadb Server

2.1. 初始化 Mariadb

2.2. 编辑配置文件

2.3. 重启 Mariadb 服务

3. 安装 Yarn

4. 配置 Redis

4.1. 新增两份配置

4.2. 启动服务

4.3. 检查服务是否启动

5. 使用 Frappe Bench 创建站点

5.1. 安装

5.2. 初始化 Frappe Bench

5.3. 切换工作目录

5.4. 修改用户目录权限

5.5. 创建新的站点

6. 安装 ERPNext 和其他应用

6.1. 下载必要的应用

6.2. 安装应用

7. 配置生产环境

7.1. 启用 scheduler 服务

7.2. 关闭维护模式

7.3. 切换到生产环境配置

7.4. 配置 Nginx

7.5. 配置最终服务

8. 访问 ERPNext

附1：文章修订记录

在 Windows 自带输入法上使用小鹤双拼

Linux termios 结构体注解

1. 结构体定义

2. 结构体成员注解

2.1. 输入模式标志 c_iflag

2.2. 输出模式标志 c_oflag

2.3. 控制模式标志 c_cflag

2.4. 本地模式标志 c_lflag

2.5. 终端特殊字符定义数组 c_cc

移植 OpenSSH

1. 准备工作

2. 交叉编译

2.1. zlib

2.1.1. 配置 Makefile

2.1.2. 编译与安装

2.2. OpenSSL

2.3. OpenSSH

2.3.1. 配置 Makefile

2.3.2. 编译

3. 在目标板上使用

3.1. 安装至目标板

3.1.1. 准备工作

2.1. 输入模式标志 `c_iflag`

2.2. 输出模式标志 `c_oflag`

2.3. 控制模式标志 `c_cflag`

2.4. 本地模式标志 `c_lflag`

2.5. 终端特殊字符定义数组 `c_cc`