Hyperbola

公告

ブログへようこそ！これはサンプルの告知です

标签

Hyperbola

公告

ブログへようこそ！これはサンプルの告知です

Learn More

标签

Database Desktop Development DevOps Hardware High_Availability Hyprland Input_Method Kubernetes Linux Networking Virtualization

Hyperbola

公告

ブログへようこそ！これはサンプルの告知です

Learn More

标签

Database Desktop Development DevOps Hardware High_Availability Hyprland Input_Method Kubernetes Linux Networking Virtualization

站点统计

文章

23

分类

6

标签

12

总字数

36,039

运行天数

0 天

最后活动

0 天前

3077 字

8 分钟

Debian13 环境配置

2026-02-27

2026-08-09

DevOps

Linux

写在开头#

废话#

2026.2.27 将家里服务器PVE改为单Debian故再次重装

于是接着25年的一个基础配置文章部署环境

Debian12升级Debian13参考链接#

1
https://www.sysgeek.cn/upgrade-debian-13/

升级成功标志#

1
root@hyperbola-txy:~# cat /etc/debian_version
2
13.1

调整root下的一些配置#

WARNING
注意：该章默认为root账户，如果是非root账户遇到权限相关的提示，请使用sudo进行提权

软件源配置（apt源）#

您的系统目前同时存在两种格式的软件源配置，建议保留一种并禁用另一种：

方案一：使用新版 DEB822 格式（推荐）

将 /etc/apt/sources.list.d/0000debian.sources 中的官方源地址替换为阿里云镜像，并补全组件。

备份并删除旧文件：

1
sudo mv /etc/apt/sources.list /etc/apt/sources.list.bak

更新源：

1
sudo apt update

方案二：使用传统格式

您的 /etc/apt/sources.list 已配置好阿里云源，无需修改。

备份并删除新版文件：

1
sudo mv /etc/apt/sources.list.d/0000debian.sources /etc/apt/sources.list.d/0000debian.sources.bak

更新源：

1
sudo apt update

IMPORTANT
核心原则：二选一，避免冲突。

网络相关#

链路聚合 (Bonding)：将 eno1 和 enp3s0 绑定为 bond0 (模式 802.3ad/LACP)。
网桥 (Bridging)：创建 br0 网桥，并将 bond0 作为端口加入。
网络接入：宿主机和未来的 KVM 虚拟机都通过 br0 获取 IP 并上网。

systemd-networkd 实现 Bond + Bridge#

1. 准备工作：禁用 NetworkManager#

如果你之前使用 NetworkManager，必须先停止并禁用它，以免冲突。

1
sudo systemctl stop NetworkManager
2
sudo systemctl disable NetworkManager
3
sudo systemctl enable --now systemd-networkd

2. 清理旧配置#

建议先清空 /etc/systemd/network/ 目录下的旧配置，避免文件名冲突或逻辑干扰。

1
sudo rm /etc/systemd/network/*.network
2
sudo rm /etc/systemd/network/*.netdev

3. 创建配置文件#

请在 /etc/systemd/network/ 目录下创建以下 6个文件。你可以直接复制粘贴内容。

① 定义 Bond 设备 (`10-bond0.netdev`)#

定义逻辑接口 bond0 及其聚合模式。

1
[NetDev]
2
Name=bond0
3
Kind=bond
4

5
[Bond]
6
Mode=802.3ad
7
TransmitHashPolicy=layer3+4
8
MIIMonitorSec=100ms
9
LACPTransmitRate=fast
10
MinLinks=1

② 定义 Bridge 设备 (`20-br0.netdev`)#

定义逻辑网桥 br0。

1
[NetDev]
2
Name=br0
3
Kind=bridge

③ 配置物理网卡 eno1 (`30-eno1.network`)#

将物理网卡 eno1 加入 bond0。

1
[Match]
2
Name=eno1
3

4
[Network]
5
Bond=bond0

④ 配置物理网卡 enp3s0 (`30-enp3s0.network`)#

将物理网卡 enp3s0 加入 bond0。

1
[Match]
2
Name=enp3s0
3

4
[Network]
5
Bond=bond0

⑤ 配置 Bond0 加入网桥 (`40-bond0.network`)#

关键点：这里不要配置 IP 地址，只负责把 bond0 桥接到 br0。IP 将在下一步配置给 br0。

1
[Match]
2
Name=bond0
3

4
[Network]
5
Bridge=br0
6
# 注意：这里不要写 Address 或 DHCP，IP 由 br0 负责

⑥ 配置网桥 IP 地址 (`50-br0.network`)#

这是整个系统的网络出口配置。宿主机和虚拟机都将通过这个接口通信。 (请根据你的实际网络环境修改 IP、网关和 DNS)

1
[Match]
2
Name=br0
3

4
[Network]
5
# --- 选项 A: 使用 DHCP 自动获取 IP (推荐测试用) ---
6
DHCP=yes
7

8
# --- 选项 B: 使用静态 IP (生产环境推荐) ---
9
# 如果要使用静态 IP，请删除上面的 DHCP=yes，并取消下面几行的注释，修改为你的真实 IP
10
# Address=192.168.86.3/24
11
# Gateway=192.168.86.1
12
# DNS=223.5.5.5
13
# DNS=8.8.8.8

4. 应用配置#

保存所有文件后，重启网络服务：

1
sudo systemctl restart systemd-networkd

5. 验证状态#

等待几秒钟，然后运行以下命令检查状态：

检查接口状态：
```
1
ip addr show br0
```
成功标志：br0 应该显示 state UP 和 LOWER_UP，并且有 IP 地址。不再有 NO-CARRIER。
检查 Bond 状态：
```
1
cat /proc/net/bonding/bond0
```
成功标志：能看到 Bonding Mode: IEEE 802.3ad Dynamic link aggregation 且 Slave Interface 列表中的 eno1 和 enp3s0 状态都是 up。
检查桥接成员：
```
1
bridge link
```
成功标志：能看到 bond0 的 master 是 br0。

现在，宿主机和 OpenWrt 虚拟机都将通过 br0 -> bond0 -> 物理网卡 的路径上网，享受链路聚合带来的带宽叠加和高可用性。

主机名#

如果安装引导的主机名你不喜欢又忘记了修改

修改/etc/hosts以及/etc/hostname的内容,重启后即可生效

使用 hostnamectl 将会输出主机名信息

1
hyperbola@Hyperbola-Server:~$ hostnamectl
2
 Static hostname: Hyperbola-Server
3
       Icon name: computer-desktop
4
         Chassis: desktop 🖥️
5
      Machine ID: c3902bd0d425420381eb440b7f83ef8f
6
         Boot ID: 7407b394c16a4e7c9bc041f614ea281d
7
Operating System: Debian GNU/Linux 13 (trixie)
8
          Kernel: Linux 6.12.63+deb13-amd64
9
    Architecture: x86-64
10
 Hardware Vendor: MECHREVO
11
  Hardware Model: IMINI Series
12
Firmware Version: IMINI Series 1.12
13
   Firmware Date: Thu 2025-02-20
14
    Firmware Age: 1y 1w

调整用户配置#

WARNING
注意：该章切换用户前默认为root账户，如果是非root账户请使用sudo su -进行切换为root账户

由于使用root用户进行业务部署并不安全，因此应当手动创建一个用户

删除默认用户（可选）#

部分云厂商（如腾讯云）自带了一个默认用户，出于安全考虑应该删除

可以通过ls /home的方法简单查看当前用户列表

1
root@hyperbola-txy:~# ls /home
2
lighthouse

删除用户

1
sudo deluser --remove-home lighthouse

创建并配置新用户#

1. 创建用户并自动创建主目录#

使用 useradd 命令创建名为 hyperbola 的用户，并通过 -m 选项自动创建其主目录 /home/hyperbola：

1
sudo useradd -m hyperbola

⚠️ 注意：该命令不会为用户设置密码。你需要手动设置密码才能允许登录。

2. 为新用户设置登录密码#

1
sudo passwd hyperbola

系统会提示你输入并确认密码。请设置一个安全的密码。

示例输出：

1
root@hyperbola-txy:~# sudo passwd hyperbola
2
New password:
3
Retype new password:
4
passwd: password updated successfully

验证用户是否创建成功

检查用户信息：

1
id hyperbola
2
uid=1001(hyperbola) gid=1001(hyperbola) groups=1001(hyperbola)

查看 /home 目录，确认主目录已创建：

1
ls /home

你应该能看到 <你的用户名> 目录。

4. 将新用户添加到 `sudo` 组（启用 sudo 权限）#

在大多数基于 Red Hat 的系统（如 CentOS、Fedora）中，wheel 组用于授予管理员权限。在 Debian 系统中，默认使用 sudo 组，但 wheel 也可能存在。

使用 `usermod` 添加到 `sudo` 组#

1
usermod -aG sudo hyperbola

-aG 表示”追加到组”，避免覆盖原有组成员关系。

或者

1
usermod -aG wheel hyperbola

验证组成员身份#

1
groups hyperbola

或：

1
id hyperbola

输出应包含 wheel 或 sudo。

5. 切换到新用户进行测试#

1
su - hyperbola

使用 - 选项可以切换到该用户的完整登录环境（加载 profile 和主目录变量）。

登录后可以通过以下命令确认当前用户：

1
whoami
2
pwd

我的输出为：

1
hyperbola
2
/home/hyperbola

6. 测试 sudo 权限#

切换回 hyperbola 用户后，尝试执行需要管理员权限的命令：

1
sudo ls /root

如果配置正确，输入密码后应能执行命令（或根据系统策略免密执行）。

注意：sudoers文件需要确保系统已配置 wheel 或 sudo 组具有 sudo 权限。（我的腾讯云需修改sudoers文件）

通常 /etc/sudoers 文件中已有如下行（不要手动编辑，除非使用 visudo）：
1
%wheel  ALL=(ALL) ALL
或
1
%sudo   ALL=(ALL) ALL

停用ssh密码登录#

为安全考虑建议关闭ssh密码登录，改为ssh密钥登录

1
sudo vim /etc/ssh/sshd_config

1
# 禁用密码认证
2
PasswordAuthentication no
3

4
# 禁用交互式密码认证（如 PAM）
5
ChallengeResponseAuthentication no
6

7
# 确保 Pubkey 认证开启
8
PubkeyAuthentication yes
9

10
# 强烈建议：禁用 root 密码登录
11
PermitRootLogin prohibit-password

环境部署#

Clash Verge Rev#

1
wget https://github.com/clash-verge-rev/clash-verge-rev/releases/download/v2.4.6/Clash.Verge_2.4.6_amd64.deb

zsh终端环境#

我比较习惯使用zsh，因此以zsh为例进行演示

安装zsh、oh-my-zsh与starship#

1
sudo apt install zsh git curl wget thefuck starship
2
sh -c "$(wget -O- https://install.ohmyz.sh/)"

提示符由 starship 提供，因此不再需要 powerlevel10k。

安装并启用常用插件（按需保留部分）：

1
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
2
git clone https://github.com/zdharma-continuum/fast-syntax-highlighting.git \
3
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/fast-syntax-highlighting

设置默认终端为 zsh（注意：不要使用 sudo）。

1
chsh -s /bin/zsh

提示输入的密码为用户密码而非root密码

配置 .zshrc#

仅保留部分插件，并去掉 p10k 相关配置，由 starship 接管提示符：

1
export ZSH="$HOME/.oh-my-zsh"
2

3
plugins=(fast-syntax-highlighting extract zsh-autosuggestions)
4

5
source $ZSH/oh-my-zsh.sh
6

7
# starship 提示符
8
eval "$(starship init zsh)"

配置 starship#

创建 ~/.config/starship.toml：

1
add_newline = true
2
command_timeout = 200
3
format = "$hostname [$directory$git_branch$git_status]($style)$character"
4

5
[hostname]
6
ssh_only = true
7
format = "[$hostname]($style) "
8

9
[character]
10
error_symbol = "[✗](bold cyan)"
11
success_symbol = "[❯](bold cyan)"
12

13
[directory]
14
truncation_length = 2
15
truncation_symbol = "…/"
16
repo_root_style = "bold cyan"
17
repo_root_format = "[$repo_root]($repo_root_style)[$path]($style)[$read_only]($read_only_style) "
18

19
[git_branch]
20
format = "[$branch]($style) "
21
style = "italic cyan"
22

23
[git_status]
24
format     = '[$all_status]($style)'
25
style      = "cyan"
26
ahead      = "⇡${count} "
27
diverged   = "⇕⇡${ahead_count}⇣${behind_count} "
28
behind     = "⇣${count} "
29
conflicted = " "
30
up_to_date = " "
31
untracked  = "? "
32
modified   = " "
33
stashed    = ""
34
staged     = ""
35
renamed    = ""
36
deleted    = ""

保存后重新打开终端即可生效。

同步点文件#

安装同步工具chezmoi

1
wget https://github.com/twpayne/chezmoi/releases/download/v2.69.4/chezmoi_2.69.4_linux_amd64.deb
2
sudo apt install ./chezmoi_2.69.4_linux_amd64.deb
3
chezmoi init --apply git@github.com:Hyperbola-QAQ/dotfiles.git

git@github.com/dotfiles.git 为我的点文件同步私有仓库

开启ZRAM#

1
sudo apt update sudo apt install zram-tools
2
sudoedit /etc/default/zramswap

修改占比为30%

一些常用的软件的安装#

1
sudo apt install btop tmux byobu starship kitty ripgrep eza nginx bat

deb.griffo.io 仓库#

deb.griffo.io 提供了大量通用工具的最新打包，如 zig、ghostty、lazygit、helix、forgejo 等，推荐直接通过 APT 安装。

添加仓库（Debian 13 代号为 trixie）：

1
sudo install -d -m 0755 /etc/apt/keyrings
2
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
3

4
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt trixie main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
5

6
sudo apt update

NOTE
若使用 $(lsb_release -sc) 自动获取代号，在 Debian 13 上会输出 trixie，与上方的 trixie 一致。

安装通用工具：

1
sudo apt install zig ghostty lazygit yazi viu eza uv fzf zoxide bun tigerbeetle deno forgejo forgejo-runner helix jujutsu zellij starship atuin k9s headscale garage just nushell duckdb herdr

uv miniforge#

1
curl -LsSf https://astral.sh/uv/install.sh | sh
2
uv tool install jupyterlab
3
uv tool install nb-cli
4
uv tool install ty
5
uv tool install ruff
6
wget https://github.com/conda-forge/miniforge/releases/download/26.1.0-0/Miniforge3-26.1.0-0-Linux-x86_64.sh | sh

yazi rust#

1
sudo apt install ffmpeg 7zip jq poppler-utils fd-find ripgrep fzf zoxide imagemagick
2
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
3
rustup update
4
cargo install --force yazi-build

mise#

1
sudo apt update -y && sudo apt install -y curl
2
sudo install -dm 755 /etc/apt/keyrings
3
curl -fSs https://mise.jdx.dev/gpg-key.pub | sudo tee /etc/apt/keyrings/mise-archive-keyring.asc 1> /dev/null
4
echo "deb [signed-by=/etc/apt/keyrings/mise-archive-keyring.asc] https://mise.jdx.dev/deb stable main" | sudo tee /etc/apt/sources.list.d/mise.list
5
sudo apt update -y
6
sudo apt install -y mise

ddns-go#

下载最新版并安装到 /usr/local/bin/：

1
wget https://github.com/jeessy2/ddns-go/releases/download/v6.17.5/ddns-go_6.17.5_linux_x86_64.tar.gz
2
x ./ddns-go_6.17.5_linux_x86_64.tar.gz
3
sudo mv ./ddns-go /usr/local/bin/
4
sudo ddns-go -s install

sudo ddns-go -s install 会自动创建 systemd 服务（/etc/systemd/system/ddns-go.service）并设置为开机自启，生成的服务文件内容如下：

1
[Unit]
2
Description=Simple and easy to use DDNS. Automatically update domain name resolution to public IP (Support Aliyun, Tencent Cloud, Dnspod, Cloudflare, Callback, Huawei Cloud, Baidu Cloud, Porkbun, GoDaddy...)
3
ConditionFileIsExecutable=/usr/local/bin/ddns-go
4
Requires=network.target
5
After=network-online.target
6

7
[Service]
8
StartLimitInterval=5
9
StartLimitBurst=10
10
ExecStart=/usr/local/bin/ddns-go "-l" ":9876" "-f" "300" "-cacheTimes" "5" "-c" "/etc/ddns-go/config.yaml"
11
Restart=always
12
RestartSec=120
13
EnvironmentFile=-/etc/sysconfig/ddns-go
14

15
[Install]
16
WantedBy=multi-user.target

创建配置目录并重启服务：

1
sudo mkdir /etc/ddns-go
2
sudo systemctl daemon-reload
3
sudo systemctl restart ddns-go.service

NOTE
默认监听 :9876，打开浏览器访问 http://<服务器IP>:9876 即可进入 Web 界面配置 DDNS 账户与域名。

Jenkins#

1
sudo wget -O /etc/apt/keyrings/jenkins-keyring.asc \
2
  https://pkg.jenkins.io/debian/jenkins.io-2026.key
3
echo "deb [signed-by=/etc/apt/keyrings/jenkins-keyring.asc]" \
4
  https://pkg.jenkins.io/debian binary/ | sudo tee \
5
  /etc/apt/sources.list.d/jenkins.list > /dev/null
6
sudo apt update
7
sudo apt install jenkins

Docker#

步骤 1：更新系统软件包

1
sudo apt update
2
sudo apt upgrade -y

步骤 2：安装必要的依赖

安装 Docker 需要一些依赖项。运行以下命令安装它们：

1
sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

步骤 3：添加 Docker 官方 GPG 密钥

为了验证 Docker 软件包的真实性，您需要添加 Docker 的官方 GPG 密钥。由于网络原因，直接从 Docker 官方获取可能不稳定，我们可以尝试通过 keyrings.debian.org 或者 keyserver.ubuntu.com 获取，或者直接下载。这里我们尝试先通过 curl 方式：

1
sudo install -m 0755 -d /etc/apt/keyrings
2
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
3
sudo chmod a+r /etc/apt/keyrings/docker.gpg

如果 curl 命令失败，可以尝试手动下载 GPG 密钥并放置到 /etc/apt/keyrings/ 目录下。

步骤 4：添加 Docker APT 仓库

接下来，您需要添加 Docker 的 APT 仓库。为了在中国大陆获得更好的下载速度，我们可以考虑使用国内的镜像源。

选项 A：使用 Docker 官方仓库（如果网络状况良好）

1
echo \
2
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
3
 "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
4
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

选项 B：使用国内镜像源（推荐，例如阿里云）

首先，您可能需要将官方仓库注释掉或删除。然后添加国内镜像源的配置。请注意，不同镜像源提供的仓库地址可能有所不同，这里以阿里云为例。请替换为您 Debian 版本的代号（例如 bookworm）。

1
# 首先移除或注释掉之前的docker.list文件，如果存在的话
2
# sudo rm /etc/apt/sources.list.d/docker.list
3

4
# 添加阿里云镜像源
5
# 请将 "$(lsb_release -cs)" 替换为您的 Debian 版本代号，例如 bookworm
6
echo \
7
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/debian \
8
 "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
9
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

请注意，阿里云等国内镜像站通常会同步 Docker 官方的 GPG 密钥，因此步骤 3 的密钥添加仍然是必需的。

步骤 5：安装 Docker 引擎

更新 APT 软件包索引，然后安装 Docker Engine、Containerd 和 Docker Compose。

1
sudo apt update
2
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

步骤 6：验证 Docker 安装

安装完成后，您可以运行一个简单的 hello-world 容器来验证 Docker 是否正确安装并运行：

1
sudo docker run hello-world

如果一切正常，您应该会看到一条消息，表明您的安装工作正常。

步骤 7：配置非 root 用户使用 Docker (可选但推荐)

默认情况下，运行 docker 命令需要 sudo 权限。如果您想让非 root 用户也能运行 Docker 命令，可以将该用户添加到 docker 组中：

1
sudo usermod -aG docker $USER

然后，您需要退出并重新登录，或者运行 newgrp docker 命令使更改生效。

1
newgrp docker

之后，您就可以不带 sudo 运行 docker 命令了。

步骤 8：配置 Docker 镜像加速器 (可选但推荐)

在中国大陆使用 Docker 时，从 Docker Hub 下载镜像可能会很慢。配置镜像加速器可以显著提高下载速度。您可以选择阿里云、腾讯云等提供的免费镜像加速服务。

登录您的云服务商控制台（例如阿里云），找到容器镜像服务，通常会有提供一个专属的镜像加速器地址。
编辑 Docker 的配置文件 /etc/docker/daemon.json。如果文件不存在，则创建它。
```
1
sudo nano /etc/docker/daemon.json
```
添加以下内容，将 YOUR_MIRROR_ACCELERATOR 替换为您获取到的镜像加速器地址。
```
1
{
2
  "registry-mirrors": ["https://YOUR_MIRROR_ACCELERATOR"]
3
}
```
例如，使用阿里云的公共加速器（请替换为您的专属加速器地址）：
```
1
{
2
  "registry-mirrors": ["https://<您的ID>.mirror.aliyuncs.com"]
3
}
```
或者尝试一些通用的公共加速器，但稳定性可能不如专属加速器：
```
1
{
2
  "registry-mirrors": ["https://hub-mirror.c.163.com", "https://mirror.baidubce.com"]
3
}
```
保存并关闭文件 (Ctrl+X, Y, Enter)。

重启 Docker 服务以使配置生效：

1
sudo systemctl daemon-reload
2
sudo systemctl restart docker

至此，您应该已经成功在 Debian 13 上安装并配置了 Docker，并且针对中国大陆的网络环境进行了优化。

acme.sh自动签发HTTPS#

参考配置Nginx

虚拟机部署#

检查并创建 libvirt 网络#

创建网络定义文件#

在终端运行以下命令（直接复制粘贴即可）：

1
cat > /tmp/br0-bond.xml <<EOF
2
<network>
3
  <name>br0-bond</name>
4
  <forward mode="bridge"/>
5
  <bridge name="br0"/>
6
</network>
7
EOF

定义并启动该网络#

依次运行以下三条命令：

1
# 1. 将 XML 定义导入 libvirt
2
sudo virsh net-define /tmp/br0-bond.xml
3

4
# 2. 启动该网络
5
sudo virsh net-start br0-bond
6

7
# 3. 设置开机自启（可选，但推荐）
8
sudo virsh net-autostart br0-bond

验证网络是否存在：#

运行以下命令，你应该能在列表中看到 br0-bond 且状态为 active：

1
sudo virsh net-list --all

1
Name         State      Autostart   Persistent
2
------------------------------------------------
3
br0-bond     active     yes         yes
4
default      active     yes         yes

确认主机网桥 `br0` 已就绪#

libvirt 的网络只是逻辑定义，它依赖于主机上真实存在的网桥接口 br0。

运行以下命令检查主机是否有 br0：

1
ip addr show br0

如果有输出（显示 IP 地址等信息）：说明主机网络配置正确，可以直接进行第三步。
如果报错 Device "br0" does not exist：说明你还没有在 Debian 主机上配置好网桥。你需要先配置主机的 /etc/network/interfaces 或使用 NetworkManager 创建 br0 并绑定到你的物理网卡（或 bond0），然后重启网络服务。虚拟机无法连接到一个不存在的宿主网桥。

创建 KVM 虚拟机#

一旦 br0 状态正常（UP），你就可以重新运行之前的 virt-install 命令了。 libvirt 定义的 br0-bond 网络（桥接宿主机的 br0）将能正常工作。

1
wget https://fw20.koolcenter.com/iStoreOS/x86_64_efi/istoreos-24.10.5-2025123110-x86-64-squashfs-combined-efi.img.gz
2

3
x ./istoreos-24.10.5-2025123110-x86-64-squashfs-combined-efi.img.gz
4

5
qemu-img convert -f raw -O qcow2 istoreos-24.10.5-2025123110-x86-64-squashfs-combined-efi.img openwrt.qcow2
6

7
sudo mkdir /var/lib/libvirt/images/openwrt
8

9
sudo mv openwrt.qcow2 /var/lib/libvirt/images/openwrt/
10

11
# 启动安装
12
sudo virt-install \
13
  --name openwrt \
14
  --ram 512 \
15
  --vcpus 1 \
16
  --disk path=/var/lib/libvirt/images/openwrt/openwrt.qcow2,format=qcow2,bus=virtio \
17
  --import \
18
  --network network=br0-bond,model=virtio \
19
  --boot uefi \
20
  --os-variant generic \
21
  --graphics none \
22
  --console pty,target_type=serial

其他#

如果出现usermod无法找到的情况将下面的添加进./.zshrc

1
export PATH="/usr/local/sbin:/usr/sbin:/sbin:$PATH"

结尾#

到此基础环境就搭建完成了

接下来需要开发环境、生产环境等环境的部署

如果这篇文章对你有帮助，欢迎分享给更多人！

Debian13 环境配置

https://hyperbola.cc/posts/tech/linux-ops/debian13-环境配置/

作者

Hyperbola

发布于

2026-02-27

许可协议

CC BY-NC-SA 4.0

部分信息可能已经过时

一次"169.254"引发的网络排障实录

Python项目开发进阶指南：环境管理、工具链与实战案例

わたしの部屋

写在开头#

废话#

Debian12升级Debian13参考链接#

升级成功标志#

调整root下的一些配置#

软件源配置（apt源）#

网络相关#

systemd-networkd 实现 Bond + Bridge#

1. 准备工作：禁用 NetworkManager#

2. 清理旧配置#

3. 创建配置文件#

① 定义 Bond 设备 (10-bond0.netdev)#

② 定义 Bridge 设备 (20-br0.netdev)#

③ 配置物理网卡 eno1 (30-eno1.network)#

④ 配置物理网卡 enp3s0 (30-enp3s0.network)#

⑤ 配置 Bond0 加入网桥 (40-bond0.network)#

⑥ 配置网桥 IP 地址 (50-br0.network)#

4. 应用配置#

5. 验证状态#

主机名#

调整用户配置#

删除默认用户（可选）#

创建并配置新用户#

1. 创建用户并自动创建主目录#

2. 为新用户设置登录密码#

4. 将新用户添加到 sudo 组（启用 sudo 权限）#

使用 usermod 添加到 sudo 组#

验证组成员身份#

5. 切换到新用户进行测试#

6. 测试 sudo 权限#

停用ssh密码登录#

环境部署#

Clash Verge Rev#

zsh终端环境#

安装zsh、oh-my-zsh与starship#

配置 .zshrc#

配置 starship#

同步点文件#

开启ZRAM#

一些常用的软件的安装#

deb.griffo.io 仓库#

uv miniforge#

yazi rust#

mise#

ddns-go#

Jenkins#

Docker#

acme.sh自动签发HTTPS#

虚拟机部署#

检查并创建 libvirt 网络#

创建网络定义文件#

定义并启动该网络#

验证网络是否存在：#

确认主机网桥 br0 已就绪#

创建 KVM 虚拟机#

其他#

结尾#

目录

① 定义 Bond 设备 (`10-bond0.netdev`)#

② 定义 Bridge 设备 (`20-br0.netdev`)#

③ 配置物理网卡 eno1 (`30-eno1.network`)#

④ 配置物理网卡 enp3s0 (`30-enp3s0.network`)#

⑤ 配置 Bond0 加入网桥 (`40-bond0.network`)#

⑥ 配置网桥 IP 地址 (`50-br0.network`)#

4. 将新用户添加到 `sudo` 组（启用 sudo 权限）#

使用 `usermod` 添加到 `sudo` 组#

确认主机网桥 `br0` 已就绪#