DPTCloud
Back to articles
Technology Insight

Tự dựng Private NPM Registry Siêu Nhẹ Cho Đội Ngũ Lập Trình Viên Frontend Bằng Verdaccio Trên VPS ARM64 Miễn Phí

June 4, 2026

Giới Thiệu: Bài Toán Quản Lý Package Nội Bộ Trong Đội Ngũ Frontend

Trong kỷ nguyên của kiến trúc Micro-Frontend và xu hướng tái sử dụng mã nguồn (code reusability), việc chia sẻ các thành phần giao diện (UI Components), thư viện tiện ích (Utils), hay các cấu hình boilerplate giữa các dự án là điều tối quan trọng. Đối với các đội ngũ lập trình viên Frontend, giải pháp phổ biến nhất là đóng gói chúng thành các NPM package.

Tuy nhiên, một thách thức lớn xuất hiện: Làm thế nào để lưu trữ và quản lý các package nội bộ này một cách an toàn, hiệu quả mà không tốn kém chi phí?

Việc sử dụng dịch vụ trả phí như NPM Enterprise hay GitHub Packages có thể trở thành gánh nặng tài chính đối với các startup hoặc đội ngũ vừa và nhỏ. Ngược lại, việc cài đặt trực tiếp qua Git URL lại bộc lộ nhiều hạn chế về quản lý phiên bản (semantic versioning) và tốc độ tải. Chính vì vậy, giải pháp tối ưu nhất là tự vận hành một Private NPM Registry. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách xây dựng một hệ thống như vậy bằng Verdaccio trên hạ tầng VPS ARM64 miễn phí (như Oracle Cloud Free Tier) — một giải pháp vừa mạnh mẽ, siêu nhẹ lại hoàn toàn tiết kiệm chi phí.

Tại Sao Lại Chọn Verdaccio Và Hạ Tầng VPS ARM64?

1. Verdaccio - Private NPM Registry Siêu Nhẹ

Verdaccio là một registry mã nguồn mở, hoạt động theo cơ chế proxy-registry. Nó không chỉ cho phép bạn lưu trữ các package private mà còn đóng vai trò là một bộ nhớ đệm (local cache) cho các public package từ npmjs.org. Điều này giúp tăng tốc độ đáng kể cho các lệnh npm install hoặc yarn install trong mạng nội bộ. Điểm mạnh lớn nhất của Verdaccio là dung lượng cực kỳ nhẹ, tiêu tốn rất ít tài nguyên CPU và RAM, hoàn hảo để chạy trên các môi trường có cấu hình khiêm tốn.

2. VPS ARM64 - Xu Hướng Tối Ưu Chi Phí Và Hiệu Năng

Kiến trúc ARM64 ngày càng khẳng định vị thế trong thế giới máy chủ nhờ hiệu suất vượt trội trên mỗi watt điện năng. Đặc biệt, các nhà cung cấp cloud lớn như Oracle Cloud hiện đang cung cấp chương trình "Always Free" với cấu hình lên tới 4 Cores và 24 GB RAM sử dụng chip Ampere Altra ARM64. Đây là một tài nguyên cực kỳ lý tưởng để triển khai các dịch vụ DevOps nội bộ cho đội ngũ Frontend mà không phát sinh bất kỳ chi phí nào.

---

Hướng Dẫn Từng Bước Cài Đặt Verdaccio Trên VPS ARM64

Để chuẩn bị triển khai, bạn cần sở hữu một VPS chạy hệ điều hành Ubuntu/Debian (kiến trúc ARM64) và đã được cấu hình trỏ tên miền (Domain) về IP của VPS.

Bước 1: Cài Đặt Môi Trường Node.js Và Docker

Verdaccio có thể chạy trực tiếp qua Node.js hoặc thông qua Docker. Để đảm bảo tính đóng gói và dễ dàng quản lý, chúng ta sẽ sử dụng Docker.

Trước tiên, hãy cập nhật hệ thống và cài đặt Docker:

sudo apt update && sudo apt upgrade -y
sudo apt install docker.io docker-compose -y
Lưu ý: Hình ảnh Docker chính thức của Verdaccio hỗ trợ đa kiến trúc (Multi-arch), bao gồm cả linux/arm64, nên hệ thống sẽ tự động tải phiên bản tối ưu nhất cho VPS của bạn.

Bước 2: Cấu Hình File docker-compose.yml Cho Verdaccio

Tạo một thư mục làm việc và thiết lập cấu hình cho Verdaccio:

mkdir -p ~/verdaccio/storage ~/verdaccio/conf
cd ~/verdaccio

Tạo file cấu hình chính cho Verdaccio tại đường dẫn ~/verdaccio/conf/config.yaml với nội dung cơ bản sau để đảm bảo bảo mật:

storage: /verdaccio/storage/data
plugins: /verdaccio/plugins

web:
  title: "Doanh Nghiep Private Registry"

auth:
  htpasswd:
    file: /verdaccio/storage/htpasswd

uplinks:
  npmjs:
    url: [https://registry.npmjs.org/](https://registry.npmjs.org/)

packages:
  '@internal/*':
    access: $authenticated
    publish: $authenticated
    proxy: npmjs
  '**':
    access: $all
    publish: $authenticated
    proxy: npmjs

logs: { type: stdout, format: pretty, level: http }

Tiếp theo, tạo file docker-compose.yml để khởi chạy dịch vụ:

version: '3.8'

services:
  verdaccio:
    image: verdaccio/verdaccio:latest
    container_name: verdaccio
    ports:
      - "4873:4873"
    volumes:
      - ./storage:/verdaccio/storage
      - ./conf:/verdaccio/conf
    restart: always

Khởi động container bằng lệnh:

sudo docker-compose up -d

Bước 3: Cấu Hình Nginx Reverse Proxy Và SSL Let's Encrypt

Để đội ngũ lập trình viên có thể truy cập an toàn qua giao thức HTTPS, chúng ta cần thiết lập Nginx làm Reverse Proxy và cài đặt chứng chỉ SSL.

sudo apt install nginx certbot python3-certbot-nginx -y

Cấu hình một server block mới cho Nginx tại /etc/nginx/sites-available/npm.yourdomain.com:

server {
    server_name npm.yourdomain.com;

    location / {
        proxy_pass http://localhost:4873;
        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;
    }
}

Kích hoạt cấu hình và lấy chứng chỉ SSL:

sudo ln -s /etc/nginx/sites-available/npm.yourdomain.com /etc/nginx/sites-enabled/
sudo systemctl restart nginx
sudo certbot --nginx -d npm.yourdomain.com
---

Cách Sử Dụng Private Registry Trong Quy Trình Làm Việc Thực Tế

Sau khi hệ thống đã hoạt động ổn định qua tên miền bảo mật, đội ngũ Frontend có thể bắt đầu tích hợp vào quy trình phát triển.

1. Đăng Ký Tài Khoản Và Đăng Nhập

Thành viên trong đội ngũ cần trỏ CLI của họ về registry mới để đăng ký tài khoản:

npm adduser --registry [https://npm.yourdomain.com](https://npm.yourdomain.com)

Sau khi nhập Username, Password và Email, tài khoản sẽ được lưu vào file htpasswd trên VPS. Để bảo mật sau khi toàn đội đã tạo xong tài khoản, bạn nên tắt tính năng tự đăng ký trong file config.yaml.

2. Phát Hành Package Nội Bộ (Publish)

Trong file package.json của thư viện bạn muốn chia sẻ, hãy định nghĩa phạm vi (scope) và registry đích:

{
  "name": "@internal/ui-components",
  "version": "1.0.0",
  "publishConfig": {
    "registry": "[https://npm.yourdomain.com](https://npm.yourdomain.com)"
  }
}

Chạy lệnh sau để phát hành:

npm publish

3. Cài Đặt Package Cho Dự Án Client

Tại dự án Frontend cần sử dụng thư viện nội bộ, bạn không cần thay đổi registry mặc định của toàn hệ thống. Hãy tạo một file .npmrc ngay tại thư mục gốc của dự án:

@internal:registry=[https://npm.yourdomain.com](https://npm.yourdomain.com)
//[npm.yourdomain.com/:_authToken=](https://npm.yourdomain.com/:_authToken=)"YOUR_AUTH_TOKEN"

Bằng cách này, mọi package có prefix @internal sẽ được tải về từ Private VPS của bạn, trong khi các package khác như react, vue, lodash vẫn được tải từ npmjs.org công cộng thông qua cơ chế proxy/cache của Verdaccio.

---

Kết Luận Và Khuyến Nghị Về Bảo Mật

Việc tự dựng Private NPM Registry bằng Verdaccio trên VPS ARM64 là một giải pháp tối ưu, dung hòa hoàn hảo giữa yếu tố chi phí, hiệu năng và quyền kiểm soát mã nguồn. Đội ngũ Frontend của bạn giờ đây có thể thoải mái module hóa các dự án mà không lo ngại về vấn đề chi phí bản quyền hay rò rỉ mã nguồn ra bên ngoài.

Để hệ thống vận hành bền vững, chúng tôi khuyến nghị bạn thực hiện thêm các biện pháp sau:

  • Sao lưu định kỳ (Backup): Lập lịch backup thư mục ~/verdaccio/storage lên các dịch vụ cloud storage như S3 hoặc Google Drive.
  • Giới hạn quyền đăng ký: Thay đổi cấu hình max_users: -1 trong Verdaccio sau khi đã tạo đủ tài khoản cho nhân sự hiện tại.
  • Giám sát tài nguyên: Sử dụng các công cụ nhẹ như Prometheus và Grafana để theo dõi dung lượng ổ đĩa của VPS, tránh tình trạng đầy bộ nhớ do cache package công cộng.
Tự dựng Private NPM Registry Siêu Nhẹ Cho Đội Ngũ Lập Trình Viên Frontend Bằng Verdaccio Trên VPS ARM64 Miễn Phí | DPTCloud