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...
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:
- Truy cập Portainer tại
http://your-vps-ip:9000 - Đăng nhập với tài khoản đã tạo
- 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
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%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
