Ubuntu on Hoàng Dương

Cài đặt Docker và Docker Compose tự động bằng Bash Script

Sat, 11 Apr 2026 00:00:00 +0000

Tự động hóa cài đặt Docker bằng Bash Script

Khi làm việc với nhiều server, việc cài đặt Docker thủ công từng bước trên mỗi máy là tốn thời gian và dễ sai sót. Giải pháp đơn giản nhất là viết một Bash Script tự động hóa toàn bộ quá trình — từ cài đặt dependencies, thêm Docker repository, đến cài đặt Docker Engine và Docker Compose.

Trong bài viết này, tôi sẽ hướng dẫn bạn viết script cài đặt Docker theo đúng tài liệu chính thức của Docker, đảm bảo luôn lấy phiên bản mới nhất từ repository chính thức.

Yêu cầu hệ thống

Trước khi bắt đầu, hãy đảm bảo server của bạn đáp ứng các điều kiện sau:

Yêu cầu	Chi tiết
Hệ điều hành	Ubuntu 22.04 (Jammy), 24.04 (Noble), 25.10 (Questing), 26.04 (Resolute)
Kiến trúc	x86_64 (amd64), arm64, armhf, s390x, ppc64le
Quyền	Tài khoản có quyền `sudo`
Kết nối mạng	Có kết nối Internet để tải packages

Gỡ cài đặt phiên bản Docker cũ (nếu có)

Theo tài liệu chính thức của Docker, trước khi cài đặt Docker Engine, bạn cần gỡ bỏ các package xung đột có thể đã được cài sẵn bởi hệ điều hành:

1

sudo apt remove docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc

Lưu ý: Lệnh trên có thể báo rằng không có package nào được cài — điều này hoàn toàn bình thường trên server mới.

Viết Bash Script cài đặt Docker

Tạo file script

1

vi install-docker.sh

Nội dung script

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


#!/bin/bash
set -e

echo "=========================================="
echo " Cài đặt Docker Engine & Docker Compose "
echo "=========================================="

# Bước 1: Cài đặt các packages cần thiết
echo "[1/5] Cài đặt dependencies..."
sudo apt update -y
sudo apt install -y ca-certificates curl gnupg

# Bước 2: Thêm Docker GPG key
echo "[2/5] Thêm Docker GPG key..."
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Bước 3: Thêm Docker repository vào apt sources
echo "[3/5] Thêm Docker repository..."
echo \
 "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
 $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
 sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Bước 4: Cài đặt Docker Engine và Docker Compose plugin
echo "[4/5] Cài đặt Docker Engine..."
sudo apt update -y
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Bước 5: Khởi động và enable Docker service
echo "[5/5] Khởi động Docker service..."
sudo systemctl start docker
sudo systemctl enable docker

echo "=========================================="
echo " Cài đặt hoàn tất!"
echo "=========================================="
docker --version
docker compose version

Giải thích từng bước trong script:

Bước	Lệnh	Mục đích
1	`apt install ca-certificates curl gnupg`	Cài các package cần thiết để xác thực GPG key và tải file qua HTTPS
2	`curl ... \| gpg --dearmor`	Tải và chuyển đổi GPG key của Docker sang định dạng binary để `apt` xác thực package
3	`tee /etc/apt/sources.list.d/docker.list`	Thêm Docker repository vào danh sách sources của `apt`, tự động detect kiến trúc và codename
4	`apt install docker-ce ...`	Cài đặt Docker Engine, CLI, containerd, Buildx plugin và Compose plugin
5	`systemctl start/enable docker`	Khởi động Docker daemon và cấu hình tự khởi động cùng hệ thống

Lưu ý quan trọng: Script sử dụng docker-compose-plugin (Compose V2) thay vì docker-compose standalone (V1). Compose V2 được tích hợp trực tiếp vào Docker CLI với lệnh docker compose (không có dấu gạch ngang). Docker đã ngừng hỗ trợ Compose V1 từ tháng 7/2023.

Cấp quyền và chạy script

1
2
3
4
5


# Cấp quyền thực thi
chmod +x install-docker.sh

# Chạy script
sudo bash install-docker.sh

Xác nhận kết quả cài đặt

Sau khi script chạy xong, bạn sẽ thấy output tương tự:

1
2
3
4
5


$ docker --version
Docker version 28.1.1, build 4eba377

$ docker compose version
Docker Compose version v2.35.1

Để kiểm tra Docker hoạt động chính xác, chạy container thử nghiệm:

1

sudo docker run hello-world

Nếu thấy thông báo Hello from Docker!, quá trình cài đặt đã thành công.

Cấu hình sau cài đặt (Post-installation)

Cho phép user thường chạy Docker (không cần sudo)

Theo mặc định, lệnh docker yêu cầu quyền root. Để user thường có thể sử dụng Docker:

1
2
3
4
5
6
7
8


# Thêm user hiện tại vào group docker
sudo usermod -aG docker $USER

# Áp dụng thay đổi group (cần logout/login lại hoặc chạy lệnh sau)
newgrp docker

# Xác nhận — không cần sudo nữa
docker run hello-world

Cấu hình Docker khởi động cùng hệ thống

Script đã thực hiện bước này với systemctl enable docker. Để xác nhận:

1
2


sudo systemctl is-enabled docker
# Output: enabled

Ghi chú triển khai

Khi áp dụng vào dự án của bạn, hãy lưu ý:
- Script chỉ hỗ trợ Ubuntu. Với Debian, CentOS, hoặc Fedora, cần thay đổi URL repository và lệnh package manager tương ứng
- Luôn kiểm tra tài liệu chính thức để đảm bảo các bước cài đặt chưa thay đổi
- set -e ở đầu script đảm bảo script dừng ngay khi có lệnh bị lỗi, tránh cài đặt không đầy đủ
Best practices:
- Sử dụng docker compose (V2) thay vì docker-compose (V1) — V1 đã ngừng hỗ trợ
- Không chạy container bằng user root trong production — cấu hình user thường với group docker
- Sau khi cài đặt, cấu hình Docker daemon phù hợp với môi trường (log driver, storage driver, v.v.)
Troubleshooting:
- Lỗi Permission denied khi chạy docker? → Đảm bảo user đã được thêm vào group docker và đã logout/login lại
- Lỗi Cannot connect to the Docker daemon? → Kiểm tra Docker service: sudo systemctl status docker
- GPG key bị lỗi khi apt update? → Xóa key cũ và chạy lại bước thêm GPG key: sudo rm /etc/apt/keyrings/docker.gpg

Lời kết

Với Bash Script trên, bạn có thể cài đặt Docker Engine và Docker Compose trên bất kỳ server Ubuntu nào chỉ với một lệnh duy nhất. Script sử dụng phương pháp cài đặt chính thức từ Docker repository, đảm bảo:

Luôn lấy phiên bản mới nhất từ repository chính thức
Cài đặt đầy đủ: Docker Engine, CLI, containerd, Buildx, và Compose V2
Tự động khởi động và enable Docker service

Bạn có thể lưu script này vào hệ thống quản lý cấu hình (Ansible, Terraform) hoặc đơn giản clone từ repository để sử dụng trên nhiều server. 🚀

Tài liệu tham khảo

Docker Official - Install Docker Engine on Ubuntu — Hướng dẫn chính thức cài đặt Docker trên Ubuntu
Docker Official - Post-installation steps for Linux — Cấu hình sau cài đặt
Docker Compose - Migrate to Compose V2 — Hướng dẫn chuyển từ Compose V1 sang V2

Cách cài đặt Docker trên Ubuntu

Sun, 30 Nov 2025 00:00:00 +0000

Giới thiệu về Docker

Docker là một nền tảng phổ biến trong DevOps để triển khai ứng dụng bằng container. Container cho phép bạn đóng gói ứng dụng cùng với tất cả các dependencies và cấu hình cần thiết, giúp ứng dụng chạy nhất quán trên mọi môi trường từ development đến production.

Lợi ích của Docker:

⚡ Tính nhất quán: Ứng dụng chạy giống nhau trên mọi môi trường
🚀 Tốc độ: Khởi động container nhanh hơn so với virtual machine
📦 Đóng gói: Dễ dàng chia sẻ và triển khai ứng dụng
🔄 Scalability: Dễ dàng mở rộng và quản lý nhiều container

Bài viết này hướng dẫn bạn cách cài đặt Docker trên Ubuntu 20.04 và 22.04 một cách đơn giản và hiệu quả, sử dụng repository chính thức của Docker để đảm bảo bạn luôn có phiên bản mới nhất và ổn định.

Yêu cầu trước khi cài đặt

Trước khi bắt đầu, hãy đảm bảo bạn có:

🖥 Máy chủ Ubuntu 20.04 hoặc 22.04 đã được cài đặt
🔐 Quyền sudo để thực thi các lệnh quản trị
🌐 Kết nối internet để tải các gói cài đặt
⏱ Thời gian: Quá trình cài đặt mất khoảng 5-10 phút

Cập nhật hệ thống

Trước khi cài đặt Docker, hãy đảm bảo hệ thống được cập nhật đầy đủ. Điều này giúp đảm bảo bạn có các bản vá bảo mật mới nhất và các gói phụ thuộc cần thiết.

1

sudo apt update && sudo apt upgrade -y

💡 Lưu ý:

Lệnh apt update cập nhật danh sách các gói có sẵn từ repository
Lệnh apt upgrade -y tự động cài đặt các bản cập nhật mà không cần xác nhận
Quá trình này có thể mất vài phút tùy thuộc vào số lượng gói cần cập nhật

Cài đặt Docker

Cài đặt các gói phụ thuộc

Các gói này cần thiết để Docker có thể tải và xác thực các gói từ repository chính thức:

apt-transport-https: Cho phép APT sử dụng giao thức HTTPS
ca-certificates: Cung cấp chứng chỉ SSL/TLS để xác thực kết nối bảo mật
curl: Công cụ để tải xuống các file từ internet
software-properties-common: Cung cấp các tiện ích để quản lý repository

1

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

Thêm repository Docker chính thức

Để cài đặt Docker từ nguồn chính thức, chúng ta cần thêm GPG key và repository của Docker vào hệ thống. Điều này đảm bảo bạn nhận được các bản cập nhật chính thức và bảo mật từ Docker.

Bước 1: Thêm GPG key của Docker

GPG key được sử dụng để xác thực tính toàn vẹn của các gói Docker:

1

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

Bước 2: Thêm Docker repository

Thêm repository Docker vào danh sách nguồn của APT. Lệnh này tự động phát hiện phiên bản Ubuntu của bạn ($(lsb_release -cs)) và thêm repository phù hợp:

1

echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

💡 Giải thích:

arch=amd64: Chỉ định kiến trúc 64-bit
signed-by: Chỉ định GPG key để xác thực
$(lsb_release -cs): Tự động lấy tên code name của Ubuntu (ví dụ: jammy cho Ubuntu 22.04)
stable: Sử dụng channel ổn định (có thể dùng test hoặc nightly cho các phiên bản thử nghiệm)

Cài đặt Docker Engine

Sau khi đã thêm repository, cập nhật danh sách gói và cài đặt Docker Engine:

1
2


sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

📦 Các gói được cài đặt:

docker-ce: Docker Community Edition - phiên bản mã nguồn mở của Docker
docker-ce-cli: Docker Command Line Interface - công cụ dòng lệnh để tương tác với Docker
containerd.io: Container runtime - công cụ quản lý vòng đời container ở mức thấp

⏱ Thời gian cài đặt: Quá trình này thường mất 2-5 phút tùy thuộc vào tốc độ internet của bạn.

Kiểm tra Docker

Sau khi cài đặt, hãy kiểm tra xem Docker đã được khởi động và hoạt động chưa:

1

sudo systemctl status docker

Kết quả mong đợi: Bạn sẽ thấy trạng thái active (running) nếu Docker đã khởi động thành công.

Nếu Docker chưa chạy, bạn có thể khởi động và kích hoạt Docker để tự động khởi động khi hệ thống boot:

1
2


sudo systemctl start docker
sudo systemctl enable docker

💡 Giải thích các lệnh:

systemctl start docker: Khởi động dịch vụ Docker ngay lập tức
systemctl enable docker: Cấu hình Docker tự động khởi động khi hệ thống khởi động lại

Chạy thử Docker

Để xác nhận Docker đã hoạt động đúng, chạy container mẫu hello-world:

1

sudo docker run hello-world

Kết quả mong đợi: Nếu thấy thông báo “Hello from Docker!” cùng với các thông tin về Docker, nghĩa là bạn đã cài đặt thành công! 🎉

🔍 Container hello-world làm gì?

Container này tải xuống image hello-world từ Docker Hub (nếu chưa có)
Chạy container và hiển thị thông báo chào mừng
Tự động dừng sau khi hoàn thành

Cấu hình quyền cho user

Mặc định, Docker yêu cầu quyền root để chạy các lệnh. Để chạy Docker không cần sudo, bạn cần thêm user hiện tại vào nhóm docker:

1
2


sudo usermod -aG docker $USER
newgrp docker

💡 Giải thích:

usermod -aG docker $USER: Thêm user hiện tại vào nhóm docker (nhóm này có quyền truy cập Docker daemon)
newgrp docker: Áp dụng thay đổi nhóm ngay lập tức mà không cần đăng xuất

⚠ Lưu ý quan trọng:

Sau khi thực hiện lệnh này, bạn có thể cần đăng xuất và đăng nhập lại để thay đổi có hiệu lực
Hoặc bạn có thể mở terminal mới để áp dụng thay đổi
Việc thêm user vào nhóm docker cho phép user đó có quyền tương đương root trên Docker daemon, vì vậy chỉ thêm những user đáng tin cậy

Kiểm tra quyền mới:

Sau khi cấu hình, thử chạy Docker không cần sudo:

1

docker run hello-world

Nếu lệnh chạy thành công mà không cần sudo, bạn đã cấu hình đúng! ✅

Gỡ cài đặt Docker (nếu cần)

Nếu bạn muốn gỡ cài đặt Docker hoàn toàn khỏi hệ thống, thực hiện các bước sau:

Bước 1: Gỡ cài đặt các gói Docker

1

sudo apt remove -y docker-ce docker-ce-cli containerd.io

Bước 2: Xóa dữ liệu Docker

Dữ liệu Docker (images, containers, volumes, networks) được lưu trong /var/lib/docker. Để xóa hoàn toàn:

1

sudo rm -rf /var/lib/docker

⚠ Cảnh báo: Lệnh này sẽ xóa TẤT CẢ dữ liệu Docker bao gồm:

Tất cả images đã tải về
Tất cả containers (đang chạy và đã dừng)
Tất cả volumes và networks
Tất cả dữ liệu trong containers

Bước 3: Xóa cấu hình Docker (tùy chọn)

Nếu muốn xóa hoàn toàn mọi dấu vết của Docker:

1
2


sudo rm -rf /var/lib/containerd
sudo rm -rf /etc/docker

Các lệnh Docker cơ bản

Sau khi cài đặt Docker, đây là một số lệnh cơ bản bạn nên biết:

Lệnh	Mô tả
`docker --version`	Kiểm tra phiên bản Docker
`docker ps`	Liệt kê các container đang chạy
`docker ps -a`	Liệt kê tất cả containers (bao gồm đã dừng)
`docker images`	Liệt kê tất cả images
`docker pull <image>`	Tải image từ Docker Hub
`docker run <image>`	Chạy container từ image
`docker stop <container>`	Dừng container đang chạy
`docker rm <container>`	Xóa container
`docker rmi <image>`	Xóa image

Troubleshooting

Vấn đề: Docker daemon không khởi động

Nguyên nhân: Có thể do xung đột với các dịch vụ khác hoặc cấu hình sai.

Giải pháp:

1
2
3
4
5


# Kiểm tra log của Docker
sudo journalctl -u docker

# Khởi động lại Docker
sudo systemctl restart docker

Vấn đề: Permission denied khi chạy Docker

Nguyên nhân: User chưa được thêm vào nhóm docker.

Giải pháp:

1
2
3
4
5


# Thêm user vào nhóm docker
sudo usermod -aG docker $USER

# Đăng xuất và đăng nhập lại, hoặc chạy:
newgrp docker

Vấn đề: Không thể kết nối đến Docker daemon

Nguyên nhân: Docker daemon chưa được khởi động.

Giải pháp:

1
2
3
4
5


# Kiểm tra trạng thái
sudo systemctl status docker

# Khởi động Docker
sudo systemctl start docker

Lời kết

Vậy là chúng ta đã hoàn tất cài đặt Docker trên Ubuntu! 🎉 Giờ đây, bạn có thể bắt đầu:

🐳 Tạo và chạy containers cho các ứng dụng của mình
📦 Sử dụng Docker images có sẵn từ Docker Hub
🚀 Triển khai ứng dụng một cách nhất quán và dễ dàng
🔄 Quản lý môi trường development và production hiệu quả hơn

Docker là một công cụ mạnh mẽ trong thế giới DevOps. Hãy tiếp tục khám phá các tính năng của Docker như Docker Compose, Docker Swarm, và tích hợp với các công cụ CI/CD để tối ưu hóa quy trình phát triển của bạn!

📖 Tài liệu tham khảo:

Tài liệu chính thức của Docker
Docker Hub - Kho lưu trữ images lớn nhất
Best practices cho Docker

Chúc bạn thành công với Docker! 🚀😊