gitea安装

Thu, 25 Dec 2025 11:45:12 +0800

简介

部署

Docker

docker compose

version: "3"

networks:
  gitea:
    external: false

services:
  server:
    image: docker.gitea.com/gitea:1.25.3
    container_name: gitea
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: unless-stopped
    networks:
      - gitea
    volumes:
      - ./gitea:/data
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "8418:3000"
      - "222:22"

使用 PostgreSQL 作为数据库

在安装 Gitea 时，通常建议为它创建一个专用的数据库用户和数据库。

以下是使用 psql 命令行工具完成此操作的步骤和命令：

1. 进入 PostgreSQL 终端

首先，你需要以 postgres 超级用户身份登录到控制台（假设你在 Linux 环境下）：

Bash

`1`	`sudo -u postgres psql`

2. 执行创建命令 (SQL)

进入 postgres=# 提示符后，请依次运行以下 SQL 命令。

请注意： 将 '你的强密码' 替换为你自己设置的真实密码。

SQL

-- 1. 创建名为 gitea 的用户，并设置密码
CREATE USER gitea WITH PASSWORD '你的强密码';

-- 2. 创建名为 gitea 的数据库，并将所有者设置为 gitea 用户
-- Gitea 强烈建议使用 UTF8 编码
CREATE DATABASE gitea OWNER gitea ENCODING 'UTF8';

-- 3. (可选但推荐) 授予该用户对数据库的所有权限
-- 实际上设置了 OWNER 之后通常已经具备权限，但为了确保无误可以再次授权
GRANT ALL PRIVILEGES ON DATABASE gitea TO gitea;

3. 如果你使用的是 PostgreSQL 15 或更高版本

PostgreSQL 15 更改了 public schema 的默认权限。虽然将数据库 owner 设置为 gitea 通常足够，但为了防止 Gitea 在建表时遇到权限问题，建议在连接到 gitea 数据库后执行以下操作：

SQL

-- 连接到刚创建的 gitea 数据库
\c gitea

-- 授予 public schema 的权限
GRANT ALL ON SCHEMA public TO gitea;

4. 退出

完成后，输入以下命令退出 psql：

SQL

\q

配置 Gitea 安装向导时的对应填写：

当你打开 Gitea 的网页安装向导时，请按照以下信息填写：

数据库类型 (Database Type): PostgreSQL
主机 (Host): 127.0.0.1:5432 (或者是你的数据库服务器 IP)
用户名 (Username): gitea
密码 (Password): (你刚才设置的强密码)
数据库名称 (Database Name): gitea

Gitea on 寻道之旅博客