UOS安装使用Docker Compose教程

在UOS（统信UOS）系统上部署多容器应用时，Docker Compose几乎是绕不开的工具。但不少人被第一步就卡住：系统里根本没有docker-compose命令，更别提让docker-compose.yml文件生效了。其实整个过程并不复杂，核心前提只有一个——Docker引擎必须已经安装并运行，否则docker-compose连启动都做不到。下面从环境检查开始，把安装和验证的完整路径走一遍。

确认Docker是否已安装并运行

UOS基于Debian/Ubuntu体系，但默认并不携带Docker。动手之前，先快速检查Docker引擎的状态：

执行 docker --version 和 sudo systemctl is-active docker。如果出现“command not found”或显示“inactive”，说明Docker完全没有安装或服务未启动——必须先搞定Docker引擎，否则docker-compose寸步难行。

若Docker已就绪，可以继续往下；如果没装，请参照UOS官方文档安装Docker Engine（通常用apt从uos-repo或Docker官方源安装）。

安装Docker Compose的三种方式

UOS没有提供docker-compose的官方deb包，所以需要手动部署。目前主流方案有三种，按推荐程度排列。

方法一：下载官方二进制（推荐）

第一步：进入临时目录，避免权限问题干扰：cd /tmp

第二步：执行下载命令，注意架构标识——UOS桌面版通常是amd64，服务器版可能是arm64：sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

第三步：赋予可执行权限：sudo chmod +x /usr/local/bin/docker-compose

第四步：验证安装：docker-compose --version。如果输出类似 docker-compose version 2.29.7，说明安装成功。

方法二：用pip3安装（需已安装python3-pip）

执行 sudo pip3 install docker-compose。安装后会放到 /usr/local/bin/ 目录下，但部分UOS版本中pip3默认没有启用，还可能因Python路径冲突导致命令不可用。

注意：如果遇到 ImportError: cannot import name 'main'，说明pip版本太老，先运行 sudo python3 -m pip install --upgrade pip 再重试。

方法三：从UOS应用商店搜索“Docker Compose”（仅限部分UOS社区版）

打开“应用商店”→顶部搜索框输入“docker compose”→查找由UnionTech官方签名的应用→点击安装。这种方式自动处理依赖与PATH，但版本往往滞后于GitHub最新发布，而且企业版UOS通常不提供这个渠道。

验证docker-compose能否正常调用容器服务

安装完成后，最好用一个最小测试用例来确认一切正常：

新建目录并进入：mkdir ~/dc-test && cd ~/dc-test

创建 docker-compose.yml 文件，内容如下：

version: "3.8"
services:
alpine:
image: alpine:latest
command: sleep 5

执行 docker-compose up。终端会拉取alpine镜像、启动容器，5秒后自动退出。如果看到 Creating dc-test-alpine-1 ... done 和 Attaching to dc-test-alpine-1，说明docker-compose已经能正确解析配置并调用Docker守护进程。

再执行 docker-compose ps 查看服务状态，确认容器已运行并结束。

这样，整套环境就验证通过了。之后就可以把真正的业务 compose 文件拿过来直接用了。