0

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


Series khác của mình


All rights reserved

Viblo
Hãy đăng ký một tài khoản Viblo để nhận được nhiều bài viết thú vị hơn.
Đăng kí