废话#

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

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

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

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

软件源配置（apt源）#

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

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

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

备份并删除旧文件：

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

更新源：

sudo apt update

方案二：使用传统格式

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

备份并删除新版文件：

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

更新源：

sudo apt update

网络相关#

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

sudo systemctl stop NetworkManager
sudo systemctl disable NetworkManager
sudo systemctl enable --now systemd-networkd

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

[NetDev]
Name=bond0
Kind=bond

[Bond]
Mode=802.3ad
TransmitHashPolicy=layer3+4
MIIMonitorSec=100ms
LACPTransmitRate=fast
MinLinks=1

[NetDev]
Name=br0
Kind=bridge

[Match]
Name=eno1

[Network]
Bond=bond0

[Match]
Name=enp3s0

[Network]
Bond=bond0

[Match]
Name=bond0

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

[Match]
Name=br0

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

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

sudo systemctl restart systemd-networkd

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

删除默认用户（可选）#

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

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

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

删除用户

sudo deluser --remove-home lighthouse

创建并配置新用户#

sudo useradd -m hyperbola

sudo passwd hyperbola

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

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

ls /home

usermod -aG sudo hyperbola

usermod -aG wheel hyperbola

groups hyperbola

id hyperbola

su - hyperbola

whoami
pwd

hyperbola
/home/hyperbola

sudo ls /root

停用ssh密码登录#

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

sudo vim /etc/ssh/sshd_config

# 禁用密码认证
PasswordAuthentication no

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

# 确保 Pubkey 认证开启
PubkeyAuthentication yes

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

Clash Verge Rev#

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为例进行演示

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

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

chsh -s /bin/zsh

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

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

source $ZSH/oh-my-zsh.sh

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

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

[hostname]
ssh_only = true
format = "[$hostname]($style) "

[character]
error_symbol = "[✗](bold cyan)"
success_symbol = "[❯](bold cyan)"

[directory]
truncation_length = 2
truncation_symbol = "…/"
repo_root_style = "bold cyan"
repo_root_format = "[$repo_root]($repo_root_style)[$path]($style)[$read_only]($read_only_style) "

[git_branch]
format = "[$branch]($style) "
style = "italic cyan"

[git_status]
format     = '[$all_status]($style)'
style      = "cyan"
ahead      = "⇡${count} "
diverged   = "⇕⇡${ahead_count}⇣${behind_count} "
behind     = "⇣${count} "
conflicted = " "
up_to_date = " "
untracked  = "? "
modified   = " "
stashed    = ""
staged     = ""
renamed    = ""
deleted    = ""

同步点文件#

安装同步工具chezmoi

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

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

开启ZRAM#

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

修改占比为30%

一些常用的软件的安装#

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

uv miniforge#

curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install jupyterlab
uv tool install nb-cli 
uv tool install ty
uv tool install ruff
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#

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

mise#

sudo apt update -y && sudo apt install -y curl
sudo install -dm 755 /etc/apt/keyrings
curl -fSs https://mise.jdx.dev/gpg-key.pub | sudo tee /etc/apt/keyrings/mise-archive-keyring.asc 1> /dev/null
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
sudo apt update -y
sudo apt install -y mise

ddns-go#

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

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

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

[Unit]
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...)
ConditionFileIsExecutable=/usr/local/bin/ddns-go
Requires=network.target
After=network-online.target

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

[Install]
WantedBy=multi-user.target

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

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

Jenkins#

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

Docker#

步骤 1：更新系统软件包

sudo apt update
sudo apt upgrade -y

步骤 2：安装必要的依赖

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

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 方式：

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

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

步骤 4：添加 Docker APT 仓库

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

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

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

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

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

# 首先移除或注释掉之前的docker.list文件，如果存在的话
# sudo rm /etc/apt/sources.list.d/docker.list
 
# 添加阿里云镜像源
# 请将 "$(lsb_release -cs)" 替换为您的 Debian 版本代号，例如 bookworm
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://mirrors.aliyun.com/docker-ce/linux/debian \
 "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

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

步骤 5：安装 Docker 引擎

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

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

步骤 6：验证 Docker 安装

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

sudo docker run hello-world

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

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

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

sudo usermod -aG docker $USER

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

newgrp docker

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

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

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

1. 登录您的云服务商控制台（例如阿里云），找到容器镜像服务，通常会有提供一个专属的镜像加速器地址。

2. 编辑 Docker 的配置文件 /etc/docker/daemon.json。如果文件不存在，则创建它。

   sudo nano /etc/docker/daemon.json

3. 添加以下内容，将 YOUR_MIRROR_ACCELERATOR 替换为您获取到的镜像加速器地址。

   {
     "registry-mirrors": ["https://YOUR_MIRROR_ACCELERATOR"]
   }

   例如，使用阿里云的公共加速器（请替换为您的专属加速器地址）：

   {
     "registry-mirrors": ["https://<您的ID>.mirror.aliyuncs.com"]
   }

   或者尝试一些通用的公共加速器，但稳定性可能不如专属加速器：

   {
     "registry-mirrors": ["https://hub-mirror.c.163.com", "https://mirror.baidubce.com"]
   }

4. 保存并关闭文件 (Ctrl+X, Y, Enter)。

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

   sudo systemctl daemon-reload
   sudo systemctl restart docker

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

acme.sh自动签发HTTPS#

参考配置Nginx

检查并创建 libvirt 网络#

cat > /tmp/br0-bond.xml <<EOF
<network>
  <name>br0-bond</name>
  <forward mode="bridge"/>
  <bridge name="br0"/>
</network>
EOF

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

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

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

sudo virsh net-list --all

Name         State      Autostart   Persistent
------------------------------------------------
br0-bond     active     yes         yes
default      active     yes         yes

确认主机网桥 br0 已就绪#

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

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

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）将能正常工作。

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

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

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

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

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

# 启动安装
sudo virt-install \
  --name openwrt \
  --ram 512 \
  --vcpus 1 \
  --disk path=/var/lib/libvirt/images/openwrt/openwrt.qcow2,format=qcow2,bus=virtio \
  --import \
  --network network=br0-bond,model=virtio \
  --boot uefi \
  --os-variant generic \
  --graphics none \
  --console pty,target_type=serial