简介本资源面向需要在 Linux 环境下快速搭建容器运行环境的开发与运维人员提供 Docker 及 Docker Compose 的离线安装包解决内网或受限网络下无法直接拉取安装文件的问题。压缩包共 4 个文件约 84.53MB包含 tgz 二进制安装包、docker-compose 编排文件、service 系统服务配置以及 sh 安装脚本覆盖从解压、注册服务到启动编排的完整链路适合具备基础 Linux 操作能力、希望省去逐条命令配置的读者。目前已有 265 人学习下载可作为搭建测试环境或部署多容器应用的参考。通过其中的安装脚本与服务配置读者能快速完成 Docker 环境初始化并借助 Compose 文件一键管理多容器应用减少手动配置带来的排错成本。1. docker和docker-compose安装包离线环境里那套能救命的二进制组合机房断外网、内网机器只开 22 端口、甲方要求所有软件必须走安全审计——这种场景下apt install docker-ce和yum install docker-compose基本等于废命令。你真正需要的是两个能塞进 U 盘、拷到目标机器上直接跑的静态二进制包docker和docker-compose。这套组合不依赖包管理器、不挑发行版、不需要联网拉依赖解压、赋权、扔进 PATH 就能用。它解决的核心问题只有一个在完全离线的 Linux 环境里把容器运行时和编排工具一次性部署到位。适合谁做私有化交付的运维、驻场实施、内网开发环境搭建的人以及被docker-compose 2.32.1下载这类搜索词反复折磨过的同行。下面按我实际交付过十几套内网环境的路径把选包、装包、验证、排错讲透。2. 先搞清楚你要的是哪个包docker、docker-compose 和 docker desktop 的边界2.1 三个名字对应三种完全不同的东西很多人搜「docker和docker-compose安装包」时脑子里其实混着三个概念。第一个是docker engine也就是dockerd守护进程加docker客户端这是真正跑容器的核心。第二个是docker-compose一个独立的 Go 二进制用来解析docker-compose.yml并调用 docker API 批量管理容器。第三个是docker desktop那是 Windows 和 macOS 上的桌面套件带图形界面、带虚拟机、带 Kubernetes和 Linux 服务器上的离线安装完全是两条路。如果你在 Windows 上看到virtualization support not detected docker desktop failed to start这类报错那是 Docker Desktop 的 WSL2 或 Hyper-V 虚拟化没开和本文讲的 Linux 二进制包不是一回事。反过来如果你在 CentOS 7 上执行docker-compose up提示command not found那才是本文要解决的问题。注意Docker Desktop 的汉化包、离线安装包属于桌面端范畴服务器交付场景直接跳过不要混用。2.2 为什么离线环境优先选静态二进制而不是 rpm/deb包管理器安装 docker 的典型流程是yum install -y yum-utils→yum-config-manager --add-repo→yum install docker-ce。这条链路里每一步都要联网而且不同发行版、不同版本之间的依赖关系能把人逼疯。我遇到过最离谱的一次内网 CentOS 7.9 缺container-selinux的某个小版本rpm 包死活装不上最后从另一台机器上rpm -e --nodeps强拆才绕过。静态二进制包的好处是官方已经把dockerd、docker、containerd、runc、docker-proxy这些组件编译好并打包在一起解压即用。它不碰系统包数据库不依赖 glibc 之外的动态库升级和回滚就是替换目录。对于「装完就跑、跑完就走」的交付场景这是最省心的路径。2.3 版本怎么选别追最新追稳定和匹配docker engine 的版本号格式是YY.MM.PATCH比如24.0.7、26.1.4。docker-compose 从 v2 开始改成了v2.x.y的格式并且官方推荐用docker compose作为 docker CLI 插件而不是独立的docker-compose命令。但在离线环境里独立二进制docker-compose反而更灵活因为它不依赖 docker CLI 的插件目录结构。我的选版原则是docker engine 选比当前最新稳定版落后一个小版本的比如最新是 27.x我就选 26.1.x。docker-compose 选 v2.20 以上的版本因为从 v2.20 开始对compose.yaml新规范的支持才完整。热搜里出现的docker-compose 2.32.1下载说明这个版本有人在用但我不建议盲目追这个号先确认你的docker-compose.yml里有没有用到profiles、depends_on的条件语法有的话至少 v2.20。组件推荐版本区间选版理由docker engine24.0.x ~ 26.1.x稳定、社区资料多、兼容性好docker-composev2.20 ~ v2.32支持 compose 规范新特性containerd随 engine 包附带不要单独升级容易版本错配runc随 engine 包附带同上2.4 下载渠道从哪拿包才不翻车官方下载地址是download.docker.com/linux/static/stable/x86_64/目录下按版本号排列着docker-26.1.4.tgz这样的文件。docker-compose 的独立二进制在 GitHub releases 页面文件名类似docker-compose-linux-x86_64。如果你在内网提前在外网机器上下好校验 SHA256再拷进去。提示下载完先sha256sum对一下官方公布的校验值我吃过一次包被中间设备篡改的亏解压后dockerd启动直接段错误。3. 离线安装 docker engine从解压到 systemd 托管的完整命令链3.1 解压与目录规划假设你已经把docker-26.1.4.tgz拷到了/tmp。这个压缩包里是一个docker/目录里面躺着所有二进制文件。不要直接解压到/usr/bin先解到临时目录看清楚内容。# 进入存放安装包的目录 cd /tmp # 查看压缩包内容确认包含哪些二进制 tar -tzf docker-26.1.4.tgz # 解压到当前目录会生成 docker/ 文件夹 tar -xzf docker-26.1.4.tgz # 查看解压出来的文件列表 ls -lh docker/执行完ls你应该看到containerd、containerd-shim-runc-v2、ctr、docker、dockerd、docker-init、docker-proxy、runc这些文件。其中dockerd是守护进程docker是客户端containerd和runc是底层运行时。参数说明-t是列出内容-x是解压-z是 gzip 解压-f指定文件名。这四个参数组合-tzf和-xzf是 tar 操作 tgz 包的标准写法顺序不能乱。3.2 拷贝二进制并设置权限确认文件无误后把它们拷到/usr/bin/。注意containerd-shim-runc-v2这个文件必须和containerd在同一目录否则 containerd 启动时会找不到 shim。# 将 docker 目录下所有二进制拷贝到 /usr/bin sudo cp docker/* /usr/bin/ # 给所有二进制加上可执行权限 sudo chmod x /usr/bin/docker* sudo chmod x /usr/bin/containerd* sudo chmod x /usr/bin/ctr sudo chmod x /usr/bin/runc # 验证 docker 客户端能否正常输出版本 docker --version如果docker --version输出了Docker version 26.1.4, build 5650f9b说明客户端二进制没问题。但此时dockerd还没跑起来docker info会报Cannot connect to the Docker daemon这是正常的。3.3 配置 systemd 单元文件静态二进制包不带 systemd 配置需要手写。创建/etc/systemd/system/docker.service内容如下[Unit] DescriptionDocker Application Container Engine Documentationhttps://docs.docker.com Afternetwork-online.target firewalld.service Wantsnetwork-online.target [Service] Typenotify ExecStart/usr/bin/dockerd ExecReload/bin/kill -s HUP $MAINPID LimitNOFILEinfinity LimitNPROCinfinity LimitCOREinfinity TimeoutStartSec0 Delegateyes KillModeprocess Restarton-failure StartLimitBurst3 StartLimitInterval60s [Install] WantedBymulti-user.target同时创建/etc/systemd/system/containerd.service[Unit] Descriptioncontainerd container runtime Documentationhttps://containerd.io Afternetwork.target [Service] ExecStartPre/sbin/modprobe overlay ExecStart/usr/bin/containerd Delegateyes KillModeprocess Restartalways RestartSec5 LimitNPROCinfinity LimitCOREinfinity LimitNOFILEinfinity TasksMaxinfinity OOMScoreAdjust-999 [Install] WantedBymulti-user.targetExecStartPre/sbin/modprobe overlay这行很关键它确保 overlay2 存储驱动需要的内核模块在 containerd 启动前加载。如果你的内核已经内置了 overlay 模块这行也不会报错。3.4 启动与开机自启# 重新加载 systemd 配置 sudo systemctl daemon-reload # 先启动 containerd sudo systemctl start containerd sudo systemctl enable containerd # 再启动 docker sudo systemctl start docker sudo systemctl enable docker # 检查两个服务的状态 sudo systemctl status containerd --no-pager sudo systemctl status docker --no-pagersystemctl status输出里看到Active: active (running)就对了。如果 docker 启动失败先看journalctl -u docker -n 50 --no-pager九成问题出在存储驱动或 iptables 上。3.5 验证安装跑一个最小容器# 用 hello-world 镜像验证 docker 能否正常拉取和运行容器 docker run --rm hello-world离线环境下这条命令会失败因为拉不到镜像。正确的验证方式是提前docker save一个镜像成 tar 包拷到目标机器后docker load进去再跑。或者直接docker info看输出里Server Version和Storage Driver是否正常。# 查看 docker 服务端信息确认存储驱动和 cgroup 驱动 docker info | grep -E Server Version|Storage Driver|Cgroup Driver|Kernel Version输出里Storage Driver: overlay2和Cgroup Driver: systemd是我最希望看到的组合。如果是cgroupfs在 Kubernetes 场景下会有隐患需要额外配置。4. 离线安装 docker-compose一个二进制文件的事但坑不少4.1 下载与放置docker-compose v2 的独立二进制就是一个文件从 GitHub releases 下载docker-compose-linux-x86_64拷到目标机器。# 将下载的二进制放到 /usr/local/bin 并重命名 sudo cp docker-compose-linux-x86_64 /usr/local/bin/docker-compose # 赋予可执行权限 sudo chmod x /usr/local/bin/docker-compose # 验证版本 docker-compose --version如果输出Docker Compose version v2.24.5说明安装成功。/usr/local/bin通常在 PATH 里如果不在用echo $PATH确认或者直接放到/usr/bin。4.2 为什么不用 docker compose 插件方式docker-compose v2 也支持作为 docker CLI 插件安装路径是~/.docker/cli-plugins/docker-compose或/usr/local/lib/docker/cli-plugins/docker-compose。这种方式的好处是可以用docker compose中间是空格调用和 docker 命令集成更紧密。但在离线交付场景里我倾向于独立二进制方式原因有三第一插件目录在不同 docker 版本里路径可能变第二独立二进制不依赖 docker CLI 的插件发现机制第三出问题时排查路径更短直接which docker-compose就能定位。注意如果你同时装了独立二进制和插件docker compose和docker-compose可能指向不同版本用docker-compose version和docker compose version分别确认。4.3 用 docker-compose 跑一个离线 Redis 主从热搜里有人搜docker安装redis主从这里给一个离线可用的 compose 文件示例。前提是你已经docker load了 redis 镜像。# docker-compose-redis.yml version: 3.8 services: redis-master: image: redis:7.2 container_name: redis-master command: redis-server --appendonly yes ports: - 6379:6379 volumes: - ./data/master:/data networks: - redis-net redis-slave: image: redis:7.2 container_name: redis-slave command: redis-server --appendonly yes --replicaof redis-master 6379 ports: - 6380:6379 volumes: - ./data/slave:/data depends_on: - redis-master networks: - redis-net networks: redis-net: driver: bridge启动命令# 后台启动 Redis 主从 docker-compose -f docker-compose-redis.yml up -d # 查看容器状态 docker-compose -f docker-compose-redis.yml ps # 验证主从复制是否生效 docker exec redis-master redis-cli info replication | grep connected_slavesconnected_slaves:1说明从节点已连上。如果为 0检查redis-slave的日志docker logs redis-slave常见原因是replicaof后面的主机名解析不到确认两个容器在同一 network 里。参数说明--appendonly yes开启 AOF 持久化--replicaof指定主节点地址和端口depends_on只保证启动顺序不保证主节点完全就绪生产环境需要在应用层做重试。5. 避坑与排查离线装 docker 最常翻车的五个地方5.1 现象dockerd 启动报failed to start daemon: error initializing graphdriver: overlay2 not supported原因内核版本过低或 overlay 模块未加载。CentOS 7 默认内核 3.10 支持 overlay2但某些裁剪版系统把模块去掉了。解决先lsmod | grep overlay确认模块是否存在没有就modprobe overlay。如果模块不存在需要升级内核或换devicemapper存储驱动不推荐性能差。在/etc/docker/daemon.json里显式指定{storage-driver: overlay2}并重启 docker。5.2 现象docker-compose up报ERROR: Version in ./docker-compose.yml is unsupported原因compose 文件里写的version: 3.8和你装的 docker-compose 版本不匹配。v2.20 以下对某些版本号解析有问题。解决要么升级 docker-compose 到 v2.20要么把 compose 文件里的version字段删掉。从 compose 规范 v2 开始version字段已经被标记为 obsolete删掉不影响功能。5.3 现象容器内无法解析域名ping baidu.com报unknown host原因离线环境没有配置 DNSdocker 默认用宿主机的/etc/resolv.conf如果宿主机本身没配 DNS容器里也没有。解决在/etc/docker/daemon.json里加{dns: [114.114.114.114, 8.8.8.8]}然后systemctl restart docker。如果内网有 DNS 服务器换成内网地址。注意这个配置对已运行的容器不生效需要重建容器。5.4 现象docker load导入镜像后docker images看不到原因导入的 tar 包不是docker save生成的可能是ctr或skopeo导出的格式docker 不认。解决用docker load -i xxx.tar时加-i参数明确指定输入文件观察输出里有没有Loaded image:字样。如果没有用tar -tf xxx.tar看包内结构正常的 docker save 包第一层是manifest.json和若干层目录。格式不对就用skopeo copy转一道。5.5 现象systemctl start docker卡住不返回超时后失败原因docker 启动时要初始化 iptables 规则如果宿主机 iptables 规则特别多或者有冲突会卡很久。解决先systemctl stop docker然后手动执行/usr/bin/dockerd --debug看卡在哪一步。常见的是iptables链被其他软件如 firewalld、kube-proxy改乱了。临时方案是在 daemon.json 里加{iptables: false}但这样容器就没有端口映射的 NAT 规则了只适合纯 host 网络场景。根治方法是清理 iptables 规则后重启 docker。6. 把安装包做成可复用交付物校验、版本锁定和升级回滚6.1 打包成一个自解压安装脚本每次交付都手动敲一遍命令太累我习惯把二进制包和安装脚本打在一起。目录结构如下docker-offline-installer/ ├── packages/ │ ├── docker-26.1.4.tgz │ └── docker-compose-linux-x86_64 ├── systemd/ │ ├── docker.service │ └── containerd.service ├── install.sh └── SHA256SUMSinstall.sh的核心逻辑#!/bin/bash set -e # 校验安装包完整性 sha256sum -c SHA256SUMS # 解压 docker 二进制 tar -xzf packages/docker-26.1.4.tgz -C /tmp/ # 拷贝二进制 cp /tmp/docker/* /usr/bin/ chmod x /usr/bin/docker* /usr/bin/containerd* /usr/bin/ctr /usr/bin/runc # 安装 docker-compose cp packages/docker-compose-linux-x86_64 /usr/local/bin/docker-compose chmod x /usr/local/bin/docker-compose # 安装 systemd 单元 cp systemd/docker.service /etc/systemd/system/ cp systemd/containerd.service /etc/systemd/system/ # 启动服务 systemctl daemon-reload systemctl enable --now containerd systemctl enable --now docker # 输出验证信息 docker --version docker-compose --version docker info | grep -E Server Version|Storage Driverset -e让脚本在任何一步失败时立即退出避免半装状态。sha256sum -c校验失败会返回非零同样触发退出。6.2 版本锁定与升级回滚离线环境最怕的是「装完能用但不知道装的是哪个版本下次想升级或回滚找不到包」。我的做法是在交付物里放一个VERSIONS文件记录每个组件的版本号和 SHA256。升级时先systemctl stop docker然后用新版本的二进制覆盖/usr/bin/下的文件再systemctl start docker。回滚同理把旧版本二进制拷回来即可。注意 containerd 和 runc 的版本要和 docker engine 匹配不要单独升级其中一个。提示升级前用docker save把关键镜像导出备份虽然升级 docker 本身不会丢镜像但存储驱动变更可能导致镜像不可用。6.3 验证清单装完必须确认的五个点检查项命令期望结果docker 客户端docker --version输出版本号docker 服务端docker infoServer Version 有值存储驱动docker info | grep Storageoverlay2compose 版本docker-compose --versionv2.20容器网络docker run --rm alpine ping -c 1 8.8.8.8能通需有镜像最后一条如果没有 alpine 镜像可以跳过但网络验证建议用docker network create test-net docker network inspect test-net确认 bridge 网络创建正常。6.4 一个我反复用的技巧用docker-compose config做语法预检在离线环境里compose 文件写错了要等up的时候才报错浪费时间。我习惯先跑# 只解析和校验 compose 文件不实际启动容器 docker-compose -f docker-compose-redis.yml config这条命令会把最终生效的配置打印出来包括环境变量替换、默认值填充的结果。如果 YAML 语法有问题或者引用了不存在的变量这里就会报错。确认无误再up -d能省掉很多来回。我自己的习惯是每次交付前在测试机上用同样的安装脚本跑一遍把docker info和docker-compose config的输出截图存档。到了现场如果出问题直接对比输出差异比盲猜快得多。这套离线安装包方案我用了三年多从 CentOS 7 到 Ubuntu 22.04从物理机到虚拟机没换过核心思路——静态二进制加 systemd 托管简单、可控、可回滚。希望帮到你。本文还有配套的精品资源点击获取