0

Từ VPS Ubuntu trắng tới app chạy HTTPS: Docker, Portainer, và Nginx Proxy Manager hoặc Caddy

Mười bài trước trong series nói từng mảnh: Dockerfile, compose cho prod, cổng nào không nên mở, Portainer, pipeline. Bài này ghép chúng lại thành một lần làm thật từ đầu tới cuối: bạn vừa mua một VPS Ubuntu, có một domain, và muốn cuối buổi có app chạy ở https://app.example.com, Portainer ở https://portainer.example.com, không cổng nào thừa mở ra internet.

Bài hướng dẫn cả hai reverse proxy phổ biến nhất cho kiểu server này: Nginx Proxy Manager (cấu hình bằng giao diện web) và Caddy (cấu hình bằng một file vài dòng). Phần chung làm một lần, tới phần proxy thì chọn một trong hai nhánh. Bài viết theo Ubuntu 24.04 LTS; tài liệu cài Docker hiện cũng hỗ trợ 26.04 LTS với cùng các lệnh. Mọi lệnh lấy theo tài liệu chính thức, link ở cuối bài.

Bức tranh đích

Internet
   │ 80, 443                      22 (SSH, chỉ bằng key)
   ▼                               ▼
┌──────────────────────── VPS Ubuntu ─────────────────────────┐
│  UFW: chỉ mở 22, 80, 443                                     │
│                                                              │
│  Reverse proxy (NPM hoặc Caddy)  ← container DUY NHẤT        │
│        │                            publish cổng ra ngoài    │
│        │ network "proxy"                                     │
│        ├──▶ portainer:9000                                   │
│        └──▶ app:80                                           │
└──────────────────────────────────────────────────────────────┘

Quy tắc xuyên suốt: chỉ reverse proxy được mở cổng. App và Portainer chỉ nằm trong network proxy, không có dòng ports. Lý do đã nói ở bài 4: Docker mở cổng bằng luật iptables riêng, đi trước UFW, nên một dòng ports thừa là một cửa mở mà tường lửa không chặn được.

Bước 0: chuẩn bị

  • VPS Ubuntu 24.04 LTS, 1–2 GB RAM là đủ để chạy những gì trong bài. Ghi lại IP public.
  • Domain, tạo hai bản ghi DNS loại A trỏ về IP của VPS: app.example.com và portainer.example.com. (Thêm npm.example.com nếu đi nhánh Nginx Proxy Manager và muốn vào trang quản trị qua domain.)
  • Nếu dùng Cloudflare cho DNS, để bản ghi ở chế độ DNS only (đám mây xám) trong lúc làm, cho việc xin chứng chỉ HTTPS đơn giản nhất. Bật proxy của Cloudflare sau cũng được.

Kiểm DNS đã trỏ đúng trước khi đi tiếp, vì bước xin chứng chỉ ở cuối phụ thuộc vào nó:

# Trên máy bạn: phải ra đúng IP của VPS
nslookup app.example.com

Bước 1: khoá cửa server

Đăng nhập lần đầu bằng tài khoản nhà cung cấp đưa (thường là root), rồi làm theo thứ tự dưới đây. Đừng đóng phiên SSH đầu tiên cho tới khi bước 1.3 xong và bạn đã đăng nhập thử thành công bằng một phiên khác.

1.1 Cập nhật và tạo user riêng

apt update && apt upgrade -y
timedatectl set-timezone Asia/Ho_Chi_Minh   # log có giờ đúng, cron chạy đúng giờ bạn nghĩ

adduser deploy               # user làm việc hằng ngày, đặt mật khẩu mạnh (dùng cho sudo)
usermod -aG sudo deploy

Làm việc bằng root hằng ngày nghĩa là gõ nhầm một lệnh là không có gì chặn lại. User riêng với sudo bắt bạn phải chủ ý mỗi khi cần quyền cao.

1.2 Đăng nhập bằng SSH key

Trên máy của bạn (không phải server):

ssh-keygen -t ed25519 -C "may-cua-toi"          # nếu chưa có key
ssh-copy-id deploy@<IP-VPS>                      # chép public key lên server
ssh deploy@<IP-VPS>                              # thử: phải vào được mà không hỏi mật khẩu đăng nhập

Trên Windows không có ssh-copy-id, chép nội dung file ~/.ssh/id_ed25519.pub vào file /home/deploy/.ssh/authorized_keys trên server (thư mục .ssh quyền 700, file quyền 600).

1.3 Tắt đăng nhập bằng mật khẩu và đăng nhập root

Ubuntu đọc thêm cấu hình SSH từ thư mục /etc/ssh/sshd_config.d/, theo thứ tự tên file. Có một cái bẫy ở đây: với SSH, giá trị xuất hiện đầu tiên thắng. Nhiều VPS có sẵn file 50-cloud-init.conf ghi PasswordAuthentication yes. Nếu bạn đặt file của mình tên 99-...conf, file kia được đọc trước và thắng, bạn tưởng đã tắt mật khẩu mà thật ra chưa.

Nên đặt tên file bắt đầu bằng 00:

sudo tee /etc/ssh/sshd_config.d/00-hardening.conf > /dev/null <<'EOF'
PermitRootLogin no
PasswordAuthentication no
KbdInteractiveAuthentication no
PubkeyAuthentication yes
EOF

sudo sshd -t                                            # kiểm cú pháp, không in gì là ổn
sudo sshd -T | grep -Ei 'permitrootlogin|passwordauthentication'   # xem giá trị đang có hiệu lực
sudo systemctl restart ssh

Lệnh sshd -T in ra giá trị thật sự đang được dùng, phải thấy permitrootlogin no và passwordauthentication no. Giờ mở một cửa sổ terminal mới, ssh deploy@<IP-VPS> vẫn vào được thì mới đóng phiên cũ.

1.4 Tường lửa

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 443/udp      # HTTP/3, Caddy dùng; NPM không cần nhưng mở cũng không hại
sudo ufw enable
sudo ufw status verbose

Thứ tự quan trọng: allow OpenSSH trước enable, không thì bạn tự khoá mình ra ngoài.

1.5 Tự cài bản vá bảo mật

Ubuntu Server thường cài sẵn unattended-upgrades. Kiểm và bật:

sudo apt install -y unattended-upgrades
sudo dpkg-reconfigure -plow unattended-upgrades    # chọn Yes
systemctl status unattended-upgrades --no-pager

Nó chỉ tự cài bản vá bảo mật, không nâng phiên bản lớn, nên an toàn để bật trên server chạy app.

1.6 Swap cho VPS ít RAM

VPS 1–2 GB RAM mà không có swap thì lúc build hay lúc tải đột biến, kernel giết bớt process, thường là đúng cái container bạn cần nhất.

sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab   # giữ swap sau khi khởi động lại
free -h

Bước 2: cài Docker từ repo chính thức

Đừng cài bằng snap install docker hay gói docker.io của Ubuntu: bản snap có nhiều giới hạn (Portainer khuyên tránh), gói của Ubuntu thường cũ hơn. Theo tài liệu của Docker:

# Khoá GPG của Docker
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Thêm repo
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

# Cài
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo docker run --rm hello-world

Giới hạn log trước khi chạy container nào

Mặc định log container không giới hạn dung lượng, chạy vài tháng là đầy ổ (bài 4 có kể). Đặt giới hạn cho cả máy:

sudo tee /etc/docker/daemon.json > /dev/null <<'EOF'
{
  "log-driver": "json-file",
  "log-opts": { "max-size": "10m", "max-file": "5" }
}
EOF
sudo systemctl restart docker

Cấu hình này chỉ áp cho container tạo mới, nên làm ngay bây giờ, trước khi có container nào.

Nhóm docker là quyền root

sudo usermod -aG docker deploy    # đăng xuất rồi đăng nhập lại để có hiệu lực

Sau lệnh này, deploy chạy được docker không cần sudo. Tiện, nhưng hiểu cho đúng: ai điều khiển được Docker thì có thể chạy một container mount cả ổ đĩa của host, tức là ngang quyền root. Chỉ thêm những user bạn tin như tin root.

Bước 3: network chung cho mọi thứ sau proxy

docker network create proxy

Từ đây, mọi stack (proxy, Portainer, app) khai báo network này là external. Các container trong cùng network gọi nhau bằng tên service, ví dụ proxy gọi portainer:9000, không cần mở cổng nào ra host.

Mỗi stack một thư mục trong /opt:

sudo mkdir -p /opt/proxy /opt/portainer
sudo chown -R deploy:deploy /opt/proxy /opt/portainer

Bước 4: chọn reverse proxy

Nginx Proxy Manager Caddy
Cấu hình bằng Giao diện web, bấm chuột File Caddyfile, vài dòng cho mỗi domain
HTTPS Xin chứng chỉ Let's Encrypt bằng một nút trong giao diện Tự động hoàn toàn: có domain trong file là có HTTPS, tự gia hạn
Lưu cấu hình trong Git Khó, cấu hình nằm trong database của nó Dễ, chỉ là một file chữ
Cổng phải lo 80, 443, và cổng admin 81 không được lộ ra 80, 443
Thêm tính năng Access list, basic auth, redirect, stream TCP/UDP có sẵn trong giao diện Viết thêm vài dòng trong file
Hợp với Người thích bấm, nhiều người cùng quản lý, ít đụng terminal Người quen file cấu hình, muốn review thay đổi như code

Không có lựa chọn sai. Làm một trong hai nhánh 4A hoặc 4B, đừng chạy cả hai cùng lúc vì cả hai đều cần cổng 80 và 443.

4A: Nginx Proxy Manager

Theo hướng dẫn cài đặt, thêm network proxy và đổi cổng admin chỉ nghe trên localhost:

# /opt/proxy/docker-compose.yml
services:
  npm:
    image: jc21/nginx-proxy-manager:2.17.0   # ghi rõ phiên bản, xem bản mới trên trang dự án
    container_name: npm
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "127.0.0.1:81:81"       # trang admin CHỈ nghe trên localhost của server
    environment:
      TZ: "Asia/Ho_Chi_Minh"
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    networks:
      - proxy

networks:
  proxy:
    external: true
cd /opt/proxy && docker compose up -d

Dòng "127.0.0.1:81:81" là dòng quan trọng nhất của nhánh này. Mẫu trong tài liệu ghi "81:81", tức trang admin mở cho cả internet, và vì Docker đi trước UFW nên tường lửa không chặn được. Trang admin này điều khiển toàn bộ traffic vào server của bạn.

Vào trang admin qua SSH tunnel từ máy bạn:

# Trên máy bạn: cổng 8181 trên máy bạn nối tới cổng 81 trên server
ssh -L 8181:127.0.0.1:81 deploy@<IP-VPS>

Giữ cửa sổ đó mở, mở trình duyệt vào http://localhost:8181. Lần đầu, tạo tài khoản admin với email và mật khẩu mạnh (các bản cũ dùng tài khoản mặc định admin@example.com / changeme, nếu gặp thì đổi ngay).

4B: Caddy

# /opt/proxy/docker-compose.yml
services:
  caddy:
    image: caddy:2.10                 # ghi rõ phiên bản chính, xem tag mới trên Docker Hub
    container_name: caddy
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"                 # HTTP/3
    volumes:
      - ./conf:/etc/caddy             # mount cả THƯ MỤC chứa Caddyfile, không mount riêng file
      - caddy_data:/data              # chứng chỉ HTTPS nằm ở đây, mất là phải xin lại
      - caddy_config:/config
    networks:
      - proxy

volumes:
  caddy_data:
  caddy_config:

networks:
  proxy:
    external: true

Vì sao mount thư mục: nhiều trình soạn thảo (vim chẳng hạn) lưu file bằng cách tạo file mới thay thế file cũ. Nếu chỉ mount riêng một file, container vẫn nhìn thấy file cũ, và lệnh nạp lại cấu hình không thấy thay đổi nào. Trang image Caddy cảnh báo đúng điều này.

# /opt/proxy/conf/Caddyfile
{
	email ban@example.com    # Let's Encrypt gửi cảnh báo hết hạn tới đây
}

portainer.example.com {
	reverse_proxy portainer:9000
}

Chưa có container portainer thì Caddy vẫn chạy được, request tới domain đó chỉ trả lỗi 502 cho tới bước 5.

mkdir -p /opt/proxy/conf          # Caddyfile ở trên đặt trong thư mục này
cd /opt/proxy && docker compose up -d
docker compose logs -f caddy      # xem Caddy xin chứng chỉ; thấy "certificate obtained successfully" là ổn

Mỗi lần sửa Caddyfile, nạp lại mà không làm rớt kết nối đang mở:

docker compose exec -w /etc/caddy caddy caddy reload

Không có bước bấm nút xin chứng chỉ nào cả: có tên domain trong Caddyfile, DNS trỏ đúng, cổng 80 và 443 mở, thì Caddy tự xin và tự gia hạn.

Bước 5: Portainer sau proxy

Khác với lệnh docker run ở bài 5, lần này Portainer không mở cổng nào:

# /opt/portainer/docker-compose.yml
services:
  portainer:
    image: portainer/portainer-ce:lts
    container_name: portainer
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    networks:
      - proxy

volumes:
  portainer_data:

networks:
  proxy:
    external: true
cd /opt/portainer && docker compose up -d

Bên trong container, Portainer nghe HTTPS ở cổng 9443 và HTTP ở cổng 9000. Proxy đã lo HTTPS ở ngoài, nên proxy gọi vào cổng 9000 qua network nội bộ.

Nhánh Caddy: khối portainer.example.com ở bước 4B đã trỏ sẵn tới portainer:9000, không cần làm gì thêm.

Nhánh NPM: trong trang admin, vào Hosts → Proxy Hosts → Add Proxy Host:

Ô Giá trị
Domain Names portainer.example.com
Scheme http
Forward Hostname / IP portainer (tên container, không phải IP)
Forward Port 9000
Websockets Support Bật, không thì cửa sổ Console của Portainer không chạy
Block Common Exploits Bật
Tab SSL Request a new SSL Certificate, bật Force SSL và HTTP/2

Mở https://portainer.example.com. Portainer yêu cầu một setup token cho lần thiết lập đầu tiên, lấy từ log:

docker logs portainer 2>&1 | grep setup_token

Tạo tài khoản admin ngay. Trang thiết lập đang nằm trên internet; setup token là thứ ngăn người khác vào trước bạn, đừng để trang ở trạng thái đó lâu.

Bước 6: deploy app đầu tiên

Dùng một image nhỏ để thử cả luồng trước khi đưa app thật vào. Trên Portainer: Stacks → Add stack → Web editor, đặt tên whoami:

services:
  app:
    image: traefik/whoami:v1.10     # trả về thông tin request, đủ để thử proxy
    container_name: whoami
    restart: unless-stopped
    networks:
      - proxy
    # Không có "ports": chỉ proxy được gọi vào

networks:
  proxy:
    external: true

Deploy the stack. Rồi gắn domain:

Nhánh Caddy: thêm vào Caddyfile và nạp lại:

app.example.com {
	reverse_proxy whoami:80
}

Nhánh NPM: thêm một Proxy Host như bước 5, Forward Hostname whoami, Forward Port 80, xin chứng chỉ SSL.

Mở https://app.example.com, thấy vài dòng thông tin request là cả luồng đã thông: DNS, tường lửa, proxy, HTTPS, network nội bộ.

App thật thì làm y như vậy: stack có networks: proxy, không có ports, thêm một khối vào Caddyfile hoặc một Proxy Host. Để stack đọc file compose từ Git và tự cập nhật khi có bản mới, xem bài 10.

Bước 7: kiểm từ bên ngoài

Tường lửa trên server nói gì cũng không bằng thử từ một máy khác. Trên máy bạn:

# Chỉ được thấy 22, 80, 443 ở trạng thái open
nmap -Pn <IP-VPS>

# Cổng admin của NPM phải KHÔNG gọi được từ ngoài
curl -m 5 http://<IP-VPS>:81       # mong đợi: timeout hoặc connection refused

# Đăng nhập bằng mật khẩu phải bị từ chối
ssh -o PubkeyAuthentication=no deploy@<IP-VPS>   # mong đợi: Permission denied (publickey)

Và trên server, liệt kê mọi cổng container đang mở ra host:

docker ps --format '{{.Names}}\t{{.Ports}}'

Chỉ container proxy được có 0.0.0.0:80 và 0.0.0.0:443. Nhánh NPM có thêm 127.0.0.1:81. Bất kỳ dòng 0.0.0.0: nào khác là một cửa mở cần đóng.

Bước 8: backup và cập nhật

Những thứ phải backup, còn lại dựng lại được từ file compose:

Nhánh Dữ liệu Nằm ở
NPM Cấu hình proxy host, user, chứng chỉ /opt/proxy/data, /opt/proxy/letsencrypt
Caddy Chứng chỉ volume caddy_data (Caddyfile thì đã lưu trong Git)
Chung User, stack, cài đặt của Portainer volume portainer_data
Chung Dữ liệu app volume của từng app

Backup một volume thành file nén:

docker run --rm -v portainer_data:/data -v /opt/backup:/backup alpine \
  tar czf /backup/portainer_data-$(date +%F).tar.gz -C /data .

Chép file trong /opt/backup ra khỏi server (một bucket lưu trữ, một máy khác). Backup nằm trên cùng server với dữ liệu thì không cứu được khi mất server.

Cập nhật proxy hay Portainer: đổi tag phiên bản trong file compose, rồi:

docker compose pull && docker compose up -d

Dữ liệu nằm trong volume và thư mục mount nên không mất. Đọc ghi chú phát hành trước khi nhảy phiên bản lớn, và backup trước khi cập nhật.

Checklist dựng server

Server
[ ] User riêng có sudo, SSH bằng key
[ ] File sshd_config.d tên bắt đầu bằng 00; sshd -T xác nhận tắt mật khẩu và root
[ ] UFW: chỉ 22, 80, 443 (allow OpenSSH trước khi enable)
[ ] unattended-upgrades bật; múi giờ đúng; có swap nếu RAM ít
Docker
[ ] Cài từ repo chính thức, không dùng snap
[ ] daemon.json giới hạn log trước khi tạo container
[ ] Chỉ user tin như root mới vào nhóm docker
[ ] Có network "proxy"; app và Portainer không có dòng ports
Proxy
[ ] NPM: cổng 81 chỉ nghe 127.0.0.1, vào qua SSH tunnel; bật Websockets cho Portainer
[ ] Caddy: Caddyfile trong Git, có email; volume caddy_data được giữ
[ ] Portainer tạo admin ngay sau khi có domain
Kiểm và bảo trì
[ ] nmap từ ngoài chỉ thấy 22, 80, 443
[ ] Backup volume ra ngoài server; thử khôi phục một lần
[ ] Image ghi rõ phiên bản; đọc ghi chú phát hành trước khi nâng

Thử ngay: nếu bạn đang có một server chạy Docker, chạy docker ps --format '{{.Names}}\t{{.Ports}}' và sudo sshd -T | grep -i passwordauthentication. Hai lệnh, mười giây, và thường là đủ để biết server đang mở những cửa nào bạn không định mở.

Bài trước trong series: ghép pipeline, registry và Portainer tự cập nhật, bài này là nơi chạy luồng đó. Bạn đang dùng Nginx Proxy Manager, Caddy, hay Traefik? Comment cho mình biết lý do nhé.

P.S. Trước khi dựng một VPS mới, mình hay hỏi skill multi-platform-deployer trong PrimeKit, bộ skill mình tự làm, để so nhanh với các lựa chọn khác (một nền tảng có sẵn như Coolify, Dokploy, hay một dịch vụ hosting) xem dự án có thật sự cần tự quản server không. Skill tự nhận ra cấu hình deploy trong project và gợi ý nền tảng hợp. Cài bằng npx @lovehlmmm/primekit init, rồi gõ /pk:multi-platform-deployer. Đã chọn tự quản server thì các bước trong bài này vẫn phải tự làm và tự kiểm.

Tài liệu để đọc thêm


Series khác của mình


All Rights Reserved

Viblo
Let's register a Viblo Account to get more interesting posts.