Cài Portainer trên Synology bằng Container Manager

Portainer là gì và giải quyết vấn đề gì

Portainer là một web UI quản lý Docker trực quan, giúp bạn xem, khởi động, dừng và cập nhật các container ngay trên trình duyệt mà không cần gõ lệnh terminal. Trên Synology, Container Manager đã lo phần chạy Docker, nhưng Portainer bổ sung một bảng điều khiển mạnh hơn để quản lý image, network, volume và log của mọi container ở cùng một nơi. Đây là công cụ gần như bắt buộc nếu bạn chạy nhiều dịch vụ tự host trên NAS.

Yêu cầu trước khi bắt đầu

Bạn cần một model Synology hỗ trợ Container Manager (dòng Plus/x86, DSM 7.2 trở lên) và tài khoản có quyền administrator. Hãy chắc chắn gói Container Manager đã được cài từ Package Center, NAS có kết nối Internet để tải image từ Docker Registry, và bạn biết địa chỉ IP nội bộ của NAS. Chúng ta sẽ dùng cổng host 18900 cho Portainer, nên hãy bảo đảm cổng này chưa bị dịch vụ khác chiếm.

Các bước cài Portainer chi tiết

Bước 1: Mở Package Center kiểm tra Container Manager

Từ menu chính của DSM, mở Package Center và tìm Container Manager. Nếu gói chưa cài, nhấn Install và đợi DSM tải xong; nếu đã cài, bạn sẽ thấy trạng thái Installed hoặc Open. Container Manager chính là engine Docker của Synology, mọi container và Project sau này đều chạy trên nền gói này nên bắt buộc phải có trước khi làm tiếp.

Bước 2: Tạo thư mục dữ liệu cho Portainer trong File Station

Mở File Station, vào shared folder docker (nếu chưa có thì Container Manager thường tự tạo), rồi tạo một thư mục con tên portainer. Thư mục này sẽ được mount vào container để lưu cấu hình và dữ liệu của Portainer, giúp dữ liệu không bị mất khi bạn cập nhật hay dựng lại container. Đường dẫn đầy đủ thường là /volume1/docker/portainer.

Bước 3: Mở Container Manager từ menu chính

Quay lại menu chính DSM và mở Container Manager. Giao diện sẽ hiện các tab quen thuộc: Overview, Project, Container, Image, Registry, Network và Log. Đây là trung tâm điều khiển Docker của bạn trên NAS; chúng ta sẽ dùng lần lượt tab Registry để tải image, rồi tab Project để triển khai Portainer bằng compose.

Bước 4: Vào tab Registry và tìm image portainer

Chuyển sang tab Registry trong Container Manager, gõ từ khóa portainer vào ô tìm kiếm rồi nhấn Enter. Registry sẽ liệt kê các image công khai trên Docker Hub. Bạn cần tìm image chính thức portainer/portainer-ce (bản Community Edition miễn phí), đây là bản được khuyên dùng cho hầu hết người tự host trên Synology.

Bước 5: Chọn portainer-ce và nhấn Download

Chọn dòng portainer/portainer-ce trong kết quả rồi nhấn Download. Container Manager sẽ hỏi bạn chọn tag; hãy chọn latest (hoặc một phiên bản cụ thể nếu bạn muốn cố định version). Sau khi xác nhận, DSM bắt đầu kéo image về NAS. Đây chính là bộ mã nguồn đóng gói sẵn của Portainer mà container sẽ chạy từ đó.

Bước 6: Kiểm tra image đã tải xong trong tab Image

Sang tab Image để theo dõi tiến trình tải. Khi cột trạng thái báo hoàn tất, bạn sẽ thấy portainer/portainer-ce:latest xuất hiện trong danh sách image cục bộ với dung lượng kèm theo. Image đã sẵn sàng này là điều kiện để bước Project bên dưới dựng container thành công mà không phải chờ tải lại.

Bước 7: Vào tab Project và nhấn Create

Chuyển sang tab Project rồi nhấn nút Create. Project là cách Container Manager triển khai một hoặc nhiều container từ file docker-compose.yml, giúp bạn khai báo cổng, volume và biến môi trường một cách rõ ràng và dễ dựng lại. Chúng ta sẽ dùng Project thay vì tạo container thủ công để cấu hình Portainer gọn gàng hơn.

Bước 8: Đặt tên project và chọn đường dẫn thư mục

Trong cửa sổ tạo Project, nhập tên portainer vào ô Project name. Ở phần Path, bấm chọn thư mục /volume1/docker/portainer mà bạn đã tạo ở File Station. Container Manager sẽ đặt file docker-compose.yml vào đúng thư mục này, đồng thời đây cũng là nơi Portainer lưu dữ liệu qua volume mount.

Bước 9: Chọn nguồn Create docker-compose.yml và dán nội dung

Ở phần chọn nguồn, chọn Create docker-compose.yml để tự soạn cấu hình, rồi dán đoạn compose dưới đây vào ô soạn thảo. Đoạn này ánh xạ cổng host 18900 vào cổng 9000 bên trong container, mount thư mục dữ liệu và gắn docker.sock để Portainer quản lý được Docker của NAS.

services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: always
    ports:
      - "18900:9000"
    volumes:
      - /volume1/docker/portainer:/data
      - /var/run/docker.sock:/var/run/docker.sock

Bước 10: Nhấn Next và bỏ qua bước Web portal settings

Nhấn Next để tiếp tục. Container Manager có thể hỏi về Web portal settings (thiết lập cổng cho reverse proxy); bạn có thể bỏ trống hoặc bỏ qua vì compose đã khai báo cổng 18900 rồi. Bước này chỉ hỗ trợ tạo shortcut, không bắt buộc cho việc chạy Portainer.

Bước 11: Xem lại Summary rồi nhấn Done để dựng project

Container Manager hiển thị bảng Summary tóm tắt image, cổng và volume của project. Kiểm tra lại một lượt rồi nhấn Done. DSM sẽ đọc file compose, tạo container và tự động khởi chạy. Bạn sẽ thấy log build chạy qua và trạng thái project chuyển sang Running khi hoàn tất.

Bước 12: Kiểm tra container portainer đang chạy ở tab Container

Mở tab Container, tìm dòng portainer và xác nhận trạng thái là Running với chỉ báo màu xanh. Bạn sẽ thấy cổng ánh xạ 18900:9000 hiển thị bên cạnh. Nếu trạng thái là Stopped hoặc lỗi, hãy mở tab Log để xem thông báo; còn nếu đã Running thì Portainer đã sẵn sàng để truy cập qua trình duyệt.

Bước 13: Mở trình duyệt vào Portainer và tạo tài khoản admin

Mở trình duyệt và truy cập http://IP-NAS:18900 (thay IP-NAS bằng địa chỉ nội bộ của NAS). Màn hình đầu tiên của Portainer yêu cầu tạo tài khoản administrator: nhập username và một mật khẩu mạnh ít nhất 12 ký tự, rồi nhấn Create user. Bạn nên hoàn tất bước này sớm vì Portainer sẽ khóa việc tạo admin sau vài phút vì lý do bảo mật.

Bước 14: Chọn môi trường Local trong wizard của Portainer

Sau khi tạo admin, Portainer hiển thị wizard chọn môi trường quản lý. Chọn Get Started (hoặc Local) để Portainer kết nối trực tiếp tới Docker của Synology thông qua docker.sock mà bạn đã mount ở compose. Đây là lựa chọn đúng cho việc quản lý container ngay trên chính NAS này, không cần cấu hình agent từ xa.

Bước 15: Vào dashboard và xác nhận Portainer thấy container

Portainer đưa bạn vào dashboard của môi trường local. Nhấn vào phần Containers, bạn sẽ thấy danh sách container đang chạy trên NAS, bao gồm cả chính portainer. Đến đây quá trình cài đặt đã hoàn tất: bạn có thể start, stop, xem log và triển khai stack mới ngay từ giao diện web này thay cho Container Manager.

Kiểm tra Portainer đã chạy đúng chưa

Truy cập http://IP-NAS:18900 và đăng nhập bằng tài khoản admin vừa tạo; nếu dashboard hiện đúng danh sách container thì Portainer đã hoạt động tốt. Đối chiếu chéo với tab Container trong Container Manager để chắc chắn container portainer luôn ở trạng thái Running và tự khởi động lại nhờ restart: always. Bạn cũng nên lưu lại mật khẩu admin ở nơi an toàn.

Lỗi thường gặp

Nếu không mở được trang, hãy kiểm tra cổng 18900 có bị dịch vụ khác chiếm hay bị firewall DSM chặn không, và thử lại bằng IP nội bộ thay vì tên miền. Lỗi phổ biến khác là Portainer báo không kết nối được Docker: nguyên nhân thường do dòng mount /var/run/docker.sock bị thiếu hoặc sai trong compose. Nếu bỏ lỡ thời gian tạo admin ban đầu, chỉ cần restart container portainer trong Container Manager rồi tải lại trang để mở lại màn hình tạo tài khoản.