AI Engineering Tools

Lập trình

Thuật ngữ máy chủ phát triển và triển khai

Tra cứu máy chủ cục bộ, URL mạng, cổng, bản dựng, triển khai, cảnh báo và lỗi web thường gặp.

42 mục

Phát triển cục bộ

localhost

localhost

http://localhost:3001

Ý nghĩa

Một tên máy chủ (hostname) trỏ đến cùng một máy tính đang chạy trình duyệt hoặc lệnh.

Cách dùng

Sử dụng localhost khi kiểm tra trang web trên cùng một máy Mac hoặc PC nơi máy chủ phát triển đang chạy.

Lưu ý

Một điện thoại hoặc máy tính bảng có địa chỉ localhost riêng, vì vậy nó không thể sử dụng địa chỉ localhost của máy Mac.

Ví dụ

http://localhost:3001

Ví dụ yêu cầu

Mở trang web cục bộ tại localhost và kiểm tra trang tham khảo mới.

Phát triển cục bộ

127.0.0.1

127.0.0.1

http://127.0.0.1:3001

Ý nghĩa

Một địa chỉ IP vòng lại (loopback IP address) cũng trỏ đến cùng một máy tính cục bộ.

Cách dùng

Nó thường có thể thay thế cho localhost để kiểm thử trên cùng một thiết bị.

Ví dụ

http://127.0.0.1:3001

Ví dụ yêu cầu

Thử 127.0.0.1 nếu localhost không được phân giải chính xác.

Phát triển cục bộ

Dev server

Dev server

npm run dev

Ý nghĩa

Một máy chủ được sử dụng trong quá trình phát triển, với khả năng xây dựng lại nhanh chóng và các tính năng dành riêng cho phát triển.

Cách dùng

Sử dụng nó để xem trước các thay đổi trước khi xây dựng hoặc triển khai trang web.

Lưu ý

Hành vi của máy chủ phát triển không phải lúc nào cũng giống hệt với hành vi của môi trường sản xuất.

Ví dụ

npm run dev

Ví dụ yêu cầu

Khởi động máy chủ phát triển để tôi có thể kiểm tra trang trên iPhone của mình.

Phát triển cục bộ

Cổng

Port

http://localhost:3001

Ý nghĩa

Một số nhận dạng tiến trình máy chủ nào nên nhận kết nối trên một máy.

Cách dùng

Nếu một máy chủ sử dụng cổng 3001, máy chủ khác phải sử dụng một cổng khác, chẳng hạn như 3002.

Ví dụ

http://localhost:3001

Ví dụ yêu cầu

Nếu cổng 3001 đã được sử dụng, hãy khởi động máy chủ phát triển trên một cổng khác.

Phát triển cục bộ

URL cục bộ

Local URL

Local: http://localhost:3001

Ý nghĩa

Địa chỉ được sử dụng từ cùng một thiết bị nơi máy chủ phát triển đang chạy.

Cách dùng

Sử dụng URL cục bộ để kiểm tra trình duyệt trên máy phát triển.

Ví dụ

Local: http://localhost:3001

Ví dụ yêu cầu

Cho tôi biết URL cục bộ sau khi khởi động máy chủ phát triển.

Truy cập mạng

URL mạng

Network URL

Network: http://172.30.1.55:3001

Ý nghĩa

Một địa chỉ mà các thiết bị khác trên cùng một mạng có thể sử dụng để truy cập máy chủ phát triển.

Cách dùng

Sử dụng khi kiểm tra trang web từ một iPhone, iPad hoặc máy tính khác trên cùng một mạng Wi-Fi.

Lưu ý

Máy chủ phát triển phải lắng nghe trên một máy chủ có thể truy cập qua mạng, chẳng hạn như 0.0.0.0.

Ví dụ

Network: http://172.30.1.55:3001

Ví dụ yêu cầu

Khởi động máy chủ phát triển với URL mạng để tôi có thể kiểm tra nó trên iPad của mình.

Truy cập mạng

Địa chỉ IP

IP address

172.30.1.55

Ý nghĩa

Một địa chỉ số nhận dạng một thiết bị trên mạng.

Cách dùng

Một địa chỉ IP LAN cho phép một thiết bị khác trên cùng một mạng Wi-Fi truy cập máy chủ phát triển của bạn.

Lưu ý

Địa chỉ IP của mạng cục bộ có thể thay đổi khi điều kiện Wi-Fi hoặc bộ định tuyến thay đổi.

Ví dụ

172.30.1.55

Ví dụ yêu cầu

Sử dụng IP LAN hiện tại khi thêm allowedDevOrigins để kiểm tra thiết bị.

Truy cập mạng

Máy chủ

Host

--hostname 0.0.0.0

Ý nghĩa

Địa chỉ mà máy chủ liên kết khi bắt đầu lắng nghe các yêu cầu.

Cách dùng

Liên kết đến 0.0.0.0 cho phép máy chủ phát triển có thể truy cập từ các thiết bị khác trên mạng.

Ví dụ

--hostname 0.0.0.0

Ví dụ yêu cầu

Chạy máy chủ phát triển với tên máy chủ `0.0.0.0` để kiểm tra trên điện thoại.

Truy cập mạng

Mạng tương tự

Same network

Máy Mac và iPhone trên cùng một mạng Wi-Fi

Ý nghĩa

Các thiết bị kết nối với cùng một mạng cục bộ, thường là cùng một bộ định tuyến Wi-Fi.

Cách dùng

Một điện thoại chỉ có thể kết nối đến máy chủ phát triển của máy Mac khi cài đặt mạng cho phép.

Ví dụ

Máy Mac và iPhone trên cùng một mạng Wi-Fi

Ví dụ yêu cầu

Kiểm tra xem iPhone và Mac có nằm trên cùng một mạng hay không trước khi gỡ lỗi trang web.

Hành vi Next.js

allowedDevOrigins

allowedDevOrigins

allowedDevOrigins: ['172.30.1.55']

Ý nghĩa

Một cài đặt phát triển Next.js cho phép các nguồn gốc cụ thể truy cập tài nguyên phát triển.

Cách dùng

Nó có thể cần thiết khi kiểm tra một máy chủ phát triển Next từ điện thoại hoặc máy tính bảng bằng IP LAN.

Lưu ý

Đây là một cấu hình dành cho quá trình phát triển. Các trang web tĩnh đã được triển khai không sử dụng cùng một đường dẫn truy cập tài nguyên phát triển.

Ví dụ

allowedDevOrigins: ['172.30.1.55']

Ví dụ yêu cầu

Thêm địa chỉ IP LAN hiện tại của tôi vào allowedDevOrigins để kiểm thử phát triển.

Truy cập mạng

Cùng nguồn gốc

Cross-origin

Blocked cross-origin request

Ý nghĩa

Một yêu cầu giữa các nguồn gốc khác nhau, trong đó lược đồ, máy chủ hoặc cổng khác nhau.

Cách dùng

Các công cụ phát triển có thể chặn truy cập chéo miền đến các tài nguyên phát triển nhạy cảm theo mặc định.

Ví dụ

Blocked cross-origin request

Ví dụ yêu cầu

Giải thích xem cảnh báo về lỗi giao tiếp giữa các nguồn khác nhau (cross-origin) có ảnh hưởng đến việc triển khai trên môi trường sản xuất hay không.

Hành vi Next.js

HMR

HMR

/_next/webpack-hmr

Ý nghĩa

Hot Module Replacement cập nhật trình duyệt trong quá trình phát triển mà không cần tải lại hoàn toàn.

Cách dùng

Nếu tài nguyên phát triển HMR bị chặn, trang có thể tải, nhưng các bản cập nhật tương tác hoặc các tập lệnh có thể hoạt động bất thường trong quá trình phát triển.

Lưu ý

HMR chỉ dành cho quá trình phát triển và không phải là một phần của bản xuất tĩnh cuối cùng.

Ví dụ

/_next/webpack-hmr

Ví dụ yêu cầu

Kiểm tra xem sự cố với iPhone có phải do tài nguyên phát triển HMR bị chặn hay không.

Hành vi Next.js

Turbopack

Turbopack

Next.js 16.2.5 (Turbopack)

Ý nghĩa

Một trình đóng gói được sử dụng bởi Next.js cho các quy trình phát triển và xây dựng.

Cách dùng

Bạn có thể thấy tên của nó trong đầu ra của máy chủ phát triển hoặc quá trình biên dịch.

Ví dụ

Next.js 16.2.5 (Turbopack)

Ví dụ yêu cầu

Tóm tắt đầu ra của Turbopack và cho tôi biết quá trình xây dựng có thành công hay không.

Hành vi Next.js

App Router

App Router

src/app/[locale]/reference/page.tsx

Ý nghĩa

Hệ thống định tuyến Next.js dựa trên thư mục ứng dụng.

Cách dùng

Thêm một tệp page.tsx trong một thư mục sẽ tạo một tuyến đường.

Ví dụ

src/app/[locale]/reference/page.tsx

Ví dụ yêu cầu

Thêm trang tham khảo mới bằng cấu trúc thư mục App Router.

Hành vi Next.js

generateStaticParams

generateStaticParams

generateStaticParams()

Ý nghĩa

Một hàm Next.js khai báo các tuyến động nào sẽ được tạo trong quá trình xây dựng.

Cách dùng

Các trang ngôn ngữ sử dụng nó để tạo các đường dẫn ngôn ngữ như /en, /ko, /ja, và các ngôn ngữ khác.

Ví dụ

generateStaticParams()

Ví dụ yêu cầu

Đảm bảo rằng trang tham khảo mới có generateStaticParams cho tất cả các ngôn ngữ.

Build và đầu ra

Xây dựng

Build

npm run build

Ý nghĩa

Quá trình biên dịch và chuẩn bị trang web cho môi trường sản xuất hoặc đầu ra tĩnh.

Cách dùng

Chạy quá trình xây dựng trước khi triển khai để phát hiện các vấn đề về TypeScript, định tuyến và tạo tĩnh.

Ví dụ

npm run build

Ví dụ yêu cầu

Chạy quá trình xây dựng và xác nhận rằng tuyến đường mới đã được tạo.

Build và đầu ra

Kiểm tra cú pháp

Lint

npm run lint

Ý nghĩa

Một kiểm tra mã tĩnh để phát hiện các vấn đề về kiểu dáng, tính chính xác và quy tắc của framework.

Cách dùng

Kiểm tra cú pháp là một kiểm tra nhanh trước khi xây dựng hoặc cam kết.

Ví dụ

npm run lint

Ví dụ yêu cầu

Chạy `lint` sau khi chỉnh sửa các trang tham khảo.

Build và đầu ra

Xuất tĩnh

Static export

output: "export"

Ý nghĩa

Một kết quả xây dựng trong đó các trang được tạo dưới dạng các tệp tĩnh thay vì cần một máy chủ đang chạy.

Cách dùng

Xuất tĩnh hữu ích cho việc lưu trữ các trang dưới dạng các tệp HTML, CSS và JavaScript được tạo sẵn.

Lưu ý

Một số tính năng chỉ dành cho máy chủ không hoạt động với việc xuất tĩnh.

Ví dụ

output: "export"

Ví dụ yêu cầu

Giữ trang mới tương thích với xuất tĩnh.

Build và đầu ra

SSG

SSG

● (SSG) được tạo sẵn dưới dạng HTML tĩnh

Ý nghĩa

Tạo trang tĩnh tạo các trang tại thời điểm xây dựng.

Cách dùng

Các trang tham chiếu với `generateStaticParams` được tạo cho mỗi ngôn ngữ trong quá trình xây dựng.

Ví dụ

● (SSG) được tạo sẵn dưới dạng HTML tĩnh

Ví dụ yêu cầu

Xác nhận rằng đường dẫn tham chiếu xuất hiện dưới dạng SSG trong đầu ra quá trình xây dựng.

Build và đầu ra

Tải trước

Prerender

được tạo trước dưới dạng nội dung tĩnh.

Ý nghĩa

Hiển thị một trang trước khi người dùng yêu cầu, thường trong quá trình xây dựng.

Cách dùng

Các trang được tải trước nhanh chóng vì HTML đã tồn tại.

Ví dụ

được tạo trước dưới dạng nội dung tĩnh.

Ví dụ yêu cầu

Kiểm tra xem tất cả các trang theo khu vực có được hiển thị trước (prerendered) thành công hay không.

Build và đầu ra

Gói

Bundle

tập tin JS tĩnh

Ý nghĩa

Các tệp đã biên dịch kết hợp mã và các phụ thuộc cho trình duyệt.

Cách dùng

Các gói lớn có thể ảnh hưởng đến tốc độ tải và cần được theo dõi khi trang web phát triển.

Ví dụ

tập tin JS tĩnh

Ví dụ yêu cầu

Tránh thêm một thư viện lớn chỉ để sử dụng cho một trang tham khảo đơn giản.

Triển khai

Triển khai

Deploy

triển khai đầu ra tĩnh

Ý nghĩa

Xuất bản trang web đã được xây dựng để người dùng có thể truy cập nó trên web.

Cách dùng

Triển khai xảy ra sau khi kiểm tra cục bộ, kiểm tra mã và xây dựng thành công.

Ví dụ

triển khai đầu ra tĩnh

Ví dụ yêu cầu

Đừng triển khai ngay bây giờ; chỉ cần chuẩn bị trang và chạy quá trình biên dịch.

Triển khai

Sản xuất

Production

triển khai cho môi trường sản xuất.

Ý nghĩa

Môi trường triển khai thực tế mà người dùng truy cập.

Cách dùng

Quá trình sản xuất nên được kiểm tra khác với máy chủ phát triển cục bộ vì các tính năng chỉ dành cho phát triển không có mặt.

Ví dụ

triển khai cho môi trường sản xuất.

Ví dụ yêu cầu

Giải thích xem cảnh báo này có ảnh hưởng đến môi trường sản xuất hay chỉ ảnh hưởng đến quá trình phát triển.

Triển khai

Lưu trữ

Hosting

nhà cung cấp dịch vụ lưu trữ tĩnh

Ý nghĩa

Dịch vụ hoặc máy chủ lưu trữ và cung cấp các tệp trang web đã được triển khai.

Cách dùng

Xuất tĩnh có thể được phục vụ bởi máy chủ tĩnh khi không cần logic máy chủ.

Ví dụ

nhà cung cấp dịch vụ lưu trữ tĩnh

Ví dụ yêu cầu

Đảm bảo rằng đầu ra hoạt động trên máy chủ tĩnh.

Triển khai

Miền (Domain)

Domain

example.com

Ý nghĩa

Địa chỉ dễ đọc mà người dùng nhập để truy cập một trang web.

Cách dùng

Một tên miền trỏ đến vị trí lưu trữ được triển khai thông qua DNS.

Ví dụ

example.com

Ví dụ yêu cầu

Không mã hóa cứng địa chỉ localhost trong các liên kết mà phải hoạt động trên miền sản xuất.

Triển khai

DNS

DNS

Bản ghi / bản ghi CNAME

Ý nghĩa

Hệ thống ánh xạ tên miền đến máy chủ hoặc đích lưu trữ.

Cách dùng

DNS phải được cấu hình chính xác để miền tùy chỉnh có thể truy cập trang web đã triển khai.

Ví dụ

Bản ghi / bản ghi CNAME

Ví dụ yêu cầu

Giải thích xem vấn đề là do lỗi DNS hay do lỗi trong quá trình biên dịch ứng dụng.

Triển khai

Bộ nhớ đệm

Cache

clear browser cache

Ý nghĩa

Lưu trữ các bản sao của các tệp hoặc phản hồi được sử dụng để tải trang nhanh hơn.

Cách dùng

Sau khi triển khai, các tệp cache cũ có thể khiến trình duyệt hiển thị phiên bản trước trong một thời gian.

Ví dụ

clear browser cache

Ví dụ yêu cầu

Kiểm tra xem trang cũ có còn hiển thị hay không do bộ nhớ đệm.

Runtime

Node.js

Node.js

node --version

Ý nghĩa

Một môi trường thời gian chạy JavaScript được sử dụng để chạy các công cụ phát triển, tập lệnh xây dựng và máy chủ.

Cách dùng

Các lệnh dev và build của Next.js chạy trên Node.js.

Ví dụ

node --version

Ví dụ yêu cầu

Hãy cho tôi biết cảnh báo này đến từ Node.js, Next.js, hay từ mã ứng dụng của tôi.

Runtime

npm

npm

npm run build

Ý nghĩa

Một trình quản lý gói và trình chạy script thường được sử dụng trong các dự án JavaScript.

Cách dùng

package.json định nghĩa các script như dev, lint và build mà npm có thể thực thi.

Ví dụ

npm run build

Ví dụ yêu cầu

Chạy script xây dựng `npm` và tóm tắt kết quả.

Runtime

package.json

package.json

"scripts": { "dev": "next dev -p 3001" }

Ý nghĩa

Một tệp dự án xác định các script, phụ thuộc và siêu dữ liệu gói.

Cách dùng

Kiểm tra package.json để biết các lệnh mà dự án mong đợi bạn chạy.

Ví dụ

"scripts": { "dev": "next dev -p 3001" }

Ví dụ yêu cầu

Kiểm tra package.json trước khi quyết định lệnh phát triển nào cần chạy.

Runtime

Biến môi trường

Environment variable

NEXT_PUBLIC_SITE_URL=https://example.com

Ý nghĩa

Một giá trị được cung cấp cho ứng dụng hoặc môi trường xây dựng bên ngoài mã nguồn.

Cách dùng

Các biến môi trường được sử dụng cho các URL của trang web, khóa API và các cài đặt dành riêng cho việc triển khai.

Lưu ý

Bí mật không nên được hiển thị thông qua các biến phía máy khách công khai.

Ví dụ

NEXT_PUBLIC_SITE_URL=https://example.com

Ví dụ yêu cầu

Không mã hóa cứng URL của trang web sản xuất nếu đã có biến môi trường.

Lỗi và cảnh báo

404

404

404 Not Found

Ý nghĩa

Một lỗi có nghĩa là trang hoặc tệp được yêu cầu không được tìm thấy.

Cách dùng

Nó có thể xảy ra khi một tuyến đường đã bị xóa, đổi tên hoặc không được tạo trong đầu ra tĩnh.

Ví dụ

404 Not Found

Ví dụ yêu cầu

Kiểm tra xem URL cơ bản của tính năng programming-basics hiện tại có trả về mã lỗi 404 sau khi bị xóa hay không.

Lỗi và cảnh báo

500

500

500 Internal Server Error

Ý nghĩa

Một lỗi có nghĩa là máy chủ đã gặp sự cố trong khi xử lý yêu cầu.

Cách dùng

Trong quá trình phát triển, terminal hoặc lớp phủ trình duyệt thường hiển thị lỗi nguồn.

Ví dụ

500 Internal Server Error

Ví dụ yêu cầu

Nếu xuất hiện lỗi 500, hãy kiểm tra thông báo lỗi trong terminal và xác định tệp bị lỗi.

Lỗi và cảnh báo

Module not found

Module not found

Module not found: Can't resolve '@/lib/programming'

Ý nghĩa

Một lỗi có nghĩa là một import trỏ đến một tệp hoặc gói không thể tìm thấy.

Cách dùng

Nó thường xảy ra sau khi di chuyển, xóa hoặc đổi tên tệp mà không cập nhật các import.

Ví dụ

Module not found: Can't resolve '@/lib/programming'

Ví dụ yêu cầu

Tìm và cập nhật bất kỳ import nào vẫn còn trỏ đến tệp đã bị xóa.

Lỗi và cảnh báo

Không tìm thấy đối tượng được xuất.

Export not found

Export programmingBasicsCopy doesn't exist

Ý nghĩa

Một lỗi có nghĩa là một tệp tồn tại, nhưng xuất khẩu có tên được yêu cầu không được cung cấp bởi tệp đó.

Cách dùng

Nó có thể xảy ra khi một đối tượng dữ liệu được đổi tên nhưng các import vẫn sử dụng tên cũ.

Ví dụ

Export programmingBasicsCopy doesn't exist

Ví dụ yêu cầu

Thay thế tên xuất hiện cũ bằng tên mới ở mọi nơi.

Lỗi và cảnh báo

EADDRINUSE

EADDRINUSE

listen EADDRINUSE: address already in use 0.0.0.0:3001

Ý nghĩa

Một lỗi có nghĩa là một quy trình khác đang sử dụng máy chủ và cổng được yêu cầu.

Cách dùng

Sử dụng một cổng khác hoặc dừng máy chủ hiện có nếu bạn muốn thay thế nó một cách có chủ ý.

Ví dụ

listen EADDRINUSE: address already in use 0.0.0.0:3001

Ví dụ yêu cầu

Nếu EADDRINUSE xuất hiện, hãy cho tôi biết cổng nào đang bị sử dụng và sử dụng một cổng khác.

Lỗi và cảnh báo

DeprecationWarning

DeprecationWarning

[DEP0205] DeprecationWarning: module.register() is deprecated

Ý nghĩa

Một cảnh báo cho biết một API vẫn hoạt động hiện tại nhưng có thể bị xóa hoặc thay đổi sau này.

Cách dùng

Các cảnh báo nên được chú ý, nhưng chúng không phải lúc nào cũng là lỗi ngăn chặn quá trình biên dịch.

Ví dụ

[DEP0205] DeprecationWarning: module.register() is deprecated

Ví dụ yêu cầu

Hãy cho tôi biết cảnh báo "DeprecationWarning" này có gây hại hay cần thay đổi mã.

Lỗi và cảnh báo

Thủy hóa

Hydration

Hydration failed because the server rendered HTML didn't match

Ý nghĩa

Quá trình mà JavaScript phía máy khách kết nối với HTML được tạo trên máy chủ.

Cách dùng

Lỗi không khớp xảy ra khi máy chủ và máy khách hiển thị nội dung ban đầu khác nhau.

Ví dụ

Hydration failed because the server rendered HTML didn't match

Ví dụ yêu cầu

Nếu quá trình thủy hóa thất bại, hãy kiểm tra thành phần nào hiển thị khác nhau trên phía máy khách.

Lệnh

npm run dev

npm run dev

npm run dev

Ý nghĩa

Một script dự án khởi động máy chủ phát triển cục bộ.

Cách dùng

Sử dụng nó khi chỉnh sửa các trang và kiểm tra các thay đổi cục bộ.

Ví dụ

npm run dev

Ví dụ yêu cầu

Chạy `npm run dev` và cung cấp cho tôi các URL cục bộ và mạng.

Lệnh

npm run build

npm run build

npm run build

Ý nghĩa

Một script dự án tạo bản dựng sản xuất hoặc xuất tĩnh.

Cách dùng

Chạy nó sau khi có thay đổi để đảm bảo ứng dụng có thể được tạo thành công.

Ví dụ

npm run build

Ví dụ yêu cầu

Chạy `npm run build` và tóm tắt bất kỳ cảnh báo hoặc lỗi nào.

Lệnh

npm run lint

npm run lint

npm run lint

Ý nghĩa

Một script dự án chạy các kiểm tra lint.

Cách dùng

Chạy nó trước khi biên dịch để nhanh chóng phát hiện nhiều vấn đề trong mã.

Ví dụ

npm run lint

Ví dụ yêu cầu

Chạy `lint` trước khi xây dựng trang web.

Lệnh

curl

curl

curl -I http://localhost:3001/ko

Ý nghĩa

Một công cụ dòng lệnh để thực hiện các yêu cầu HTTP và kiểm tra các phản hồi.

Cách dùng

curl can quickly check whether a local or deployed page responds with 200, 404, or another status.

Ví dụ

curl -I http://localhost:3001/ko

Ví dụ yêu cầu

Sử dụng curl để kiểm tra xem tuyến tham chiếu mới có trả về mã 200 hay không.