Portainer: quản lý server Docker mà không phải SSH vào mò
Server chạy vài stack Docker, team năm người. Mỗi lần tester báo "API trả lỗi 500", sẽ có một người SSH vào server, gõ docker ps tìm tên container, docker logs --tail 200, cuộn, copy đoạn log dán vào chat. Người thứ hai muốn xem thì lại SSH vào. Ai cũng cần quyền SSH, nghĩa là ai cũng có quyền làm mọi thứ trên server, kể cả docker rm -f nhầm container database.
Portainer là một giao diện web cho Docker: xem container, log, biến môi trường, restart, deploy stack, phân quyền theo người. Bài này là cách dựng nó trong năm phút, những việc hằng ngày làm trên nó thay cho SSH, và phần nhiều bài hướng dẫn bỏ qua: Portainer có quyền gì trên server của bạn.
Bài viết theo Portainer CE (Community Edition, bản miễn phí) 2.x. Một số tính năng chỉ có ở bản Business, mình ghi rõ ở chỗ nhắc tới.
Cài: một volume, một container
Theo tài liệu cài đặt chính thức:
docker volume create portainer_data
docker run -d \
-p 9443:9443 \
--name portainer \
--restart=always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v portainer_data:/data \
portainer/portainer-ce:lts
Mình bỏ cổng 8000 trong lệnh mẫu của tài liệu: cổng đó chỉ cần khi dùng Edge Agent (quản lý server ở xa qua đường hầm), một server thì không cần. Cổng nào không dùng thì đừng mở.
Mở https://<server>:9443, trình duyệt sẽ cảnh báo chứng chỉ vì Portainer tự ký. Bản mới yêu cầu một setup token cho lần thiết lập đầu tiên, lấy trong log của container:
docker logs portainer 2>&1 | grep setup_token
Tạo tài khoản admin (Portainer bắt mật khẩu tối thiểu 12 ký tự), và lưu vào trình quản lý mật khẩu của team. Đây là tài khoản mạnh nhất trên server, bạn sẽ thấy vì sao ở phần sau.
Muốn quản lý bằng compose thay vì docker run, viết lại thành một service, và nhớ những thứ của bài trước về compose cho prod: tag phiên bản cụ thể, giới hạn log.
Ba việc làm ngay sau khi đăng nhập
| Việc | Ở đâu | Vì sao |
|---|---|---|
| Đặt chứng chỉ thật hoặc để Portainer sau reverse proxy có HTTPS | Settings → SSL certificate | Mật khẩu admin không nên đi qua chứng chỉ tự ký mà ai cũng bấm "tiếp tục" |
| Tạo user cho từng người, tạo team | Users, Teams | Không ai dùng chung tài khoản admin |
| Thêm registry riêng nếu có | Registries | Để stack kéo được image từ registry cần đăng nhập |
Stack chính là file compose
Trong Portainer, một stack là một file compose được Portainer deploy và quản lý. Có bốn cách tạo stack:
| Cách | Hợp khi |
|---|---|
| Web editor: dán nội dung compose vào ô soạn thảo | Thử nhanh, stack nhỏ |
| Upload file compose | Có sẵn file trên máy |
| Git repository: trỏ tới repo chứa file compose | Muốn file compose có lịch sử, review được, và tự cập nhật |
| Custom template | Một stack dùng lặp lại nhiều lần |
Mình khuyên dùng Git repository cho mọi stack sống lâu. Lý do đơn giản: stack sửa thẳng trên web editor không có lịch sử, sáu tháng sau không ai biết ai đổi dòng nào và vì sao. Đặt file compose trong Git thì mọi thay đổi đi qua commit, có thể review như code.
Biến môi trường khai báo trong Portainer (từng biến hoặc nạp từ file .env) được dùng cho ${...} trong file compose, và file compose trong Git không bị sửa. Nhờ vậy secret nằm trong Portainer, file compose trong Git không chứa mật khẩu.
services:
api:
image: registry.example.com/api:1.4.2
environment:
# Giá trị thật khai báo trong mục Environment variables của stack trên Portainer
- ConnectionStrings__Default=${DB_CONNECTION}
Việc hằng ngày: trước và sau
| Việc | Trước, qua SSH | Giờ, trên Portainer |
|---|---|---|
| Xem log khi có lỗi | docker ps, docker logs --tail 200 <tên>, copy dán |
Containers → chọn container → Logs, có ô tìm kiếm, gửi link cho người khác |
| Restart một service | docker compose restart api trong đúng thư mục |
Nút Restart |
| Xem biến môi trường, volume, network | docker inspect rồi đọc JSON |
Trang chi tiết container |
| Chạy lệnh trong container | docker exec -it <tên> sh |
Console |
| Xem container nào ngốn RAM | docker stats |
Stats của từng container |
| Cập nhật stack | Sửa file trên server, docker compose up -d |
Sửa trong Git, Portainer cập nhật (bài 10 trong series) |
Quan trọng hơn bảng trên: người chỉ cần xem log không còn cần quyền SSH.
Portainer có quyền gì trên server của bạn
Đây là phần mình muốn bạn đọc kỹ nhất. Dòng -v /var/run/docker.sock:/var/run/docker.sock cho Portainer nói chuyện trực tiếp với Docker engine. Ai điều khiển được Docker engine thì có thể chạy một container mount toàn bộ ổ đĩa của host với quyền root. Nói cách khác: quyền admin Portainer tương đương quyền root trên server.
Hệ quả cụ thể:
- Tài khoản admin Portainer phải được giữ như mật khẩu root. Không dùng chung, không ghi trong chat.
- Đừng mở cổng 9443 ra internet nếu không cần. Để sau VPN, hoặc giới hạn IP ở tường lửa của cloud (nhớ rằng Docker publish cổng đi trước UFW, như bài trước đã nói).
- Ai xem được container thì thấy biến môi trường và log của nó. Secret đặt bằng biến môi trường hiện ra trong trang chi tiết container. Một entrypoint in khoá ra log (chuyện ở bài 3) là in cho mọi người có quyền xem log trên Portainer.
- Console là một shell trong container. Cho ai quyền console là cho họ chạy lệnh tuỳ ý trong container đó.
Về phân quyền: bản CE có user, team, và gán quyền truy cập từng tài nguyên (chỉ admin, chỉ một số user hoặc team, hoặc công khai). Phân vai chi tiết kiểu "chỉ đọc", "chỉ được restart" là tính năng của bản Business. Với bản CE, cách thực tế là: dev được gán vào những stack của dev và test, stack prod chỉ admin và người trực mới thấy.
Checklist dựng Portainer cho team
[ ] Image Portainer có tag cụ thể (lts hoặc số phiên bản), không latest
[ ] Chỉ mở cổng 9443; 8000 chỉ khi dùng Edge Agent
[ ] Cổng 9443 không mở ra internet, hoặc giới hạn IP
[ ] HTTPS bằng chứng chỉ thật hoặc sau reverse proxy
[ ] Mỗi người một tài khoản; admin chỉ một hai người
[ ] Stack prod chỉ gán cho team cần thấy
[ ] Stack sống lâu tạo từ Git, không sửa thẳng trên web editor
[ ] Secret của stack khai báo trong Portainer, không nằm trong file compose trên Git
[ ] Volume portainer_data được backup (chứa user, cấu hình, stack)
Thử ngay: nếu server của bạn đang có Portainer, vào Users và đếm xem bao nhiêu tài khoản đang là admin. Mỗi tài khoản đó là một người có root trên server.
Bài sau trong series: chuyển sang Azure Pipelines, đọc từng dòng một pipeline thật build app Next.js thành artifact. Team bạn đang quản lý container bằng gì, Portainer, Lazydocker hay vẫn SSH? Comment cho mình biết với.
P.S. Phần "Portainer có quyền gì" mình không tự nghĩ ra hết ngay từ đầu. Lần dựng lại gần đây, mình chạy skill stride-security-audit trong PrimeKit, bộ skill mình tự làm, để rà hệ thống theo góc nhìn của từng kiểu kẻ tấn công: người ngoài, người trong team, chuỗi cung ứng image. Skill phân loại rủi ro theo mức độ nghiêm trọng. Cài bằng npx @lovehlmmm/primekit init, rồi gõ /pk:stride-security-audit kèm mô tả hệ thống. Chấp nhận rủi ro nào vẫn là quyết định của team.
Tài liệu để đọc thêm
- Cài Portainer CE trên Linux, Portainer Docs
- Thêm một stack, Portainer Docs
- Docker daemon attack surface, Docker Docs
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 bài toán UI mà tutorial không dạy: 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 với Playwright.
- 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