海棠的知识库

外观

Ubuntu离线软件移植完整指南 ​

概述 ​

在离线环境中部署Ubuntu软件是运维工作中的常见场景。本文档详细介绍如何使用Docker创建Ubuntu离线软件包的完整流程，包括同架构和跨架构软件包的创建、打包和安装方法。

核心原理 ​

离线软件移植的核心思路是通过在线环境创建与目标系统完全一致的软件包集合，包括所有依赖项，然后在离线环境中进行批量安装。Docker容器提供了一个纯净、隔离的环境，确保生成的软件包与目标环境高度匹配。

方法一：同架构软件包创建 ​

1. 创建本地文件夹 ​

bash
# 创建存储目录
mkdir ~/nfs-packages-for-22.04

2. 启动纯净Ubuntu容器 ​

bash
# 使用Docker启动纯净的Ubuntu 22.04环境
docker run --rm -it -v ~/nfs-packages-for-22.04:/packages ubuntu:22.04 bash

参数说明：

  • --rm：容器退出后自动删除
  • -it：进入交互式终端
  • -v：挂载本地目录实现文件共享

3. 在容器内下载软件包 ​

bash
# 更新软件包列表
apt update

# 进入共享目录
cd /packages

# 下载指定软件包及其依赖
apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances nfs-common | grep "^\\w")

4. 退出容器并打包 ​

bash
# 退出容器
exit

# 打包下载的软件包
cd ~
tar -czvf nfs-packages-for-22.04.tar.gz nfs-packages-for-22.04

5. 在目标机器安装 ​

bash
# 解压软件包
tar -xzvf nfs-packages-for-22.04.tar.gz

# 进入解压目录
cd nfs-packages-for-22.04

# 安装所有软件包
sudo dpkg -i *.deb

方法二：跨架构软件包创建 ​

1. 安装多架构支持 ​

bash
# 确保Docker支持多架构模拟
sudo apt-get update
sudo apt-get install qemu-user-static binfmt-support

2. 创建ARM软件包目录 ​

bash
# 创建专用目录
mkdir ~/nfs-packages-for-22.04-arm64

3. 运行ARM64架构容器 ​

bash
# 使用Docker运行ARM64架构的Ubuntu环境
docker run --rm -it --platform linux/arm64 -v ~/nfs-packages-for-22.04-arm64:/packages ubuntu:22.04 bash

4. 在容器内下载ARM软件包 ​

bash
# 更新软件包列表
apt update

# 进入共享目录
cd /packages

# 下载ARM64版本的软件包及依赖
apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances nfs-common | grep "^\\w")

5. 退出容器并打包 ​

bash
# 退出容器
exit

# 打包ARM软件包
cd ~
tar -czvf nfs-packages-for-22.04-arm64.tar.gz nfs-packages-for-22.04-arm64

6. 在ARM目标机器安装 ​

bash
# 传输nfs-packages-for-22.04-arm64.tar.gz到ARM机器
tar -xzvf nfs-packages-for-22.04-arm64.tar.gz
cd nfs-packages-for-22.04-arm64

sudo apt install ./*.deb

高级技巧 ​

1. 使用Dockerfile自动化流程 ​

创建Dockerfile实现自动化软件包创建：

dockerfile
FROM ubuntu:22.04
ARG PACKAGE_NAME=nfs-common
ARG ARCH=amd64

# 更新软件包列表
RUN apt-get update

# 创建输出目录
RUN mkdir /packages

# 下载软件包及其依赖
RUN apt-get download $(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances ${PACKAGE_NAME} | grep "^\\w") -d /packages/

# 默认工作目录
WORKDIR /packages

构建命令：

bash
# 构建AMD64版本
docker build --build-arg PACKAGE_NAME=nfs-common -t package-builder:amd64 .

# 构建ARM64版本
docker build --build-arg PACKAGE_NAME=nfs-common --build-arg ARCH=arm64 --platform linux/arm64 -t package-builder:arm64 .

提取软件包：

bash
# 提取AMD64软件包
docker run --rm -v ~/nfs-packages-for-22.04:/output package-builder:amd64

# 提取ARM64软件包
docker run --rm -v ~/nfs-packages-for-22.04-arm64:/output package-builder:arm64

2. 批量创建多个软件包 ​

创建批量脚本处理多个软件包：

bash
#!/bin/bash
# package-builder.sh
PACKAGES=("nfs-common" "apache2" "mysql-server")
ARCH=${1:-amd64}

for package in "${PACKAGES[@]}"; do
    echo "处理软件包: $package"
    
    # 创建容器
    if [ "$ARCH" = "arm64" ]; then
        docker run --rm -it --platform linux/arm64 \
            -v ~/packages-${ARCH}:/packages \
            ubuntu:22.04 bash -c "
                apt-get update &&
                apt-get download \$(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances $package | grep \"^\\\\w\") -d /packages/
            "
    else
        docker run --rm -it \
            -v ~/packages-${ARCH}:/packages \
            ubuntu:22.04 bash -c "
                apt-get update &&
                apt-get download \$(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances $package | grep \"^\\\\w\") -d /packages/
            "
    fi
    
    # 打包
    tar -czvf ~/packages-${ARCH}/${package}-packages.tar.gz -C ~/packages-${ARCH} .
    rm -rf ~/packages-${ARCH}/*
done
echo "所有软件包处理完成"

3. 使用apt-offline创建离线仓库 ​

创建完整的离线软件仓库：

bash
#!/bin/bash
# offline-repo.sh
REPO_DIR=offline-repo
PACKAGES=("nfs-common" "apache2" "mysql-server")

# 创建仓库目录
mkdir -p $REPO_DIR

# 启动容器并下载软件包
docker run --rm -it -v $(pwd)/$REPO_DIR:/packages ubuntu:22.04 bash -c "
    apt-get update
    cd /packages
    
    for package in ${PACKAGES[@]}; do
        echo \"下载软件包: $package\"
        apt-get download \$(apt-cache depends --recurse --no-recommends --no-suggests --no-conflicts --no-breaks --no-replaces --no-enhances $package | grep \"^\\\\w\") -d /packages/
    done
    
    # 创建软件包索引
    dpkg-scanpackages . /dev/null | gzip -c > Packages.gz
"

echo "离线仓库创建完成: $REPO_DIR"

在离线环境中使用：

bash
# 添加本地源到apt源列表
echo "deb [trusted=yes] file://$(pwd)/offline-repo/ ./" | sudo tee /etc/apt/sources.list.d/offline-repo.list

# 更新软件包列表
sudo apt-get update

# 安装软件
sudo apt-get install nfs-common apache2 mysql-server

参数详解 ​

命令参数说明
apt-cache depends--recurse递归下载所有依赖
--no-recommends不下载推荐依赖
--no-suggests不下载建议依赖
--no-conflicts不检查冲突
--no-breaks不检查中断
--no-replaces不检查替换
--no-enhances不下载增强
docker run--platform指定容器架构
-v挂载卷，实现文件共享

故障排查 ​

1. 依赖解析失败 ​

bash
# 检查软件包依赖树
apt-cache depends nfs-common

# 手动下载依赖
apt-get download dependency-package

2. 架构不匹配 ​

bash
# 检查当前架构
dpkg --print-architecture

# 检查容器架构
uname -m

3. 安装失败 ​

bash
# 修复依赖问题
sudo apt-get -f install

# 强制覆盖安装
sudo dpkg -i --force-overwrite package.deb

注意事项 ​

⚠️ 操作前：

  • 确认Docker环境正常工作
  • 确认目标系统架构与软件包匹配
  • 准备足够的存储空间

⚠️ 操作中：

  • 监控下载进度，避免中断
  • 检查网络连接稳定性
  • 记录软件包版本信息

⚠️ 操作后：

  • 验证软件包完整性
  • 测试软件包安装过程
  • 文档记录创建过程

最佳实践 ​

  1. 版本匹配：确保源容器与目标系统版本一致
  2. 依赖完整性：使用--recurse确保所有依赖被下载
  3. 批量处理：使用脚本处理多个软件包，提高效率
  4. 版本锁定：记录软件包版本，避免兼容性问题
  5. 自动化流程：将完整流程封装为脚本，减少人工错误

总结 ​

使用Docker创建Ubuntu离线软件包是一种高效、可靠的方法，可以确保软件包与目标环境的高度兼容性。通过合理配置参数和流程，可以创建适用于不同架构的软件包集合，解决离线环境中的软件部署问题。

用心记录，持续学习 | CNB

Copyright © 2025-present github | 本站源代码由 CNB.cool 保存，静态页面由 EdgeOne 托管并全球加速