版本：1.23.7

使用 Docker（無根）安裝

Gitea 在其 Docker Hub 組織中提供自動更新的 Docker 映像。可以始終使用最新的穩定標籤或使用另一個處理更新的服務 Docker 映像。

無根映像使用 Gitea 內部 SSH 提供 Git 協議，不支持 OpenSSH。

此參考設置指導用戶通過基於 docker-compose 的設置，但 docker-compose 的安裝不在本文檔的範圍內。要安裝 docker-compose 本身，請遵循官方安裝說明。

基礎

最簡單的設置只是創建一個卷和一個網絡，並啟動 docker.gitea.com/gitea:latest-rootless 作為服務的映像。由於沒有可用的數據庫，可以使用 SQLite3 進行初始化。

為 data 和 config 創建一個目錄：

mkdir -p gitea/{data,config}
cd gitea
touch docker-compose.yml

然後將以下內容粘貼到名為 docker-compose.yml 的文件中：

version: "2"

services:
  server:
    image: docker.gitea.com/gitea:1.23.7-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。如果需要，您可以使用以下命令設置這些文件夾的所有權：

sudo chown 1000:1000 config/ data/

如果您未授予卷正確的權限，則容器可能無法啟動。

對於穩定版本，您可以使用 :latest-rootless、:1-rootless 或指定某個版本，例如 :1.23.7-rootless，但如果您想使用最新的開發版本，則 :nightly-rootless 將是一個合適的標籤。如果您想運行來自發布分支的最新提交，您可以使用 :1.x-nightly-rootless 標籤，其中 x 是 Gitea 的次要版本。（例如 :1.16-nightly-rootless）

自定義端口

要在不同的端口上綁定集成的 ssh 和 web 服務器，請調整端口部分。通常只需更改主機端口並保持容器內的端口不變。

version: "2"

services:
  server:
    image: docker.gitea.com/gitea:1.23.7-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 文件。

version: "2"

services:
  server:
    image: docker.gitea.com/gitea:1.23.7-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 文件。

version: "2"

services:
  server:
    image: docker.gitea.com/gitea:1.23.7-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 會自動處理。

version: "2"

+volumes:
+  gitea-data:
+    driver: local
+  gitea-config:
+    driver: local
+
services:
  server:
    image: docker.gitea.com/gitea:1.23.7-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 文件中：請確保掛載的文件夾可由用戶寫入。

version: "2"

services:
  server:
    image: docker.gitea.com/gitea:1.23.7-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"

啟動

備註

從 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。這將停止並殺死容器。卷將仍然存在。

備註

如果在 http 上使用非 3000 端口，請更改 app.ini 以匹配 LOCAL_ROOT_URL = http://localhost:3000/。

安裝

通過 docker-compose 啟動 Docker 設置後，應該可以使用喜愛的瀏覽器完成安裝。訪問 http://server-ip:3000 並按照安裝向導進行操作。如果數據庫是使用 docker-compose 設置啟動的，如上所述，請注意 db 必須用作數據庫主機名。

自定義

此處描述的自定義文件應放置在 /var/lib/gitea/custom 目錄中。如果使用主機卷，則可以很容易地訪問這些文件；對於命名卷，這是通過另一個容器或直接訪問 /var/lib/docker/volumes/gitea_gitea/_/var_lib_gitea 來完成的。配置文件將保存在安裝後的 /etc/gitea/app.ini 中。

升級

注意

❗❗ 確保您已將數據卷掛載到 Docker 容器外的某個位置 ❗❗

要將您的安裝升級到最新版本：

# 編輯 `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:1.23.7-rootless

使用環境變量管理部署

除了上述環境變量外，app.ini 中的任何設置都可以設置或使用形式為 GITEA__SECTION_NAME__KEY_NAME 的環境變量覆蓋。這些設置在每次 docker 容器啟動時應用，不會傳遞到 Gitea 的子進程中。完整信息此處。

這些環境變量可以在 docker-compose.yml 中傳遞給 docker 容器。以下示例將啟用 smtp 郵件服務器，如果所需的環境變量 GITEA__mailer__FROM、GITEA__mailer__HOST、GITEA__mailer__PASSWD 在主機上設置或在與 docker-compose.yml 相同的目錄中的 .env 文件中設置。

這些設置也可以通過定義形式為的環境變量來設置或覆蓋： GITEA__section_name__KEY_NAME__FILE 指向文件。

...
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 的內置生成實用程序函數。

SSH 容器透傳

由於 SSH 在容器內運行，因此如果需要 SSH 支持，則需要將 SSH 從主機透傳到容器。一種選擇是將容器 SSH 運行在非標準端口上（或將主機端口移動到非標準端口）。另一種可能更直接的方法是將 SSH 命令從主機轉發到容器。以下說明了這種設置。

本指南假設您已在主機上創建了一個名為 git 的用戶，該用戶有權運行 docker exec，並且 Gitea 容器名為 gitea。您需要修改該用戶的 shell 以使用 docker exec 將命令轉發到容器內的 sh 可執行文件。

首先，在主機上創建文件 /usr/local/bin/gitea-shell，內容如下：

#!/bin/sh
/usr/bin/docker exec -i --env SSH_ORIGINAL_COMMAND="$SSH_ORIGINAL_COMMAND" gitea sh "$@"

請注意，docker 命令中的 gitea 是容器的名稱。如果您命名不同，請不要忘記更改它。

您還應確保已正確設置 shell 包裝器的權限：

sudo chmod +x /usr/local/bin/gitea-shell

包裝器就位後，您可以將其設置為 git 用戶的 shell：

sudo usermod -s /usr/local/bin/gitea-shell git

現在所有的 SSH 命令都轉發到容器，您需要在主機上設置 SSH 認證。這是通過利用 SSH AuthorizedKeysCommand 將密鑰與 Gitea 接受的密鑰匹配來完成的。在主機上的 /etc/ssh/sshd_config 中添加以下塊：

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

sudo systemctl restart sshd

注意

這實際上並未使用 docker SSH - 它只是使用周圍的命令。理論上，您可以不運行內部 SSH 服務器。

基礎​

自定義端口​

MySQL 數據庫​

PostgreSQL 數據庫​

命名卷​

自定義用戶​

啟動​

安裝​

自定義​

升級​

從標準映像升級​

使用環境變量管理部署​