chenyue/docs
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity
Files
c8ebd4e896095b83543b12e649ca7fc6d38fbcfd
docs/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/installation/with-docker-rootless.md
T

363 lines
11 KiB
Markdown
Raw Normal View History

docs: add zh-tw folder (#195)
2025-04-04 23:28:16 +00:00
---
date: "2020-02-09T20:00:00+02:00"
slug: "install-with-docker-rootless"
sidebar_position: 60
aliases:
- /zh-tw/install-with-docker-rootless
---
# 使用 Docker（無根）安裝
Gitea 在其 Docker Hub 組織中提供自動更新的 Docker 映像。可以
始終使用最新的穩定標籤或使用另一個處理更新的服務
Docker 映像。
無根映像使用 Gitea 內部 SSH 提供 Git 協議，不支持 OpenSSH。
此參考設置指導用戶通過基於 `docker-compose` 的設置，但 `docker-compose` 的安裝
不在本文檔的範圍內。要安裝 `docker-compose` 本身，請遵循
官方[安裝說明](https://docs.docker.com/compose/install/)。
## 基礎
最簡單的設置只是創建一個卷和一個網絡，並啟動 `docker.gitea.com/gitea:latest-rootless`
作為服務的映像。由於沒有可用的數據庫，可以使用 SQLite3 進行初始化。
為 `data` 和 `config` 創建一個目錄：
```sh
mkdir -p gitea/{data,config}
cd gitea
touch docker-compose.yml
```
然後將以下內容粘貼到名為 `docker-compose.yml` 的文件中：
```yaml
version: "2"
services:
server:
image: docker.gitea.com/gitea:@dockerVersion@-rootless
restart: always
volumes:
- ./data:/var/lib/gitea
- ./config:/etc/gitea
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2222:2222"
```
請注意，卷應由配置文件中指定的 UID/GID 的用戶/組擁有。默認情況下，docker 中的 Gitea 將使用 uid:1000 gid:1000。如果需要，您可以使用以下命令設置這些文件夾的所有權：
```sh
sudo chown 1000:1000 config/ data/
```
> 如果您未授予卷正確的權限，則容器可能無法啟動。
對於穩定版本，您可以使用 `:latest-rootless`、`:1-rootless` 或指定某個版本，例如 `:@dockerVersion@-rootless`，但如果您想使用最新的開發版本，則 `:nightly-rootless` 將是一個合適的標籤。如果您想運行來自發布分支的最新提交，您可以使用 `:1.x-nightly-rootless` 標籤，其中 x 是 Gitea 的次要版本。（例如 `:1.16-nightly-rootless`）
## 自定義端口
要在不同的端口上綁定集成的 ssh 和 web 服務器，請調整
端口部分。通常只需更改主機端口並保持容器內的端口不變。
```diff
version: "2"
services:
server:
image: docker.gitea.com/gitea:@dockerVersion@-rootless
restart: always
volumes:
- ./data:/var/lib/gitea
- ./config:/etc/gitea
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- - "3000:3000"
- - "2222:2222"
+ - "80:3000"
+ - "22:2222"
```
## MySQL 數據庫
要將 Gitea 與 MySQL 數據庫結合使用，請將這些更改應用到
上面創建的 `docker-compose.yml` 文件。
```diff
version: "2"
services:
server:
image: docker.gitea.com/gitea:@dockerVersion@-rootless
+ environment:
+ - GITEA__database__DB_TYPE=mysql
+ - GITEA__database__HOST=db:3306
+ - GITEA__database__NAME=gitea
+ - GITEA__database__USER=gitea
+ - GITEA__database__PASSWD=gitea
restart: always
volumes:
- ./data:/var/lib/gitea
- ./config:/etc/gitea
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2222:2222"
+ depends_on:
+ - db
+
+ db:
+ image: docker.io/library/mysql:8
+ restart: always
+ environment:
+ - MYSQL_ROOT_PASSWORD=gitea
+ - MYSQL_USER=gitea
+ - MYSQL_PASSWORD=gitea
+ - MYSQL_DATABASE=gitea
+ volumes:
+ - ./mysql:/var/lib/mysql
```
## PostgreSQL 數據庫
要將 Gitea 與 PostgreSQL 數據庫結合使用，請將這些更改應用到
上面創建的 `docker-compose.yml` 文件。
```diff
version: "2"
services:
server:
image: docker.gitea.com/gitea:@dockerVersion@-rootless
environment:
+ - GITEA__database__DB_TYPE=postgres
+ - GITEA__database__HOST=db:5432
+ - GITEA__database__NAME=gitea
+ - GITEA__database__USER=gitea
+ - GITEA__database__PASSWD=gitea
restart: always
volumes:
- ./data:/var/lib/gitea
- ./config:/etc/gitea
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2222:2222"
+ depends_on:
+ - db
+
+ db:
+ image: docker.io/library/postgres:14
+ restart: always
+ environment:
+ - POSTGRES_USER=gitea
+ - POSTGRES_PASSWORD=gitea
+ - POSTGRES_DB=gitea
+ volumes:
+ - ./postgres:/var/lib/postgresql/data
```
## 命名卷
要使用命名卷而不是主機卷，請在 `docker-compose.yml` 配置中定義並使用命名卷。此更改將自動
創建所需的卷。您不需要擔心命名卷的權限；Docker 會自動處理。
```diff
version: "2"
+volumes:
+ gitea-data:
+ driver: local
+ gitea-config:
+ driver: local
+
services:
server:
image: docker.gitea.com/gitea:@dockerVersion@-rootless
restart: always
volumes:
- - ./data:/var/lib/gitea
+ - gitea-data:/var/lib/gitea
- - ./config:/etc/gitea
+ - gitea-config:/etc/gitea
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2222:2222"
```
MySQL 或 PostgreSQL 容器需要單獨創建。
## 自定義用戶
您可以選擇使用自定義用戶（遵循 --user 標誌定義 https://docs.docker.com/engine/reference/run/#user）。
例如，要克隆主機用戶 `git` 定義，請使用命令 `id -u git` 並將其添加到 `docker-compose.yml` 文件中：
請確保掛載的文件夾可由用戶寫入。
```diff
version: "2"
services:
server:
image: docker.gitea.com/gitea:@dockerVersion@-rootless
restart: always
+ user: 1001
volumes:
- ./data:/var/lib/gitea
- ./config:/etc/gitea
- /etc/timezone:/etc/timezone:ro
- /etc/localtime:/etc/localtime:ro
ports:
- "3000:3000"
- "2222:2222"
```
## 啟動
:::note
從 2023 年 7 月起，Compose V1 停止接收更新。它也不再可用於 Docker Desktop 的新版本中。
Compose V2 包含在所有當前支持的 Docker Desktop 版本中。請使用 V2 進行以下操作。
:::
要基於 `docker-compose` 啟動此設置，請執行 `docker-compose up -d`，
在後台啟動 Gitea。使用 `docker-compose ps` 將顯示 Gitea 是否
正確啟動。可以使用 `docker-compose logs` 查看日誌。
要關閉設置，請執行 `docker-compose down`。這將停止
並殺死容器。卷將仍然存在。
:::note
如果在 http 上使用非 3000 端口，請更改 app.ini 以匹配
`LOCAL_ROOT_URL = http://localhost:3000/`。
:::
## 安裝
通過 `docker-compose` 啟動 Docker 設置後，應該可以使用
喜愛的瀏覽器完成安裝。訪問 http://server-ip:3000 並按照
安裝向導進行操作。如果數據庫是使用 `docker-compose` 設置啟動的，
如上所述，請注意 `db` 必須用作數據庫主機名。
## 自定義
[此處](../administration/customizing-gitea.md) 描述的自定義文件應
放置在 `/var/lib/gitea/custom` 目錄中。如果使用主機卷，則可以很容易地訪問這些
文件；對於命名卷，這是通過另一個容器或直接訪問
`/var/lib/docker/volumes/gitea_gitea/_/var_lib_gitea` 來完成的。配置文件將保存在
安裝後的 `/etc/gitea/app.ini` 中。
## 升級
:::warning
:exclamation::exclamation: **確保您已將數據卷掛載到 Docker 容器外的某個位置** :exclamation::exclamation:
:::
要將您的安裝升級到最新版本：
```bash
# 編輯 `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
## 使用環境變量管理部署
除了上述環境變量外，`app.ini` 中的任何設置都可以設置
或使用形式為 `GITEA__SECTION_NAME__KEY_NAME` 的環境變量覆蓋。
這些設置在每次 docker 容器啟動時應用，不會傳遞到 Gitea 的子進程中。
完整信息[此處](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` 文件中設置。
這些設置也可以通過定義形式為的環境變量來設置或覆蓋：
`GITEA__section_name__KEY_NAME__FILE` 指向文件。
```bash
...
services:
server:
environment:
- GITEA__mailer__ENABLED=true
- GITEA__mailer__FROM=${GITEA__mailer__FROM:?GITEA__mailer__FROM not set}
- GITEA__mailer__PROTOCOL=smtp
- GITEA__mailer__HOST=${GITEA__mailer__HOST:?GITEA__mailer__HOST not set}
- GITEA__mailer__IS_TLS_ENABLED=true
- GITEA__mailer__USER=${GITEA__mailer__USER:-apikey}
- GITEA__mailer__PASSWD="""${GITEA__mailer__PASSWD:?GITEA__mailer__PASSWD not set}"""
```
要設置所需的 TOKEN 和 SECRET 值，請考慮使用 Gitea 的內置[生成實用程序函數](../administration/command-line.md#generate)。
# SSH 容器透傳
由於 SSH 在容器內運行，因此如果需要 SSH 支持，則需要將 SSH 從主機透傳到容器。一種選擇是將容器 SSH 運行在非標準端口上（或將主機端口移動到非標準端口）。另一種可能更直接的方法是將 SSH 命令從主機轉發到容器。以下說明了這種設置。
本指南假設您已在主機上創建了一個名為 `git` 的用戶，該用戶有權運行 `docker exec`，並且 Gitea 容器名為 `gitea`。您需要修改該用戶的 shell 以使用 `docker exec` 將命令轉發到容器內的 `sh` 可執行文件。
首先，在主機上創建文件 `/usr/local/bin/gitea-shell`，內容如下：
```bash
#!/bin/sh
/usr/bin/docker exec -i --env SSH_ORIGINAL_COMMAND="$SSH_ORIGINAL_COMMAND" gitea sh "$@"
```
請注意，docker 命令中的 `gitea` 是容器的名稱。如果您命名不同，請不要忘記更改它。
您還應確保已正確設置 shell 包裝器的權限：
```bash
sudo chmod +x /usr/local/bin/gitea-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` 中添加以下塊：
```bash
Match User git
AuthorizedKeysCommandUser 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` 選項。）
剩下的就是重啟 SSH 服務器：
```bash
sudo systemctl restart sshd
```
**注意**
這實際上並未使用 docker SSH - 它只是使用周圍的命令。
理論上，您可以不運行內部 SSH 服務器。
Reference in New Issue Copy Permalink