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
Atrỏ về IP của VPS:app.example.comvàportainer.example.com. (Thêmnpm.example.comnế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
- Cài Docker Engine trên Ubuntu, Docker Docs
- Các bước sau khi cài Docker trên Linux (nhóm docker), Docker Docs
- Docker và tường lửa, Docker Docs
- Nginx Proxy Manager, hướng dẫn cài đặt
- Caddy: reverse proxy và Automatic HTTPS
- Image Caddy trên Docker Hub
- Cài Portainer CE trên Linux
- Tự cập nhật bản vá trên Ubuntu Server
Series khác của mình
- SQL thực chiến: Những bài học mình ước đã biết sớm hơn: viết query dễ đọc, đọc execution plan, lỗi NULL và N+1 không báo lỗi, schema và transaction, phân trang bằng con trỏ.
- Backend .NET thực chiến: những case hay gặp trên production: async/await làm treo API, HttpClient hết socket, EF Core kéo cả bảng, idempotency, outbox, caching, bảo mật API.
- Front End thực chiến: những cú lừa của production mà tutorial không kể 🐧: ngày giờ và giờ mùa hè, tầng dữ liệu theo hợp đồng API, chart, in ấn và accessibility, Outlook Add-in, E2E, Remix trên Cloudflare Workers, Supabase và Prisma.
- Dùng AI hiệu quả trong công việc: kinh nghiệm thực chiến của dev: viết prompt đủ ngữ cảnh, bắt AI bịa API, giao việc cho agent, review code AI viết, debug, đọc codebase lạ, đóng gói quy trình thành skill.
All Rights Reserved