---
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 服務器。
