Linux on 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 源码更新编译流程

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
- 修正文中多处错误

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 所指定的目录中。

自用 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。

Linux on 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. 文章修订记录

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：文章修订记录

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. 准备工作

3.1.2. 拷贝程序至目标板

3.2. 建立工作目录

3.3. 生成密钥

3.4. 开启 sshd

2.1. 输入模式标志 `c_iflag`

2.2. 输出模式标志 `c_oflag`

2.3. 控制模式标志 `c_cflag`

2.4. 本地模式标志 `c_lflag`

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