Update zh tw languages and fix some broken links

This commit is contained in:
Lunny Xiao
2026-07-01 14:47:51 -07:00
parent 9558006c39
commit a084bdb556
842 changed files with 31137 additions and 31065 deletions

View File

@@ -6,19 +6,19 @@ aliases:
- /zh-tw/install-with-docker-rootless
---
# 使用 Docker 安 (rootless)
# 使用 Docker 安 (rootless)
Gitea 在其 Docker Hub 组织中提供自更新的 Docker 像。您可以始使用最新的稳定标签,或使用其他理 Docker 像更新的服
Gitea 在其 Docker Hub 組織中提供自更新的 Docker 像。您可以始使用最新的穩定標籤,或使用其他理 Docker 像更新的服
rootless 像使用 Gitea 部 SSH 功能提供 Git 协议,但不支 OpenSSH。
rootless 像使用 Gitea 部 SSH 功能提供 Git 協議,但不支 OpenSSH。
参考设置指南将用户引导通过基于 `docker-compose`设置。但是,`docker-compose` 的安超出了本文档的范围。要安`docker-compose` 本身, 按照官方的 [装说](https://docs.docker.com/compose/install/)行操作。
參考設定指南將使用者引導通過基於 `docker-compose`設定。但是,`docker-compose` 的安超出了本文件的範圍。要安`docker-compose` 本身, 按照官方的 [裝說](https://docs.docker.com/compose/install/)行操作。
## 基础设置
## 基礎設定
简单的设置只需创建一个卷和一个网络,并将 `docker.gitea.com/gitea:latest-rootless` 像作为服务启动。由于没有可用的数据库,可以使用 SQLite3 初始化一
簡單的設定只需建立一個卷和一個網路,並將 `docker.gitea.com/gitea:latest-rootless` 像作爲服務啟動。由於沒有可用的資料庫,可以使用 SQLite3 初始化一
创建一个名为 `data``config`:
建立一個名爲 `data``config`:
```sh
mkdir -p gitea/{data,config}
@@ -26,7 +26,7 @@ cd gitea
touch docker-compose.yml
```
后将以下容粘到名 `docker-compose.yml` 的文件中:
後將以下容粘到名 `docker-compose.yml` 的文件中:
```yaml
version: "2"
@@ -45,19 +45,19 @@ services:
- "2222:2222"
```
注意,卷由在配置文件中指定的 UID/GID 的用户/组所有。默认情况Docker 中的 Gitea 使用 uid:1000 gid:1000。如果需要您可以使用以下命令设置这些文件的所有
注意,卷由在設定文件中指定的 UID/GID 的使用者/組所有。預設情況Docker 中的 Gitea 使用 uid:1000 gid:1000。如果需要您可以使用以下命令設定這些文件的所有
```sh
sudo chown 1000:1000 config/ data/
```
> 如果未为卷设置正确的权限,容器可能无法启动
> 如果未爲卷設定正確的權限,容器可能無法啟動
对于稳定版本,您可以使用 `:latest-rootless``:1-rootless`,或指定特定的版本,如: `@dockerVersion@-rootless`。如果您想使用最新的开发版本,可以使用 `:dev-rootless` 标签。如果您想运行发布分支的最新提交,可以使用 `:1.x-dev-rootless` 标签,其中 x 是 Gitea 的次要版本(例如:`1.16-dev-rootless`)。
對於穩定版本,您可以使用 `:latest-rootless``:1-rootless`,或指定特定的版本,如: `@dockerVersion@-rootless`。如果您想使用最新的開發版本,可以使用 `:dev-rootless` 標籤。如果您想運行發佈分支的最新提交,可以使用 `:1.x-dev-rootless` 標籤,其中 x 是 Gitea 的次要版本(例如:`1.16-dev-rootless`)。
## 自定义端口
## 自端口
将集成的 SSH 和 Web 服务器绑定到不同的端口,请调整端口部分。通常只需更改主端口保持容器的端口不
將整合的 SSH 和 Web 伺服器綁定到不同的端口,請調整端口部分。通常只需更改主端口保持容器的端口不
```diff
version: "2"
@@ -78,9 +78,9 @@ services:
+ - "22:2222"
```
## MySQL 数据库
## MySQL 資料庫
Gitea MySQL 数据库结合使用,请对上面创建`docker-compose.yml` 文件行以下更改。
Gitea MySQL 資料庫結合使用,請對上面建立`docker-compose.yml` 文件行以下更改。
```diff
version: "2"
@@ -118,9 +118,9 @@ services:
+ - ./mysql:/var/lib/mysql
```
## PostgreSQL 数据库
## PostgreSQL 資料庫
Gitea PostgreSQL 数据库结合使用,请对上面创建`docker-compose.yml` 文件行以下更改。
Gitea PostgreSQL 資料庫結合使用,請對上面建立`docker-compose.yml` 文件行以下更改。
```diff
version: "2"
@@ -159,7 +159,7 @@ services:
## 命名卷 (Named Volumes)
要使用命名卷 (Named Volumes) 而不是主卷 (Host Volumes)`docker-compose.yml` 配置中定和使用命名卷。这样的更改将自动创建所需的卷。您不需要担心权限问题Docker 会自动处理。
要使用命名卷 (Named Volumes) 而不是主卷 (Host Volumes)`docker-compose.yml` 設定中定和使用命名卷。這樣的更改將自動建立所需的卷。您不需要擔心權限問題Docker 會自動處理。
```diff
version: "2"
@@ -186,13 +186,13 @@ services:
- "2222:2222"
```
MySQL 或 PostgreSQL 容器需要单独创建
MySQL 或 PostgreSQL 容器需要單獨建立
## 自定义用户
## 自訂使用者
你可以选择使用自定义用户 (遵循 --user 标志定义 https://docs.docker.com/engine/reference/run/#user)。
例如,要克隆主机用户 `git` 的定义,请使用命令 `id -u git` 并将其添加到 `docker-compose.yml` 文件中:
请确用户对保挂载的文件具有写权限。
你可以選擇使用自訂使用者 (遵循 --user 標誌定義 https://docs.docker.com/engine/reference/run/#user)。
例如,要克隆主機使用者 `git` 的定義,請使用命令 `id -u git` 並將其添加到 `docker-compose.yml` 文件中:
請確使用者對保掛載的文件具有寫權限。
```diff
version: "2"
@@ -212,53 +212,53 @@ services:
- "2222:2222"
```
## 启动
## 啟動
启动基于 `docker-compose`这个设置,请执`docker-compose up -d`,以在后台启动 Gitea。使用 `docker-compose ps` 命令可以查看 Gitea 是否正确启动。可以使用 `docker-compose logs` 命令查看日
啟動基於 `docker-compose`這個設定,請執`docker-compose up -d`,以在後臺啟動 Gitea。使用 `docker-compose ps` 命令可以查看 Gitea 是否正確啟動。可以使用 `docker-compose logs` 命令查看日
关闭设置,请执`docker-compose down` 命令。这将停止和止容器,但卷仍存在。
關閉設定,請執`docker-compose down` 命令。這將停止和止容器,但卷仍存在。
注意:如果在 HTTP 上使用的是非 3000 端口,请将 app.ini 更改匹配 `LOCAL_ROOT_URL = http://localhost:3000/`
注意:如果在 HTTP 上使用的是非 3000 端口,請將 app.ini 更改匹配 `LOCAL_ROOT_URL = http://localhost:3000/`
## 安
## 安
在通 `docker-compose` 启动 Docker 设置后,可以使用喜爱的浏览器访问 Gitea完成安装过程。访问 `http://<服器-IP>:3000` 按照安装向导进行操作。如果数据库是使用上述文中的 `docker-compose` 设置启动的,注意必使用 `db`为数据库主机名。
在通 `docker-compose` 啟動 Docker 設定後,可以使用喜愛的瀏覽器訪問 Gitea完成安裝過程。訪問 `http://<服器-IP>:3000` 按照安裝嚮導進行操作。如果資料庫是使用上述文中的 `docker-compose` 設定啟動的,注意必使用 `db`爲資料庫主機名。
## 自定义
## 自
定义文件的位置位 `/var/lib/gitea/custom`中,可以在这里找到有关自定义的文件明。如果使用主host volumes很容易访问这些文件如果使用命名卷named volumes可以通过另一容器或直接访问 `/var/lib/docker/volumes/gitea_gitea/_/var_lib_gitea` 来进行访问。在安装后,配置文件保存在 `/etc/gitea/app.ini` 中。
文件的位置位 `/var/lib/gitea/custom`中,可以在這裏找到有關自訂的文件明。如果使用主host volumes很容易訪問這些文件如果使用命名卷named volumes可以透過另一容器或直接訪問 `/var/lib/docker/volumes/gitea_gitea/_/var_lib_gitea` 來進行訪問。在安裝後,設定文件保存在 `/etc/gitea/app.ini` 中。
## 升
## 升
:::warning
:exclamation::exclamation: **保您已将数据卷迁移到 Docker 容器之外的其他位置** :exclamation::exclamation:
:exclamation::exclamation: **保您已將資料卷遷移到 Docker 容器之外的其他位置** :exclamation::exclamation:
:::
将安装升级到最新版本,按照以下步操作:
將安裝升級到最新版本,按照以下步操作:
```bash
# 如果在 docker-compose.yml 中指定了版本,请编辑该文件以更新版本
# 拉取新的
# 如果在 docker-compose.yml 中指定了版本,請編輯該文件以更新版本
# 拉取新的
docker-compose pull
# 启动一个新的容器,自移除的容器
# 啓動一個新的容器,自移除的容器
docker-compose up -d
```
## 从标准镜像升
## 從標準鏡像升
- 份您的设置
- 将卷挂载点从 `/data` 更改 `/var/lib/gitea`
- 如果使用了自定义`app.ini`请将其移到新的挂载`/etc/gitea` 的卷中
- 卷中的文件gitea重命名 custom
- 如果需要,编辑 `app.ini`
- 设置 `START_SSH_SERVER = true`
- 使用` docker.gitea.com/gitea:@dockerVersion@-rootless`
- 份您的設定
- 將卷掛載點從 `/data` 更改 `/var/lib/gitea`
- 如果使用了自`app.ini`請將其移到新的掛載`/etc/gitea` 的卷中
- 卷中的文件gitea重命名 custom
- 如果需要,編輯 `app.ini`
- 設定 `START_SSH_SERVER = true`
- 使用` docker.gitea.com/gitea:@dockerVersion@-rootless`
## 使用环境变量管理部署
## 使用環境變量管理部署
除了上述的环境变量外,`app.ini` 中的任何设置都可以通过形式 `GITEA__SECTION_NAME__KEY_NAME`环境变量进行设置或覆盖。这些设置在每次 Docker 容器启动时都会生效。完整信息请参考[这里](https://github.com/go-gitea/gitea/tree/main/contrib/environment-to-ini).
除了上述的環境變量外,`app.ini` 中的任何設定都可以透過形式 `GITEA__SECTION_NAME__KEY_NAME`環境變量進行設定或覆蓋。這些設定在每次 Docker 容器啟動時都會生效。完整資訊請參考[這裏](https://github.com/go-gitea/gitea/tree/main/contrib/environment-to-ini).
这些环境变量可以在 `docker-compose.yml`传递给 Docker 容器。以下示例将启用 SMTP 邮件服务器,如果主机上设置了所需的环境变量 GITEA**mailer**FROM、GITEA**mailer**HOST、GITEA**mailer**PASSWD或者在 `docker-compose.yml` 相同目中的 `.env` 文件中设置了这些环境变量:
這些環境變量可以在 `docker-compose.yml`傳遞給 Docker 容器。以下範例將啟用 SMTP 郵件伺服器,如果主機上設定了所需的環境變量 GITEA**mailer**FROM、GITEA**mailer**HOST、GITEA**mailer**PASSWD或者在 `docker-compose.yml` 相同目中的 `.env` 文件中設定了這些環境變量:
```bash
...
@@ -274,36 +274,36 @@ services:
- GITEA__mailer__PASSWD="""${GITEA__mailer__PASSWD:?GITEA__mailer__PASSWD not set}"""
```
设置所需的 TOKEN 和 SECRET 值,可以使用 Gitea 的置[生成使用函](../administration/command-line.md#generate).
設定所需的 TOKEN 和 SECRET 值,可以使用 Gitea 的置[生成使用函](../administration/command-line.md#generate).
# SSH 容器透
# SSH 容器透
SSH 在容器内运行,如果需要 SSH 支,需要 SSH 从主机透传到容器。一种选择是在容器内运行 SSH使用非标准端口(或将主机端口移到非标准端口)。另一可能更直接的选择是将主机上的 SSH 命令转发到容器。下面解释了这种设置
SSH 在容器內運行,如果需要 SSH 支,需要 SSH 從主機透傳到容器。一種選擇是在容器內運行 SSH使用非標準端口(或將主機端口移到非標準端口)。另一可能更直接的選擇是將主機上的 SSH 命令轉發到容器。下面解釋了這種設定
本指南假您已在主机上创建了一个名为 `git`用户,并具有`docker exec`限,且 Gitea 容器的名称为 `gitea`。您需要修改该用户的 shell命令转发到容器`sh`行文件,使用 `docker exec`
本指南假您已在主機上建立了一個名爲 `git`使用者,並具有`docker exec`限,且 Gitea 容器的名稱爲 `gitea`。您需要修改該使用者的 shell命令轉發到容器`sh`行文件,使用 `docker exec`
首先,在主机上创建文件 `/usr/local/bin/gitea-shell`填入以下容:
首先,在主機上建立文件 `/usr/local/bin/gitea-shell`填入以下容:
```bash
#!/bin/sh
/usr/bin/docker exec -i --env SSH_ORIGINAL_COMMAND="$SSH_ORIGINAL_COMMAND" gitea sh "$@"
```
注意上述 docker 命令中的 `gitea` 是容器的名。如果您的容器名不同,请记得更改。
注意上述 docker 命令中的 `gitea` 是容器的名。如果您的容器名不同,請記得更改。
还应确保正确设置了 shell 包器的限:
還應確保正確設定了 shell 包器的限:
```bash
sudo chmod +x /usr/local/bin/gitea-shell
```
一旦包器就位,您可以将其设置为 `git` 用户的 shell
一旦包器就位,您可以將其設定爲 `git` 使用者的 shell
```bash
sudo usermod -s /usr/local/bin/gitea-shell git
```
在,所有的 SSH 命令都会被转发到容器,您需要在主机上设置 SSH 认证。这可以通过利用 [SSH AuthorizedKeysCommand](../administration/command-line.md#keys) 匹配 Gitea 接受的密。在主`/etc/ssh/sshd_config` 文件中添加以下代码块
在,所有的 SSH 命令都會被轉發到容器,您需要在主機上設定 SSH 認證。這可以透過利用 [SSH AuthorizedKeysCommand](../administration/command-line.md#keys) 匹配 Gitea 接受的密。在主`/etc/ssh/sshd_config` 文件中添加以下程式碼塊
```bash
Match User git
@@ -311,9 +311,9 @@ Match User git
AuthorizedKeysCommand /usr/bin/docker exec -i gitea /usr/local/bin/gitea keys -c /etc/gitea/app.ini -e git -u %u -t %t -k %k
```
1.16.0 始,您不需要设置 `-c /etc/gitea/app.ini` 选项。)
1.16.0 始,您不需要設定 `-c /etc/gitea/app.ini` 選項。)
剩下的就是重新启动 SSH 服器:
剩下的就是重新啟動 SSH 服器:
```bash
sudo systemctl restart sshd
@@ -321,5 +321,5 @@ sudo systemctl restart sshd
**注意**
这实际上并没有使用 Docker 的 SSH而是仅仅使用了围绕它的命令。
从理论上讲,您可以不运行内部的 SSH 服器。
這實際上並沒有使用 Docker 的 SSH而是僅僅使用了圍繞它的命令。
從理論上講,您可以不運行內部的 SSH 服器。