Cách cài đặt và sử dụng Portainer để quản lý Docker với Nginx Proxy Manager

[theanh]

Portainer là giải pháp quản lý container nguồn mở dành cho Docker, Kubernetes và Nomad giúp đơn giản hóa việc khởi động, tạo và chạy container theo cách dễ dàng. Giải pháp này cung cấp bảng điều khiển dựa trên web để quản lý container, hình ảnh, mạng và khối lượng.

Trong hướng dẫn này, bạn sẽ học cách cài đặt và cấu hình giải pháp quản lý container Portainer trên máy chủ Linux và sử dụng giải pháp này để tạo và quản lý container Docker để chạy các ứng dụng khác nhau. Bạn cũng sẽ học cách đặt các container này đằng sau Nginx bằng trình quản lý proxy Nginx.

Điều kiện tiên quyết​

• Máy chủ Linux chạy Ubuntu / Debian / Cent OS / Rocky Linux 8 / Alma Linux.
• Người dùng không phải root có quyền sudo.
• Tên miền đủ điều kiện (FQDN) trỏ đến máy chủ cho Portainer (portrainer.example.com) và Trình quản lý proxy Nginx (npm.example.com).

Bước 1 - Cấu hình tường lửa​

Cent OS/Rocky Linux/Alma Linux​

Bạn nên cài đặt tường lửa Firewalld. Kiểm tra trạng thái của tường lửa.

$ sudo firewall-cmd --staterunning

Mở các cổng 80, 9443 và 443. Portainer sử dụng cổng 9443 để hiển thị giao diện người dùng web của nó qua HTTPS.Nginx Proxy Manager sử dụng cổng 81 cho giao diện người dùng của nó.

$ sudo firewall-cmd --permanent --add-service=http$ sudo firewall-cmd --permanent --add-service=https$ sudo firewall-cmd --permanent --add-port=9443/tcp$ sudo firewall-cmd --permanent --add-port=81/tcp

Tải lại tường lửa để kích hoạt các thay đổi.

$ sudo firewall-cmd --reload

Ubuntu/Debian​

Hệ thống Ubuntu và Debian sử dụng ufw (Uncomplicated Tường lửa) theo mặc định.

Kiểm tra xem tường lửa có đang chạy không.

$ sudo ufw status

Nếu đang chạy, hãy mở các cổng 80, 9443 và 443.

$ sudo ufw allow 80$ sudo ufw allow 443$ sudo ufw allow 9443$ sudo ufw allow 81

Mở cổng SSH nếu tường lửa không chạy.

$ sudo ufw allow "OpenSSH"

Bật tường lửa nếu tường lửa không chạy.

$ sudo ufw enable

Nếu tường lửa đang chạy, hãy tải lại để áp dụng các thay đổi.

$ sudo ufw reload

Bước 2 - Cài đặt Docker​

Cent OS/Rocky Linux/Alma Linux​

Chạy lệnh sau để cài đặt Docker.

$ sudo yum install -y yum-utils$ sudo yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo$ sudo yum install docker-ce docker-ce-cli containerd.io

Ubuntu​

$ sudo apt install ca-certificates curl gnupg lsb-release$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null$ sudo apt update$ sudo apt install docker-ce docker-ce-cli containerd.io

Debian​

$ sudo apt install ca-certificates curl gnupg lsb-release$ curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg$ echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null$ sudo apt update$ sudo apt install docker-ce docker-ce-cli containerd.io

Kích hoạt và khởi động dịch vụ Docker.

$ sudo systemctl start docker --now

Thêm tên người dùng của bạn vào nhóm Docker.

$ sudo usermod -aG docker $USER

Đăng xuất khỏi hệ thống và đăng nhập lại để áp dụng thay đổi.

Bước 3 - Cài đặt Docker Compose​

Tải xuống và cài đặt nhị phân Docker compose.

$ sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

Áp dụng quyền thực thi cho binary.

$ sudo chmod +x /usr/local/bin/docker-compose

Bước 4 - Cài đặt Portainer​

Tạo thư mục cho Portainer.

$ mkdir ~/portainer

Chuyển đến thư mục.

$ cd ~/portainer

Tạo và mở tệp Docker Compose để chỉnh sửa.

$ nano docker-compose.yaml

Dán mã sau vào đó.

version: "3.3"services: portainer: image: portainer/portainer-ce:latest container_name: portainer restart: always privileged: true volumes: - ./data:/data:Z - /var/run/docker.sock:/var/run/docker.sock:Z ports: - 9443:9443

Lưu tệp bằng cách nhấn Ctrl + X và nhập Y khi được nhắc.

Chúng ta hãy xem qua tệp Docker compose.

• Chúng tôi đang kéo phiên bản mới nhất của Portainer Community Edition từ Docker Hub. Portainer Community Edition miễn phí sử dụng, trong khi phiên bản Business của họ yêu cầu phải có giấy phép trả phí. Bạn có thể kéo Phiên bản Doanh nghiệp, nhưng bạn sẽ được yêu cầu nhập khóa cấp phép để sử dụng.
• Chúng tôi đã đặt tên cho vùng chứa của mình là portainer cho mục đích nhận dạng và liên kết.
• Chính sách khởi động lại được đặt thành always để vùng chứa vẫn hoạt động trong khi khởi động.
• Thiết lập privileged: true là để Portainer có thể truy cập vào ổ cắm Docker và chạy trong ngữ cảnh đặc quyền vì chúng tôi đang sử dụng SELinux. Nếu bạn không sử dụng SELinux, bạn có thể xóa thiết lập này. Thiết lập này cấp cho vùng chứa Portainer quyền truy cập vào mọi thứ trên hệ thống máy chủ, bao gồm cả quyền truy cập vào phần cứng. Vì vậy, chỉ bật thiết lập này khi bạn biết mình đang làm gì.
• Phần volumes ánh xạ thư mục trên máy chủ với các thư mục trong vùng chứa bằng cách sử dụng gắn kết Bind. Chúng tôi đã đưa thư mục ~/portainer/data vào container để lưu trữ bất kỳ dữ liệu có liên quan nào và Docker socket API để quản lý container. Nhãn :Z cho Docker biết rằng chúng tôi đang chạy SELinux trên máy chủ của mình. Nếu bạn không bật SELinux, bạn nên xóa nhãn.

Khởi động Portainer.

$ docker-compose up -d

Kiểm tra trạng thái của container.

$ docker psCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES916411e8d12e portainer/portainer-ce:latest "/portainer" 5 giây trước Đã hoạt động 4 giây 8000/tcp, 9000/tcp, 0.0.0.0:9443->9443/tcp, :::9443->9443/tcp portainer

Bước 5 - Truy cập và cấu hình Portainer​

Mở URL https://<yourserverIP>:9443 trong trình duyệt của bạn và bạn sẽ thấy màn hình sau.



Bạn sẽ được yêu cầu tạo người dùng quản trị viên mới. Thêm thông tin chi tiết về người dùng của bạn. Bỏ chọn hộp Cho phép thu thập số liệu thống kê ẩn danh nếu bạn quan tâm đến quyền riêng tư. Nhấp vào nút Tạo người dùng để bắt đầu cài đặt và tạo tài khoản quản trị viên mới.

Tiếp theo, bạn sẽ được đưa đến màn hình bảng điều khiển sau.



Sau vài giây, nó sẽ tự động làm mới và hiển thị cho bạn màn hình sau.



Nó sẽ hiển thị cho bạn môi trường cục bộ mà Portainer đang chạy. Nhấp vào môi trường cục bộ để bắt đầu.



Hầu hết các phần đều tự giải thích. Phần Ngăn xếp giúp tạo vùng chứa bằng cách sử dụng tệp Docker compose. Bạn có thể triển khai container trực tiếp bằng danh mục Containers trong thanh bên. Bạn có thể cấu hình môi trường docker hiện tại thông qua phần Hosts. Phần App Templates đi kèm với các tệp Docker compose được cài đặt sẵn để cài đặt các ứng dụng phổ biến nhất. Bạn cũng có thể tạo các mẫu tùy chỉnh.

Phần Settings cho phép bạn cấu hình nhiều cài đặt khác nhau như thêm các sổ đăng ký Docker tùy chỉnh, thêm nhiều máy chủ cho Docker swarm, cấu hình quyền truy cập của người dùng, sao lưu dữ liệu và tùy chỉnh Portainer.

Bước 5 - Đặt Portainer sau proxy ngược bằng Nginx Proxy Manager (NPM)​

Trước khi tiếp tục, chúng ta hãy đặt Portainer sau proxy ngược bằng Nginx Proxy Manager. Nginx Proxy Manager là ứng dụng Docker cung cấp giao diện người dùng quản lý web để thiết lập Nginx làm máy chủ proxy ngược. Nó cũng có thể được sử dụng làm máy chủ chuyển hướng hoặc máy chủ phát trực tuyến.

Cài đặt NPM​

Bước đầu tiên là tạo mạng cho Nginx Proxy Manager (NPM). Mở phần Mạng và nhấp vào nút Thêm mạng để tạo mạng mới.



Đặt tên cho mạng và giữ nguyên mọi cài đặt. Nhấp vào nút Tạo mạng để hoàn tất.



Truy cập Ngăn xếp và tạo ngăn xếp mới bằng nút Thêm ngăn xếp.



Đặt tên cho ngăn xếp là nginx-proxy-manager và dán mã sau vào đó.

version: "3.3"services: npm-app: image: 'jc21/nginx-proxy-manager:latest' container_name: npm-app restart: except-stopped ports: - '80:80' # Cổng HTTP công khai - '443:443' # Cổng HTTPS công khai - '81:81' # Cổng web quản trị # Thêm bất kỳ cổng Stream nào khác mà bạn muốn hiển thị # - '21:21' # Môi trường FTP: DB_MYSQL_HOST: "npm-db" DB_MYSQL_PORT: 3306 DB_MYSQL_USER: "npm" DB_MYSQL_PASSWORD: ${DB_MYSQL_PASSWORD} DB_MYSQL_NAME: "npm" # Bỏ chú thích dòng bên dưới nếu IPv6 không được bật trên máy chủ của bạn # DISABLE_IPV6: 'true' volumes: - ./npm-data:/data:Z - ./letsencrypt:/etc/letsencrypt:Z depends_on: - npm-db networks: - npm-network - npm-internal npm-db: image: 'mariadb:latest' container_name: npm-db restart: except-stopped environment: MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD} MYSQL_DATABASE: 'npm' MYSQL_USER: 'npm' MYSQL_PASSWORD: ${DB_MYSQL_PASSWORD} volumes: - ./npm-data/mysql:/var/lib/mysql:Z networks: - npm-internalnetworks: npm-internal: npm-network: external: true

Chúng tôi đã đặt hai biến môi trường để đặt mật khẩu cơ sở dữ liệu và MySQL gốc. Portainer có thể được sử dụng để đặt bí mật bằng cách sử dụng các biến môi trường. Cuộn xuống trang và nhấp vào nút Thêm biến môi trường để thêm mật khẩu mạnh.



Nhấp vào nút Triển khai ngăn xếp để tạo và khởi động vùng chứa NPM.

Truy cập NPM​

Mở URL https://<yourserverIP>:81 trong trình duyệt của bạn và bạn sẽ thấy màn hình sau. Nhập thông tin đăng nhập mặc định sau để đăng nhập.

Địa chỉ email: [emailprotected] Mật khẩu: changeme

Tiếp theo, bạn sẽ được yêu cầu đặt tên và địa chỉ email ngay lập tức. Nhấp vào nút Lưu và bạn sẽ được yêu cầu tạo mật khẩu mới. Nhấp vào nút Lưu một lần nữa để bắt đầu.



Truy cập Máy chủ >> Proxy Hosts và nhấp vào nút Add Proxy Host.



Nhập tên miền là portainer.example.com. Chọn lược đồ là https. Nhập tên của vùng chứa là Forward Hostname và 9443 là Forward port. Kiểm tra các tùy chọn Block Common Exploits và Websockets Support.



Chuyển sang tab SSL và chọn Request a new SSL Certificate từ menu thả xuống. Kiểm tra các tùy chọn Force SSL và HTTP/2 Support để bảo mật và tối ưu hóa kết nối SSL của bạn. Nhập địa chỉ email để nhận thông báo gia hạn và đồng ý với các điều khoản dịch vụ. Nhấp vào nút Lưu để hoàn tất việc thiết lập Proxy Host cho Portainer.

Kết nối Portainer với NPM Container​

Chúng tôi đã thiết lập Proxy host, nhưng container vẫn chưa được kết nối với mạng NPM. Quay lại bảng điều khiển Portainer, truy cập phần Containers và chọn container portainer.

Chọn npm-network từ menu thả xuống bên dưới phần Connected networks và nhấp vào nút Join network để thêm container Portainer vào mạng của trình quản lý proxy.



Bạn có thể gặp lỗi nhưng hãy làm mới trang và bạn sẽ thấy container được thêm vào mạng NPM.



Bạn sẽ có thể truy cập Portainer bằng URL https://portainer.example.com trong trình duyệt của mình.

Bạn có thể làm theo quy trình tương tự để đặt NPM sau URL có thể truy cập công khai như https://npm.example.com như đã thảo luận trong hướng dẫn Nginx Proxy Manager của chúng tôi.

Bây giờ bạn đã đặt URL công khai cho Portainer, bạn có thể tháo cổng 9443 đang hở ra. Để thực hiện điều đó, hãy quay lại Terminal và chuyển sang thư mục portainer.

$ cd ~/portainer

Mở tệp Docker compose để chỉnh sửa.

$ nano docker-compose.yaml

Xóa phần ports bằng cách bình luận, như hiển thị bên dưới.

version: "3.3"services: portainer: image: portainer/portainer-ce:latest container_name: portainer restart: always privileged: true volumes: - ./data:/data:Z - /var/run/docker.sock:/var/run/docker.sock:Z #ports: # - 9443:9443 networks: - npm-networknetworks: npm-network: external: true

Lưu tệp bằng cách nhấn Ctrl + X và nhập Y khi được nhắc.

Tại đây, chúng tôi đã thêm thông tin chi tiết về mạng NPM vì chúng tôi sẽ cần khởi động lại vùng chứa Portainer.

Dừng vùng chứa Portainer.

$ docker-compose down --remove-orphans

Khởi động lại vùng chứa với cấu hình đã cập nhật.

$ docker-compose up -d

Bước 6 - Triển khai container bằng App Template​

Portainer cung cấp một số mẫu được xác định trước để khởi chạy ứng dụng trực tiếp với cấu hình tối thiểu.



Truy cập phần App Templates và chọn bất kỳ mẫu nào. Đặt tên cho mẫu và chọn mạng để sử dụng. Sử dụng phần tùy chọn nâng cao để triển khai các cổng, mạng và ổ đĩa tùy chỉnh.

Nhấp vào nút Triển khai container để hoàn tất việc triển khai ứng dụng của bạn. Ở đây chúng ta đang triển khai container Redis.

Bước 7 - Quản lý container​

Chúng ta hãy quản lý một container hiện có. Mở trang container và bạn sẽ thấy tất cả các container đang chạy.



Nhấp vào container hw-redis vừa tạo để tiếp tục.



Ở trên cùng, bạn có thể thấy danh sách các hành động bạn có thể thực hiện trên một container đang chạy. Bạn có thể dừng và tắt container. Recreate sẽ tạo container từ đầu. Tùy chọn Duplicate/Edit sẽ cho phép bạn tạo một container giống hệt khác, cho phép bạn thay đổi cài đặt trước khi khởi chạy container đó.

Container status hiển thị thời gian chạy, địa chỉ IP và các chi tiết khác về container.

Tùy chọn Logs hiển thị đầu ra của lệnh docker logs. Vì đầu ra của lệnh không được lưu vào bộ nhớ đệm, nên mỗi lần bạn làm mới trang, lệnh sẽ được chạy từ đầu.



Tùy chọn Kiểm tra chạy lệnh docker inspect trên vùng chứa và hiển thị đầu ra của lệnh đó.



Tùy chọn Thống kê hiển thị cho bạn mức sử dụng vùng chứa theo thời gian thực.



Bạn có thể khởi chạy bảng điều khiển Vùng chứa bằng cách sử dụng tùy chọn Bảng điều khiển. Bạn sẽ được yêu cầu chạy lệnh và người dùng hệ thống.



Nhấn nút Kết nối để khởi chạy bảng điều khiển.



Tùy chọn Đính kèm chạy lệnh docker attach.

Có các tùy chọn khác trên trang Chi tiết vùng chứa. Bạn có thể tạo ảnh bằng cách sử dụng vùng chứa hiện có. Các tùy chọn khác bao gồm thay đổi chính sách khởi động lại của vùng chứa và kết nối hoặc ngắt kết nối mạng với vùng chứa hiện có.

Gắn vùng chứa bên ngoài vào Portainer​

Việc tạo bất kỳ vùng chứa nào bên ngoài Portainer sẽ hiển thị bên trong vùng chứa đó miễn là vùng chứa đó được tạo trên cùng hệ thống mà Portainer đang chạy. Điều này khả thi vì Portainer được kết nối với Docker bằng websocket.

Chúng ta hãy thử nghiệm bằng cách chạy container Hello World Docker.

$ docker run hello-worldKhông tìm thấy hình ảnh 'hello-world:latest' cục bộlatest: Đang kéo từ thư viện/hello-world2db29710123e: Đã kéo xongTóm tắt: sha256:10d7d58d5ebd2a652f4d93fdd86da8f265f5318c6a73cc5b6a9798ff6d2b2e67Trạng thái: Đã tải xuống hình ảnh mới hơn cho hello-world:latestXin chào từ Docker!Thông báo này cho biết cài đặt của bạn có vẻ đang hoạt động bình thường.Để tạo thông báo này, Docker đã thực hiện các bước sau: 1. Máy khách Docker đã liên hệ với daemon Docker. 2. Daemon Docker đã kéo hình ảnh "hello-world" từ Docker Hub. (amd64) 3. Daemon Docker đã tạo một container mới từ hình ảnh đó để chạy tệp thực thi tạo ra đầu ra mà bạn đang đọc. 4. Daemon Docker đã truyền phát đầu ra đó đến máy khách Docker, sau đó gửi đến thiết bị đầu cuối của bạn.Để thử một cái gì đó tham vọng hơn, bạn có thể chạy một container Ubuntu với: $ docker run -it ubuntu bashChia sẻ hình ảnh, tự động hóa quy trình làm việc và nhiều hơn nữa với ID Docker miễn phí: https://hub.docker.com/Để biết thêm ví dụ và ý tưởng, hãy truy cập: https://docs.docker.com/get-started/

Kiểm tra danh sách container trong thiết bị đầu cuối. Chúng tôi đang sử dụng cờ -a để hiển thị danh sách tất cả các container, bao gồm cả các container đã dừng. Bạn có thể thấy tên của container là sad_williamson.

$ docker ps -aCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES5fa46b85d594 hello-world "/hello" 3 phút trước Exited (0) 3 phút trước sad_williamson.....

Bây giờ, hãy kiểm tra trang Portainer Containers và container hello world sẽ hiển thị là đã dừng trong danh sách có cùng tên.

Kết luận​

Đây là phần kết thúc hướng dẫn của chúng tôi về cách cài đặt và sử dụng Portainer để quản lý Docker và Nginx Proxy Manager. Chúng tôi sẽ khám phá cách xây dựng hình ảnh docker, tạo container tùy chỉnh và sử dụng Portainer với Docker swarm trong hướng dẫn sắp tới. Nếu bạn có bất kỳ câu hỏi nào, hãy đăng chúng trong phần bình luận bên dưới.