Debian Minimal如何管理软件仓库

Debian Minimal 软件仓库管理指南

一 核心概念与工具

• 使用 APT 管理软件仓库与软件包，底层用 dpkg 处理 .deb 包；优先用 APT，dpkg 仅用于本地包或特殊场景。
• 常用 APT 命令：apt update（更新索引）、apt install <包名>（安装）、apt upgrade / apt full-upgrade（升级）、apt remove / apt purge（卸载，purge 同时删除配置）、apt search <关键词>、apt show <包名>（查看详情）、apt-cache depends <包名>（查看依赖）、apt autoremove（清理无用依赖）、apt clean / apt autoclean（清理缓存）。
• 本地 .deb 安装与依赖修复：dpkg -i <file.deb>；遇到依赖错误执行 apt install -f 或 sudo apt --fix-broken install。
• 重要提示：Debian 系列不使用 YUM，请使用 APT 体系。

二 配置与切换软件源

• 编辑主源文件：sudo nano /etc/apt/sources.list（或 /etc/apt/sources.list.d/*.list）。
• 选择镜像与组件：常见组件为 main、contrib、non-free、non-free-firmware；将 deb cdrom: 行注释或删除，改用网络镜像。
• 源条目格式：deb <镜像地址> <发行版代号> <组件1> <组件2> …；例如 Debian 12（bookworm）可使用清华镜像：
  • deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
  • deb-src https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
• 使配置生效：sudo apt update；若提示 GPG 公钥未导入，按提示导入对应公钥后再更新。

三 第三方源与本地仓库

• 添加第三方源：将 .list 文件放入 /etc/apt/sources.list.d/，内容遵循 “deb <地址> <发行版代号> <组件>” 格式，保存后执行 sudo apt update。
• 本地仓库（便于内部分发/自建包）：
  • 安装工具：sudo apt-get install reprepro
  • 初始化目录并配置 ~/debian-repo/conf/distributions（设置 Origin、Label、Codename、Architectures、Components）
  • 导入包并生成索引：reprepro -b ~/debian-repo includedeb <发行版代号> /path/to/pkg.deb
  • 在 sources.list 添加本地源：deb [trusted=yes] file:/home/<用户>/debian-repo <发行版代号> main
  • 更新索引并测试：sudo apt update && sudo apt install <你的包名>。

四 日常维护与故障排查

• 常规维护：
  • 更新与升级：sudo apt update && sudo apt upgrade；遇到依赖变化用 sudo apt full-upgrade
  • 清理：sudo apt autoremove（移除不再需要的依赖）、sudo apt clean / sudo apt autoclean（清理下载缓存）
• 常见问题处理：
  • 依赖错误：sudo apt --fix-broken install 或 sudo apt install -f
  • 本地 .deb 安装失败：先 dpkg -i <file.deb>，再用 apt install -f 修复依赖
  • 列出与查询：dpkg -l（已装包列表）、dpkg -s <包名>（包信息）、dpkg -L <包名>（文件清单）
  • 搜索与选型：apt search <关键词>、apt show <包名>、apt-cache depends <包名>。