mirror of
https://gitea.com/gitea/docs.git
synced 2026-07-22 12:17:50 +00:00
Update zh tw languages and fix some broken links (#455)
--------- Co-authored-by: silverwind <me@silverwind.io> Co-authored-by: silverwind <2021+silverwind@noreply.gitea.com> Reviewed-on: https://gitea.com/gitea/docs/pulls/455 Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
This commit is contained in:
Lunny Xiao
@@ -8,9 +8,9 @@ aliases:
|
||||
|
||||
# 反向代理
|
||||
|
||||
## 一般配置
|
||||
## 一般設定
|
||||
|
||||
1. 在您的 `app.ini` 文件中設置 `[server] ROOT_URL = https://git.example.com/`。
|
||||
1. 在您的 `app.ini` 文件中設定 `[server] ROOT_URL = https://git.example.com/`。
|
||||
2. 使反向代理將 `https://git.example.com/foo` 傳遞到 `http://gitea:3000/foo`。
|
||||
3. 確保反向代理不解碼 URI。請求 `https://git.example.com/a%2Fb` 應傳遞為 `http://gitea:3000/a%2Fb`。
|
||||
4. 確保 `Host` 和 `X-Forwarded-Proto` 標頭正確傳遞給 Gitea，以使 Gitea 看到實際訪問的 URL。
|
||||
@@ -20,13 +20,13 @@ aliases:
|
||||
通常**不建議**將 Gitea 放在子路徑中，這不常用，並且在某些罕見情況下可能會有一些問題。
|
||||
|
||||
要使 Gitea 與子路徑（例如：`https://common.example.com/gitea/`）一起工作，
|
||||
除了上述的一般配置外，還有一些額外要求：
|
||||
除了上述的一般設定外，還有一些額外要求：
|
||||
|
||||
1. 在您的 `app.ini` 文件中使用 `[server] ROOT_URL = https://common.example.com/gitea/`。
|
||||
2. 使反向代理將 `https://common.example.com/gitea/foo` 傳遞到 `http://gitea:3000/foo`。
|
||||
3. 容器註冊表需要在根級別配置固定子路徑 `/v2`：
|
||||
3. 容器註冊表需要在根級別設定固定子路徑 `/v2`：
|
||||
- 使反向代理將 `https://common.example.com/v2` 傳遞到 `http://gitea:3000/v2`。
|
||||
- 確保 URI 和標頭也正確傳遞（請參閱上述的一般配置）。
|
||||
- 確保 URI 和標頭也正確傳遞（請參閱上述的一般設定）。
|
||||
|
||||
## Nginx
|
||||
|
||||
@@ -53,7 +53,7 @@ server {
|
||||
## Nginx 與子路徑
|
||||
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，
|
||||
您可以通過將以下 `server` 部分添加到 `nginx.conf` 的 `http` 部分中來設置 Nginx 以在子路徑下服務 Gitea：
|
||||
您可以透過將以下 `server` 部分添加到 `nginx.conf` 的 `http` 部分中來設定 Nginx 以在子路徑下服務 Gitea：
|
||||
|
||||
```nginx
|
||||
server {
|
||||
@@ -77,29 +77,29 @@ server {
|
||||
}
|
||||
```
|
||||
|
||||
然後您**必須**在配置中正確設置 `[server] ROOT_URL = http://git.example.com/gitea/`。
|
||||
然後您**必須**在設定中正確設定 `[server] ROOT_URL = http://git.example.com/gitea/`。
|
||||
|
||||
## Nginx 和直接服務靜態資源
|
||||
|
||||
我們可以通過將請求分為靜態和動態來調整性能。
|
||||
我們可以透過將請求分為靜態和動態來調整性能。
|
||||
|
||||
CSS 文件、JavaScript 文件、圖像和網頁字體是靜態內容。
|
||||
首頁、存儲庫視圖或問題列表是動態內容。
|
||||
首頁、儲存庫視圖或問題列表是動態內容。
|
||||
|
||||
Nginx 可以直接服務靜態資源，僅代理動態請求到 Gitea。
|
||||
Nginx 對於服務靜態內容進行了優化，而代理大響應可能正好相反
|
||||
（請參閱 [https://serverfault.com/q/587386](https://serverfault.com/q/587386)）。
|
||||
|
||||
將 Gitea 源存儲庫的快照下載到 `/path/to/gitea/`。
|
||||
之後，在存儲庫目錄中運行 `make frontend` 以生成靜態資源。我們只對此任務的 `public/` 目錄感興趣，因此您可以刪除其餘部分。
|
||||
將 Gitea 源儲存庫的快照下載到 `/path/to/gitea/`。
|
||||
之後，在儲存庫目錄中運行 `make frontend` 以生成靜態資源。我們只對此任務的 `public/` 目錄感興趣，因此您可以刪除其餘部分。
|
||||
（您需要安裝 [Node with npm](https://nodejs.org/en/download/) 和 `make` 來生成靜態資源）
|
||||
|
||||
根據您的用戶基數規模，您可能希望將流量分為兩個不同的服務器，
|
||||
或使用 cdn 來存儲靜態文件。
|
||||
根據您的使用者基數規模，您可能希望將流量分為兩個不同的伺服器，
|
||||
或使用 cdn 來儲存靜態文件。
|
||||
|
||||
### 單節點和單域
|
||||
|
||||
在您的配置中設置 `[server] STATIC_URL_PREFIX = /_/static`。
|
||||
在您的設定中設定 `[server] STATIC_URL_PREFIX = /_/static`。
|
||||
|
||||
```nginx
|
||||
server {
|
||||
@@ -118,7 +118,7 @@ server {
|
||||
|
||||
### 兩個節點和兩個域
|
||||
|
||||
在您的配置中設置 `[server] STATIC_URL_PREFIX = http://cdn.example.com/gitea`。
|
||||
在您的設定中設定 `[server] STATIC_URL_PREFIX = http://cdn.example.com/gitea`。
|
||||
|
||||
```nginx
|
||||
# 運行 Gitea 的應用服務器
|
||||
@@ -150,7 +150,7 @@ server {
|
||||
|
||||
## Apache HTTPD
|
||||
|
||||
如果您希望 Apache HTTPD 服務您的 Gitea 實例，您可以將以下內容添加到您的 Apache HTTPD 配置中（通常位於 Ubuntu 的 `/etc/apache2/httpd.conf`）：
|
||||
如果您希望 Apache HTTPD 服務您的 Gitea 實例，您可以將以下內容添加到您的 Apache HTTPD 設定中（通常位於 Ubuntu 的 `/etc/apache2/httpd.conf`）：
|
||||
|
||||
```apacheconf
|
||||
<VirtualHost *:80>
|
||||
@@ -164,14 +164,14 @@ server {
|
||||
```
|
||||
|
||||
:::note
|
||||
必須啟用以下 Apache HTTPD 模塊：`proxy`、`proxy_http`。
|
||||
必須啟用以下 Apache HTTPD 模組：`proxy`、`proxy_http`。
|
||||
:::
|
||||
|
||||
如果您希望使用 Let's Encrypt 進行 webroot 驗證，請在 `ProxyPass` 之前添加 `ProxyPass /.well-known !` 行，以禁用將這些請求代理到 Gitea。
|
||||
|
||||
## Apache HTTPD 與子路徑
|
||||
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以通過將以下內容添加到您的 Apache HTTPD 配置中（通常位於 Ubuntu 的 `/etc/apache2/httpd.conf`）來設置 Apache HTTPD 以在子路徑下服務 Gitea：
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以透過將以下內容添加到您的 Apache HTTPD 設定中（通常位於 Ubuntu 的 `/etc/apache2/httpd.conf`）來設定 Apache HTTPD 以在子路徑下服務 Gitea：
|
||||
|
||||
```apacheconf
|
||||
<VirtualHost *:80>
|
||||
@@ -181,22 +181,22 @@ server {
|
||||
Allow from all
|
||||
</Proxy>
|
||||
AllowEncodedSlashes NoDecode
|
||||
# 注意：在 /git 或端口之後沒有尾隨斜杠
|
||||
# 注意：在 /git 或端口之後沒有尾隨斜槓
|
||||
ProxyPass /git http://localhost:3000 nocanon
|
||||
ProxyPreserveHost On
|
||||
RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}
|
||||
</VirtualHost>
|
||||
```
|
||||
|
||||
然後您**必須**在配置中正確設置 `[server] ROOT_URL = http://git.example.com/git/`。
|
||||
然後您**必須**在設定中正確設定 `[server] ROOT_URL = http://git.example.com/git/`。
|
||||
|
||||
:::note
|
||||
必須啟用以下 Apache HTTPD 模塊：`proxy`、`proxy_http`。
|
||||
必須啟用以下 Apache HTTPD 模組：`proxy`、`proxy_http`。
|
||||
:::
|
||||
|
||||
## Caddy
|
||||
|
||||
如果您希望 Caddy 服務您的 Gitea 實例，您可以將以下服務器塊添加到您的 Caddyfile 中：
|
||||
如果您希望 Caddy 服務您的 Gitea 實例，您可以將以下伺服器塊添加到您的 Caddyfile 中：
|
||||
|
||||
```
|
||||
git.example.com {
|
||||
@@ -206,7 +206,7 @@ git.example.com {
|
||||
|
||||
## Caddy 與子路徑
|
||||
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以通過將以下內容添加到您的 Caddyfile 中的服務器塊來設置 Caddy 以在子路徑下服務 Gitea：
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以透過將以下內容添加到您的 Caddyfile 中的伺服器塊來設定 Caddy 以在子路徑下服務 Gitea：
|
||||
|
||||
```
|
||||
git.example.com {
|
||||
@@ -217,22 +217,22 @@ git.example.com {
|
||||
}
|
||||
```
|
||||
|
||||
然後在您的配置中設置 `[server] ROOT_URL = http://git.example.com/git/`。
|
||||
然後在您的設定中設定 `[server] ROOT_URL = http://git.example.com/git/`。
|
||||
|
||||
## IIS
|
||||
|
||||
如果您希望使用 IIS 運行 Gitea。您需要設置 IIS 並使用 URL Rewrite 作為反向代理。
|
||||
如果您希望使用 IIS 運行 Gitea。您需要設定 IIS 並使用 URL Rewrite 作為反向代理。
|
||||
|
||||
1. 在 IIS 中設置一個空網站，命名為 `Gitea Proxy`。
|
||||
2. 按照 [Microsoft 的技術社區指南設置 IIS 並使用 URL Rewrite](https://techcommunity.microsoft.com/t5/iis-support-blog/setup-iis-with-url-rewrite-as-a-reverse-proxy-for-real-world/ba-p/846222#M343) 中的前兩步操作。即：
|
||||
1. 在 IIS 中設定一個空網站，命名為 `Gitea Proxy`。
|
||||
2. 按照 [Microsoft 的技術社區指南設定 IIS 並使用 URL Rewrite](https://techcommunity.microsoft.com/t5/iis-support-blog/setup-iis-with-url-rewrite-as-a-reverse-proxy-for-real-world/ba-p/846222#M343) 中的前兩步操作。即：
|
||||
|
||||
- 使用 Microsoft Web Platform Installer 5.1（WebPI）安裝應用程序請求路由（簡稱 ARR），或從 [IIS.net](https://www.iis.net/downloads/microsoft/application-request-routing) 下載擴展。
|
||||
- 安裝模塊後，您將在 IIS 管理控制台中看到一個名為 URL Rewrite 的新圖標。
|
||||
- 打開 IIS 管理控制台，從左側樹視圖中單擊 `Gitea Proxy` 網站。從中間窗格中選擇並雙擊 URL Rewrite 圖標以加載 URL Rewrite 界面。
|
||||
- 從管理控制台的右側窗格中選擇 `Add Rule` 操作，並從 `Inbound and Outbound Rules` 類別中選擇 `Reverse Proxy Rule`。
|
||||
- 在 Inbound Rules 部分中，將服務器名稱設置為運行 Gitea 的主機及其端口。例如，如果您在本地主機上運行 Gitea，端口為 3000，則以下應該可以工作：`127.0.0.1:3000`
|
||||
- 使用 Microsoft Web Platform Installer 5.1（WebPI）安裝應用程式請求路由（簡稱 ARR），或從 [IIS.net](https://www.iis.net/downloads/microsoft/application-request-routing) 下載擴展。
|
||||
- 安裝模組後，您將在 IIS 管理控制檯中看到一個名為 URL Rewrite 的新圖標。
|
||||
- 打開 IIS 管理控制檯，從左側樹視圖中單擊 `Gitea Proxy` 網站。從中間窗格中選擇並雙擊 URL Rewrite 圖標以加載 URL Rewrite 介面。
|
||||
- 從管理控制檯的右側窗格中選擇 `Add Rule` 操作，並從 `Inbound and Outbound Rules` 類別中選擇 `Reverse Proxy Rule`。
|
||||
- 在 Inbound Rules 部分中，將伺服器名稱設定為運行 Gitea 的主機及其端口。例如，如果您在本地主機上運行 Gitea，端口為 3000，則以下應該可以工作：`127.0.0.1:3000`
|
||||
- 啟用 SSL 卸載
|
||||
- 在 Outbound Rules 中，確保設置 `Rewrite the domain names of the links in HTTP response`，並將 `From:` 字段設置為上述內容，將 `To:` 設置為您的外部主機名，例如：`git.example.com`
|
||||
- 在 Outbound Rules 中，確保設定 `Rewrite the domain names of the links in HTTP response`，並將 `From:` 欄位設定為上述內容，將 `To:` 設定為您的外部主機名，例如：`git.example.com`
|
||||
- 現在編輯您的網站的 `web.config` 以匹配以下內容：（根據需要更改 `127.0.0.1:3000` 和 `git.example.com`）
|
||||
|
||||
```xml
|
||||
@@ -303,7 +303,7 @@ git.example.com {
|
||||
|
||||
## HAProxy
|
||||
|
||||
如果您希望 HAProxy 服務您的 Gitea 實例，您可以將以下內容添加到您的 HAProxy 配置中
|
||||
如果您希望 HAProxy 服務您的 Gitea 實例，您可以將以下內容添加到您的 HAProxy 設定中
|
||||
|
||||
在前端部分添加一個 acl 以將調用重定向到 gitea.example.com 到正確的後端
|
||||
|
||||
@@ -322,11 +322,11 @@ backend gitea
|
||||
server localhost:3000 check
|
||||
```
|
||||
|
||||
如果您將 http 內容重定向到 https，配置方式相同，只需記住 HAProxy 和 Gitea 之間的連接將通過 http 完成，因此您不必在 Gitea 的配置中啟用 https。
|
||||
如果您將 http 內容重定向到 https，設定方式相同，只需記住 HAProxy 和 Gitea 之間的連接將通過 http 完成，因此您不必在 Gitea 的設定中啟用 https。
|
||||
|
||||
## HAProxy 與子路徑
|
||||
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以通過將以下內容添加到您的 HAProxy 配置中來設置 HAProxy 以在子路徑下服務 Gitea：
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以透過將以下內容添加到您的 HAProxy 設定中來設定 HAProxy 以在子路徑下服務 Gitea：
|
||||
|
||||
```
|
||||
frontend http-in
|
||||
@@ -336,7 +336,7 @@ frontend http-in
|
||||
...
|
||||
```
|
||||
|
||||
使用該配置 http://example.com/gitea/ 將重定向到您的 Gitea 實例。
|
||||
使用該設定 http://example.com/gitea/ 將重定向到您的 Gitea 實例。
|
||||
|
||||
然後為後端部分
|
||||
|
||||
@@ -346,9 +346,9 @@ backend gitea
|
||||
server localhost:3000 check
|
||||
```
|
||||
|
||||
添加的 http-request 將自動添加尾隨斜杠（如果需要），並在內部刪除 /gitea 從路徑中刪除，以便通過正確設置 http://example.com/gitea 作為根來使其與 Gitea 正確工作。
|
||||
添加的 http-request 將自動添加尾隨斜槓（如果需要），並在內部刪除 /gitea 從路徑中刪除，以便通過正確設定 http://example.com/gitea 作為根來使其與 Gitea 正確工作。
|
||||
|
||||
然後您**必須**在配置中正確設置 `[server] ROOT_URL = http://example.com/gitea/`。
|
||||
然後您**必須**在設定中正確設定 `[server] ROOT_URL = http://example.com/gitea/`。
|
||||
|
||||
## Traefik
|
||||
|
||||
@@ -364,11 +364,11 @@ gitea:
|
||||
- "traefik.http.services.gitea-websecure.loadbalancer.server.port=3000"
|
||||
```
|
||||
|
||||
此配置假設您在 traefik 端處理 HTTPS，並在 Gitea 和 traefik 之間使用 HTTP。
|
||||
此設定假設您在 traefik 端處理 HTTPS，並在 Gitea 和 traefik 之間使用 HTTP。
|
||||
|
||||
## Traefik 與子路徑
|
||||
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以通過將以下內容添加到您的 `docker-compose.yaml`（假設提供者是 docker）來設置 Traefik 以在子路徑下服務 Gitea：
|
||||
如果您已經有一個站點，並且希望 Gitea 共享域名，您可以透過將以下內容添加到您的 `docker-compose.yaml`（假設提供者是 docker）來設定 Traefik 以在子路徑下服務 Gitea：
|
||||
|
||||
```yaml
|
||||
gitea:
|
||||
@@ -382,4 +382,4 @@ gitea:
|
||||
- "traefik.http.routers.gitea.middlewares=gitea-stripprefix"
|
||||
```
|
||||
|
||||
此配置假設您在 traefik
|
||||
此設定假設您在 traefik
|
||||
|
||||
Reference in New Issue
Block a user