Debian 使用避坑指南｜附源码

Debian 是许多服务器、开发环境、容器镜像的基础发行版，以稳定、安全、社区成熟著称。无论你是用 Debian 搭建个人服务器、部署 Web 服务、配置开发环境，还是作为 Linux 学习系统，Debian 都是一个非常值得长期使用的选择。

不过，Debian 的“稳定”也意味着它在软件版本、仓库策略、系统默认配置等方面相对保守。很多初学者刚上手 Debian 时，容易踩到一些坑：软件源慢、软件版本旧、权限配置混乱、网络服务启动失败、中文环境异常、系统升级出问题等。

本文将结合实际使用经验，整理一份 Debian 使用避坑指南，并附上常用配置与脚本源码，帮助你更顺畅地使用 Debian。

一、安装 Debian 前需要注意什么？

1. 尽量选择稳定版 Stable

Debian 常见分支包括：

如果你是新手，或者准备用 Debian 搭建服务器，建议优先选择：

Debian Stable

不要一开始就使用 Testing 或 Sid，否则遇到依赖冲突、包升级异常时排查成本会比较高。

2. 镜像文件要选对

Debian 官方提供多种安装镜像，例如：

• netinst 网络安装镜像
• DVD 完整镜像
• live 镜像
• cloud 镜像

如果你网络稳定，推荐使用：

debian-xx.x.x-amd64-netinst.iso

netinst 镜像体积小，安装时从网络下载软件包，适合大多数场景。

如果你在离线环境安装，建议选择 DVD 镜像，否则安装过程中可能缺少软件包。

3. 注意网卡驱动问题

部分无线网卡、较新的有线网卡可能需要非自由固件。Debian 12 开始，官方安装镜像已经更好地集成了 non-free firmware，但老版本 Debian 可能安装后没有网络。

如果安装后发现没有网络，可以先检查网卡：

ip a
lspci | grep -i network
lspci | grep -i ethernet

查看系统日志：

dmesg | grep -i firmware

如果看到缺少 firmware 相关提示，就需要安装对应固件包，例如：

sudo apt install firmware-linux firmware-realtek firmware-iwlwifi

二、软件源配置避坑

1. 安装后第一件事：更换软件源

Debian 默认源在国内访问可能较慢，建议更换为国内镜像源，例如清华源、阿里云源、中科大源等。

以 Debian 12 Bookworm 为例，备份原配置：

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

编辑软件源：

sudo nano /etc/apt/sources.list

推荐配置如下：

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian-security bookworm-security main contrib non-free non-free-firmware

更新索引：

sudo apt update

注意：Debian 12 开始将 non-free-firmware 单独拆分出来，如果你需要显卡、网卡、无线网卡固件，不要漏掉它。

2. 不要随便混用 Ubuntu PPA

很多新手在 Debian 上看到某些教程直接添加 Ubuntu PPA，例如：

sudo add-apt-repository ppa:xxx/xxx

这在 Debian 上是非常容易出问题的。

Ubuntu 虽然基于 Debian，但二者的软件包依赖、版本策略、库文件版本并不完全一致。混用 Ubuntu PPA 可能导致：

• apt 依赖冲突
• 系统关键库被替换
• 桌面环境异常
• 软件无法卸载
• 系统升级失败

如果 Debian 官方源没有某个软件，建议优先考虑：

1. Debian Backports
2. 官方 .deb 包
3. Flatpak
4. AppImage
5. Docker
6. 源码编译

3. 合理使用 Backports

Debian Stable 软件版本偏旧，但官方提供了 Backports 仓库，用于安装较新版本的软件。

添加 Backports：

deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware

更新：

sudo apt update

从 Backports 安装软件：

sudo apt install -t bookworm-backports 软件包名

例如安装较新内核：

sudo apt install -t bookworm-backports linux-image-amd64

避坑重点：

不要把 Backports 当成默认源全部升级，只在需要时指定安装。

三、APT 使用避坑

1. apt update 和 apt upgrade 的区别

很多人容易混淆这两个命令：

sudo apt update

表示更新软件包索引，不会真正升级软件。

sudo apt upgrade

表示升级已安装软件包。

通常推荐：

sudo apt update
sudo apt upgrade

如果涉及内核、依赖变更，有时需要：

sudo apt full-upgrade

但 full-upgrade 可能会删除某些包，执行前一定要看清楚提示。

2. 不要盲目复制 rm 命令

Linux 教程中经常出现危险命令，例如：

sudo rm -rf /某个目录

如果路径写错，可能直接删系统。尤其是下面这种命令非常危险：

sudo rm -rf /*
sudo rm -rf / var/log
sudo rm -rf $HOME/*

建议写脚本时加入变量检查。例如：

#!/bin/bash

TARGET_DIR="/tmp/test-cache"

if [ -z "$TARGET_DIR" ]; then
  echo "TARGET_DIR 为空，拒绝执行"
  exit 1
fi

if [ "$TARGET_DIR" = "/" ]; then
  echo "目标目录为根目录，拒绝执行"
  exit 1
fi

rm -rf "$TARGET_DIR"
echo "已清理：$TARGET_DIR"

3. 遇到 apt 锁不要强删

如果执行 apt 时看到：

Could not get lock /var/lib/dpkg/lock-frontend

不要第一时间删除 lock 文件。多数情况下是系统正在自动更新或另一个 apt 进程正在运行。

先查看进程：

ps aux | grep apt
ps aux | grep dpkg

等待进程结束。如果确认卡死，再谨慎处理：

sudo kill -9 进程ID
sudo dpkg --configure -a
sudo apt -f install

四、用户权限与 sudo 避坑

1. Debian 默认可能没有 sudo

有些 Debian 安装方式中，如果你设置了 root 密码，普通用户默认可能没有 sudo 权限。

切换 root：

su -

安装 sudo：

apt install sudo

把用户加入 sudo 组：

usermod -aG sudo 用户名

退出重新登录后验证：

sudo whoami

如果输出：

root

说明配置成功。

2. 不要长期使用 root 登录

服务器上建议禁用 root SSH 登录，使用普通用户加 sudo 管理。

编辑 SSH 配置：

sudo nano /etc/ssh/sshd_config

修改：

PermitRootLogin no
PasswordAuthentication no

重启 SSH：

sudo systemctl restart ssh

注意：禁用密码登录前，一定要确认 SSH 密钥登录已经配置成功，否则可能把自己锁在服务器外面。

五、网络配置避坑

1. Debian 网络管理方式可能不一样

Debian 服务器版常见网络配置工具有：

• ifupdown
• systemd-networkd
• NetworkManager

桌面版通常使用 NetworkManager，服务器版可能使用 /etc/network/interfaces。

查看网络服务：

systemctl status NetworkManager
systemctl status systemd-networkd

查看 IP：

ip addr
ip route

2. 配置静态 IP 示例

如果你的系统使用 /etc/network/interfaces，可以这样配置：

sudo nano /etc/network/interfaces

示例源码：

auto enp0s3
iface enp0s3 inet static
    address 192.168.1.100
    netmask 255.255.255.0
    gateway 192.168.1.1
    dns-nameservers 223.5.5.5 8.8.8.8

重启网络：

sudo systemctl restart networking

如果使用 NetworkManager，建议用 nmcli：

nmcli connection show

设置静态 IP：

sudo nmcli connection modify "连接名称" \
ipv4.addresses 192.168.1.100/24 \
ipv4.gateway 192.168.1.1 \
ipv4.dns "223.5.5.5 8.8.8.8" \
ipv4.method manual

重启连接：

sudo nmcli connection down "连接名称"
sudo nmcli connection up "连接名称"

六、时间、时区与中文环境避坑

1. 设置时区

服务器时间不对会导致日志混乱、证书校验失败、定时任务异常。

查看时间：

timedatectl

设置上海时区：

sudo timedatectl set-timezone Asia/Shanghai

开启 NTP：

sudo timedatectl set-ntp true

2. 配置中文 Locale

如果终端中文乱码，可能是 locale 未配置。

安装 locale：

sudo apt install locales

配置：

sudo dpkg-reconfigure locales

建议选择：

en_US.UTF-8
zh_CN.UTF-8

设置默认：

sudo update-locale LANG=zh_CN.UTF-8

重新登录后查看：

locale

七、服务管理避坑

Debian 使用 systemd 管理服务。常用命令如下：

sudo systemctl start nginx
sudo systemctl stop nginx
sudo systemctl restart nginx
sudo systemctl reload nginx
sudo systemctl enable nginx
sudo systemctl disable nginx
sudo systemctl status nginx

1. restart 和 reload 的区别

• restart：重启服务，可能中断连接
• reload：重新加载配置，通常不中断服务

例如 Nginx 修改配置后，建议先测试：

sudo nginx -t

再平滑加载：

sudo systemctl reload nginx

2. 查看服务日志

服务启动失败时，不要只看 status，还要看日志：

journalctl -u nginx

查看最近日志：

journalctl -u nginx -n 100

实时查看：

journalctl -u nginx -f

八、防火墙与安全避坑

1. Debian 默认防火墙可能未启用

很多人以为 Linux 默认安全，但如果服务暴露在公网，仍然需要防火墙。

安装 UFW：

sudo apt install ufw

允许 SSH：

sudo ufw allow OpenSSH

允许 HTTP/HTTPS：

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

启用防火墙：

sudo ufw enable

查看状态：

sudo ufw status verbose

远程服务器启用防火墙前，必须先允许 SSH 端口，否则可能断开后无法登录。

2. 修改 SSH 默认端口需谨慎

有些人喜欢把 SSH 从 22 改成其他端口，例如 2222。修改后别忘了同步防火墙规则。

编辑：

sudo nano /etc/ssh/sshd_config

修改：

Port 2222

防火墙放行：

sudo ufw allow 2222/tcp

重启 SSH：

sudo systemctl restart ssh

测试新端口：

ssh -p 2222 user@server_ip

确认没问题后再关闭 22 端口。

九、磁盘与文件系统避坑

1. 查看磁盘空间

常用命令：

df -h
du -sh *
lsblk

查看某目录占用：

sudo du -h --max-depth=1 /var | sort -h

很多服务器磁盘满，常见原因是：

• Docker 日志过大
• Nginx/Apache 日志过大
• apt 缓存过多
• journal 日志过大
• 数据库文件暴涨

2. 清理 apt 缓存

sudo apt clean
sudo apt autoremove

3. 限制 systemd 日志大小

编辑配置：

sudo nano /etc/systemd/journald.conf

加入或修改：

SystemMaxUse=500M
RuntimeMaxUse=200M
MaxRetentionSec=7day

重启：

sudo systemctl restart systemd-journald

十、Docker 使用避坑

Debian 上安装 Docker，不建议直接使用系统里较旧的包，推荐使用 Docker 官方源。

安装依赖：

sudo apt update
sudo apt install ca-certificates curl gnupg

添加 GPG key：

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

添加源：

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

安装 Docker：

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

启动：

sudo systemctl enable --now docker

把用户加入 docker 组：

sudo usermod -aG docker $USER

重新登录后测试：

docker version
docker compose version

注意：加入 docker 组等同于赋予较高权限，不建议给不可信用户加入 docker 组。

十一、常用初始化脚本源码

下面提供一个适用于 Debian 12 的基础初始化脚本，可用于新服务器初始化。使用前请根据实际情况修改用户名、SSH 端口和软件源。

init-debian.sh

#!/usr/bin/env bash

set -e

USERNAME="debian"
SSH_PORT="22"
TIMEZONE="Asia/Shanghai"

echo "====== Debian 初始化脚本开始 ======"

if [ "$(id -u)" -ne 0 ]; then
  echo "请使用 root 用户执行该脚本"
  exit 1
fi

echo "1. 更新软件源"
cp /etc/apt/sources.list /etc/apt/sources.list.bak.$(date +%F-%H%M%S)

cat > /etc/apt/sources.list </dev/null 2>&1; then
  echo "用户 $USERNAME 已存在，跳过创建"
else
  adduser "$USERNAME"
fi

usermod -aG sudo "$USERNAME"

echo "6. 配置 SSH"
cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak.$(date +%F-%H%M%S)

sed -i "s/^#Port .*/Port $SSH_PORT/" /etc/ssh/sshd_config
sed -i "s/^Port .*/Port $SSH_PORT/" /etc/ssh/sshd_config
sed -i "s/^#PermitRootLogin .*/PermitRootLogin no/" /etc/ssh/sshd_config
sed -i "s/^PermitRootLogin .*/PermitRootLogin no/" /etc/ssh/sshd_config

systemctl restart ssh

echo "7. 配置防火墙"
ufw allow "$SSH_PORT/tcp"
ufw --force enable

echo "8. 升级系统"
apt upgrade -y
apt autoremove -y
apt clean

echo "====== Debian 初始化完成 ======"
echo "请确认新用户可以登录后，再关闭当前 root 会话"

使用方式：

chmod +x init-debian.sh
sudo ./init-debian.sh

十二、桌面环境使用避坑

如果你使用 Debian 桌面版，还需要注意以下问题。

1. 显卡驱动

NVIDIA 用户如果需要闭源驱动，可以安装：

sudo apt install nvidia-driver

安装前建议确认显卡：

lspci | grep -i nvidia

如果是较新的显卡，可能需要 Backports 中的新内核或新驱动。

2. 字体渲染

安装常用中文字体：

sudo apt install fonts-noto-cjk fonts-wqy-microhei fonts-wqy-zenhei

刷新字体缓存：

fc-cache -fv

3. 输入法

常用中文输入法框架包括 Fcitx5 和 IBus。推荐 Fcitx5：

sudo apt install fcitx5 fcitx5-chinese-addons fcitx5-config-qt

设置环境变量：

nano ~/.profile

加入：

export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx
export XMODIFIERS=@im=fcitx

重新登录后，在桌面环境中配置输入法。

十三、系统升级避坑

Debian 大版本升级前一定要谨慎。比如从 Debian 11 升级到 Debian 12，建议按以下步骤：

1. 备份数据

至少备份：

/home
/etc
/var/www
数据库数据
Docker volume
重要配置文件

可使用 rsync：

rsync -avh /etc /backup/etc-backup
rsync -avh /home /backup/home-backup

2. 确认当前系统状态健康

sudo apt update
sudo apt upgrade
sudo apt autoremove
sudo dpkg --audit

如果 dpkg --audit 有异常，先修复再升级。

3. 修改 sources.list

例如从 bullseye 升级到 bookworm：

sudo sed -i 's/bullseye/bookworm/g' /etc/apt/sources.list

然后：

sudo apt update
sudo apt upgrade --without-new-pkgs
sudo apt full-upgrade

升级后重启：

sudo reboot

十四、常见问题排查清单

1. 软件安装失败

执行：

sudo apt update
sudo apt -f install
sudo dpkg --configure -a

2. 服务启动失败

执行：

systemctl status 服务名
journalctl -u 服务名 -n 100

3. 网络不通

执行：

ip a
ip route
ping -c 4 223.5.5.5
ping -c 4 debian.org
cat /etc/resolv.conf

如果能 ping IP，不能 ping 域名，通常是 DNS 问题。

4. 磁盘满

执行：

df -h
sudo du -h --max-depth=1 / | sort -h

重点查看：

/var/log
/var/lib/docker
/tmp
/home

十五、总结

Debian 的优势在于稳定、安全、规范，非常适合作为服务器系统和长期开发环境。但它并不是“装完就万事大吉”的系统，很多问题都来自以下几个方面：

1. 软件源没有配置好
2. 混用了不合适的第三方仓库
3. 不理解 apt 升级逻辑
4. root、sudo、SSH 权限管理不当
5. 防火墙和服务端口配置遗漏
6. 日志、Docker、缓存导致磁盘被占满
7. 大版本升级前没有备份

如果你是新手，建议遵循一个原则：

尽量使用 Debian 官方推荐方式，不要随便混用其他发行版的软件源。

如果你是服务器用户，建议再加一个原则：

所有危险操作前先备份，所有远程安全配置修改前先保留一个可用连接。

掌握这些避坑点后，Debian 会成为一个非常可靠、干净、可维护的 Linux 系统。无论是个人博客、开发测试环境、数据库服务器、Docker 容器宿主机，还是企业级应用部署，Debian 都值得作为长期主力系统使用。