- Giới thiệu
- Tính năng
- Cấu trúc dự án
- Cài đặt Local
- Deploy lên Cloudflare Pages
- Tích hợp Hệ thống Đại lý
- Tùy chỉnh Website
- Tech Stack
- Liên hệ & Hỗ trợ
NetProxy Index V2 là landing page được xây dựng với công nghệ hiện đại nhất, tối ưu cho hiệu suất và SEO. Website hỗ trợ đa ngôn ngữ (14 ngôn ngữ) với giao diện đẹp mắt, hiệu ứng mượt mà và tương thích hoàn hảo với Cloudflare Pages.
Dự án này được thiết kế để kết hợp với Seller Portal - hệ thống quản lý đại lý bán proxy chuyên nghiệp.
| Tính năng | Mô tả |
|---|---|
| 🌍 Đa ngôn ngữ (i18n) | Hỗ trợ 14 ngôn ngữ: Tiếng Việt, English, 中文, 日本語, 한국어, Русский, Español, ... |
| 🎬 Hiệu ứng mượt mà | Framer Motion, GSAP, Particles, Lenis Smooth Scroll |
| 📱 Responsive Design | Tương thích hoàn hảo trên Desktop, Tablet, Mobile |
| 🔍 SEO Optimized | Cấu trúc chuẩn SEO, meta tags, sitemap |
| 🌙 Dark Theme | Giao diện tối hiện đại, dễ nhìn |
| ⚡ Edge Runtime | Tối ưu cho Cloudflare Pages, tốc độ cực nhanh |
| 🧩 Component-based | Dễ dàng tùy chỉnh và mở rộng |
netproxy-index-v2/
│
├── 📂 app/
│ ├── 📂 [locale]/ # 🌍 Routes theo ngôn ngữ (vi, en, zh, ...)
│ │ ├── page.tsx # Trang chủ
│ │ ├── privacy-policy/ # Chính sách bảo mật
│ │ ├── term-service/ # Điều khoản dịch vụ
│ │ └── ...
│ ├── 📂 fonts/ # Font files (Inter, Neue Kaine)
│ ├── globals.css # Global styles
│ └── layout.tsx # Root layout
│
├── 📂 components/
│ ├── 📂 Header/ # Navigation bar
│ ├── 📂 Hero/ # Hero section với particles
│ ├── 📂 Pricing/ # Bảng giá
│ ├── 📂 FAQs/ # Câu hỏi thường gặp
│ ├── 📂 Footer/ # Footer
│ ├── 📂 Contact/ # Form liên hệ
│ ├── 📂 TrustedBy/ # Logo đối tác
│ └── 📂 ui/ # UI components (shadcn/ui)
│
├── 📂 messages/ # 🌍 File ngôn ngữ
│ ├── vi.json # Tiếng Việt
│ ├── en.json # English
│ ├── zh.json # 中文
│ └── ... # 14 ngôn ngữ
│
├── 📂 i18n/ # Cấu hình đa ngôn ngữ
├── 📂 lib/ # Utilities & helpers
├── 📂 hooks/ # Custom React hooks
├── 📂 public/ # Static assets (images, icons)
│
├── .env.example # Template biến môi trường
├── package.json # Dependencies
└── README.md # Tài liệu này
- ✅ Node.js 18.17 trở lên
- ✅ pnpm (khuyến nghị) hoặc npm/yarn
- ✅ Git
git clone https://github.com/lebachhiep/netproxy-index-v2.git
cd netproxy-index-v2# Sử dụng pnpm (khuyến nghị)
pnpm install
# Hoặc npm
npm install
# Hoặc yarn
yarn install# Copy file môi trường mẫu
cp .env.example .env.localMở file .env.local và cấu hình:
# API endpoint cho hệ thống proxy
NEXT_PUBLIC_API_BASE_URL=https://api.prx.networkpnpm dev
# hoặc
npm run devTruy cập 👉 http://localhost:3000
Website sẽ tự động chuyển hướng theo ngôn ngữ trình duyệt (/vi hoặc /en).
Đây là cách đơn giản nhất, Cloudflare sẽ tự động build và deploy mỗi khi bạn push code.
- Truy cập 👉 https://dash.cloudflare.com/
- Đăng nhập hoặc tạo tài khoản mới (miễn phí)
- Từ sidebar, chọn Workers & Pages
- Click nút Create
- Chọn tab Pages
- Click Connect to Git
- Click Connect GitHub
- Authorize Cloudflare truy cập GitHub của bạn
- Chọn repository:
lebachhiep/netproxy-index-v2 - Click Begin setup
Điền các thông tin sau:
| Mục | Giá trị |
|---|---|
| Project name | netproxy-index-v2 (hoặc tên bạn muốn) |
| Production branch | main |
| Framework preset | Next.js |
| Build command | npx @cloudflare/next-on-pages@1 |
| Build output directory | .vercel/output/static |
Click Add variable và thêm các biến sau:
| Variable Name | Value |
|---|---|
NEXT_PUBLIC_API_BASE_URL |
https://api.prx.network |
NODE_VERSION |
18 |
💡 Tip: Bạn có thể thay đổi
NEXT_PUBLIC_API_BASE_URLthành API của riêng bạn nếu có.
- Click Save and Deploy
- Đợi quá trình build hoàn tất (khoảng 2-5 phút)
- Sau khi thành công, bạn sẽ nhận được URL như:
https://netproxy-index-v2.pages.dev
✅ Done! Website của bạn đã online!
⚠️ Bắt buộc: Dự án này sử dụng Pages + Workers nên cần cấu hình Compatibility Flags để Node.js APIs hoạt động đúng.
- Trong Cloudflare Dashboard, vào project của bạn
- Click tab Settings
- Chọn Functions từ menu bên trái
Tìm phần Compatibility flags và thêm:
| Environment | Compatibility Flags |
|---|---|
| Production | nodejs_compat |
| Preview | nodejs_compat |
- Trong phần Production compatibility flags, click Add
- Nhập:
nodejs_compat - Click Save
- Lặp lại cho Preview compatibility flags
Tạo file wrangler.toml ở thư mục gốc:
name = "netproxy-index-v2"
compatibility_date = "2024-01-01"
compatibility_flags = ["nodejs_compat"]
[vars]
NEXT_PUBLIC_API_BASE_URL = "https://api.prx.network"💡 Tại sao cần
nodejs_compat?
- Next.js sử dụng một số Node.js APIs
- Cloudflare Workers mặc định không hỗ trợ đầy đủ Node.js APIs
- Flag
nodejs_compatcho phép sử dụng các APIs nhưBuffer,crypto,stream, v.v.
Sau khi thêm Compatibility Flags, bạn cần re-deploy:
- Vào tab Deployments
- Click ... ở deployment mới nhất
- Chọn Retry deployment
Hoặc push một commit mới để trigger auto-deploy.
Dành cho những ai muốn kiểm soát quá trình deploy.
npm install -g wranglerwrangler loginTrình duyệt sẽ mở ra, đăng nhập và authorize.
# Build Next.js
pnpm build
# Build cho Cloudflare Pages
npx @cloudflare/next-on-pages@1wrangler pages deploy .vercel/output/static --project-name=netproxy-index-v2wrangler pages secret put NEXT_PUBLIC_API_BASE_URL
# Nhập giá trị: https://api.prx.networkNếu bạn muốn sử dụng domain riêng thay vì *.pages.dev:
- Trong Cloudflare Pages project, vào tab Custom domains
- Click Set up a custom domain
- Nhập domain của bạn (ví dụ:
proxy.yourdomain.com) - Làm theo hướng dẫn cấu hình DNS:
- Nếu domain đã trên Cloudflare: Tự động cấu hình
- Nếu domain ở nơi khác: Thêm CNAME record
Seller Portal là hệ thống quản lý đại lý bán proxy chuyên nghiệp. Landing page này được thiết kế để kết hợp hoàn hảo với Seller Portal.
👉 URL: https://seller.prx.network/
| Tính năng | Mô tả |
|---|---|
| 📈 Dashboard | Tổng quan doanh thu, đơn hàng, khách hàng theo thời gian thực |
| 📦 Quản lý sản phẩm | Tạo gói proxy riêng, định giá linh hoạt theo ý bạn |
| 👥 Quản lý khách hàng | Theo dõi khách hàng, lịch sử mua hàng, hỗ trợ |
| 📊 Báo cáo chi tiết | Thống kê doanh thu, xuất báo cáo Excel/PDF |
| 🔌 API Integration | API để tích hợp tự động với website/app riêng |
| 🏷️ White-label | Tùy chỉnh thương hiệu, logo, màu sắc |
┌─────────────────────┐
│ 👤 Khách hàng │
│ truy cập website │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ 🌐 Landing Page │
│ (NetProxy Index) │
│ - Giới thiệu │
│ - Bảng giá │
│ - Tính năng │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ 🛒 Seller Portal │
│ seller.prx.network │
│ - Đăng ký/Login │
│ - Mua proxy │
│ - Quản lý đơn hàng │
└──────────┬──────────┘
│
▼
┌─────────────────────┐
│ 📡 PRX API │
│ api.prx.network │
│ - Xử lý đơn hàng │
│ - Cấp phát proxy │
│ - Quản lý IP │
└─────────────────────┘
- 📝 Đăng ký tài khoản tại seller.prx.network
- 💰 Nạp tiền vào tài khoản đại lý
- 📦 Tạo gói sản phẩm với giá bán riêng của bạn
- 🌐 Deploy landing page này với thông tin của bạn
- 🔗 Liên kết nút mua hàng đến Seller Portal
- 📈 Bắt đầu kinh doanh và theo dõi doanh thu!
Chỉnh sửa các file ngôn ngữ trong thư mục messages/:
messages/
├── vi.json # Tiếng Việt
├── en.json # English
└── ...Ví dụ chỉnh sửa messages/vi.json:
{
"hero": {
"title": "Tiêu đề của bạn",
"description": "Mô tả của bạn"
},
"pricing": {
"title": "Bảng giá"
}
}public/images/
├── logo/ # Logo website
├── hero/ # Hình ảnh hero section
├── trusted-by/ # Logo đối tác
└── ...Chỉnh sửa file app/globals.css:
:root {
--primary-color: #your-color;
--secondary-color: #your-color;
}Chỉnh sửa trong components/Footer/ và components/Contact/.
| Công nghệ | Phiên bản | Mô tả |
|---|---|---|
| ⚛️ Next.js | 16.0 | React Framework với App Router |
| 📱 React | 19.2 | UI Library |
| 📝 TypeScript | 5.x | Type Safety |
| 🎨 Tailwind CSS | 4.0 | Utility-first CSS |
| 🎬 Framer Motion | 12.x | Animations |
| 🎭 GSAP | 3.x | Advanced Animations |
| 🌍 next-intl | 4.x | Internationalization |
| 🧩 Radix UI | Latest | Headless UI Components |
| 🖱️ Lenis | 1.x | Smooth Scrolling |
| ✨ tsparticles | 2.x | Particle Effects |
| Command | Mô tả |
|---|---|
pnpm dev |
🚀 Chạy development server |
pnpm build |
📦 Build production |
pnpm start |
|
pnpm lint |
🔍 Kiểm tra lỗi ESLint |
Nếu bạn cần hỗ trợ hoặc có câu hỏi:
| Kênh | Thông tin |
|---|---|
| [email protected] | |
| 💬 Telegram | @NetProxy_Support |
| 🛒 Seller Portal | seller.prx.network |
| 📡 API Docs | api.prx.network |
MIT License - Xem file LICENSE để biết thêm chi tiết.
Made with ❤️ by NetProxy Team