1. 確保已安裝 Docker
Docker Compose 需要 Docker 作為依賴,請先安裝 Docker:
sudo apt update
sudo apt install docker.io
sudo systemctl enable --now docker
2. 下載 Docker Compose 二進制文件
推薦安裝最新穩定版的 Docker Compose(v2):
# 下載最新版本(替換為實際最新版本號)
DOCKER_COMPOSE_VERSION=$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep 'tag_name' | cut -d\" -f4)
sudo curl -L "https://github.com/docker/compose/releases/download/${DOCKER_COMPOSE_VERSION}/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose# 賦予執行權限
sudo chmod +x /usr/local/bin/docker-compose
3. 驗證安裝
docker-compose --version
應輸出類似:Docker Compose version v2.x.x
4. (可選) 啟用命令補全
sudo curl -L https://raw.githubusercontent.com/docker/compose/master/contrib/completion/bash/docker-compose -o /etc/bash_completion.d/docker-compose
source ~/.bashrc
注意事項:
- 如果遇到權限問題,請將用戶加入
docker
組:sudo usermod -aG docker $USER newgrp docker
- 如果系統無法識別
docker-compose
命令,檢查/usr/local/bin
是否在$PATH
中
替代方案(使用 apt 安裝舊版)
Ubuntu 倉庫也提供舊版 Compose v1:
sudo apt install docker-compose
但建議使用官方的最新 v2 版本以獲得完整功能支持。