当前位置：首页 > news >正文

Docker离线安装包构建（一键安装，多平台适用）

news 2026/5/12 20:06:25

Docker离线一键安装

更新日志

2026-03-13：v1.1.3版本更新，修复部分操作系统 docker run 时无法任何执行命令问题
2026-03-03：v1.1.2版本更新，调整docker.service安全加固配置，解决无法挂载未创建目录和 /home/ 下目录问题
2026-01-26：v1.1.1版本更新，首次发布

项目简介

Docker离线一键安装工具，支持在无网络环境下快速部署Docker和Docker Compose，适用于生产环境、内网环境等网络受限场景。

跨架构支持：自动检测并支持aarch64（ARM 64位）和x86_64（AMD/Intel 64位）架构
一键操作：简化安装、卸载和清理流程，降低运维成本
版本管理：支持多版本Docker安装，方便不同环境的版本控制
镜像加速：内置多个国内镜像源，提升镜像拉取速度

系统要求

操作系统：Linux 发行版（支持 systemd 的系统）
架构：aarch64或x86_64
权限：需要root用户或 sudo 权限
依赖：systemd、tar、bash4.0+

快速开始

1. 拉取代码

gitclone https://gitcode.com/WesleyTse/docker-offline.gitcddocker-offline

2. 下载二进制包

构建离线安装包需要下载Docker和Docker Compose的二进制包，推荐每次构建下载最新版本。

2.1 Docker

官方下载链接：

ARM架构：Index of linux/static/stable/aarch64/
x86架构：Index of linux/static/stable/x86_64/

下载说明：选择合适的Docker版本下载对应架构的二进制包，由于不同架构的包名相同，需要修改以区分，命名规则：docker-<版本>-<架构>.tgz，如下载 Docker 29.1.4 版本：

ARM架构：重命名为docker-29.1.4-aarch64.tgz
x86架构：重命名为docker-29.1.4-x86_64.tgz

2.2 Docker Compose

Docker Compose 是依赖Docker引擎运行的工具，建议下载与Docker发布日期相近的版本。

下载链接：Releases · docker/compose

下载说明：下载对应架构的二进制文件，保持原始文件名，无需重命名：

ARM架构：docker-compose-linux-aarch64
x86架构：docker-compose-linux-x86_64

2.3 命令补全脚本

下载最新的Docker命令补全脚本并改名为completion_docker：

下载链接：docker bash completion

注意：本仓库的completion_docker适用于 Docker 29.1.4 及以下版本，更高版本需更新自动补全脚本。

打包压缩

完成二进制包下载后，即可将docker-offline目录打包压缩为Docker离线一键安装包，方便迁移使用，无需重复下载。

目录结构

docker-offline/ ├── completion_docker# Docker 命令自动补全脚本├── daemon.json# Docker 配置文件（含镜像源配置）├── docker-29.1.4-aarch64.tgz# Docker 离线压缩包（aarch64 架构）├── docker-29.1.4-x86_64.tgz# Docker 离线压缩包（x86_64 架构）├── docker-compose-linux-aarch64# docker-compose 二进制文件（aarch64 架构）├── docker-compose-linux-x86_64# docker-compose 二进制文件（x86_64 架构）├── docker.service# Docker服务文件├── LICENSE# 许可证文件├── README.md# 安装教程└── setup.sh# Docker 安装脚本

安装教程

3.1 安装

执行命令完成 Docker 的安装：

bashsetup.shinstall

安装过程：

自动检测系统架构
移除系统中已安装的旧版本 Docker
解压并安装对应架构的 Docker 二进制包
安装对应架构的 Docker Compose
提示用户输入 Docker 数据存储路径（默认为 /var/lib/docker）
根据用户输入更新 daemon.json 配置文件
设置 Docker 服务自启动
启动 Docker 服务
验证 Docker 安装状态
配置 Docker 命令自动补全

3.2 卸载

执行命令完成离线安装 Docker 的卸载：

bashsetup.sh uninstall

卸载过程：

停止 Docker 服务
禁用 Docker 服务自启动
移除 Docker 相关二进制文件
移除 Docker 配置和数据目录
移除自动补全脚本

3.3 完全清理

执行命令完成离线安装和包管理器安装 Docker 的完全清理：

bashsetup.sh clean

清理过程：

执行remove_old_docker清理系统包管理器安装的旧版本 Docker
执行uninstall_current_docker清理本脚本安装的 Docker

命令行选项

脚本支持以下命令行选项：

选项	说明	示例
`--help`或`-h`	显示帮助信息	`bash setup.sh --help`
`--version`或`-v`	显示脚本版本	`bash setup.sh --version`
`install`	安装 Docker 和 Docker Compose	`bash setup.sh install`
`uninstall`	卸载 Docker 和 Docker Compose	`bash setup.sh uninstall`
`clean`	完全清理 Docker 相关文件	`bash setup.sh clean`

脚本特性

智能架构检测：自动识别系统架构（aarch64/x86_64）并安装对应版本
多版本支持：支持安装不同版本的 Docker，满足不同环境需求
自动依赖安装：自动安装对应架构的 Docker Compose
彩色日志输出：提供更直观的安装过程反馈
自动清理：安装完成后自动清理临时文件，保持系统整洁
详细的帮助信息：提供完整的命令行帮助和使用示例
版本管理：脚本自带版本号，便于追踪和维护
一键完全清理：支持清理所有 Docker 相关文件和配置
完善的错误处理：遇到错误时提供清晰的错误信息并退出

daemon.json 配置说明

默认配置

{"data-root":"/var/lib/docker","log-driver":"json-file","log-opts":{"max-size":"100m","max-file":"3"},"storage-driver":"overlay2","registry-mirrors":["https://docker.mirrors.ustc.edu.cn","https://docker.m.daocloud.io","https://hub-mirror.c.163.com","https://mirror.baidubce.com","https://registry.cn-hangzhou.aliyuncs.com","https://docker.xuanyuan.me","https://docker.nju.edu.cn"]}