补络阁

Dank Material Shell安装

Thu, 09 Apr 2026 00:00:00 GMT

Debian安装Dank Material Shell的折腾记录#

1. 效果图：#

niri-example

2. Niri 和 Dank Material Shell#

2.1 Niri#

niri-wm

niri

Waiting for api.github.com...

00K

Waiting...

Niri 是一款创新的 可滚动平铺式 Wayland 合成器（scrollable-tiling Wayland compositor），采用 Rust 语言编写，自 2023 年发布以来迅速获得了大量关注，GitHub 星标数已超过 17,000，超越了 Sway 并正在追赶 Hyprland 。

Niri 最大的特色是其水平无限滚动的工作空间：

列式布局：窗口以列（column）的形式水平排列，每列可包含多个垂直堆叠的窗口
无限滚动：工作空间不是固定大小的桌面，而是一条无限延伸的水平带。当打开新窗口时，现有窗口不会被压缩，而是向左右滚动展示
动态工作空间：工作空间按需动态创建和销毁，空工作空间会自动清理，始终保持整洁

这种设计灵感来源于 GNOME 的 PaperWM 扩展，但 Niri 作为独立的 Wayland 合成器，解决了 PaperWM 在多显示器隔离方面的局限性

特性	说明
多显示器支持	每个显示器拥有独立的工作空间，窗口不会溢出到相邻显示器，支持混合 DPI 和分数缩放
标签页功能	同一列中的窗口可作为标签页切换，节省水平空间
概览模式 (Overview)	按 `Super+O` 可缩放查看所有窗口和工作空间，支持键盘导航
浮动窗口	支持将窗口切换为浮动模式，自动处理对话框等子窗口
内置截图工具	集成截图 UI，支持区域选择和窗口录制
实时重载配置	修改 `config.kdl` 后无需重启会话即可生效
XWayland 支持	通过 `xwayland-satellite` 运行 X11 应用（从 25.08 版本开始集成）
视觉效果	支持渐变边框（Oklab/Oklch 色彩空间）、圆角、模糊和自定义动画着色器

2.2 Dank Material Shell#

AvengeMedia

DankMaterialShell

Waiting for api.github.com...

00K

Waiting...

Dank Material Shell（简称 DMS）是一个为 Wayland 合成器打造的现代桌面 Shell，采用 Quickshell（QtQuick/QML 前端框架）和 Go（后端）构建，旨在提供类似 GNOME Shell 或 KDE Plasma 的完整桌面体验，但专为平铺式窗口管理器优化。

DMS 解决了平铺式窗口管理器（如 Niri、Hyprland、Sway）“开箱即用”能力不足的问题。传统平铺 WM 通常只提供窗口管理功能，用户需要自行配置状态栏、启动器、系统托盘、通知中心等组件。DMS 将这些全部打包，提供一站式桌面环境，同时保留平铺 WM 的高效特性。

DMS 采用客户端-服务器架构 ：

后端（dms）：Go 编写的核心，管理 D-Bus 接口（NetworkManager、蓝牙、CUPS 打印机等）、Wayland 协议（如 wlr-gamma-control 用于夜间模式），并通过 Unix Socket 暴露 JSON API
前端（Quickshell）：QML 编写的 UI，负责小部件、模态框和用户体验
可选组件：
- dgop：系统遥测服务，为资源监控小部件提供数据
- dsearch：极速文件系统搜索引擎
- dankinstall：自动化安装和管理工具

DMS 支持的渲染器：

合成器	支持程度
Niri	完全支持（推荐），包括工作区切换、概览集成、显示器关闭等
Hyprland	完全支持，提供专门的 Home Manager 模块
Sway / dwl (MangoWC)	支持，但部分功能受限（如无工作区切换器集成）
其他	基础功能可用，但缺少合成器特定集成

3. 安装教程#

这里为了方便，我们不手动配置Niri，转而使用DMS

DMS 支持 Arch，Fedora，Debian 这几个Linux发行版以及其衍生版本 (所以理论上Kali Linux也能装)

3.1 安装基准系统#

这里我们使用Debian 13.4.0 KDE

Debian 13.4.0 Live KDE: 下载链接

选择 Live System (amd64)

debian-install-1

点击 Install Debian

debian-install-2

选择 简体中文

debian-install-3

时区选择上海

debian-install-4

键盘布局默认

debian-install-5

磁盘选择 抹除磁盘 (后面看情况会出双系统的教程)

debian-install-6

设置用户名与密码

debian-install-7

点击安装

debian-install-8

等待安装完毕

debian-install-9

点击完成

debian-install-10

3.2 安装 Niri 和 Dank Material Shell#

打开 Kconsole 并挂好 终端代理

这里虚拟机难用，用SSH在我外面的终端上操作

debian-install-niri-1

更新一下 apt 软件源

这里的话，等一下安装DMS时它会添加外部镜像源，也需要挂代理，所以不换国内源了

Terminal window

1
sudo apt update

使用官方安装命令进行安装

Terminal window

1
curl -fsSL https://install.danklinux.com | sh

debian-install-niri-2

这里直接 Enter 继续

debian-install-niri-3

这里 WM 选第一个

debian-install-niri-4

Terminal 的话按自己偏好选就行，这里我选Kitty

debian-install-niri-5

这里的话 Enter 继续

debian-install-niri-6

输入你的密码然后回车开始安装

debian-install-niri-7

等待脚本执行

debian-install-niri-8

出现这个界面就说明安装成功了，此时我们注销并重新登录，记得登录时在SDDM的会话那里把 KDE Wayland 改为 Niri

3.3 安装 DankGreeter#

现在我们已经安装好了DMS，但是我们的窗口管理器还是 KDE 默认的 SDDM ，风格不统一，所以我们安装 Dank 官方的 DankGreeter

3.3.1 安装命令#

使用 dms-cli 安装：

Terminal window

1
dms greeter install

Arch Linux (AUR)

Terminal window

1
paru -S greetd-dms-greeter-git
2
# Or with yay
3
yay -S greetd-dms-greeter-git

Fedora

Terminal window

1
sudo dnf copr enable avengemedia/danklinux
2
sudo dnf install dms-greeter

Debian

Terminal window

1
sudo apt install dms-greeter

3.3.2 初始化 DankGreeter#

Terminal window

1
dms greeter enable

3.3.3 同步主题#

Terminal window

1
dms greeter sync

Note

这里可能会提示是否将当前用户加入用户组，选择是并且输入账号密码就行

3.3.4 效果展示#

dankgreeter

4. 系统优化#

4.1 安装 Nerd Font#

我用的是FiraCode Nerd Font Regular，下载链接

Nerd Font：FireCode

4.2 设置Kitty Terminal#

配置文件路径：～/.config/kitty/kitty.conf

4.2.1 设置Font#

1
# Font Confguration
2
font_size 12.0
3
font_family FiraCode Nerd Font

4.2.2 设置默认Shell#

1
# Default Shell
2
shell /bin/zsh

4.2.3 设置半透明#

1
# Window Configuration
2
background_opacity 0.9

4.3 添加 Emoji 选择器#

4.3.1 安装依赖#

Terminal window

1
sudo apt install wofi wl-clipboard jq curl

软件包	备注
wofi	Emoji选择器
wl-clipboard	剪切板支持
jq	json支持
curl	这个不用说了

4.3.2 编写启动脚本#

Terminal window

1
sudo nano /usr/bin/wofi-emoji

内容

1
#!/bin/bash
2

3
DATA_DIR="$HOME/.local/share"
4
EMOJI_FILE="$DATA_DIR/emojis.json"
5
FAVORITES_FILE="$DATA_DIR/emoji-favorites.txt"
6

7
# 下载数据
8
[ ! -f "$EMOJI_FILE" ] && curl -sL \
9
    https://raw.githubusercontent.com/muan/emojilib/main/dist/emoji-en-US.json \
10
    -o "$EMOJI_FILE"
11

12
# 加载收藏
13
favorites=""
14
[ -f "$FAVORITES_FILE" ] && favorites=$(cat "$FAVORITES_FILE" | sed 's/^/⭐ /')
15

16
# 构建列表
17
list="$favorites
18
$(jq -r 'to_entries | .[] | .key + " " + (.value | join(" "))' "$EMOJI_FILE")"
19

20
# 选择
21
selected=$(echo "$list" | wofi --dmenu \
22
    --prompt "Emoji (copied):" \
23
    --width 700 \
24
    --height 500 \
25
    --insensitive \
26
    --cache-file /dev/null | sed 's/^⭐ //')
27

28
# 复制到剪贴板
29
if [ -n "$selected" ]; then
30
    emoji=$(echo "$selected" | awk '{print $1}')
31

32
    # 复制到剪贴板
33
    echo -n "$emoji" | wl-copy
34

35
    # 添加到收藏
36
    [ -f "$FAVORITES_FILE" ] && grep -v "^$emoji$" "$FAVORITES_FILE" > "$FAVORITES_FILE.tmp" || true
37
    echo "$emoji" > "$FAVORITES_FILE"
38
    [ -f "$FAVORITES_FILE.tmp" ] && head -19 "$FAVORITES_FILE.tmp" >> "$FAVORITES_FILE"
39
    rm -f "$FAVORITES_FILE.tmp"
40
fi

展开收起

赋予执行权限

Terminal window

1
sudo chmod +x /usr/bin/wofi-emoji

4.3.3 编写CSS样式#

1
window {
2
    margin: 5px;
3
    border: 2px solid #7aa2f7;
4
    border-radius: 10px;
5
    background-color: #1a1b26;
6
    font-family: "Noto Color Emoji", "JetBrains Mono";
7
}
8

9
#input {
10
    margin: 10px;
11
    padding: 10px;
12
    border-radius: 5px;
13
    border: none;
14
    background-color: #24283b;
15
    color: #a9b1d6;
16
}
17

18
#inner-box {
19
    margin: 10px;
20
}
21

22
#entry {
23
    padding: 8px;
24
    border-radius: 5px;
25
}
26

27
#entry:selected {
28
    background-color: #7aa2f7;
29
    color: #1a1b26;
30
}
31

32
#text {
33
    color: #c0caf5;
34
}

展开收起

4.3.4 绑定 Niri 快捷键#

Terminal window

1
nano .config/niri/dms/binds.kdl

添加：

1
// +++ Emoji-Seletor +++
2
binds {
3
    Mod+E hotkey-overlay-title="Open Emoji" { spawn "wofi-emoji"; }
4
}

使用 Mod-E 打开 Emoji 选择器

4.3.5 效果例图#

debian-niri-emoji

4.4 安装 fastfeach#

4.4.1 安装依赖#

Terminal window

1
sudo apt install fastfetch

4.4.2 下载美化包#

sqlsec

fastfetch

Waiting for api.github.com...

00K

Waiting...

下载

Terminal window

1
wget https://github.com/sqlsec/fastfetch/releases/download/v0.1/fastfetch-for-Linux.zip

备份原配置

Terminal window

1
mv $HOME/.config/fastfetch $HOME/.config/fastfetch.bak

写入新配置

Terminal window

1
cd .config

Terminal window

1
wget https://github.com/sqlsec/fastfetch/releases/download/v0.1/fastfetch-for-Linux.zip
2
unzip fastfetch-for-Linux.zip && rm fastfetch-for-Linux.zip

不同的 .jsonc 就是不同的预设方案，如果启用的话，将其重命名为 config.jsonc 即可切换为默认的预设方案

4.4.3 我的配置#

新建配置文件夹

Terminal window

1
mkdir ~/.config/fastfetch

复制文件夹

Terminal window

1
cd ./fastfetch-for-linux/fastfetch
2

3
cp -r ./anime ~/.config/fastfetch

写入新配置

Terminal window

1
nano ./fastfetch-for-linux/fastfetch/config.jsonc

1
{
2
    "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
3
    "logo": {
4
    "type": "kitty",
5
        "source": "~/.config/fastfetch/anime/cat-1.jpg",
6
        "height": 18,
7
    },
8
    "display": {
9
        "separator": " : "
10
    },
11
    "modules": [
12
    {
13
            "type": "custom",
14
            "format": "┌────────────────────────────────────────────────────────┐"
15
        },
16
    {
17
            "type": "title",
18
            "key": "  "
19
        },
20
    {
21
            "type": "custom",
22
            "format": "└────────────────────────────────────────────────────────┘"
23
        },
24
        {
25
            "type": "os",
26
            "key": "  󰰖 OS",
27
            "keyColor": "red"
28
        },
29
        {
30
            "type": "kernel",
31
            "key": "   Kernel",
32
            "keyColor": "red"
33
        },
34
        {
35
            "type": "wm",
36
            "key": "   WM",
37
           "format": "{2}",
38
            "keyColor": "yellow"
39
        },
40
        {
41
            "type": "shell",
42
            "format": "{1} {4}",
43
            "key": "  󰘳 Shell",
44
            "keyColor": "blue"
45
        },
46
        {
47
             "type": "memory",
48
            "key": "  󰀚 Memory",
49
            "keyColor": "blue"
50
        },
51
        {
52
            "type": "uptime",
53
            "key": "  󱫐 Uptime ",
54
            "keyColor": "red"
55
        },
56
        {
57
            "type": "host",
58
            "key": "  󰢚 Machine",
59
            "format": "{name}{?vendor} ({vendor}){?}",
60
            "keyColor": "red"
61
        },
62
    "break",
63
    {
64
            "type": "colors",
65
            "paddingLeft": 2,
66
            "symbol": "circle"
67
        },
68
        "break"
69

70
    ]
71
}

展开收起

4.5 解决屏幕共享失败问题#

系统安装完成后，我用飞书开会议时共享屏幕失败了，这里找到了一种解决方法：https://forum.archlinuxcn.org/t/topic/15155

安装 xdg-desktop-portal-hyprland

Terminal window

1
apt install xdg-desktop-portal-hyprland

修改 /usr/share/xdg-desktop-portal/niri-portals.conf 的内容

1
[preferred]
2
default=hyprland;gtk;
3
org.freedesktop.impl.portal.Access=gtk;
4
org.freedesktop.impl.portal.Notification=gtk;
5
org.freedesktop.impl.portal.Secret=gnome-keyring;

重启系统

5. 其余设置#

5.1 系统样式设置#

5.1.1 DankBar#

Super + , 打开DMS Settings
进入 Dank Bar >> 设置
修改位置为左

debian-dankbar

5.1.2 设置系统主题色#

Super + , 打开DMS Settings
进入 主题与配色
修改 主题色 为黄色

debian-theme-color

5.1.3 Window Gap#

Super + , 打开DMS Settings
进入 主题与配色
在 niri布局覆盖 打开 覆盖间隙 并修改 窗口间隙 为 28px

debian-window-gap

5.2 软件的安装和修改#

5.2.1 在 Chrome 里添加带代理的启动选项#

修改.local/share/applications/google-chrome.desktop

Terminal window

1
sudo nano .local/share/applications/google-chrome.desktop

内容

1
[Desktop Entry]
2
Actions=new-window;new-private-window;new-window-with-proxy;
3
Categories=Network;WebBrowser;
4
Comment=访问互联网
5
Exec=/usr/bin/google-chrome-stable --ozone-platform=x11 %u
6
GenericName[zh_CN]=网页浏览器
7
GenericName=Web Browser
8
Icon=google-chrome
9
MimeType=application/pdf;application/rdf+xml;application/rss+xml;application/xhtml+xml;application/xhtml_xml;application/xml;image/gif;image/jpeg;image/png;image/webp;text/html;text/xml;x-scheme-handler/http;x-scheme-handler/https;x-scheme-handler/google-chrome;
10
Name=Google Chrome
11
NoDisplay=false
12
Path=
13
PrefersNonDefaultGPU=false
14
StartupNotify=true
15
Terminal=false
16
TerminalOptions=
17
Type=Application
18
Version=1.0
19
X-KDE-SubstituteUID=false
20
X-KDE-Username=
21

22
[Desktop Action new-private-window]
23
Exec=/usr/bin/google-chrome-stable --incognito --ozone-platform=x11
24
Name[zh_CN]=新建隐身窗口
25
Name=New Incognito Window
26

27
[Desktop Action new-window]
28
Exec=/usr/bin/google-chrome-stable --ozone-platform=x11
29
Name[zh_CN]=新建窗口
30
Name=New Window
31

32
[Desktop Action new-window-with-proxy]
33
Exec=/usr/bin/google-chrome-stable --ozone-platform=x11 --proxy-server="socks5://127.0.0.1:7897" %u
34
Name[zh_CN]=新建带代理的窗口
35
Name=New Window With Proxy

展开收起

5.2.2 安装AppImage#

这里以yakit为例

去官网下载最新的 AppImage 文件
解包 AppImage 文件

Terminal window

1
./Yakit.AppImage --appimage-extract

这样会得到 squashfs-root 文件夹，将它重命名为 app

Terminal window

1
mv squashfs-root app

新建 Yakit.desktop 文件

Terminal window

1
nano .local/share/applications/Yakit.desktop

写入以下内容

1
[Desktop Entry]
2
Name=Yakit
3
Exec="/home/tuf3i/UserApps/yakit/app/yakit" --on-sandbox # 改为可执行文件的具体路径
4
Terminal=false
5
Icon=/home/tuf3i/UserApps/yakit/app/yakit.png # 改为图标的具体路径
6
Type=Application
7
StartupWMClass=Yakit
8
X-AppImage-Version=1.4.6-403
9
Comment=Yakit is for yaklang.io Electron GUI Entry
10
Categories=Utility;

6. 结尾#

没有了喵，谢谢阅读

gopher

博客-启航

Thu, 02 Apr 2026 00:00:00 GMT

我的第一篇博客喵#

弄了两天多吧，终于把这个博客搭起来了，用的云函数和中间件有点多，真不容易
说起来，这个博客好像也挺复杂的，它是部署在我的K3S集群上的，用了Gitea Action监听Push和Merge Pr这两种操作，从而在内容有更新时调用CICD对Pod进行滚动更新来更新博客内容。
说起来在部署这个博客的时候确实出现了亿点小问题，我的Dood-Action-Runner死活登录不了我的Gitea-ContainerRegistry，最后也是得到了红岩运维大佬的指点，才解决了这个问题（后面可以水一篇博客好好讲讲）。

这是我的第一篇博客喵，也不知道要写一点什么，简单庆祝一下吧，从今天开始我也是有博客的人了😋😋😋。

gopher

Linux Shell Pipeline

Sat, 18 Apr 2026 00:00:00 GMT

Linux管道符的知识点和使用#

先记住一句话核心：管道符号 |，作用是：把左边命令打印出来的内容，直接交给右边命令去处理。 Linux 一切皆文本，管道就是文本传送带，把前一个工具的结果，传给下一个工具。

1. 管道的底层原理#

1.1 三大输出流#

Linux 每个命令运行时，都有 3 个数据流：

标准输入 stdin：命令读取的内容（好比人的耳朵，接收数据）
标准输出 stdout：命令正常打印的内容（好比嘴巴，输出内容）
标准错误 stderr：命令报错的红色错误信息

1.2 管道规则#

只转发标准输出 (stdout)
默认不转发错误信息 (stderr)
格式固定：

Terminal window

1
命令1 | 命令2 | 命令3

数据流向：命令 1 打印的内容 → 自动变成命令 2 的输入 → 命令 2 处理完 → 传给命令 3

2. 基础示例#

2.1 示例一#

Terminal window

1
ls -la | grep "txt"

ls -la：列出当前文件夹所有文件 + 详细信息（这是左边输出）
|：把上面列出的所有内容，传给右边
grep "txt"：筛选出包含 txt 字符串的行

2.2 示例二#

Terminal window

1
ps aux | grep python | wc -l

ps aux：列出系统所有正在运行的进程
第一层|：全部进程信息传给 grep
grep python：只筛选出和 python 相关的进程
第二层|：筛选后的内容传给 wc
wc -l：统计行数（也就是统计 python 进程数量）

3. 进阶：文本流水线#

3.1 错误日志筛选 + 去重#

Terminal window

1
cat /var/log/syslog | grep "ERROR" | sort | uniq

分步拆解：

cat /var/log/syslog：读取系统日志文件全部内容
grep "ERROR"：只保留包含 ERROR 的错误日志
sort：把日志内容按字母 / 时间排序
uniq：去掉完全重复的日志行

3.2 统计每种错误出现次数#

Terminal window

1
cat /var/log/syslog | grep "ERROR" | sort | uniq -c | sort -nr

新增参数解释：

uniq -c：去重 + 在每行前面加上出现次数
sort -nr：
- -n：按数字排序
- -r：倒序（错误最多的排最上面）

4. 管道 + xargs#

4.1 为什么需要 xargs？#

管道 | 传递的是内容（文本），当做「输入」
很多命令（rm、mkdir、curl）不接收文本输入，只接收「参数」
xargs 作用：把管道传过来的文本，转换成命令的参数

4.2 示例#

4.2.1 删除所有 .log 文件#

Terminal window

1
find . -name "*.log" | xargs rm

拆解：

find . -name "*.log"：找出当前目录下所有后缀为 .log 的文件，打印出来
xargs rm：把上面找到的文件名，一个个当成 rm 的参数等价于：rm 日志1.log 日志2.log ...

4.2.2 批量访问网址#

Terminal window

1
cat urls.txt | xargs -P 4 -I {} curl -s {}

参数：

-P 4：同时开 4 个进程，并行执行
-I {}：用 {} 代替每一行内容
curl -s {}：静默访问每一个网址

5. 进程替换 `<()` 命令#

5.1 核心作用#

有些命令不支持管道，就用 < 把命令输出伪装成临时文件

Terminal window

1
diff <(cat file1.txt) <(cat file2.txt)

diff：对比两个文件差异
<(cat file1.txt)：把 file1 内容，假装成一个文件

*等价写法（管道版）：

Terminal window

1
cat file1.txt | diff - <(cat file2.txt)

这里的 - 代表：读取管道传来的stdout的内容

5.2 进程替换与文件重定向#

方式	语法	本质	使用场景
进程替换	`cat <(cmd)`	将命令输出作为文件路径传入	需要文件名参数时
输入重定向	`cat < file` 或 `cmd < file`	将文件内容作为stdin	从文件读取输入

进程替换 <(...)

Terminal window

1
# 将命令输出伪装成文件，传给需要文件参数的命令
2
cat <(echo "hello world")
3
# 等价于: cat /dev/fd/63 （bash创建的临时管道文件描述符）
4

5
# 实际应用：对比两个命令输出
6
diff <(ls dir1) <(ls dir2)
7

8
# 写入文件（通过 cat 中转）
9
cat <(echo "content") > output.txt

原理：Bash 创建命名管道（FIFO）或 /dev/fd 文件，让 cat 以为是普通文件。

输入重定向 <

Terminal window

1
# 从文件读取，写入另一个文件（相当于复制）
2
cat < input.txt > output.txt
3

4
# 等价于
5
cat input.txt > output.txt
6

7
# 结合 Here Document
8
cat << 'EOF' > output.txt
9
line 1
10
line 2
11
EOF

6. 标准错误管道处理#

6.1 默认问题#

管道只传正常输出，报错信息会直接打印屏幕，不走管道。

6.2 两个核心数字#

1 = 标准输出（正常内容）
2 = 标准错误（报错内容）

6.3 示例#

6.3.1 屏蔽错误#

Terminal window

1
find /root 2>/dev/null | grep "file"

2>/dev/null：把错误信息丢进null设备，直接删除
只有正常搜索结果进入管道被 grep 筛选

6.3.2 错误也走管道#

Terminal window

1
find /root 2>&1 | grep "Permission"

2>&1：把错误流 (2) 合并到正常输出流 (1)
此时正常内容 + 报错内容全部进入管道，可以筛选权限报错

7. 三通阀（tee命令）#

7.1 作用#

一份数据两用：

屏幕上正常显示
同时保存到文件

7.2 基础用法#

Terminal window

1
cat file.txt | tee backup.txt | grep "keyword"

流程：

读取 file.txt
tee backup.txt：
- 复制一份内容存入 backup.txt
- 同时把内容继续往后传给管道
最后 grep 筛选关键词

7.3 追加写入#

Terminal window

1
echo "新内容" | tee -a log.txt

-a：append 追加，不会删掉文件原有内容

8. 流式编辑器（sed命令）#

这个可以修改前端管道的内容，然后传递给后端的管道，比如cmd_1 | sed [opts] 'cmd' | cmd_2

8.1 基础用法#

Terminal window

1
sed [opts] 'cmd' 文件
2
sed [opts] -e 'cmd_1' -e 'cmd_2' 文件

基础示例 (将每行第一个匹配的foo替换为bar)

Terminal window

1
sed 's/foo/bar/' file

1
foo is great
2
another foo here foo
3
no match here
4
foofoo test

dest

1
bar is great
2
another bar here foo
3
no match here
4
barfoo test

8.2 核心命令#

8.2.1 替换（s）#

Terminal window

1
# 基本替换：每行第一个匹配
2
sed 's/foo/bar/' file
3

4
# 全局替换（g）：每行所有匹配
5
sed 's/foo/bar/g' file
6

7
# 替换第 N 个匹配
8
sed 's/foo/bar/2' file      # 替换每行第 2 个
9
sed 's/foo/bar/2g' file   # 从第 2 个开始，替换后面所有
10

11
# 使用分隔符（当替换路径等含/的内容时）
12
sed 's#/usr/local#/opt#g' file    # 用 # 代替 /
13
sed 's|/home/user|/data|g' file    # 用 | 代替 /

8.2.2 删除（d）#

Terminal window

1
# 删除指定行
2
sed '3d' file          # 删除第 3 行
3
sed '1,5d' file        # 删除 1-5 行
4
sed '$d' file          # 删除最后一行
5

6
# 删除匹配行
7
sed '/pattern/d' file              # 删除含 pattern 的行
8
sed '/^#/d' file                   # 删除注释行（以#开头）
9
sed '/^$/d' file                   # 删除空行

8.2.3 打印（p）与静默（-n）#

Terminal window

1
# 默认 sed 会打印所有行，p 会额外打印匹配行（导致重复）
2
sed '/pattern/p' file    # 匹配行出现两次
3

4
# -n 静默模式，只打印指定内容
5
sed -n '/pattern/p' file         # 只打印匹配行
6
sed -n '5,10p' file              # 打印 5-10 行（类似 head/tail）
7
sed -n '1~2p' file               # 打印奇数行（从1开始，步长2）

8.2.4 插入、追加、修改（i/a/c）#

Terminal window

1
# i：行前插入
2
sed '3i\This is new line' file
3

4
# a：行后追加
5
sed '3a\This is new line' file
6

7
# c：替换整行
8
sed '3c\Replace line 3' file
9

10
# 匹配后操作
11
sed '/pattern/a\New line after match' file

8.3 常用选项#

选项	作用
`-i`	原地修改文件（in-place）
`-i.bak`	原地修改并备份原文件为 .bak
`-n`	静默模式，配合 `p` 使用
`-e`	多命令连接
`-r`	使用扩展正则（ERE），免转义
`-E`	同 `-r`（BSD/macOS 风格）

8.4 实用组合示例#

Terminal window展开收起

1
# 1. 原地修改文件（危险操作，建议先备份）
2
sed -i 's/localhost/127.0.0.1/g' config.conf
3

4
# 2. 删除文件中的 Windows 换行符 (^M)
5
sed -i 's/\r$//' file.txt
6

7
# 3. 提取特定行范围到另一个文件
8
sed -n '100,200p' log.txt > extracted.txt
9

10
# 4. 多命令组合
11
sed -e 's/foo/bar/g' -e 's/hello/hi/g' file
12

13
# 5. 从管道读取（无输入文件）
14
cat file | sed 's/foo/bar/g'
15
# 更优写法（避免无用猫）
16
sed 's/foo/bar/g' < file
17

18
# 6. 复杂：删除空行和注释，提取有效配置
19
sed '/^#/d; /^$/d' config.ini
20

21
# 7. 使用扩展正则（更简洁）
22
sed -r 's/(foo|bar)/baz/g' file    # 无需转义 ()

展开收起

8.5 注意事项#

注意点	说明
`-i` 无备份风险	`sed -i` 直接修改，建议先用 `sed '' file` 测试
正则转义	基础正则中 `()+?{}` 需转义，用 `-r` 可免转义
macOS 差异	BSD sed 要求 `sed -i '' 's///' file`（必须给备份后缀）
单引号优先	避免 shell 提前展开变量，需要变量时用双引号

9. 匿名管道和命名管道#

9.1 匿名管道 `|`#

临时生效，命令结束就消失
只能一条命令行里多个命令连用

9.2 命名管道 FIFO (好玩)#

可以跨两个终端、跨进程传数据

Terminal window

1
# 1. 创建一个管道文件
2
mkfifo mypipe
3

4
# 2. 第一个终端：往管道写数据（后台运行 &）
5
echo "测试数据" > mypipe &
6

7
# 3. 第二个终端：读取管道数据
8
cat < mypipe

10. 实用指令组合#

看文件最后 100 行 + 实时过滤错误

Terminal window

1
tail -f 日志文件.log | grep error

Terminal window

1
find . -type f | sed 's/.*\.//' | sort | uniq -c

Terminal window

1
ls -la | less

11. 结尾#

没了喵，谢谢欣赏

gopher

[Auto CQUPT Plan] 免费洗衣机

Fri, 17 Apr 2026 00:00:00 GMT

记重庆邮电大学物联网洗衣机破解方法#

Warning

本博文仅供技术参考，请勿用于非法用途!!!

1. 破解原理#

重邮的物联网洗衣机本质上就是应该普通洗衣机，只是多了一个可以和控制板卡用串口通信的物联网模块而已。

所以，我们只需要获取启动洗衣机时物联网模块发送的数据，并再找一个同样可以进行串口通信的模块替换物联网模块就行。

flowchart LR subgraph 洗衣机本体["🧺 洗衣机本体"] direction TB ControlBoard["控制板卡 (主控MCU)"] Motor["电机/水泵/加热器等 (执行机构)"] Sensors["水位/温度/转速传感器 (数据采集)"] end subgraph 物联网部分["📡 物联网模块"] direction TB IoTModule["物联网通信模块 (WiFi/4G)"] Cloud["云端服务器 (重邮洗衣平台)"] MobileApp["手机APP (用户端)"] end subgraph 替换方案["🔧 替换方案"] CustomModule["自定义串口模块 (ESP32/Arduino等)"] end %% 原有连接关系 ControlBoard <-->|"UART/RS232/RS485 串口通信 启动指令/状态上报"| IoTModule IoTModule <-->|"HTTP/MQTT 网络通信"| Cloud Cloud <-->|"API接口"| MobileApp %% 洗衣机内部连接 ControlBoard -->|"GPIO/PWM 控制信号"| Motor Sensors -->|"ADC/Digital 传感器数据"| ControlBoard %% 替换方案连接 ControlBoard -.->|"相同串口协议 模拟原模块"| CustomModule %% 样式定义 style ControlBoard fill:#e1f5fe,stroke:#01579b,stroke-width:2px style IoTModule fill:#fff3e0,stroke:#e65100,stroke-width:2px style CustomModule fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px,stroke-dasharray: 5 5 style Cloud fill:#f3e5f5,stroke:#6a1b9a,stroke-width:2px style MobileApp fill:#fce4ec,stroke:#c2185b,stroke-width:2px style 洗衣机本体 fill:#fafafa,stroke:#424242,stroke-width:1px style 物联网部分 fill:#fafafa,stroke:#424242,stroke-width:1px style 替换方案 fill:#fafafa,stroke:#424242,stroke-width:1px,stroke-dasharray: 5 5

2. 怎么获取物联网模块发送的指令#

必需品：CH340 USB-TTL 串口模块

usb-ttl

原理： 每次扫描二维码付钱时，物联网模块就会向控制板卡的UATR发送指令，只要将物联网模块接入CH340 USB-TTL 串口模块，然后再给每一种洗衣服务都付一次钱就可以得到所有的指令。

但是这里我从大手子那里搞到了宿舍内洗衣机（不是公共洗衣机）所有的UATR指令：

波特率：2400

Hex	备注
AA 06 01 98 04 00 75 03	1元脱水
AA 06 01 98 03 01 D0 AC	3元快速洗
AA 06 01 98 02 02 B2 0D	4元标准洗
AA 06 01 98 02 02 B2 0A	4元标准洗（有6元加强洗的版本）
AA 06 01 98 01 03 51 C6	6元加强洗（第一部分）
AA 06 00 9F 01 03 09	6元加强洗（第二部分）

注意：6元加强洗的两部分连续发送

3. 物联网模块替代板卡的选择以及接线#

3.1 开发板选择#

这里我决定选用 ESP8266 开发板作为物联网模块的替代方案。该芯片集成硬件 UART 接口，并支持通过软件模拟额外串口；内置 Wi-Fi 无线通信能力，扩展性较强。此外，ESP8266 具备成本优势，且兼容 Arduino 开发框架，学习曲线平缓，适合快速原型开发。

esp8266

3.2 接线#

以下是 Node MCU 与 洗衣机控制板卡 的线路连接

NodeMCU	洗衣机控制板卡
VCC	5V
GND	GND
TXD	RXD
RXD	TXD

以下是读取指令时 CH340 USB-TTL 与 洗衣机控制板卡 的线路连接（5V不接）

CH340 USB-TTL	洗衣机控制板卡
GND	GND
TXD	RXD
RXD	TXD

洗衣机控制板卡 引脚定义 ：

board

4. 自己画的板子#

这几天挺闲的，就用嘉立创EDA画了一块板子，直接接上就能用

4.1 原理图样例#

SCH

4.2 PCB样例#

PCB

5. 程序#

采用 PlaformIO 编写，适用于 NodeMCU 0.9 及 NodeMCU 1.0

5.1 串口部分#

1
const uint8_t CMD_1YUAN[]      = {0xAA, 0x06, 0x01, 0x98, 0x04, 0x00, 0x75, 0x03};
2
const uint8_t CMD_3YUAN[]      = {0xAA, 0x06, 0x01, 0x98, 0x03, 0x01, 0xD0, 0xAC};
3
const uint8_t CMD_4YUAN[]      = {0xAA, 0x06, 0x01, 0x98, 0x02, 0x02, 0xB2, 0x0D};
4
const uint8_t CMD_4YUAN_PLUS[] = {0xAA, 0x06, 0x01, 0x98, 0x02, 0x02, 0xB2, 0x0A};
5
const uint8_t CMD_6YUAN_1[]    = {0xAA, 0x06, 0x01, 0x98, 0x01, 0x03, 0x51, 0xC6};
6
const uint8_t CMD_6YUAN_2[]    = {0xAA, 0x06, 0x00, 0x9F, 0x01, 0x03, 0x09};
7

8
void sendCmd(const uint8_t* data, size_t len) {
9
    Serial.write(data, len);
10
    Serial.flush();
11
}

5.2 DashBoard部分#

1
ESP8266WebServer server(80);
2

3
void handleRoot() {
4
    server.send(200, "text/html", R"rawliteral(
5
<!DOCTYPE html>
6
<html>
7
<head>
8
<meta charset="UTF-8">
9
<meta name="viewport" content="width=device-width, initial-scale=1.0">
10
<title>洗衣机控制</title>
11
<style>
12
*{margin:0;padding:0;box-sizing:border-box}
13
body{font-family:-apple-system,BlinkMacSystemFont,sans-serif;background:linear-gradient(135deg,#667eea 0%,#764ba2 100%);min-height:100vh;padding:20px}
14
.container{max-width:400px;margin:0 auto;background:rgba(255,255,255,0.95);border-radius:20px;padding:30px;box-shadow:0 20px 60px rgba(0,0,0,0.3)}
15
h1{text-align:center;color:#333;margin-bottom:30px;font-size:24px}
16
.btn-grid{display:grid;gap:15px;margin-bottom:30px}
17
button{padding:18px;border:none;border-radius:12px;font-size:16px;font-weight:600;cursor:pointer;transition:all 0.3s;color:white;text-shadow:0 1px 2px rgba(0,0,0,0.2)}
18
button:active{transform:scale(0.95)}
19
.btn-1{background:linear-gradient(135deg,#f093fb 0%,#f5576c 100%)}
20
.btn-3{background:linear-gradient(135deg,#4facfe 0%,#00f2fe 100%)}
21
.btn-4{background:linear-gradient(135deg,#43e97b 0%,#38f9d7 100%)}
22
.btn-4p{background:linear-gradient(135deg,#fa709a 0%,#fee140 100%)}
23
.btn-6{background:linear-gradient(135deg,#30cfd0 0%,#330867 100%)}
24
.custom-section{border-top:2px dashed #ddd;padding-top:25px}
25
.custom-section h3{color:#666;margin-bottom:15px;font-size:14px;text-transform:uppercase;letter-spacing:1px}
26
textarea{width:100%;padding:12px;border:2px solid #e0e0e0;border-radius:8px;font-family:monospace;font-size:14px;resize:vertical;min-height:60px;margin-bottom:10px}
27
textarea:focus{outline:none;border-color:#667eea}
28
.btn-send{width:100%;background:#333;color:white}
29
.status{text-align:center;margin-top:15px;padding:10px;border-radius:8px;font-size:14px;opacity:0;transition:opacity 0.3s}
30
.status.show{opacity:1}
31
.status.success{background:#d4edda;color:#155724}
32
.status.error{background:#f8d7da;color:#721c24}
33
</style>
34
</head>
35
<body>
36
<div class="container">
37
<h1>🧺 洗衣机控制面板</h1>
38
<div class="btn-grid">
39
<button class="btn-1" onclick="send('1')">1元脱水</button>
40
<button class="btn-3" onclick="send('3')">3元快速洗</button>
41
<button class="btn-4" onclick="send('4')">4元标准洗</button>
42
<button class="btn-4p" onclick="send('4p')">4元标准洗(加强版)</button>
43
<button class="btn-6" onclick="send('6')">6元加强洗</button>
44
</div>
45
<div class="custom-section">
46
<h3>自定义指令 (十六进制)</h3>
47
<textarea id="custom" placeholder="AA 06 01 98..."></textarea>
48
<button class="btn-send" onclick="sendCustom()">发送自定义指令</button>
49
</div>
50
<div id="status" class="status"></div>
51
</div>
52
<script>
53
function show(msg,err){const e=document.getElementById('status');e.textContent=msg;e.className='status show '+(err?'error':'success');setTimeout(()=>e.className='status',2000)}
54
async function send(t){try{await fetch('/'+t,{method:'POST'});show('已发送')}catch(e){show('失败',1)}}
55
async function sendCustom(){const d=document.getElementById('custom').value.trim();if(!d)return;try{await fetch('/custom',{method:'POST',headers:{'Content-Type':'application/x-www-form-urlencoded'},body:'d='+encodeURIComponent(d)});show('已发送')}catch(e){show('失败',1)}}
56
</script>
57
</body>
58
</html>
59
)rawliteral");
60
}

展开收起

5.3 配置部分#

1
#include <Arduino.h>
2
#include <ESP8266WiFi.h>
3
#include <ESP8266WebServer.h>
4
#include <LittleFS.h>
5

6
#define BAUD_RATE 2400
7

8
const char* SSID = "WashingMachine";
9
const char* PASSWORD = "12345678";
10
IPAddress localIP(172, 16, 0, 1);
11
IPAddress gateway(172, 16, 0, 1);
12
IPAddress subnet(255, 255, 255, 0);

5.4 Setup 和 Loop#

1
void setup() {
2
    Serial.begin(BAUD_RATE);
3
    delay(1000);
4

5
    LittleFS.begin();
6

7
    WiFi.softAPConfig(localIP, gateway, subnet);
8
    WiFi.softAP(SSID, PASSWORD);
9

10
    server.on("/", handleRoot);
11
    server.on("/1", HTTP_POST, [](){ sendCmd(CMD_1YUAN, sizeof(CMD_1YUAN)); server.send(200); });
12
    server.on("/3", HTTP_POST, [](){ sendCmd(CMD_3YUAN, sizeof(CMD_3YUAN)); server.send(200); });
13
    server.on("/4", HTTP_POST, [](){ sendCmd(CMD_4YUAN, sizeof(CMD_4YUAN)); server.send(200); });
14
    server.on("/4p", HTTP_POST, [](){ sendCmd(CMD_4YUAN_PLUS, sizeof(CMD_4YUAN_PLUS)); server.send(200); });
15
    server.on("/6", HTTP_POST, [](){
16
        sendCmd(CMD_6YUAN_1, sizeof(CMD_6YUAN_1));
17
        delay(100);
18
        sendCmd(CMD_6YUAN_2, sizeof(CMD_6YUAN_2));
19
        server.send(200);
20
    });
21
    server.on("/custom", HTTP_POST, [](){
22
        String hex = server.arg("d");
23
        hex.replace(" ", "");
24
        for(size_t i=0; i<hex.length(); i+=2) {
25
            if(i+1 < hex.length()) {
26
                String b = hex.substring(i, i+2);
27
                Serial.write((uint8_t)strtol(b.c_str(), NULL, 16));
28
            }
29
        }
30
        Serial.flush();
31
        server.send(200);
32
    });
33

34
    server.begin();
35
}
36

37
void loop() {
38
    server.handleClient();
39
}

展开收起

6. 结尾#

没有了喵，谢谢欣赏

gopher

Linux Systemd的一些东西

Mon, 13 Apr 2026 00:00:00 GMT

有关 Linux Systemd 的一些东西#

1. 什么是 Systemd#

1.1 Systemd 简介#

Systemd（全称：system daemon）是 Linux 系统中用于启动和管理服务的核心工具，也是其前身 init 的改良版本，

旨在解决传统 init 系统启动时间长、脚本复杂的问题。

在 Linux 发展初期，系统启动过程中，内核完成初始化以后，由内核第一个启动的程序便是 init 程序，路径为 /sbin/init（为一个软连接，链接到真实的 init 进程），其 PID 为1，它为系统里所有进程的“祖先”，Linux 中所有的进程都由 init 进程直接或间接进行创建并运行，init 进程以守护进程的方式存在，负责组织与运行系统的相关初始化工作，让系统进入定义好的运行模式，如命令行模式或图形界面模式。

原文链接：https://blog.csdn.net/qq_35995514/article/details/125582824

init 程序的发展，大体上可分为三个阶段：sysvinit->upstart->systemd

阶段	描述
sysvinit	本质上是一个脚本，通过串行执行shell脚本来启动系统服务，速度缓慢
upstart	在前者的基础上，把一些无关联的程序并行启动，提升速度，但是存在依赖关系的服务仍为串行。
systemd	这个使用了套接字激活的机制，不管程序有无互相依赖全部并行启动，并且仅按照系统启动的需要启动相应的服务，大幅优化开机速度。

1.2 什么是套接字激活机制#

套接字激活（Socket Activation）是 systemd 引入的一种延迟启动机制，核心思想是：先创建监听套接字，等服务真正被请求时再启动对应的服务程序。

1
传统启动: 服务A → 启动完成 → 创建套接字 → 等待连接
2
           ↓
3
         服务B (等待A完成才能启动，即使B不依赖A)
4

5
套接字激活: systemd 先创建所有套接字（socket单元）
6
              ↓
7
           服务并行启动，无需等待彼此
8
              ↓
9
           当某个套接字收到请求时，才真正启动对应的服务

用到才启动

**例如 sshd **：

/usr/lib/systemd/system/sshd.socket

1
[Socket]
2
ListenStream=22          # systemd 先监听 22 端口
3
Accept=yes
4

5
[Install]
6
WantedBy=sockets.target
7

8
# /usr/lib/systemd/system/sshd@.service
9
[Service]
10
ExecStart=-/usr/sbin/sshd -i   # 有连接时才启动sshd实例

效果：

开机时 systemd 只占用 22 端口，sshd 进程并未运行
第一次有 SSH 连接进来时，systemd 才按需启动 sshd

如果没人连 SSH，sshd 永远不启动（如果 sshd 使用套接字激活且无人连接，它的状态会显示为 inactive），节省资源

查看初始状态

Terminal window

1
# 查看 socket 状态（活跃，正在监听22端口）
2
$ systemctl status sshd.socket
3
● sshd.socket - OpenSSH server socket
4
     Loaded: loaded (/usr/lib/systemd/system/sshd.socket; enabled;)
5
     Active: active (listening) since Mon 2026-04-13 10:00:00 CST
6

7
# 查看 service 状态（未启动，inactive）
8
$ systemctl status sshd.service
9
○ sshd.service - OpenSSH server daemon
10
     Loaded: loaded (/usr/lib/systemd/system/sshd.service; enabled;)
11
     Active: inactive (dead) since Mon 2026-04-13 10:00:00 CST

查看连接后状态

Terminal window

1
# 当第一个 SSH 连接进来后
2
$ systemctl status sshd@0-192.168.1.100:22-192.168.1.5:54321.service
3
● sshd@0-192.168.1.100:22-192.168.1.5:54321.service
4
     Active: active (running) since Mon 2026-04-13 10:05:30 CST

单元	开机时状态	有人连接后
`sshd.socket`	active (listening)	保持 listening
`sshd.service`	inactive (dead)	可能仍保持 inactive（取决于配置）
`sshd@xxx.service`	不存在	active (running)

配置差异

1
# 传统方式（Type=simple/forking）- 开机就启动
2
[Service]
3
Type=simple
4
ExecStart=/usr/sbin/sshd -D
5

6
# 套接字激活方式（Type=notify/简单的exec）- 按需启动
7
[Service]
8
Type=simple
9
ExecStart=-/usr/sbin/sshd -i   # -i 表示从stdin接受连接
10
StandardInput=socket
11
StandardOutput=socket

1.3 用户态和系统态#

目前主流的系统中，systemd 的守护进程主要分为系统态(system)与用户态(user)，可以在 ps -ef中看到 systemd 的守护进程

原文链接：https://blog.csdn.net/qq_35995514/article/details/125582824

1.4 Systemd相关的系统进程#

Terminal window

1
root@aliyun-worker-01:~# ps -ef | grep systemd
2
root         277       1  0 Apr01 ?        00:00:06 /usr/lib/systemd/systemd-journald
3
systemd+     305       1  0 Apr01 ?        00:00:13 /usr/lib/systemd/systemd-resolved
4
root         333       1  0 Apr01 ?        00:00:01 /usr/lib/systemd/systemd-udevd
5
systemd+     751       1  0 Apr01 ?        00:00:01 /usr/lib/systemd/systemd-networkd
6
message+     777       1  0 Apr01 ?        00:00:13 /usr/bin/dbus-daemon --system --address=systemd: --nofork --nopidfile --systemd-activation --syslog-only
7
root         791       1  0 Apr01 ?        00:00:01 /usr/lib/systemd/systemd-logind
8
root      832660       1  0 19:47 ?        00:00:00 /usr/lib/systemd/systemd --user
9
root      832692  832677  0 19:48 pts/0    00:00:00 grep systemd

1.4.1 核心系统组件#

进程	作用	说明
`systemd-journald`	日志服务	收集和管理系统日志，替代传统的 syslog
`systemd-resolved`	DNS 解析	提供本地 DNS 缓存和解析服务
`systemd-udevd`	设备管理	处理内核 uevent，管理 /dev 设备节点
`systemd-networkd`	网络管理	管理网络配置（你的服务器在用这个而非 NetworkManager）
`systemd-logind`	登录管理	管理用户登录会话、电源管理（重启/关机等）

1.4.2 其他相关进程#

进程	作用	说明
`dbus-daemon`	消息总线	系统服务间通信的”邮局”，`--systemd-activation` 表示支持 systemd 套接字激活
`systemd --user`	用户级 systemd	你当前 root 用户的 systemd 用户实例，管理用户级服务

1.5 Systemd 的特点#

1.5.1 兼容性#

systemd 兼容 sysvinit，系统中已经存在的服务无需进行修改，即可迁移到 systemd 。

1.5.2 启动速度和资源占用#

systemd 依赖于 套接字激活机制，先监听进程的套接字，出现请求时再进行启动。这使其在启动初期只需拉起少量进程，并且允许并行操作，大大加快启动速度。这样不仅能加快启动速度，在一定程度上还可以节省资源。

1.5.3 采用 linux 的 cgroups 跟踪和管理进程的生命周期#

一个服务可能依赖多个进程，systemd 利用了 linux 的内核特性 cgroups 来进行管理和跟踪。当服务停止时，systemd 可以通过查询 cgroups 来获取所有相关进程，从而干净地停止服务。

什么是cgroups:
cgroups 已经出现了很久，它主要用来实现系统资源配额管理。cgroups 提供了类似文件系统的接口，使用方便。当进程创建子进程时，子进程会继承父进程的 cgroups 。因此无论服务如何启动新的子进程，所有的这些相关进程都会属于同一个 cgroups ，systemd 只需要简单地遍历指定的 cgroups 即可正确地找到所有的相关进程，将它们一一停止即可。
原文链接：https://blog.csdn.net/qq_35995514/article/details/125582824

2. Systemd 管理的基本单元 — Unit#

后缀	类型	作用	例子
`.service`	服务	后台进程/应用程序	`nginx.service`, `sshd.service`
`.socket`	套接字	监听端口/套接字（用于套接字激活）	`sshd.socket`
`.target`	目标	一组 unit 的集合（类似 runlevel）	`multi-user.target`, `graphical.target`
`.timer`	定时器	定时触发任务（替代 cron）	`apt-daily.timer`
`.mount`	挂载点	管理文件系统挂载	`home.mount`
`.automount`	自动挂载	按需挂载	`home.automount`
`.path`	路径	监控文件/目录变化	`backup.path`
`.slice`	切片	资源控制组（cgroup）	`system.slice`
`.scope`	范围	外部创建的进程组	`session-1.scope`

2.1 `.service`（服务 - 最常用）#

2.1.1 定义#

后台运行的应用程序或系统服务，是 Systemd 中最常见的 Unit 类型。

2.1.2 配置模板#

/etc/systemd/system/myapp.service展开收起

1
# ============================================
2
# [Unit] 段：定义服务的元信息、描述和依赖关系
3
# ============================================
4
[Unit]
5
# 服务的简短描述，会显示在 systemctl status 中
6
Description=My Application
7

8
# 文档链接，可以是 man 手册、网页或本地文件路径
9
# Documentation=man:myapp(8)
10
# Documentation=https://example.com/docs
11

12
# 启动顺序：本服务在 network.target 之后启动
13
# 注意：After 只控制顺序，不控制依赖
14
After=network.target
15

16
# 强依赖：启动本服务前，必须先启动这些服务
17
# 如果依赖服务启动失败，本服务也会失败
18
# Requires=network.target mysql.service
19

20
# 弱依赖：尽可能启动这些服务，但不影响本服务启动
21
# Wants=network.target
22

23
# 反向顺序：本服务应该在哪些服务之前启动
24
# Before=nginx.service
25

26
# 冲突服务：不能与这些服务同时运行，会自动停止冲突服务
27
# Conflicts=another-app.service
28

29
# 启动条件判断：条件不满足时跳过启动（软失败）
30
# ConditionPathExists=/etc/myapp/config.conf
31
# ConditionDirectoryNotEmpty=/var/lib/myapp
32
# ConditionUser=root
33

34
# 断言判断：条件不满足时启动失败（硬错误）
35
# AssertPathExists=/usr/local/bin/myapp
36
# AssertUser=root
37

38
# ============================================
39
# [Service] 段：定义服务的执行方式和生命周期管理
40
# ============================================
41
[Service]
42

43
# ---- 服务类型 ----
44
# simple: 默认，ExecStart 启动的进程保持前台运行
45
# forking: 服务通过 fork 创建守护进程后父进程退出（传统守护进程）
46
# oneshot: 执行一次性任务，执行完即退出
47
# notify: 服务启动后会发送 sd_notify 通知 systemd
48
# dbus: 服务在 D-Bus 上注册后认为启动完成
49
# idle: 延迟到所有其他任务处理完再启动
50
Type=simple
51

52
# ---- 进程执行配置 ----
53
# 启动命令（必须），必须使用绝对路径
54
ExecStart=/usr/local/bin/myapp
55

56
# 启动前的准备命令（可多个，按顺序执行）
57
# ExecStartPre=/usr/local/bin/myapp --check-config
58
# ExecStartPre=/bin/mkdir -p /var/run/myapp
59

60
# 启动后的收尾命令
61
# ExecStartPost=/bin/echo "MyApp started"
62

63
# 停止命令，默认发送 SIGTERM
64
# ExecStop=/usr/local/bin/myapp --shutdown
65

66
# 停止后的收尾命令
67
# ExecStopPost=/bin/rm -f /var/run/myapp.pid
68

69
# 重载配置命令（systemctl reload）
70
ExecReload=/bin/kill -HUP $MAINPID
71

72
# ---- 进程管理 ----
73
# 主进程 PID 变量，可用于 ExecReload 等
74
# $MAINPID 由 systemd 自动设置为服务主进程 PID
75

76
# 服务运行用户
77
User=www-data
78

79
# 服务运行组（默认与用户主组相同）
80
# Group=www-data
81

82
# 工作目录
83
# WorkingDirectory=/var/www/myapp
84

85
# 根目录（chroot），设置后服务无法访问指定目录外文件
86
# RootDirectory=/var/chroot/myapp
87

88
# 环境变量（可多次指定）
89
# Environment="NODE_ENV=production"
90
# Environment="PORT=8080"
91

92
# 环境变量文件（每行一个 KEY=VALUE）
93
# EnvironmentFile=/etc/default/myapp
94
# EnvironmentFile=-/etc/default/myapp  # 减号表示文件不存在也不报错
95

96
# ---- 重启策略 ----
97
# no: 不自动重启（默认）
98
# on-success: 退出码为 0 时重启
99
# on-failure: 退出码非 0 时重启
100
# on-abnormal: 被信号终止或超时重启
101
# on-abort: 被信号终止时重启（不含 SIGHUP/SIGINT）
102
# on-watchdog: 看门狗超时重启
103
# always: 总是重启
104
Restart=on-failure
105

106
# 重启间隔秒数
107
RestartSec=5
108

109
# 启动超时时间（0 表示禁用超时检测）
110
# TimeoutStartSec=30
111

112
# 停止超时时间，超时后发送 SIGKILL
113
# TimeoutStopSec=30
114

115
# 同时设置启动和停止超时
116
# TimeoutSec=30
117

118
# 启动频率限制：在指定时间内最多重启次数
119
# StartLimitIntervalSec=60
120
# StartLimitBurst=3
121

122
# ---- 标准输入输出 ----
123
# 标准输出目标：journal/syslog/kern/tty/null/socket/fd/file
124
# StandardOutput=journal
125

126
# 标准错误输出目标
127
# StandardError=journal
128

129
# 标准输入来源：null/tty/tty-force/tty-fail/file/fd/socket
130
# StandardInput=null
131

132
# ---- 资源限制（类似 ulimit） ----
133
# 文件描述符数量限制
134
# LimitNOFILE=65535
135

136
# 进程数量限制
137
# LimitNPROC=4096
138

139
# core dump 文件大小限制
140
# LimitCORE=infinity
141

142
# ---- 进程终止配置 ----
143
# 终止模式：
144
# control-group: 终止控制组内所有进程（默认）
145
# process: 仅终止主进程
146
# mixed: 主进程发 SIGTERM，其他进程发 SIGKILL
147
# none: 不终止任何进程
148
# KillMode=control-group
149

150
# 发送给主进程的终止信号
151
# KillSignal=SIGTERM
152

153
# 最终强制终止信号
154
# FinalKillSignal=SIGKILL
155

156
# 发送 SIGKILL 前的等待时间
157
# TimeoutAbortSec=30
158

159
# ---- 看门狗配置 ----
160
# 启用看门狗，服务需定期调用 sd_notify("WATCHDOG=1")
161
# WatchdogSec=30
162

163
# ---- 其他配置 ----
164
# 是否为 oneshot 类型保持激活状态（即使进程已退出）
165
# RemainAfterExit=yes
166

167
# 服务私有的临时文件目录
168
# RuntimeDirectory=myapp
169
# RuntimeDirectoryMode=0755
170

171
# 状态目录
172
# StateDirectory=myapp
173

174
# 缓存目录
175
# CacheDirectory=myapp
176

177
# 日志目录
178
# LogsDirectory=myapp
179

180
# 配置目录
181
# ConfigurationDirectory=myapp
182

183
# 是否从 /dev、/proc、/sys 挂载私有副本
184
# PrivateDevices=yes
185

186
# 是否启用私有网络命名空间
187
# PrivateNetwork=yes
188

189
# 是否启用私有用户命名空间
190
# PrivateUsers=yes
191

192
# 是否启用私有挂载命名空间
193
# PrivateMounts=yes
194

195
# 能力限制（Linux capabilities）
196
# CapabilityBoundingSet=CAP_NET_BIND_SERVICE CAP_DAC_READ_SEARCH
197

198
# 安全相关选项
199
# NoNewPrivileges=yes
200
# ProtectSystem=strict
201
# ProtectHome=yes
202
# ReadWritePaths=/var/lib/myapp
203

204
# ============================================
205
# [Install] 段：定义服务如何安装到系统中
206
# ============================================
207
[Install]
208

209
# 启用服务时，创建符号链接到该 target 的 .wants 目录
210
# multi-user.target: 多用户命令行模式（类似运行级别3）
211
# graphical.target: 图形界面模式（类似运行级别5）
212
WantedBy=multi-user.target
213

214
# 强依赖版本，服务失败会影响 target
215
# RequiredBy=multi-user.target
216

217
# 别名，可用 systemctl enable/disable 操作别名
218
# Alias=myapp-daemon.service
219

220
# 启用/禁用本服务时，同时操作的其他服务
221
# Also=myapp-socket.socket
222

223
# 启用时的默认目标（systemctl enable 时使用）
224
# DefaultInstance=

展开收起

2.1.3 常用配置速查表#

段	配置项	作用
`[Unit]`	`Description`	服务描述
`[Unit]`	`After`/`Before`	启动顺序
`[Unit]`	`Requires`/`Wants`	依赖关系
`[Unit]`	`ConditionPathExists`	启动条件判断
`[Service]`	`Type`	服务类型 (simple/forking/oneshot/notify)
`[Service]`	`ExecStart`	启动命令
`[Service]`	`ExecStop`/`ExecReload`	停止/重载命令
`[Service]`	`Restart`	重启策略
`[Service]`	`User`/`Group`	运行用户/组
`[Service]`	`Environment`/`EnvironmentFile`	环境变量
`[Service]`	`WorkingDirectory`	工作目录
`[Install]`	`WantedBy`	启用目标

2.1.4 常用命令#

Terminal window展开收起

1
# 重新加载配置
2
sudo systemctl daemon-reload
3

4
# 启动/停止/重启/重载服务
5
sudo systemctl start myapp
6
sudo systemctl stop myapp
7
sudo systemctl restart myapp
8
sudo systemctl reload myapp
9

10
# 设置开机自启/禁用
11
sudo systemctl enable myapp
12
sudo systemctl disable myapp
13

14
# 查看状态
15
sudo systemctl status myapp
16

17
# 查看日志
18
sudo journalctl -u myapp -f

展开收起

2.2 `.socket`（套接字）#

2.2.1 定义#

监听网络端口或 Unix 套接字，实现按需启动服务。服务未运行时，systemd 先监听端口，有连接时再启动服务。

2.2.2 配置模板#

/etc/systemd/system/myapp.socket展开收起

1
# ============================================
2
# [Unit] 段：定义套接字单元的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# 套接字单元的简短描述
6
Description=My Application Socket
7

8
# 文档链接
9
# Documentation=man:systemd.socket(5)
10

11
# 启动顺序：在 network.target 之后启动
12
After=network.target
13

14
# 启动顺序：在 sockets.target 之前启动
15
# sockets.target 是系统启动时统一启动所有套接字的目标
16
Before=sockets.target
17

18
# 弱依赖：启动本套接字前尽可能启动这些服务
19
# Wants=network.target
20

21
# 强依赖：启动本套接字前必须先启动这些服务
22
# Requires=network.target
23

24
# 冲突服务：不能与这些服务同时运行
25
# Conflicts=shutdown.target
26
# Before=shutdown.target
27

28
# ============================================
29
# [Socket] 段：定义套接字的监听配置
30
# ============================================
31
[Socket]
32

33
# ---- 监听地址与类型（核心配置）----
34

35
# 流式套接字（SOCK_STREAM）- 通常用于 TCP
36
# 格式：IP:PORT 或 [IPv6]:PORT 或 /path/to/socket
37
ListenStream=0.0.0.0:8080
38
# ListenStream=127.0.0.1:8080
39
# ListenStream=/run/myapp.sock
40

41
# 数据报套接字（SOCK_DGRAM）- 通常用于 UDP
42
# ListenDatagram=53
43

44
# 顺序包套接字（SOCK_SEQPACKET）- 用于可靠有序数据传输
45
# ListenSequentialPacket=/run/myapp-seq.sock
46

47
# FIFO 命名管道
48
# ListenFIFO=/run/myapp.fifo
49

50
# Netlink 套接字（用于内核通信）
51
# ListenNetlink=audit 1
52

53
# POSIX 消息队列
54
# ListenMessageQueue=/myapp-queue
55

56
# USB 功能端点（用于 USB gadget 模式）
57
# ListenUSBFunction=ffs.myapp
58

59
# 特殊值：留空表示重置所有已定义的监听地址
60
# ListenStream=
61

62
# ---- 连接处理模式 ----
63

64
# 连接处理方式：
65
# no（默认）：将监听套接字传递给服务，服务自己 accept() 连接
66
# yes：为每个连接创建独立的 [name@.service] 实例（inetd 风格）
67
Accept=no
68

69
# 当 Accept=yes 时，指定要实例化的服务模板
70
# 例如：Accept=yes 且 Service=myapp@.service 时，
71
# 每个连接会创建 myapp@<连接ID>.service 实例
72
# Service=myapp.service
73

74
# ---- 套接字选项 ----
75

76
# 绑定 IPv6 专用模式：
77
# default：根据系统默认（/proc/sys/net/ipv6/bindv6only）
78
# yes：仅绑定 IPv6
79
# no：同时绑定 IPv4 和 IPv6（双栈）
80
BindIPv6Only=default
81

82
# 重用端口（允许多个进程绑定同一端口，用于负载均衡）
83
# ReusePort=yes
84

85
# 监听队列长度（backlog）
86
# Backlog=128
87

88
# 是否延迟激活（接收到数据时才激活服务，而非连接建立时）
89
# DeferAcceptSec=5
90

91
# 是否禁用 Nagle 算法（TCP_NODELAY）
92
# NoDelay=yes
93

94
# 是否启用 TCP keepalive
95
# KeepAlive=yes
96

97
# Keepalive 时间设置（秒）
98
# KeepAliveTimeSec=7200
99

100
# Keepalive 探测间隔（秒）
101
# KeepAliveIntervalSec=75
102

103
# Keepalive 探测次数
104
# KeepAliveProbes=9
105

106
# 标记套接字（用于 SO_MARK）
107
# Mark=1234
108

109
# 最大连接数
110
# MaxConnections=64
111

112
# 每个连接的超时时间（秒）
113
# MaxConnectionsPerSource=256
114

115
# 消息队列最大大小（字节）
116
# MessageQueueMaxMessages=10
117
# MessageQueueMessageSize=8192
118

119
# ---- 文件系统与权限（用于 AF_UNIX/FIFO）----
120

121
# 套接字文件的所有者用户
122
SocketUser=www-data
123

124
# 套接字文件的所属组
125
SocketGroup=www-data
126

127
# 套接字文件的权限模式（八进制）
128
SocketMode=0660
129

130
# 自动创建父目录时的权限模式
131
DirectoryMode=0755
132

133
# 停止套接字单元时是否删除文件系统节点
134
# 注意：通常不推荐使用，因为服务可能仍在使用
135
# RemoveOnStop=no
136

137
# 创建指向套接字的符号链接（别名）
138
# Symlinks=/run/myapp-alias.sock
139

140
# ---- 文件描述符传递 ----
141

142
# 为传递的文件描述符命名，便于服务识别
143
# FileDescriptorName=myapp-socket
144

145
# 是否传递套接字的 credentials（SCM_CREDENTIALS）
146
PassCredentials=yes
147

148
# 是否传递套接字的 security context（SELinux）
149
PassSecurity=yes
150

151
# 接收缓冲区大小（字节）
152
# ReceiveBuffer=8M
153

154
# 发送缓冲区大小（字节）
155
# SendBuffer=8M
156

157
# 是否移除传递的套接字上的 close-on-exec 标志
158
# PassEnvironment=yes
159

160
# ---- 触发限制（防雪崩保护）----
161

162
# 触发间隔时间（秒）
163
# TriggerLimitIntervalSec=2
164

165
# 在触发间隔内允许的最大触发次数
166
# TriggerLimitBurst=200
167

168
# ---- 执行命令（可选）----
169

170
# 启动套接字前的准备命令
171
# ExecStartPre=/bin/mkdir -p /run/myapp
172

173
# 启动套接字后的命令
174
# ExecStartPost=/bin/chown www-data:www-data /run/myapp.sock
175

176
# 停止套接字前的命令
177
# ExecStopPre=
178

179
# 停止套接字后的命令
180
# ExecStopPost=/bin/rm -f /run/myapp.sock
181

182
# ============================================
183
# [Install] 段：定义套接字如何安装到系统
184
# ============================================
185
[Install]
186

187
# 启用时链接到 sockets.target
188
# 这是所有套接字单元的标准目标
189
WantedBy=sockets.target
190

191
# 强依赖版本
192
# RequiredBy=sockets.target
193

194
# 别名
195
# Alias=myapp-daemon.socket
196

197
# 启用/禁用本单元时同时操作的其他单元
198
# Also=myapp.service

展开收起

2.2.3 配套的`.service`模板#

/etc/systemd/system/myapp.service展开收起

1
# ============================================
2
# Socket Activation 配套的服务单元
3
# ============================================
4

5
[Unit]
6
Description=My Application Service
7
# 关键：确保服务在套接字之后启动，且套接字存在
8
Requires=myapp.socket
9
After=myapp.socket
10

11
[Service]
12
Type=simple
13
User=www-data
14
ExecStart=/usr/local/bin/myapp
15

16
# 重启策略
17
Restart=on-failure
18
RestartSec=5
19

20
# 标准输入输出（如果使用 inetd 风格的 Accept=yes）
21
# StandardInput=socket
22
# StandardOutput=socket
23

24
[Install]
25
# 注意：socket 激活的服务通常不需要 WantedBy=multi-user.target
26
# 因为服务是由套接字按需启动的
27
# 但如果需要开机启动，可以启用此配置
28
WantedBy=multi-user.target

展开收起

2.2.4 两种工作模式对比#

模式	Accept=no（默认）	Accept=yes
套接字传递	传递监听套接字	传递已连接的套接字
服务单元	`myapp.service`	`myapp@.service`（模板）
连接处理	服务自己 accept()	每个连接一个独立进程
适用场景	高性能服务器（nginx/redis）	简单服务、inetd 风格服务
代码要求	需支持 `sd_listen_fds()`	可从 stdin 读取（StandardInput=socket）

2.2.5 常用命令#

Terminal window展开收起

1
# 重新加载配置
2
sudo systemctl daemon-reload
3

4
# 启用并启动套接字（服务会在第一个连接时自动启动）
5
sudo systemctl enable myapp.socket
6
sudo systemctl start myapp.socket
7

8
# 查看套接字状态
9
sudo systemctl status myapp.socket
10

11
# 查看监听中的套接字
12
sudo systemctl list-sockets
13

14
# 手动启动服务（非 socket 激活方式）
15
sudo systemctl start myapp.service
16

17
# 停止套接字（会同时停止关联的服务）
18
sudo systemctl stop myapp.socket
19

20
# 查看日志
21
sudo journalctl -u myapp.socket -u myapp.service -f

展开收起

2.2.6 典型应用场景#

按需启动：服务平时不运行，有请求时才启动（节省资源）
并行启动：系统启动时并行创建所有套接字，无需等待服务启动完成
故障恢复：服务崩溃后，新请求会自动重启服务，连接不会丢失（systemd 保持套接字监听）
无缝升级：可以停止旧服务、启动新服务，而不中断客户端连接

2.2.7 套接字激活机制流程图#

flowchart TD subgraph Stage1["🚀 Systemd 启动阶段"] A1[解析 myapp.socket] --> A2[创建并监听套接字 bind & listen] A2 --> A3[myapp.service 尚未启动] A3 --> A4[继续启动其他服务 实现并行启动] end A4 -->|"等待请求"| Stage2 subgraph Stage2["📡 请求到达时"] B1[客户端连接到套接字] --> B2[Systemd 检测到连接/数据] B2 --> B3[启动 myapp.service] B3 --> B4[传递套接字 FD sd_listen_fds] B4 --> B5[myapp 直接使用套接字 无需 bind/listen] B5 --> B6[处理请求] end style Stage1 fill:#e1f5fe,stroke:#01579b style Stage2 fill:#e8f5e9,stroke:#2e7d32 style A2 fill:#fff3e0,stroke:#ef6c00 style B4 fill:#fff3e0,stroke:#ef6c00

2.2.8 代码中对套接字激活机制的检测#

1
// 服务代码中检测 socket activation
2
#include <systemd/sd-daemon.h>
3

4
int main() {
5
    int n = sd_listen_fds(0);  // 获取 systemd 传递的 FD 数量
6
    if (n > 0) {
7
        // 使用 FD 3（SD_LISTEN_FDS_START）作为监听套接字
8
        int sock = SD_LISTEN_FDS_START;
9
        accept(sock, ...);  // 直接 accept，无需 bind/listen
10
    } else {
11
        // 普通启动，需要自行 bind/listen
12
    }
13
}

2.3 `.target` （目标 - 运行级别）#

2.3.1 定义#

一组 Unit 的集合，用于组织启动顺序和系统状态，替代传统的 SysV runlevel。

flowchart LR A[客户端请求] --> B[systemd 监听端口] B --> C[启动服务] C --> D[传递 socket 给服务] D --> E[服务处理请求] style A fill:#e1f5fe style E fill:#c8e6c9 style B fill:#fff3e0 style C fill:#fff3e0 style D fill:#fff3e0

2.3.2 配置模板#

/etc/systemd/system/myapp.target展开收起

1
# ============================================
2
# [Unit] 段：定义 Target 的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Target 的简短描述，显示在 systemctl status 中
6
Description=My Application Target
7

8
# 文档链接，可以是 man 手册或网页
9
Documentation=man:systemd.special(7)
10
# Documentation=https://example.com/docs/myapp-target
11

12
# ---- 依赖关系配置 ----
13

14
# 强依赖：启动本 Target 前必须先启动这些 Unit
15
# 如果依赖的 Unit 启动失败，本 Target 也会失败
16
Requires=basic.target
17
# Requires=network.target mysql.service
18

19
# 弱依赖：尽可能启动这些 Unit，但不影响本 Target 启动
20
# Wants=myapp-database.service myapp-cache.service
21

22
# 启动顺序：本 Target 在这些 Unit 之后启动
23
# 注意：After 只控制顺序，不控制依赖
24
After=basic.target network.target
25
# After=myapp-database.service
26

27
# 启动顺序：本 Target 在这些 Unit 之前启动
28
# Before=multi-user.target
29

30
# 冲突 Unit：不能与这些 Unit 同时运行
31
# 当切换到本 Target 时，会自动停止冲突的 Unit
32
Conflicts=rescue.service rescue.target
33
# Conflicts=shutdown.target
34

35
# 反向依赖：哪些 Unit 依赖于本 Target（用于 systemctl enable）
36
# 通常不需要手动设置，由其他 Unit 的 WantedBy/RequiredBy 决定
37
# WantedBy=
38
# RequiredBy=
39

40
# ---- 启动条件与断言 ----
41

42
# 条件判断：条件不满足时跳过启动（软失败）
43
# ConditionPathExists=/etc/myapp/enabled
44
# ConditionDirectoryNotEmpty=/var/lib/myapp
45

46
# 断言判断：条件不满足时启动失败（硬错误）
47
# AssertPathExists=/usr/bin/myapp
48

49
# ---- 隔离模式配置 ----
50

51
# 允许使用 systemctl isolate 命令切换到此 Target
52
# 为 yes 时，切换到本 Target 会停止不属于本 Target 的其他 Unit
53
# 为 no（默认）时，isolate 命令会拒绝执行
54
AllowIsolate=yes
55

56
# 忽略隔离请求（当其他 Target 执行 isolate 时，本 Target 保持运行）
57
# IgnoreOnIsolate=no
58

59
# ---- 停止行为配置 ----
60

61
# 停止本 Target 时，是否同时停止依赖它的 Unit
62
# StopWhenUnneeded=no
63

64
# 忽略停止信号（systemctl stop 时保持运行）
65
# RefuseManualStop=no
66

67
# 忽略启动信号（systemctl start 时拒绝启动）
68
# RefuseManualStart=no
69

70
# ---- 其他元信息 ----
71

72
# 启动失败时的默认依赖行为
73
# DefaultDependencies=yes
74

75
# 任务超时时间
76
# JobTimeoutSec=0
77
# JobRunningTimeoutSec=0
78

79
# 超时后的动作：fail/replace/ignore/isolate
80
# JobTimeoutAction=fail
81
# JobTimeoutRebootArgument=
82

83
# ============================================
84
# [Install] 段：定义 Target 如何安装到系统
85
# ============================================
86
[Install]
87

88
# 启用时创建符号链接到该 Target 的 .wants 目录
89
# 通常不需要设置，因为 Target 一般直接由其他 Unit 引用
90
# WantedBy=multi-user.target
91

92
# 强依赖版本
93
# RequiredBy=
94

95
# 别名
96
# Alias=myapp-group.target
97

98
# 启用/禁用本 Target 时同时操作的其他 Unit
99
# Also=myapp.service myapp.socket

展开收起

2.3.3 常用命令#

Terminal window展开收起

1
# 查看当前默认 Target
2
systemctl get-default
3

4
# 设置默认启动 Target
5
sudo systemctl set-default multi-user.target
6
sudo systemctl set-default graphical.target
7

8
# 切换到指定 Target（会停止不属于该 Target 的 Unit）
9
sudo systemctl isolate multi-user.target
10

11
# 查看 Target 包含的所有 Unit
12
systemctl list-dependencies multi-user.target
13

14
# 查看当前激活的所有 Target
15
systemctl list-units --type=target
16

17
# 查看所有可用的 Target
18
systemctl list-unit-files --type=target
19

20
# 启动/停止 Target
21
sudo systemctl start myapp.target
22
sudo systemctl stop myapp.target
23

24
# 启用/禁用 Target（通常不需要，因为 Target 由依赖关系驱动）
25
sudo systemctl enable myapp.target
26
sudo systemctl disable myapp.target

展开收起

2.3.4 自定义应用示例#

2.3.4.1 自定义应用组 Target#

/etc/systemd/system/myapp-stack.target

1
[Unit]
2
Description=My Application Stack
3
Documentation=https://docs.example.com
4
Requires=basic.target network.target
5
After=basic.target network.target
6
Wants=myapp-db.service myapp-redis.service myapp-api.service myapp-web.service
7
AllowIsolate=yes
8

9
[Install]
10
WantedBy=multi-user.target

2.3.4.2 配合 Service 使用#

/etc/systemd/system/myapp-api.service

1
[Unit]
2
Description=My Application API Server
3
PartOf=myapp-stack.target  # 当 myapp-stack.target 停止时，本服务也停止
4

5
[Service]
6
ExecStart=/usr/bin/myapp-api
7
Restart=on-failure
8

9
[Install]
10
WantedBy=myapp-stack.target  # 启用时加入 myapp-stack.target 组

2.3.5 Target 与 Service 的关键区别#

特性	Target	Service
功能	组织和管理一组 Unit	运行具体的守护进程
进程	不启动任何进程	启动并管理实际进程
配置段	只有 `[Unit]` 和 `[Install]`	有 `[Unit]`、`[Service]`、`[Install]`
启动命令	无 `ExecStart` 等执行命令	必须有 `ExecStart`
状态	激活表示依赖的 Unit 已启动	激活表示进程正在运行
用途	系统状态/运行级别分组	具体服务管理

2.4 `.timer`（定时器 - 替代 cron）#

2.4.1 定义#

在特定时间或周期触发服务，功能比 cron 更强大，支持依赖管理和日志集中。

2.4.2 配置模板#

/etc/systemd/system/myapp.timer展开收起

1
# ============================================
2
# [Unit] 段：定义 Timer 的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Timer 单元的简短描述
6
Description=My Application Timer
7

8
# 文档链接
9
Documentation=man:systemd.timer(5)
10
# Documentation=https://example.com/docs/myapp-timer
11

12
# 启动顺序：在这些 Unit 之后启动
13
After=network.target
14

15
# 弱依赖：尽可能启动这些 Unit
16
# Wants=network.target
17

18
# 强依赖：必须先启动这些 Unit
19
# Requires=network.target
20

21
# 冲突 Unit：不能与这些同时运行
22
# Conflicts=shutdown.target
23

24
# 启动条件
25
# ConditionPathExists=/etc/myapp/enabled
26

27
# ============================================
28
# [Timer] 段：定义定时触发规则（核心配置）
29
# ============================================
30
[Timer]
31

32
# ---- 基础定时触发（OnCalendar）----
33

34
# 日历时间触发（类似 cron，但语法更强大）
35
# 格式：DayOfWeek Year-Month-Day Hour:Minute:Second
36
# 支持通配符 * 和范围
37
OnCalendar=*-*-* *:*:00           # 每分钟
38
# OnCalendar=*-*-* 02:00:00        # 每天凌晨 2 点
39
# OnCalendar=Mon *-*-* 09:00:00    # 每周一 9 点
40
# OnCalendar=*-*-01 00:00:00       # 每月 1 号
41
# OnCalendar=*-01-01 00:00:00      # 每年 1 月 1 号
42
# OnCalendar=Mon..Fri 09:00:00     # 工作日 9 点
43
# OnCalendar=*-*-* 09:00,15:00:00  # 每天 9 点和 15 点
44

45
# 使用具体日期
46
# OnCalendar=2024-12-25 00:00:00
47

48
# 相对时间语法
49
# OnCalendar=*:0/10                # 每 10 分钟
50
# OnCalendar=*-01/3-01 00:00:00    # 每 3 个月的 1 号
51

52
# 时区指定（默认系统时区）
53
# OnCalendar=*-*-* 09:00:00 Asia/Shanghai
54

55
# ---- 单调时钟触发（Monotonic Timers）----
56

57
# 系统启动后触发（开机后）
58
# OnBootSec=5min                   # 开机 5 分钟后
59
# OnBootSec=10s
60

61
# 系统首次激活后触发（systemd 第一次启动）
62
# OnStartupSec=1min
63

64
# 本 Timer 单元激活后触发
65
# OnActiveSec=30min                # Timer 启动 30 分钟后
66

67
# 关联 Unit 激活后触发
68
# OnUnitActiveSec=1h               # 上次运行后 1 小时
69
# OnUnitInactiveSec=30min          # 上次停止后 30 分钟
70

71
# ---- 持久化配置 ----
72

73
# 持久化模式：如果系统关机时错过了触发，开机后补执行
74
# 适用于定时备份、日志轮转等不能错过的任务
75
Persistent=true
76

77
# 持久化精度（秒），控制补执行的精度范围
78
# AccuracySec=1min
79

80
# ---- 随机延迟 ----
81

82
# 随机延迟时间，防止多个 Timer 同时触发造成负载高峰
83
# 格式：秒、分钟、小时等
84
RandomizedDelaySec=30             # 随机延迟 0-30 秒
85
# RandomizedDelaySec=5min
86

87
# 是否固定随机种子（相同配置产生相同随机数）
88
# FixedRandomDelay=no
89

90
# ---- 触发精度 ----
91

92
# 触发精度，用于合并相近时间的触发以节省资源
93
# AccuracySec=1min                 # 默认 1 分钟
94
# AccuracySec=1us                  # 微秒级（高精度但费电）
95

96
# ---- 触发关联配置 ----
97

98
# 要触发的 Unit（默认是同名的 .service）
99
# 例如：myapp.timer 默认触发 myapp.service
100
Unit=myapp.service
101

102
# 触发时传递给 Unit 的属性
103
# 可以覆盖被触发 Unit 的某些设置
104
# PropagatesReloadTo=myapp.service
105

106
# ---- 触发限制 ----
107

108
# 在日历事件触发后，延迟多久才执行
109
# OnCalendarSec=5min
110

111
# 两次触发之间的最小间隔（防抖动）
112
# OnClockChange=yes               # 系统时间调整时是否触发
113

114
# ---- 其他配置 ----
115

116
# 是否保持 Timer 运行（即使关联的 Unit 失败）
117
# RemainAfterElapse=yes
118

119
# 是否唤醒休眠的系统
120
# WakeSystem=no                    # 需要硬件支持 RTC 唤醒
121

122
# 硬件时钟使用 UTC 还是本地时间
123
# UTC=no
124

125
# ============================================
126
# [Install] 段：定义 Timer 如何安装到系统
127
# ============================================
128
[Install]
129

130
# 启用时链接到 timers.target（所有 Timer 的默认目标）
131
WantedBy=timers.target
132

133
# 强依赖版本
134
# RequiredBy=timers.target
135

136
# 别名
137
# Alias=myapp-cron.timer
138

139
# 启用/禁用时同时操作的其他 Unit
140
# Also=myapp.service

展开收起

2.4.3 配套的 `.service` 文件#

/etc/systemd/system/myapp.service展开收起

1
[Unit]
2
Description=My Application Service
3
# 不需要 [Install] 段，因为由 Timer 触发
4

5
[Service]
6
Type=oneshot                      # 一次性任务，执行完即退出
7
ExecStart=/usr/local/bin/myapp --run-task
8

9
# 如果任务可能运行时间较长，可使用 simple 类型
10
# Type=simple
11
# ExecStart=/usr/local/bin/myapp-daemon
12

13
# 环境变量
14
Environment="TASK_TYPE=scheduled"
15

16
# 工作目录
17
WorkingDirectory=/var/lib/myapp
18

19
[Install]
20
# 通常不需要 WantedBy，因为由 Timer 管理
21
# 但如果需要手动启动，可以保留
22
# WantedBy=multi-user.target

展开收起

2.4.4 OnCalendar 语法详解#

1
  DayOfWeek Year-Month-Day Hour:Minute:Second
2
     │         │              │
3
     │         │              └── 时:分:秒
4
     │         └───────────────── 年-月-日
5
     └─────────────────────────── 星期几（英文缩写或数字）
6

7
特殊值：
8
  *      匹配任意值
9
  ,      列表分隔（如 1,3,5）
10
  ..     范围（如 Mon..Fri）
11
  /      步长（如 */10 或 0/10）
12

13
示例：
14
  *-*-* 00:00:00          每天午夜
15
  Mon *-*-* 09:00:00      每周一 9 点
16
  *-01-01 00:00:00        每年元旦
17
  *-*-01 03:00:00         每月 1 号 3 点
18
  *-*-* 09:00..17:00:00   每天 9 点到 17 点每小时
19
  *:0/5                   每 5 分钟
20
  *-01/3-01 00:00:00      每季度第一天
21
  Mon..Fri 08:00:00       工作日早上 8 点
22
  Sat,Sun 10:00:00        周末早上 10 点

展开收起

2.4.5 常用命令#

Terminal window展开收起

1
# 查看所有 Timer 状态
2
systemctl list-timers
3

4
# 查看所有 Timer（包括未激活的）
5
systemctl list-timers --all
6

7
# 查看特定 Timer 状态
8
systemctl status myapp.timer
9

10
# 启动/停止/重启 Timer
11
sudo systemctl start myapp.timer
12
sudo systemctl stop myapp.timer
13
sudo systemctl restart myapp.timer
14

15
# 启用/禁用开机启动
16
sudo systemctl enable myapp.timer
17
sudo systemctl disable myapp.timer
18

19
# 查看下次触发时间
20
systemctl list-timers myapp.timer
21

22
# 手动触发关联的 Service
23
sudo systemctl start myapp.service
24

25
# 查看 Timer 日志
26
sudo journalctl -u myapp.timer -f
27

28
# 查看 Service 日志
29
sudo journalctl -u myapp.service -f
30

31
# 验证 OnCalendar 语法（测试下次触发时间）
32
systemd-analyze calendar "*-*-* 02:00:00"
33
systemd-analyze calendar "Mon..Fri 09:00:00"
34

35
# 验证 Timer 配置
36
systemd-analyze verify /etc/systemd/system/myapp.timer

展开收起

2.4.6 数据库备份示例#

/etc/systemd/system/db-backup.timer

1
[Unit]
2
Description=Daily Database Backup Timer
3

4
[Timer]
5
OnCalendar=*-*-* 02:00:00          # 每天凌晨 2 点
6
RandomizedDelaySec=10min           # 随机延迟 0-10 分钟，避免所有服务器同时备份
7
Persistent=true                    # 如果错过（如关机），开机后补执行
8

9
[Install]
10
WantedBy=timers.target

/etc/systemd/system/db-backup.service

1
[Unit]
2
Description=Daily Database Backup
3

4
[Service]
5
Type=oneshot
6
ExecStart=/usr/local/bin/backup-db.sh
7
User=backup
8
Group=backup

2.5 `.mount / .automount`（挂载管理）#

2.5.1 定义#

管理文件系统挂载，替代 /etc/fstab 中的条目，支持依赖和自动挂载。

2.5.2 配置模板#

/etc/systemd/system/mnt-data.mount展开收起

1
# ============================================
2
# [Unit] 段：定义 Mount 的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Mount 单元的描述
6
Description=Data Partition Mount
7

8
# 文档链接
9
Documentation=man:systemd.mount(5)
10

11
# ---- 依赖关系 ----
12

13
# 强依赖：挂载前必须先启动这些 Unit
14
# 通常需要 local-fs-pre.target 和块设备
15
Requires=local-fs-pre.target
16
Requires=dev-disk-by\x2duuid-12345678\x2d1234\x2d1234\x2d1234\x2d123456789abc.device
17

18
# 弱依赖
19
# Wants=
20

21
# 启动顺序：在这些 Unit 之后挂载
22
After=local-fs-pre.target
23
After=dev-disk-by\x2duuid-12345678\x2d1234\x2d1234\x2d1234\x2d123456789abc.device
24
# After=network.target              # 网络文件系统需要
25

26
# 启动顺序：在这些 Unit 之前挂载
27
Before=local-fs.target
28

29
# 冲突 Unit
30
Conflicts=umount.target
31
# Conflicts=shutdown.target
32

33
# ---- 启动条件 ----
34

35
# 条件判断
36
# ConditionPathExists=/dev/sdb1
37
# ConditionDirectoryNotEmpty=/mnt/data
38

39
# ============================================
40
# [Mount] 段：定义挂载参数（核心配置）
41
# ============================================
42
[Mount]
43

44
# ---- 挂载源和目标（必需）----
45

46
# 要挂载的设备或远程路径
47
What=/dev/disk/by-uuid/12345678-1234-1234-1234-123456789abc
48
# What=/dev/sdb1
49
# What=192.168.1.100:/nfs/export    # NFS 远程路径
50
# What=//192.168.1.100/share        # SMB/CIFS 路径
51

52
# 挂载点（必须是绝对路径，且单元文件名必须匹配）
53
# 例如：mnt-data.mount 对应 /mnt/data
54
Where=/mnt/data
55

56
# ---- 文件系统类型 ----
57

58
# 文件系统类型
59
Type=ext4
60
# Type=xfs
61
# Type=btrfs
62
# Type=nfs
63
# Type=cifs
64
# Type=vfat
65
# Type=auto                         # 自动检测
66

67
# ---- 挂载选项 ----
68

69
# 挂载选项（逗号分隔，无空格）
70
Options=defaults,noatime,discard
71
# Options=rw,sync,noexec,nosuid,nodev
72
# Options=username=user,password=pass,uid=1000  # CIFS 认证
73

74
# 额外的挂载标志
75
# SloppyOptions=no                  # 是否忽略不支持的挂载选项
76

77
# ---- 挂载模式 ----
78

79
# 是否以只读方式挂载
80
# ReadOnlyOnly=no                   # 只尝试只读挂载
81

82
# 是否强制作为绑定挂载
83
# BindPaths=
84
# BindReadOnlyPaths=
85

86
# 是否作为移动挂载（mount --move）
87
# MoveDirectory=no
88

89
# ---- 挂载前准备 ----
90

91
# 挂载前执行的命令
92
# ExecMount=/bin/mount ...
93

94
# 挂载后执行的命令
95
# ExecUnmount=/bin/umount ...
96

97
# 挂载前创建挂载点目录
98
# DirectoryMode=0755
99

100
# ---- 超时与重试 ----
101

102
# 挂载超时时间
103
TimeoutSec=30
104
# TimeoutSec=0                      # 0 表示无超时
105

106
# 挂载失败时的重试次数
107
# Retry=0
108

109
# ============================================
110
# [Install] 段：定义 Mount 如何安装到系统
111
# ============================================
112
[Install]
113

114
# 启用时链接到 local-fs.target（本地文件系统目标）
115
WantedBy=local-fs.target
116

117
# 网络文件系统应使用 remote-fs.target
118
# WantedBy=remote-fs.target
119

120
# 强依赖版本
121
# RequiredBy=local-fs.target
122

123
# 别名
124
# Alias=data.mount

展开收起

2.5.3 命名规则（重要）#

单元文件路径	挂载点路径
`mnt-data.mount`	`/mnt/data`
`home-user-data.mount`	`/home/user/data`
`mnt-usb\x2dbackup.mount`	`/mnt/usb-backup`（`-` 用 `\x2d` 转义）
`dev-sdb1.mount`	`/dev/sdb1`（不推荐直接挂载设备）

转义规则：

- → \x2d
/ → -（路径分隔符）
其他特殊字符使用 \xHH 十六进制编码

2.5.4 Mount vs Automount 对比#

特性	.mount	.automount
触发时机	系统启动时立即挂载	首次访问挂载点时挂载
卸载行为	系统关机时才卸载	空闲超时时自动卸载
资源占用	始终占用资源	按需占用，节省资源
适用场景	系统必需分区	移动设备、网络共享、备份盘
依赖关系	需等待设备就绪	设备就绪后仍延迟挂载
用户体验	启动时可能变慢	首次访问可能有延迟

2.5.5 常用命令#

Terminal window展开收起

1
# 查看所有挂载点
2
systemctl list-units --type=mount
3

4
# 查看所有自动挂载点
5
systemctl list-units --type=automount
6

7
# 启动/停止挂载
8
sudo systemctl start mnt-data.mount
9
sudo systemctl stop mnt-data.mount
10

11
# 重新挂载
12
sudo systemctl restart mnt-data.mount
13

14
# 启用/禁用开机挂载
15
sudo systemctl enable mnt-data.mount
16
sudo systemctl disable mnt-data.mount
17

18
# 启用/禁用自动挂载
19
sudo systemctl enable mnt-data.automount
20
sudo systemctl disable mnt-data.automount
21

22
# 查看挂载状态
23
systemctl status mnt-data.mount
24
systemctl status mnt-data.automount
25

26
# 查看日志
27
sudo journalctl -u mnt-data.mount -f
28

29
# 手动触发自动挂载（通过访问挂载点）
30
ls /mnt/data
31

32
# 查看当前挂载的文件系统
33
findmnt
34
mount | grep mnt-data
35

36
# 验证配置
37
systemd-analyze verify /etc/systemd/system/mnt-data.mount

展开收起

2.5.6 自动挂在本地硬盘示例#

/etc/systemd/system/mnt-data.automount

1
[Unit]
2
Description=Data Partition Automount
3

4
[Automount]
5
Where=/mnt/data
6
TimeoutIdleSec=300                  # 5分钟无访问自动卸载
7

8
[Install]
9
WantedBy=local-fs.target

/etc/systemd/system/mnt-data.mount

1
[Unit]
2
Description=Data Partition Mount
3

4
[Mount]
5
What=/dev/disk/by-uuid/a1b2c3d4-e5f6-7890-abcd-ef1234567890
6
Where=/mnt/data
7
Type=ext4
8
Options=defaults,noatime
9

10
[Install]
11
WantedBy=local-fs.target

2.5.7 挂载NFS示例#

/etc/systemd/system/mnt-nfs-share.mount

1
[Unit]
2
Description=NFS Share Mount
3
Requires=network-online.target
4
After=network-online.target
5
Before=remote-fs.target
6

7
[Mount]
8
What=192.168.1.100:/export/share
9
Where=/mnt/nfs-share
10
Type=nfs
11
Options=defaults,_netdev,soft,intr
12

13
[Install]
14
WantedBy=remote-fs.target

2.5.8 USB 移动设备自动挂载示例#

/etc/systemd/system/mnt-usb.automount

1
[Unit]
2
Description=USB Drive Automount
3
After=local-fs-pre.target
4

5
[Automount]
6
Where=/mnt/usb
7
TimeoutIdleSec=60                   # 1分钟无访问自动卸载
8

9
[Install]
10
WantedBy=local-fs.target

/etc/systemd/system/mnt-usb.mount

1
[Unit]
2
Description=USB Drive Mount
3

4
[Mount]
5
What=/dev/disk/by-label/MYUSB
6
Where=/mnt/usb
7
Type=auto
8
Options=defaults,noatime,uid=1000,gid=1000
9

10
[Install]
11
WantedBy=local-fs.target

2.6 `.path`（路径监控）#

2.6.1 定义#

监控文件或目录变化，触发对应的服务执行。适用于文件上传处理、日志轮转等场景。

2.6.2 配置模板#

/etc/systemd/system/myapp-monitor.path展开收起

1
# ============================================
2
# [Unit] 段：定义 Path 单元的元信息和依赖关系
3
# ============================================
4
[Unit]
5
# Path 单元的描述
6
Description=Monitor /var/lib/myapp for changes
7

8
# 文档链接
9
Documentation=man:systemd.path(5)
10

11
# ---- 依赖关系 ----
12

13
# 启动顺序：在这些 Unit 之后启动
14
After=basic.target
15

16
# 弱依赖
17
# Wants=
18

19
# 强依赖
20
# Requires=
21

22
# 冲突 Unit
23
Conflicts=shutdown.target
24

25
# ============================================
26
# [Path] 段：定义路径监控规则（核心配置）
27
# ============================================
28
[Path]
29

30
# ---- 监控路径类型（四种触发条件）----
31

32
# 1. 监控目录存在性：当指定目录存在时触发
33
PathExists=/var/lib/myapp/ready
34

35
# 2. 监控目录非空：当指定目录存在且非空时触发
36
# PathExistsGlob=/var/lib/myapp/uploads/*
37

38
# 3. 监控目录内容变化：当目录内文件被创建、修改、删除时触发
39
PathChanged=/var/lib/myapp/data/
40

41
# 4. 监控目录修改时间变化：当目录本身被修改（权限、时间戳等）时触发
42
# PathModified=/var/lib/myapp/config/
43

44
# ---- 触发关联配置 ----
45

46
# 要触发的 Unit（默认是同名的 .service）
47
# 例如：myapp-monitor.path 默认触发 myapp-monitor.service
48
Unit=myapp-processor.service
49

50
# 触发时传递给 Unit 的属性
51
# MakeDirectory=yes                 # 如果路径不存在，是否创建目录
52
# DirectoryMode=0755                # 创建目录时的权限
53

54
# ---- 触发行为配置 ----
55

56
# 是否触发一次后停止监控（默认 no，持续监控）
57
# TriggerLimitIntervalSec=0
58
# TriggerLimitBurst=0
59

60
# 触发间隔限制（防雪崩）
61
# TriggerLimitIntervalSec=2
62
# TriggerLimitBurst=200
63

64
# ============================================
65
# [Install] 段：定义 Path 单元如何安装到系统
66
# ============================================
67
[Install]
68

69
# 启用时链接到默认目标
70
WantedBy=multi-user.target
71

72
# 或者使用 paths.target（所有 path 单元的标准目标）
73
# WantedBy=paths.target

展开收起

2.6.3 配套的 `.service` 文件#

/etc/systemd/system/myapp-processor.service展开收起

1
[Unit]
2
Description=Process myapp data changes
3
# 不需要 [Install] 段，由 Path 单元触发
4

5
[Service]
6
Type=oneshot                      # 一次性任务，执行完即退出
7
ExecStart=/usr/local/bin/myapp-processor
8

9
# 如果处理可能并发，使用 simple 类型并处理并发
10
# Type=simple
11
# ExecStart=/usr/local/bin/myapp-daemon --process
12

13
# 环境变量
14
Environment="WATCH_PATH=/var/lib/myapp/data"
15

16
# 工作目录
17
WorkingDirectory=/var/lib/myapp

展开收起

2.6.4 种 Path 触发类型详解#

类型	语法	触发条件	适用场景
PathExists	`PathExists=/path/to/file`	路径存在时触发一次	等待配置文件就绪、设备就绪
PathExistsGlob	`PathExistsGlob=/path/*`	匹配 glob 模式的文件存在时触发	等待特定类型文件出现
PathChanged	`PathChanged=/path/to/dir/`	目录内容变化时触发（创建/删除/修改文件）	监控上传目录、数据目录
PathModified	`PathModified=/path/to/file`	文件/目录元数据变化时触发（权限、时间戳、内容）	监控配置文件修改

2.6.5 触发行为对比#

1
PathExists:     文件/目录出现 ──→ 触发（只触发一次，除非删除后重新出现）
2
                 文件/目录删除 ──→ 无操作
3

4
PathExistsGlob: 匹配的文件出现 ──→ 触发
5
                 匹配的文件全部删除 ──→ 无操作
6

7
PathChanged:    目录内文件创建 ──→ 触发
8
                目录内文件删除 ──→ 触发
9
                目录内文件修改 ──→ 触发
10
                子目录创建/删除 ──→ 触发
11

12
PathModified:   文件内容修改 ──→ 触发
13
                文件权限修改 ──→ 触发
14
                文件时间戳修改 ──→ 触发
15
                目录属性修改 ──→ 触发

展开收起

2.6.6 常用命令#

Terminal window展开收起

1
# 查看所有 Path 单元状态
2
systemctl list-units --type=path
3

4
# 查看所有 Path 单元（包括未激活的）
5
systemctl list-units --type=path --all
6

7
# 启动/停止 Path 监控
8
sudo systemctl start myapp-monitor.path
9
sudo systemctl stop myapp-monitor.path
10

11
# 启用/禁用开机监控
12
sudo systemctl enable myapp-monitor.path
13
sudo systemctl disable myapp-monitor.path
14

15
# 查看 Path 单元状态
16
systemctl status myapp-monitor.path
17

18
# 查看日志
19
sudo journalctl -u myapp-monitor.path -f
20
sudo journalctl -u myapp-processor.service -f
21

22
# 手动触发关联的 Service
23
sudo systemctl start myapp-processor.service
24

25
# 验证配置
26
systemd-analyze verify /etc/systemd/system/myapp-monitor.path

展开收起

2.6.7 配置文件热重载#

/etc/systemd/system/myapp-config.path

1
[Unit]
2
Description=Monitor myapp config changes
3

4
[Path]
5
PathModified=/etc/myapp/config.yaml
6
Unit=myapp-reload.service
7

8
[Install]
9
WantedBy=multi-user.target

/etc/systemd/system/myapp-reload.service

1
[Unit]
2
Description=Reload myapp configuration
3

4
[Service]
5
Type=oneshot
6
ExecStart=/bin/kill -HUP $(cat /run/myapp.pid)

2.7 `.slice`（资源控制 - cgroup）#

2.7.1 定义#

组织进程树，进行资源限制（CPU、内存、IO）。是 Linux cgroup 的 systemd 封装。

2.7.2 配置模板#

/etc/systemd/system/myapp.slice展开收起

1
# ============================================
2
# [Unit] 段：定义 Slice 的元信息
3
# ============================================
4
[Unit]
5
# Slice 的描述
6
Description=My Application Resource Slice
7

8
# 文档链接
9
Documentation=man:systemd.slice(5)
10

11
# ---- 依赖关系 ----
12

13
# 启动顺序
14
After=system.slice
15

16
# 弱依赖
17
# Wants=
18

19
# 强依赖
20
# Requires=system.slice
21

22
# 冲突
23
Conflicts=umount.target
24

25
# 停止时是否同时停止子单元
26
# StopWhenUnneeded=no
27

28
# ============================================
29
# [Slice] 段：定义资源限制（核心配置）
30
# ============================================
31
[Slice]
32

33
# ---- CPU 资源控制 ----
34

35
# CPU 权重（相对份额），用于 CPU 调度
36
# 范围：1-10000，默认 100
37
# 与其他 Slice 竞争 CPU 时按权重分配
38
CPUWeight=500
39
# CPUShares=500                  # 旧版 cgroup v1 语法（已弃用）
40

41
# CPU 配额：绝对限制，百分比形式
42
# 100% = 1 个核心，200% = 2 个核心
43
CPUQuota=80%
44
# CPUQuotaPeriodSec=100ms         # 配额计算周期
45

46
# CPU 亲和性：绑定到特定 CPU 核心
47
# AllowedCPUs=0-3                # 允许使用 0-3 号核心
48
# AllowedCPUs=0,2,4-6            # 混合指定
49

50
# NUMA 节点亲和性
51
# AllowedMemoryNodes=0-1
52

53
# ---- 内存资源控制 ----
54

55
# 内存限制（硬限制，超过会被 OOM killer 终止）
56
MemoryMax=512M
57
# MemoryMax=1G
58
# MemoryMax=infinity             # 无限制（默认）
59

60
# 内存高水位（软限制，超过时内核优先回收该组内存）
61
MemoryHigh=400M
62

63
# 内存交换限制
64
# MemorySwapMax=1G               # 最大交换使用量
65
# MemorySwapMax=0                # 禁用交换
66

67
# 内存最小保证（预留内存，不被其他组借用）
68
# MemoryMin=256M
69
# MemoryLow=256M                 # 尽力保证的内存量
70

71
# 内存回收压力控制
72
# MemoryPressureWatch=auto
73
# MemoryPressureThresholdSec=100ms
74

75
# OOM 控制
76
# OOMPolicy=continue              # OOM 时继续运行（默认）
77
# OOMPolicy=stop                  # OOM 时停止
78
# OOMPolicy=kill                  # OOM 时杀死进程
79

80
# ---- IO 资源控制 ----
81

82
# IO 权重（相对份额），用于块设备调度
83
# 范围：1-10000，默认 100
84
IOWeight=500
85
# BlockIOWeight=500              # 旧版语法
86

87
# 特定设备的 IO 限制
88
# IOReadBandwidthMax=/dev/sda 10M
89
# IOWriteBandwidthMax=/dev/sda 10M
90
# IOReadIOPSMax=/dev/sda 100
91
# IOWriteIOPSMax=/dev/sda 100
92

93
# IO 延迟目标（控制 IO 延迟）
94
# IODeviceLatencyTargetSec=/dev/sda 10ms
95

96
# ---- 网络资源控制 ----
97

98
# 网络带宽限制（需要内核支持，通常通过 tc 实现）
99
# NetworkIngressMax=100M
100
# NetworkEgressMax=100M
101

102
# IP 防火墙规则（通过 BPF/cgroup 实现）
103
# IPAddressAllow=192.168.0.0/16
104
# IPAddressDeny=any
105

106
# ---- 任务/进程数量控制 ----
107

108
# 最大任务数（线程/进程）
109
TasksMax=1000
110
# TasksMax=infinity
111

112
# 最大进程数
113
# TasksAccounting=yes            # 启用任务统计
114

115
# ---- 设备访问控制 ----
116

117
# 允许访问的设备
118
DeviceAllow=/dev/null rw
119
DeviceAllow=/dev/zero rw
120
DeviceAllow=/dev/random r
121
DeviceAllow=/dev/urandom r
122
# DeviceAllow=char-pts rw        # 允许伪终端
123

124
# 拒绝访问的设备（默认策略）
125
DevicePolicy=closed
126
# DevicePolicy=auto              # 自动（根据类型）
127
# DevicePolicy=strict            # 严格（只允许明确允许的）
128
# DevicePolicy=closed            # 关闭（只允许白名单）
129

130
# ---- 控制组属性 ----
131

132
# 是否委托控制组给子进程管理
133
# Delegate=yes
134
# Delegate=cpu cpuset io memory  # 委托特定控制器
135

136
# 控制组内存回收策略
137
# MemoryAccounting=yes           # 启用内存统计（默认启用）
138

139
# 控制组 CPU 统计
140
# CPUAccounting=yes              # 启用 CPU 统计（默认启用）
141

142
# IO 统计
143
# IOAccounting=yes               # 启用 IO 统计（默认启用）
144

145
# IP 统计
146
# IPAccounting=yes               # 启用网络统计
147

148
# 控制组层级中的权重
149
# Slice=machine.slice            # 指定父 Slice
150

151
# ---- 其他资源控制 ----
152

153
# 文件描述符限制（继承到子单元）
154
# LimitNOFILE=65535
155

156
# 进程数限制（继承到子单元）
157
# LimitNPROC=1024
158

159
# 核心转储限制
160
# LimitCORE=0
161

162
# 文件大小限制
163
# LimitFSIZE=1G
164

165
# 虚拟内存限制
166
# LimitAS=2G
167

168
# 栈大小限制
169
# LimitSTACK=8M
170

171
# ============================================
172
# [Install] 段：通常不需要，Slice 由依赖关系驱动
173
# ============================================
174
[Install]
175

176
# Slice 通常不需要 [Install] 段
177
# 因为它们被其他单元引用而非直接启用
178
# WantedBy=

展开收起

2.7.3 Slice 层级结构#

1
system.slice (系统默认 Slice)
2
├── user.slice (用户会话)
3
│   ├── user-1000.slice (UID 1000 用户)
4
│   │   ├── session-1.scope (会话 1)
5
│   │   └── session-2.scope (会话 2)
6
│   └── user-1001.slice (UID 1001 用户)
7
├── machine.slice (容器/虚拟机)
8
│   ├── libvirt-lxc\x2dvm1.scope
9
│   └── docker-abc123.scope
10
└── myapp.slice (自定义应用组)
11
    ├── myapp-web.service
12
    ├── myapp-api.service
13
    └── myapp-db.service

2.7.4 命名规则#

单元文件路径	层级位置
`myapp.slice`	直接位于根层级（与 system.slice 同级）
`myapp-frontend.slice`	myapp.slice 的子 Slice
`myapp-backend.slice`	myapp.slice 的子 Slice
`system-myapp.slice`	位于 system.slice 下

命名约定：

使用 - 连接父子层级
顶层 Slice 建议放在 system.slice 下（system-xxx.slice）
用户相关放在 user.slice 下

2.7.5 常用命令#

Terminal window展开收起

1
# 查看所有 Slice
2
systemctl list-units --type=slice
3

4
# 查看 Slice 树状结构
5
systemd-cgls
6

7
# 查看资源使用情况
8
systemd-cgtop
9

10
# 查看特定 Slice 状态
11
systemctl status myapp.slice
12

13
# 启动/停止 Slice
14
sudo systemctl start myapp.slice
15
sudo systemctl stop myapp.slice
16

17
# 查看 cgroup 文件系统
18
ls /sys/fs/cgroup/system.slice/myapp.slice/
19

20
# 实时查看资源使用
21
cat /sys/fs/cgroup/system.slice/myapp.slice/memory.current
22
cat /sys/fs/cgroup/system.slice/myapp.slice/cpu.stat
23

24
# 查看资源限制
25
cat /sys/fs/cgroup/system.slice/myapp.slice/memory.max
26
cat /sys/fs/cgroup/system.slice/myapp.slice/cpu.max

展开收起

2.7.6 数据库资源隔离示例#

/etc/systemd/system/myapp-db.slice展开收起

1
[Unit]
2
Description=MyApp Database Tier Resources
3

4
[Slice]
5
# 数据库需要更多 CPU
6
CPUWeight=800
7

8
# 内存：2GB 限制，1.5GB 高水位
9
MemoryHigh=1536M
10
MemoryMax=2G
11

12
# 禁用交换（数据库性能考虑）
13
MemorySwapMax=0
14

15
# IO：最高优先级
16
IOWeight=1000
17

18
# 允许访问块设备（用于原始设备访问）
19
DeviceAllow=/dev/sda rw
20
DeviceAllow=block-blkext rw

展开收起

2.8 `.scope`（外部进程组）#

2.8.1 定义#

由外部程序创建的进程组，systemd 只负责管理生命周期，不启动进程。主要用于用户会话和容器。

2.8.2 与 Service 的区别#

特性	Service	Scope
启动方式	systemd 启动	外部程序创建
主进程	systemd 管理	外部管理
使用场景	守护进程	用户会话、容器
配置	完整配置	主要是资源限制

2.8.3 配置模板#

/run/systemd/transient/session-123.scope展开收起

1
# 通过 systemd-run 创建的临时 scope 示例
2
# ============================================
3
# [Unit] 段：定义 Scope 的元信息
4
# ============================================
5
[Unit]
6
# Scope 的描述
7
Description=User Session 123
8

9
# 文档链接
10
Documentation=man:systemd.scope(5)
11

12
# ---- 依赖关系 ----
13

14
# 启动顺序
15
After=systemd-logind.service
16

17
# 弱依赖
18
# Wants=
19

20
# 强依赖
21
# Requires=
22

23
# 冲突
24
Conflicts=shutdown.target
25

26
# 停止时是否同时停止
27
# StopWhenUnneeded=no
28

29
# 忽略停止信号
30
# RefuseManualStop=no
31

32
# ============================================
33
# [Scope] 段：定义进程组管理参数（核心配置）
34
# ============================================
35
[Scope]
36

37
# ---- 进程管理 ----
38

39
# 要管理的初始 PID（创建时指定）
40
# PIDs=1234                        # 主进程 PID
41
# PIDs=1234 1235 1236             # 多个初始 PID
42

43
# 运行时目录
44
# RuntimeDirectory=session-123
45

46
# 运行时目录权限
47
# RuntimeDirectoryMode=0755
48

49
# 状态目录
50
# StateDirectory=
51

52
# 缓存目录
53
# CacheDirectory=
54

55
# 日志目录
56
# LogsDirectory=
57

58
# 配置目录
59
# ConfigurationDirectory=
60

61
# ---- 资源控制（与 Slice 相同）----
62

63
# CPU 权重
64
CPUWeight=100
65

66
# CPU 配额
67
# CPUQuota=
68

69
# 内存限制
70
MemoryMax=1G
71
# MemoryHigh=800M
72

73
# 交换限制
74
# MemorySwapMax=
75

76
# IO 权重
77
IOWeight=100
78

79
# 任务数限制
80
TasksMax=1000
81

82
# 设备访问控制
83
DevicePolicy=auto
84
# DeviceAllow=
85

86
# ---- 控制组委托 ----
87

88
# 是否委托 cgroup 给子进程
89
# Delegate=yes                   # 委托所有控制器
90
# Delegate=cpu memory io         # 委托特定控制器
91

92
# 委托属性
93
# DelegateSubgroup=
94

95
# ---- _KILL 模式_ ----
96

97
# 终止模式
98
KillMode=mixed                   # mixed: 主进程 SIGTERM，其他 SIGKILL
99
# KillMode=control-group         # 终止整个控制组
100
# KillMode=process               # 仅终止主进程
101
# KillMode=none                  # 不终止任何进程
102

103
# 终止信号
104
KillSignal=SIGTERM
105

106
# 最终终止信号
107
FinalKillSignal=SIGKILL
108

109
# 发送终止信号前的等待时间
110
TimeoutStopSec=30
111

112
# 是否发送 SIGHUP
113
SendSIGHUP=yes
114

115
# 是否发送 SIGKILL
116
SendSIGKILL=yes
117

118
# ---- 标准输入输出 ----
119

120
# 标准输入
121
StandardInput=null
122
# StandardInput=tty
123
# StandardInput=tty-force
124

125
# 标准输出
126
StandardOutput=journal
127
# StandardOutput=inherit         # 继承调用者的输出
128
# StandardOutput=null
129
# StandardOutput=tty
130

131
# 标准错误
132
StandardError=journal
133
# StandardError=inherit
134
# StandardError=null
135
# StandardError=tty
136

137
# 终端设置
138
# TTYPath=/dev/tty1
139
# TTYReset=yes
140
# TTYVHangup=yes
141
# TTYVTDisallocate=yes
142

143
# ---- 环境变量 ----
144

145
# 环境变量
146
# Environment=VAR=value
147

148
# 环境变量文件
149
# EnvironmentFile=
150

151
# 是否传递环境变量给子进程
152
# PassEnvironment=
153

154
# ---- 其他控制组设置 ----
155

156
# 控制组属性
157
# Slice=session.slice
158

159
# 内存压力监控
160
# MemoryPressureWatch=auto
161
# MemoryPressureThresholdSec=100ms
162

163
# OOM 策略
164
OOMPolicy=continue
165
# OOMPolicy=stop
166
# OOMPolicy=kill
167

168
# ============================================
169
# [Install] 段：通常不需要，Scope 是动态的
170
# ============================================
171
[Install]
172

173
# Scope 通常是动态创建的，不需要 [Install]
174
# WantedBy=

展开收起

2.8.4 创建 Scope 的方式#

2.8.4.1 使用 systemd-run 🌟#

Terminal window

1
# 创建临时 scope 运行命令
2
systemd-run --scope --unit=myjob --slice=myapp.slice --property=MemoryMax=512M ./my-script.sh
3

4
# 创建交互式 scope
5
systemd-run --scope --unit=interactive-session --uid=$(id -u) --gid=$(id -g) /bin/bash
6

7
# 指定更多资源限制
8
systemd-run --scope \
9
    --unit=heavy-job \
10
    --property=CPUWeight=200 \
11
    --property=MemoryMax=2G \
12
    --property=IOWeight=50 \
13
    ./heavy-processing.sh

2.8.4.2 使用 D-Bus API（程序化）#

1
package main
2

3
import (
4
    "context"
5
    "fmt"
6
    "os"
7
    "os/exec"
8
    "syscall"
9

10
    "github.com/godbus/dbus/v5"
11
)
12

13
// SystemdManager 封装 systemd D-Bus 调用
14
type SystemdManager struct {
15
    conn   *dbus.Conn
16
    object dbus.BusObject
17
}
18

19
// NewSystemdManager 连接到 systemd D-Bus
20
func NewSystemdManager() (*SystemdManager, error) {
21
    conn, err := dbus.SystemBus()
22
    if err != nil {
23
        // 尝试用户 bus（用于用户级 systemd）
24
        conn, err = dbus.UserBus()
25
        if err != nil {
26
            return nil, fmt.Errorf("连接 D-Bus 失败: %w", err)
27
        }
28
    }
29

30
    object := conn.Object("org.freedesktop.systemd1", "/org/freedesktop/systemd1")
31

32
    return &SystemdManager{
33
        conn:   conn,
34
        object: object,
35
    }, nil
36
}
37

38
// RunInScope 在指定 scope 中运行命令
39
func (m *SystemdManager) RunInScope(
40
    ctx context.Context,
41
    unitName string,
42
    slice string,
43
    properties map[string]interface{},
44
    cmd string,
45
    args ...string,
46
) error {
47

48
    // 准备 transient unit 的属性
49
    props := []dbus.Property{
50
        {
51
            Name:  "Description",
52
            Value: dbus.MakeVariant(fmt.Sprintf("Scope for %s", unitName)),
53
        },
54
        {
55
            Name:  "PIDs",
56
            Value: dbus.MakeVariant([]uint32{uint32(os.Getpid())}),
57
        },
58
    }
59

60
    // 指定 slice
61
    if slice != "" {
62
        props = append(props, dbus.Property{
63
            Name:  "Slice",
64
            Value: dbus.MakeVariant(slice),
65
        })
66
    }
67

68
    // 添加自定义属性（资源限制等）
69
    for name, value := range properties {
70
        props = append(props, dbus.Property{
71
            Name:  name,
72
            Value: dbus.MakeVariant(value),
73
        })
74
    }
75

76
    // 辅助单元（无）
77
    aux := []dbus.UnitAux{}
78

79
    // 调用 StartTransientUnit
80
    var jobPath dbus.ObjectPath
81
    err := m.object.CallWithContext(
82
        ctx,
83
        "org.freedesktop.systemd1.Manager.StartTransientUnit",
84
        0,
85
        unitName,
86
        "fail", // 模式: fail/replace/ignore-dependencies/isolate
87
        props,
88
        aux,
89
    ).Store(&jobPath)
90

91
    if err != nil {
92
        return fmt.Errorf("创建 scope 失败: %w", err)
93
    }
94

95
    fmt.Printf("Scope %s created, job: %s\n", unitName, jobPath)
96

97
    // 执行实际命令
98
    command := exec.CommandContext(ctx, cmd, args...)
99
    command.Stdin = os.Stdin
100
    command.Stdout = os.Stdout
101
    command.Stderr = os.Stderr
102

103
    // 设置进程组，确保信号正确传递
104
    command.SysProcAttr = &syscall.SysProcAttr{
105
        Setpgid: true,
106
    }
107

108
    return command.Run()
109
}
110

111
func main() {
112
    manager, err := NewSystemdManager()
113
    if err != nil {
114
        fmt.Fprintf(os.Stderr, "错误: %v\n", err)
115
        os.Exit(1)
116
    }
117

118
    // 资源限制属性
119
    properties := map[string]interface{}{
120
        "MemoryMax": uint64(512 * 1024 * 1024), // 512M
121
    }
122

123
    // 运行命令
124
    err = manager.RunInScope(
125
        context.Background(),
126
        "myjob.scope",
127
        "myapp.slice",
128
        properties,
129
        "./my-script.sh",
130
    )
131

132
    if err != nil {
133
        fmt.Fprintf(os.Stderr, "执行失败: %v\n", err)
134
        os.Exit(1)
135
    }
136
}

展开收起

2.8.5 常用命令#

Terminal window展开收起

1
# 查看所有 Scope
2
systemctl list-units --type=scope
3

4
# 查看特定 Scope 状态
5
systemctl status session-1.scope
6

7
# 停止 Scope（会终止其中所有进程）
8
sudo systemctl stop myscope.scope
9

10
# 查看 Scope 中的进程
11
systemd-cgls /user.slice/user-1000.slice/session-1.scope
12

13
# 查看资源使用
14
systemd-cgtop --batch | grep scope
15

16
# 查看 cgroup 文件
17
ls /sys/fs/cgroup/user.slice/user-1000.slice/session-1.scope/
18

19
# 将现有进程移入 Scope（通过 busctl）
20
busctl call org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager AttachProcessesToUnit 'sau' myscope.scope 0 1234 1235
21

22
# 创建临时 scope 并立即执行
23
systemd-run --scope --unit=temporary --collect /path/to/command

展开收起

2.8.6 容器/沙箱环境示例#

/run/systemd/transient/container-web.scope展开收起

1
# 通过 systemd-nspawn 创建的容器 scope
2
[Unit]
3
Description=Container web
4

5
[Scope]
6
Slice=machine.slice
7
CPUWeight=200
8
MemoryMax=4G
9
MemorySwapMax=0
10
TasksMax=10000
11
DevicePolicy=closed
12
DeviceAllow=/dev/null rw
13
DeviceAllow=/dev/zero rw
14
DeviceAllow=/dev/random r
15
DeviceAllow=/dev/urandom r
16
DeviceAllow=eth0 rw
17

18
# 网络命名空间
19
PrivateNetwork=no
20

21
# 用户命名空间
22
PrivateUsers=yes
23

24
# 挂载命名空间
25
PrivateMounts=yes

展开收起

3. 结尾#

没了喵，谢谢欣赏

gopher

补络阁

Dank Material Shell安装

Debian安装Dank Material Shell的折腾记录#

1. 效果图：#

2. Niri 和 Dank Material Shell#

2.1 Niri#

2.2 Dank Material Shell#

3. 安装教程#

3.1 安装基准系统#

3.2 安装 Niri 和 Dank Material Shell#

3.3 安装 DankGreeter#

3.3.1 安装命令#

3.3.2 初始化 DankGreeter#

3.3.3 同步主题#

3.3.4 效果展示#

4. 系统优化#

4.1 安装 Nerd Font#

4.2 设置Kitty Terminal#

4.2.1 设置Font#

4.2.2 设置默认Shell#

4.2.3 设置半透明#

4.3 添加 Emoji 选择器#

4.3.1 安装依赖#

4.3.2 编写启动脚本#

4.3.3 编写CSS样式#

4.3.4 绑定 Niri 快捷键#

4.3.5 效果例图#

4.4 安装 fastfeach#

4.4.1 安装依赖#

4.4.2 下载美化包#

4.4.3 我的配置#

4.5 解决屏幕共享失败问题#

5. 其余设置#

5.1 系统样式设置#

5.1.1 DankBar#

5.1.2 设置系统主题色#

5.1.3 Window Gap#

5.2 软件的安装和修改#

5.2.1 在 Chrome 里添加带代理的启动选项#

5.2.2 安装AppImage#

6. 结尾#

博客-启航

我的第一篇博客喵#

Linux Shell Pipeline

Linux管道符的知识点和使用#

1. 管道的底层原理#

1.1 三大输出流#

1.2 管道规则#

2. 基础示例#

2.1 示例一#

2.2 示例二#

3. 进阶：文本流水线#

3.1 错误日志筛选 + 去重#

3.2 统计每种错误出现次数#

4. 管道 + xargs#

4.1 为什么需要 xargs？#

4.2 示例#

4.2.1 删除所有 .log 文件#

4.2.2 批量访问网址#

5. 进程替换 <() 命令#

5.1 核心作用#

5.2 进程替换与文件重定向#

6. 标准错误管道处理#

6.1 默认问题#

6.2 两个核心数字#

6.3 示例#

6.3.1 屏蔽错误#

6.3.2 错误也走管道#

7. 三通阀（tee命令）#

7.1 作用#

7.2 基础用法#

7.3 追加写入#

8. 流式编辑器（sed命令）#

8.1 基础用法#

8.2 核心命令#

8.2.1 替换（s）#

8.2.2 删除（d）#

8.2.3 打印（p）与静默（-n）#

8.2.4 插入、追加、修改（i/a/c）#

8.3 常用选项#

5. 进程替换 `<()` 命令#

9. 匿名管道和命名管道#

9.1 匿名管道 `|`#

1.3 用户态和系统态#

2.1 `.service`（服务 - 最常用）#

2.2 `.socket`（套接字）#

2.2.3 配套的`.service`模板#

2.3 `.target` （目标 - 运行级别）#

2.4 `.timer`（定时器 - 替代 cron）#

2.4.3 配套的 `.service` 文件#

2.5 `.mount / .automount`（挂载管理）#