Quay lại danh sách
DevOps & Hệ thống

Hướng dẫn toàn diện sử dụng private Docker Registry với giao diện UI trên VPS cho doanh nghiệp

Đây là hướng dẫn chi tiết về cách thiết lập và vận hành private Docker Registry với giao diện người dùng trực quan (UI) trên VPS, phù hợp cho doanh nghiệp cần kiểm soát container...

DPTCloud Engineering4 phút đọc
Hướng dẫn toàn diện sử dụng private Docker Registry với giao diện UI trên VPS cho doanh nghiệp

Nguồn ảnh: congerdesign · Pixabay Content License

Đây là hướng dẫn chi tiết về cách thiết lập và vận hành private Docker Registry với giao diện người dùng trực quan (UI) trên VPS, phù hợp cho doanh nghiệp cần kiểm soát container images, đảm bảo bảo mật nội bộ và tối ưu hóa quy trình CI/CD. Hướng dẫn bao gồm các bước cài đặt, cấu hình SSL, tích hợp với Nginx, và sử dụng Portainer hoặc Docker UI để quản lý dễ dàng. Tất cả được triển khai trên nền tảng VPS NVMe, đảm bảo hiệu năng cao và khả năng mở rộng.

Giới thiệu về private Docker Registry và nhu cầu doanh nghiệp

Private Docker Registry cho phép doanh nghiệp lưu trữ và phân phối các container images nội bộ mà không cần phải công khai lên Docker Hub. Điều này giúp bảo vệ mã nguồn, tuân thủ chính sách bảo mật nội bộ, và giảm thời gian tải image khi triển khai ứng dụng trong môi trường nội bộ. Với VPS NVMe, doanh nghiệp có thể triển khai registry với hiệu năng cao, ổn định và chi phí hợp lý, phù hợp với các hệ thống phát triển và sản xuất nhỏ đến trung bình.

Yêu cầu và bước chuẩn bị

Để triển khai private Docker Registry với giao diện UI trên VPS, bạn cần:

  • Một VPS NVMe (tham khảo: Cloud VPS NVMe cho Docker, Nginx & Database)
  • Địa chỉ IP công khai hoặc tên miền (tốt nhất là đã cấu hình DNS)
  • Đã cài đặt Docker và Docker Compose
  • Chứng chỉ SSL (có thể dùng Let's Encrypt)
  • Phần mềm hỗ trợ như Nginx hoặc Traefik để proxy và bảo mật

Trước khi bắt đầu, đảm bảo VPS đã được cập nhật và cài đặt các công cụ cần thiết:

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose -y
sudo systemctl enable docker
sudo systemctl start docker

Thiết lập private Docker Registry với Portainer UI

Portainer là một giao diện UI mạnh mẽ cho phép quản lý Docker từ trình duyệt. Kết hợp với private Docker Registry, bạn có thể theo dõi, quản lý và phân phối image một cách trực quan.

Đầu tiên, tạo file `docker-compose.yml` để triển khai Registry và Portainer:

version: '3.8'

services:
  registry:
    image: registry:2
    container_name: docker-registry
    ports:
      - "5000:5000"
    volumes:
      - ./data:/var/lib/registry
    restart: always
    environment:
      REGISTRY_HTTP_ADDR: 0.0.0.0:5000
      REGISTRY_HTTP_TLS_CERTIFICATE: /certs/server.crt
      REGISTRY_HTTP_TLS_KEY: /certs/server.key
      REGISTRY_AUTH: htpasswd
      REGISTRY_AUTH_HTPASSWD_PATH: /auth/htpasswd
      REGISTRY_AUTH_HTPASSWD_REALM: Registry Realm
    volumes:
      - ./certs:/certs
      - ./auth:/auth
      - ./data:/var/lib/registry

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

Chạy lệnh để khởi động các dịch vụ:

docker-compose up -d

Để bảo mật, tạo tài khoản người dùng với mật khẩu:

sudo apt install apache2-utils -y
htpasswd -B -c ./auth/htpasswd admin

Chú ý: Đảm bảo thư mục `certs`, `auth`, và `data` được tạo trước khi chạy.

Tích hợp Nginx và SSL cho truy cập an toàn

Để truy cập private registry qua HTTPS, sử dụng Nginx làm reverse proxy. Tạo file cấu hình Nginx:

server {
    listen 443 ssl;
    server_name registry.yourdomain.com;

    ssl_certificate /etc/letsencrypt/live/registry.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/registry.yourdomain.com/privkey.pem;

    location / {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /v2/ {
        proxy_pass http://localhost:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Chạy Let's Encrypt để lấy chứng chỉ SSL:

sudo certbot certonly --standalone -d registry.yourdomain.com

Sau khi cấu hình, restart Nginx:

sudo systemctl restart nginx

Xác minh và kiểm tra hoạt động

Để kiểm tra xem private registry hoạt động, thực hiện các bước sau:

  1. Truy cập Portainer tại http://your-vps-ip:9000
  2. Đăng nhập với tài khoản đã tạo
  3. Chạy lệnh Docker để push image:
docker tag myimage:latest registry.yourdomain.com/myimage:latest
docker login registry.yourdomain.com
docker push registry.yourdomain.com/myimage:latest

Nếu thành công, image sẽ xuất hiện trong giao diện Portainer hoặc Registry UI.

Giải quyết sự cố và bảo trì

Một số lỗi phổ biến:

  • Không thể push image: Kiểm tra lại chứng chỉ SSL, cấu hình Nginx, và tài khoản đăng nhập.
  • Portainer không hiển thị container: Đảm bảo Docker socket được mount đúng vào container Portainer.
  • Registry không bắt được request: Kiểm tra log Docker: docker logs docker-registry.

Để bảo trì, định kỳ sao lưu thư mục `data` và `auth`, đồng thời cập nhật phiên bản Docker và Portainer.

Tài liệu tham khảo

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478