{"id":19317673,"url":"https://github.com/queeniecplusplus/nginx_proxy","last_synced_at":"2026-03-02T06:04:36.110Z","repository":{"id":104588372,"uuid":"297792395","full_name":"QueenieCplusplus/Nginx_Proxy","owner":"QueenieCplusplus","description":"Proxy Server \u0026 Reverse Proxy Server","archived":false,"fork":false,"pushed_at":"2020-09-23T01:00:48.000Z","size":684,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-24T04:44:41.434Z","etag":null,"topics":["proxy","proxy-configuration","proxy-server","proxypool"],"latest_commit_sha":null,"homepage":"https://github.com/QueenieCplusplus/QuickGoThru/blob/master/README.md#nginx--k8s-in-2020","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/QueenieCplusplus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-22T22:59:02.000Z","updated_at":"2020-09-23T01:59:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"74f5660c-d5d9-4fa2-be35-8fa9e031e801","html_url":"https://github.com/QueenieCplusplus/Nginx_Proxy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/QueenieCplusplus/Nginx_Proxy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QueenieCplusplus%2FNginx_Proxy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QueenieCplusplus%2FNginx_Proxy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QueenieCplusplus%2FNginx_Proxy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QueenieCplusplus%2FNginx_Proxy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/QueenieCplusplus","download_url":"https://codeload.github.com/QueenieCplusplus/Nginx_Proxy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/QueenieCplusplus%2FNginx_Proxy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29993581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["proxy","proxy-configuration","proxy-server","proxypool"],"created_at":"2024-11-10T01:15:48.657Z","updated_at":"2026-03-02T06:04:36.093Z","avatar_url":"https://github.com/QueenieCplusplus.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nginx_Proxy\nProxy Server \u0026amp; Reverse Proxy Server\n\n\n* Forward Proxy\n\n大部分的代理服務，是指『正向代理』服務，如果把 WAN 想像成一個極大資源庫，資源分布在網路中的各種網站上，區域網內 LAN 的用戶端倘若要使用這個資源庫資源就要透過代理服務，方才能對各種網站進行造訪。\n\n而通常此處的代理也會造成一部份防火牆功能，也能對於網內道往外進行監控與管理，但方向僅僅是網內至網外。\n\n目的是用戶端造訪網路中網站資源。\n\n![forward](https://raw.githubusercontent.com/QueenieCplusplus/Nginx_Proxy/master/Forward_Proxy.png)\n\n![fp](https://raw.githubusercontent.com/QueenieCplusplus/Nginx_Proxy/master/f_p.png)\n\n基本部署的設定實例\n\n\n      // Forward Proxy Server\n\n\n      server{\n\n          resolver 8.8.8.8; # 設定 DNS 伺服器的虛擬網路位址為 8.8.8.8，預設 DNS 服務的通訊阜號為 53，伺服器因此能處理收到的域名。\n          listen 82; # 正向代理服務的監聽阜設定為 82\n          location /{  # 伺服器收到的所有請求，都由此區塊過濾處理。\n              proxy_pass http://$http_host$req_uri #被代理伺服器的位址\n          }\n\n      }\n\n\n* Reverse Proxy\n\n反向代理伺服器用來讓網外的用呼端連線區域網中的網站以造訪網站中資源。\n\n目的是伺服器把資源發佈讓其它用戶端能夠造訪（通常反向代理伺服器和網站中間有防火牆）。\n\n![reverse](https://raw.githubusercontent.com/QueenieCplusplus/Nginx_Proxy/master/Reversed_Proxy.png)\n\n![rp](https://raw.githubusercontent.com/QueenieCplusplus/Nginx_Proxy/master/r_p.png)\n\n\n(1) 關於代理伺服器服務群的設定\n\n      upstream service_group{  # 倘若被代理伺服器是一組（群）伺服器，則使用 upstream 設定後端伺服器組。\n\n       server http://192.168.1.1:8001/uri/; \n       server http://192.168.1.2:8001/uri/; # 同阜，不同 ip，使用 bind()\n       server http://192.168.1.3:8000/uri/; # 不同阜，表示不同服務  \n\n      }\n      server{\n\n          resolver 8.8.8.8;\n          listen 82;\n          location /{\n\n              proxy_pass http://$http_host$req_uri; # 被代理伺服器的位址，可能是 主機名稱 與i p+port 和 uri 等要素\n              proxy_pass http://www.queenie.com/tech;\n              proxy_pass http://localhost:8000/blog_article;\n              proxy_pass http://unix:/tmp/backend.socket:/uri/;\n              proxy_pass service_group # 倘若被代理伺服器是一組（群）伺服器，則使用 upstream 設定後端伺服器組。\n\n          }\n\n      }\n      \n (2) 關於轉址的設定\n \n       server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6;\n\n          }\n          \n           location /article/{\n\n             proxy_pass http://192.168.1.7; # 此為當使用者對目的www.katesapp.com/article 發起請求，因為 代理伺服器的 url 變數不會包含 uri, 故實際轉址為 http://192.168.1.7/article\n\n          }\n\n      }\n      \n (3) 隱藏或忽略不處理標頭資訊\n \n        server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6;\n             proxy_hide_header [field 標頭域]; # 此指令可在 http、server、location 區塊中進行設定。\n             proxy_pass_header [field 標頭域]; # 設定可以被發送的標頭資訊。\n             proxy_pass_request_header on; # 設定用戶端將請求標頭發送給代理伺服器\n             proxy_pass_request_body on; # 設定用戶端將請求本體發送給代理伺服器\n             \n             proxy_set_header field value; # 代理伺服器接收使用者端請求之標頭後經過修改，轉發給被代理伺服器。\n             proxy_set_header $Host $proxy_host;\n             proxy_set_header $Host $host:$proxy_port;\n             proxy_set_body value; # 代理伺服器接收使用者端請求之請求本體，經過修改後，將新請求轉發給被代理伺服器。\n             proxy_ignore_headers field...; # 代理伺服器去到被代理伺服器的回應資料後，不會處理被設定的標頭域。\n\n          }\n          \n      }\n \n （4) bind 繫連結\n \n \n      server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_bind addr; # 強制將代理主機連接與指定ip綁定。\n            \n          }\n          \n      }\n      \n  (5) 逾時設定\n  \n      server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_connect_timeout time; # 代理伺服器與被代理伺服器嘗試建立連接的逾時間，預設為 60s。\n             proxy_read_timeout time; #代理伺服器向後端被代理伺服器服務群組發出讀取請求後，等待回應的逾時間，預設為 60s。\n             proxy_send_timeout time; #代理伺服器向後端被代理伺服器發出寫入請求後，等待回應的逾時間，預設為 60s。\n            \n          }\n          \n      }\n      \n   (6) http 支援版本\n   \n      server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6;\n             proxy_http_version 1.0 | 1.1;\n            \n          }\n          \n      }\n      \n   (7) 改寫用戶端請求的方法\n   \n     server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6;\n             proxy_method POST; # or GET, 此指令一經設定，用戶端請求方法的域值將被忽略。\n            \n          }\n          \n      }\n      \n   (8) 戶端請求中斷時，設定代理伺服器也中斷與來自被代理伺服器的請求。\n   \n        server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6;\n             proxy_ignore_client_abort on;\n            \n          }\n          \n      }\n   \n   \n   (9)重新定義使用者的請求位址\n   \n      設定方式(1)與設定方式(2)相同\n   \n      server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6; # 此指令將用戶端請求位址重新定義為被代理伺服器的位置\n             proxy_redirect [redirect 被取代值] [replacement 取代值]; # 藉此指令，可以將回應標頭和用戶端請求位址相對應，而非代理伺服器的傳回的位址資訊。\n             \n             # 設定方式(1)\n             proxy_pass http://proxyserver/;\n             proxy_redirect http://proxyserver/ /server/; # 前面的值為被取的的值 後者的值為取代值。\n             \n             # 設定方式(2)\n             proxy_pass http://proxyserver/;\n             proxy_redirect default ; # 前面的值為被取的的值 後者的值為取代值。\n             \n            \n          }\n          \n      }\n   \n   (10) 回應 http 狀態碼\n   \n   \n         server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6; # 此指令將用戶端請求位址重新定義為被代理伺服器的位置\n             proxy_intercept_errors on; # 開啟此狀態，則被代理伺服器倘若回傳狀態數字大於等於 400，則代理伺服器使用自定義的錯誤頁面，如此設定被關閉，則被代理伺服器傳回的 http 狀態直接回應給使用者端。\n            \n          }\n          \n      }\n      \n   （11）請求標頭之容量限制\n   \n   \n      server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6; # 此指令將用戶端請求位址重新定義為被代理伺服器的位置\n             proxy_headers_hash_max_size [size]; 此指令設定儲存 http 封包標頭的雜湊表容量，預設上限為 512 字元。\n             # 此 hash table 能儲存標頭中各種資訊，如伺服器名稱、多元網路媒體類型、請求標頭之名稱等等，固定單位大小由 proxy_headers_hash_bucket_size 設定，預設為 64 字元。\n              \n          }\n          \n      }\n      \n      \n   (12) HTTPs\n   \n      server{\n\n          server_name www.katesapp.com\n          listen 80;\n          location /{\n\n             proxy_pass http://192.168.1.6; # 此指令將用戶端請求位址重新定義為被代理伺服器的位置\n             proxy_ssl_session reuse on; # 此指令設定用以 SSL (第五層 secure socket layer) 安全協定為基礎的階段連接被代理的伺服器。 \n            \n          }\n          \n      }\n      \n      \n  # Load Balancing, 負載平衡\n  \n   (to be continued...)\n   \n   網路負載平衡是利用一定的分配策略將網路平衡地分攤到網路叢集，使得單一工作能夠分攤到多個單元平行處理，抑或使得大量早方資料流量分擔到多單元個別處理，避免使用者等待回應時間過久。\n   \n   然而，實務上的 LB 會根據 OSI 七層模型進行劃分，現在的 LB 著重在 L4 | L7 ，完全獨立與硬體裝置，成為單獨的技術裝置。而 Nginx 是 L7 的 LB 實現。\n   \n   透過硬體實現的 LB 雖然效果更好，但是成本較高，軟體則是依賴程式的穩定性與演算法的選擇：分為靜態與動態的 LB 演算法。\n   \n   * 靜態負載平衡演算法\n   \n     透過加權輪詢實現，適合一般網路。\n     \n     \n     範例 1\n                 \n                 upstream service_group{  # 倘若被代理伺服器是一組（群）伺服器，則使用 upstream 設定後端伺服器組。\n\n                   server http://192.168.1.1:80; \n                   server http://192.168.1.2:80;      # 預設權重為 1，實現一般輪詢\n                   server http://192.168.1.3:80;\n\n                  }\n\n                  server{\n\n                      server_name www.pattyappier.com;\n                      listen 80;\n                      location /{\n\n                          proxy_pass service_group # 倘若被代理伺服器是一組（群）伺服器，則使用 upstream 設定後端伺服器組。\n\n                      }\n\n                  }\n                  \n       範例 2\n       \n       \n                upstream service_group{  # 倘若被代理伺服器是一組（群）伺服器，則使用 upstream 設定後端伺服器組。\n\n                   server http://192.168.1.1:80  weigth=5; \n                   server http://192.168.1.2:80  weight=2;            # 實現加權負載平衡，權重越低，則接受與處理的用戶端請求最少。\n                   server http://192.168.1.3:80;\n\n                  }\n\n                  server{\n\n                      server_name www.pattyappier.com;\n                      listen 80;\n                      location /{\n\n                          proxy_pass service_group # 倘若被代理伺服器是一組（群）伺服器，則使用 upstream 設定後端伺服器組。\n\n                      }\n\n                  }\n               \n   \n   * 動態負載平衡演算法\n   \n     包含最少連接優先演算法、最快回應優先演算法、動態效能分配演算法，適合複雜網路。 \n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqueeniecplusplus%2Fnginx_proxy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqueeniecplusplus%2Fnginx_proxy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqueeniecplusplus%2Fnginx_proxy/lists"}