程式設計

網路主要術語

整理本機開發、瀏覽器請求、API、Docker 與部署疑難排解中常見的網路術語。

42 個項目

位址與名稱

IP 位址

IP address

192.168.1.25

意思

一個用於在網路中尋找裝置的數字地址。

使用時機

在其他設備需要訪問您的電腦、伺服器或容器主機時使用。

範例

192.168.1.25

請求範例

說明我應該從其他設備使用哪個 IP 地址。

位址與名稱

IPv4

192.168.0.10

意思

常用的四部分 IP 位址格式。

使用時機

大部分本機網路範例使用 IPv4 位址，例如 192.168.x.x 或 10.x.x.x。

範例

192.168.0.10

請求範例

請告訴我，這個位址是否為 IPv4 的本機網路位址。

位址與名稱

IPv6

::1

意思

一種較新的、更長的 IP 地址格式，旨在提供更多的地址。

使用時機

您可能會在日誌、localhost 綁定或伺服器網路輸出中看到 IPv6。

範例

::1

請求範例

說明這個日誌是否使用 IPv4 或 IPv6。

位址與名稱

localhost

http://localhost:3000

意思

一個表示運行代碼或瀏覽器的同一台機器名稱。

使用時機

從運行開發伺服器的同一台電腦連接。

注意

在手機上，localhost 指的是手機本身，而不是您的開發電腦。

範例

http://localhost:3000

請求範例

說明為什麼 localhost 在我的電腦上可以工作，但在我的手機上卻不行。

位址與名稱

127.0.0.1

http://127.0.0.1:3000

意思

目前機器常用的 IPv4 回饋位址。

使用時機

將其用作 `localhost` 的數字替代方案。

範例

http://127.0.0.1:3000

請求範例

說明 localhost 和 127.0.0.1 在這裡是否等同。

位址與名稱

0.0.0.0

next dev -H 0.0.0.0

意思

一個用於讓服務器監聽所有可用網絡接口的地址。

使用時機

在同一網路上的其他設備需要訪問您的開發伺服器時使用。

注意

它可以比 `localhost` 更廣泛地暴露開發伺服器。

範例

next dev -H 0.0.0.0

請求範例

說明這個開發伺服器是否應該綁定到 0.0.0.0。

位址與名稱

主機名

Hostname

my-laptop.local

意思

一個用於裝置或伺服器的可讀名稱。

使用時機

運用它，當網路名稱比 IP 位址更容易記住時。

範例

my-laptop.local

請求範例

說明這個主機名稱是否解析為預期的 IP 地址。

位址與名稱

領域

Domain

example.com

意思

一個對人類可讀的網域名稱，用於網站或服務。

使用時機

對於公開網站，使用域名，而不是要求用戶記住伺服器 IP 地址。

範例

example.com

請求範例

說明部署的網站應該使用的網域。

位址與名稱

DNS

example.com -> 93.184.216.34

意思

將網域名稱翻譯成 IP 位址的系統。

使用時機

當將網域名稱連接到託管服務或伺服器時，使用 DNS 記錄。

範例

example.com -> 93.184.216.34

請求範例

說明這個網域名稱需要哪個 DNS 記錄。

Port 與連線

端口

Port

3000

意思

一個用於識別哪個應用程式或服務接收來自機器的流量的數字。

使用時機

開發伺服器通常使用 3000、3001、5173 或 8000 等埠。

範例

3000

請求範例

請告訴我，這個伺服器正在使用哪個埠。

Port 與連線

聆聽

Listen

已在 http://localhost:3000 上啟動。

意思

當伺服器準備好接受地址和埠上的請求時，它處於監聽狀態。

使用時機

檢查輸出，以了解哪些 URL 可以在瀏覽器中打開。

範例

已在 http://localhost:3000 上啟動。

請求範例

說明這個伺服器正在監聽哪個端口。

Port 與連線

端口轉發

Port forwarding

8080 -> 3000

意思

將流量從一個端口或機器轉發到另一個端口或機器。

使用時機

在路由器、隧道、容器和遠端開發環境中使用。

範例

8080 -> 3000

請求範例

說明這個端口被轉發到哪個位置。

Port 與連線

防火牆

Firewall

允許在 3000 端口上進行入站連接。

意思

一個允許或阻止網路流量的規則系統。

使用時機

如果伺服器在本地運行，但其他設備無法連接，請檢查一下。

範例

允許在 3000 端口上進行入站連接。

請求範例

說明防火牆是否可能阻止這個本地連接。

Web 請求

URL

https://example.com/docs?page=1

意思

用于请求 Web 资源的完整地址。

使用時機

一個 URL 包含協議、主機、可選的端口、路徑、查詢字串，有時還包含片段。

範例

https://example.com/docs?page=1

請求範例

將此 URL 分解為協議、主機、埠、路徑和查詢。

Web 請求

路徑

Path

/ko/reference/docker

意思

URL 的一部分，用於識別伺服器上的路由或資源。

使用時機

運用它來理解正在請求哪個頁面或 API 端點。

範例

/ko/reference/docker

請求範例

請告訴我，這個 URL 路徑對應到哪個應用程式路由。

Web 請求

查詢字串。

Query string

?page=1&lang=ko

意思

URL 中 ? 之後的部分，用於傳遞額外的參數。

使用時機

適用於篩選器、頁碼、搜尋詞和輕量級選項。

範例

?page=1&lang=ko

請求範例

說明此 URL 發送的查詢參數。

Web 請求

HTTP

http://localhost:3000

意思

瀏覽器和伺服器用於網頁請求和回應的基本協議。

使用時機

本機開發通常使用 HTTP，在配置 HTTPS 之前。

範例

http://localhost:3000

請求範例

說明這個本地 URL 是否使用 HTTP 或 HTTPS。

Web 請求

HTTPS

https://example.com

意思

使用 TLS 加密的 HTTP。

使用時機

對於公開網站、登入、Cookie、付款、API 和生產流量，請使用 HTTPS。

範例

https://example.com

請求範例

說明這個已部署的網站是否需要 HTTPS。

Web 請求

HTTP 方法

HTTP method

GET /api/tools

意思

一個告訴伺服器請求希望執行哪種類型操作的動詞。

使用時機

`GET` 通常用於讀取數據，而 `POST` 通常用於創建或提交數據。

範例

GET /api/tools

請求範例

說明這個 API 請求應該使用哪個 HTTP 方法。

Web 請求

狀態碼

Status code

200 OK / 404 Not Found / 500 Internal Server Error

意思

一個用於總結 HTTP 回應結果的數字。

使用時機

運用它來快速區分成功、重定向、客戶端錯誤和伺服器錯誤的回應。

範例

200 OK / 404 Not Found / 500 Internal Server Error

請求範例

說明此 HTTP 狀態碼的含義。

Web 請求

標題

Header

Content-Type: application/json

意思

隨 HTTP 請求或回應發送的元資料。

使用時機

標題包含內容類型、授權、Cookie、緩存規則和 CORS 設置。

範例

Content-Type: application/json

請求範例

說明此回應中的重要標頭。

Web 請求

主體

Body

{"name":"demo"}

意思

在 HTTP 请求或响应中发送的主要数据内容。

使用時機

POST 和 PUT 請求通常在主體中傳送 JSON 資料。

範例

{"name":"demo"}

請求範例

說明此請求主體發送的資料。

瀏覽器安全

起源

Origin

http://192.168.1.25:3000

意思

協議、主機和埠的組合。

使用時機

使用 origin 來推理 CORS、Cookie 和瀏覽器安全規則。

注意

僅變更埠會產生不同的來源。

範例

http://192.168.1.25:3000

請求範例

確定此 URL 的來源。

瀏覽器安全

同源策略

Same-origin policy

https://app.example.com cannot freely read https://api.example.com

意思

一個瀏覽器規則，限制頁面如何從其他來源讀取數據。

使用時機

運用它來理解為什麼瀏覽器 API 請求可能失敗，即使伺服器是可訪問的。

範例

https://app.example.com cannot freely read https://api.example.com

請求範例

說明這是否是一個同源策略問題。

瀏覽器安全

CORS

Access-Control-Allow-Origin: https://app.example.com | app.example.com

意思

一個伺服器端權限系統，允許瀏覽器使用來自另一個來源的回應。

使用時機

運用它，當前端應用程式呼叫位於不同來源的 API 時。

注意

CORS 必須由發送響應的伺服器允許。

範例

Access-Control-Allow-Origin: https://app.example.com | app.example.com

請求範例

請告訴我，這個 CORS 錯誤是否需要在前端程式碼或伺服器設定中進行修正。

瀏覽器安全

Cookie

Set-Cookie: session=abc; HttpOnly

意思

瀏覽器儲存的小數據，並發送回匹配的網站。

使用時機

Cookie 通常用於會話、偏好設定和驗證狀態。

範例

Set-Cookie: session=abc; HttpOnly

請求範例

說明這個登入狀態是否儲存在 cookie 中。

瀏覽器安全

會話

Session

session_id=abc123

意思

一種用於在多個請求之間記住用戶狀態的方法。

使用時機

使用 session 來維持登入狀態或暫時的伺服器端使用者資料。

範例

session_id=abc123

請求範例

說明此應用程式如何保持使用者會話。

瀏覽器安全

令牌 (Token)

Token

Authorization: Bearer <token>

意思

一個用於證明身份或權限的字串。

使用時機

使用token進行API驗證、臨時訪問和服務間請求。

注意

令牌可以授予存取權，因此不應在公開程式碼或日誌中顯示。

範例

Authorization: Bearer <token>

請求範例

檢查這個 Token 是否會暴露給瀏覽器。

瀏覽器安全

TLS 憑證

TLS certificate

Let's Encrypt 證書

意思

一個證書，用於通過 HTTPS 證明網站的身份並加密流量。

使用時機

在通過 HTTPS 服務生產網站時使用。

範例

Let's Encrypt 證書

請求範例

說明為什麼這個瀏覽器顯示證書無效。

本機開發

本機網路

Local network

筆記型電腦和手機連接到相同的 Wi-Fi 網路。

意思

一個私有網路，其中附近的裝置可以進行通訊，例如同一個 Wi-Fi 網路。

使用時機

在從手機或平板電腦測試本地開發伺服器時使用。

範例

筆記型電腦和手機連接到相同的 Wi-Fi 網路。

請求範例

說明這些設備是否在同一本地網絡中。

本機開發

LAN IP 位址

LAN IP

192.168.1.25

意思

一個在本地網絡內部使用的 IP 地址。

使用時機

從同一網路上的另一台設備連接到您的開發機器。

範例

192.168.1.25

請求範例

請告訴我本機主機和 LAN IP 之間的區別。

本機開發

網路 URL

Network URL

http://192.168.1.25:3000

意思

一個 URL，同一網絡上的其他設備可以使用它來訪問本地伺服器。

使用時機

在測試響應式頁面時，使用手機或平板電腦。

注意

开发服务器可能还需要监听 0.0.0.0 端口，并允许访问源地址。

範例

http://192.168.1.25:3000

請求範例

說明如何從手機開啟此開發伺服器。

本機開發

開發伺服器

Dev server

npm run dev

意思

一個在開發和測試應用程序時使用的本地伺服器。

使用時機

適用於快速重新載入、本機預覽以及在正式構建之前的調試。

範例

npm run dev

請求範例

說明這個開發伺服器公開哪個本地 URL 和哪個網絡 URL。

本機開發

HMR

/_next/webpack-hmr

意思

一個開發功能，在程式碼更改時更新瀏覽器。

使用時機

運用它來在編輯 UI 程式碼時，保持瀏覽器狀態。

範例

/_next/webpack-hmr

請求範例

說明這個被阻止的請求是否與 HMR 相關。

伺服器與 Docker

代理。

Proxy

Browser -> proxy -> API

意思

一個代表客戶發送請求的伺服器。

使用時機

運用它來路由請求、隱藏後端細節，或避免在開發過程中直接的瀏覽器到 API 呼叫。

範例

Browser -> proxy -> API

請求範例

說明這個 API 請求是否通過代理伺服器。

伺服器與 Docker

反向代理

Reverse proxy

Nginx -> app:3000

意思

一個接收公共流量並將其轉發到內部服務的伺服器。

使用時機

用於 HTTPS 終止、路由、壓縮、快取和轉發到應用程式伺服器。

範例

Nginx -> app:3000

請求範例

說明此反向代理如何將流量路由到應用程式。

伺服器與 Docker

Docker port mapping

3000:3000

意思

一個從主機端口到容器端口的映射。

使用時機

確保主機上的瀏覽器可以訪問運行在容器內的 Web 應用程式。

注意

在 Docker 端口中，左側是主機端口，右側是容器端口。

範例

3000:3000

請求範例

說明此 Docker 埠映射的瀏覽器 URL。

伺服器與 Docker

host.docker.internal

http://host.docker.internal:3000

意思

一個容器可以使用的主機名，在許多 Docker Desktop 環境中，它可以訪問主機機。

使用時機

運用它，當容器需要呼叫主機機器的服務時。

範例

http://host.docker.internal:3000

請求範例

說明這個容器是否應該使用 host.docker.internal。

伺服器與 Docker

服務名稱

Service name

postgres://db:5432/app

意思

在 Docker Compose 中，服務通常可以使用服務名稱相互訪問。

使用時機

在容器之間，使用 `db`、`api`、`redis` 或其他 Compose 服務名稱，而不是使用 `localhost`。

範例

postgres://db:5432/app

請求範例

說明為什麼這個容器應該使用 db 服務名稱而不是 localhost。

伺服器與 Docker

負載平衡器

Load balancer

Client -> load balancer -> app servers

意思

一個將傳入流量分發到多個伺服器的系統。

使用時機

在一個應用程式有多個運行實例，以實現可擴展性和可靠性時使用。

範例

Client -> load balancer -> app servers

請求範例

說明負載平衡器在這個部署中的作用。

伺服器與 Docker

CDN

從邊緣快取伺服器提供的靜態資源

意思

一個分佈式網絡，從更靠近用戶的位置提供內容。

使用時機

運用它來加速靜態資源、圖像、腳本、樣式和快取頁面。

範例

從邊緣快取伺服器提供的靜態資源

請求範例

說明這個靜態網站是否能從 CDN 中受益。

伺服器與 Docker

快取

Cache

Cache-Control: max-age=3600

意思

儲存的數據或回應可重複使用，以加快未來的請求。

使用時機

對於靜態檔案、API 回應、頁面和 CDN 邊緣內容，請使用快取。

注意

舊的緩存內容可能會使已知的錯誤看似已解決。

範例

Cache-Control: max-age=3600

請求範例

說明這個問題是否可能由快取引起。