918 字

2 分钟

Debian 13 上安装配置 Gitea 服务

2026-03-01

Linux运维

Linux

/

Debian

/

Gitea

/

Git

/

DevOps

前言#

在软件开发过程中，自建 Git 服务是团队协作的基础。相比 GitHub 等公共平台，自建 Gitea 服务能提供更高的数据安全性和灵活性，尤其适合私有项目开发。本文将详细记录在 Debian 13 系统上从零开始安装和配置 Gitea 的完整流程，包括系统环境准备、数据库配置、服务部署等关键步骤，帮助您快速搭建属于自己的 Git 服务。

一、准备工作#

安装依赖#

1
apt update
2
apt install -y wget git postgresql supervisor

创建 Git 系统用户#

1
adduser \
2
  --system \
3
  --shell /bin/bash \
4
  --gecos 'Git Version Control' \
5
  --group \
6
  --disabled-password \
7
  --home /home/git \
8
  git

创建 Gitea 目录结构#

1
mkdir -p /var/lib/gitea/{custom,data,log}
2
chown -R git:git /var/lib/gitea/
3
chmod -R 750 /var/lib/gitea/
4
mkdir /etc/gitea
5
chown root:git /etc/gitea
6
chmod 775 /etc/gitea

二、安装 Gitea 二进制文件#

拉取二进制文件并移动#

1
wget -O gitea https://dl.gitea.com/gitea/1.25.4/gitea-1.25.4-linux-amd64
2
chmod +x gitea
3
mv gitea /usr/local/bin/

三、配置 PostgreSQL 数据库#

修改 PostgreSQL 配置#

编辑 /etc/postgresql/15/main/postgresql.conf：

1
listen_addresses = 'localhost, 127.0.0.1'  # 根据需要添加您的IP
2
password_encryption = scram-sha-256

重启 PostgreSQL：

1
systemctl restart postgresql

创建 Gitea 数据库和用户#

1
sudo -u postgres psql

在 PostgreSQL 控制台中执行：

1
CREATE ROLE gitea WITH LOGIN PASSWORD 'gi******tea';
2
CREATE DATABASE giteadb WITH OWNER gitea TEMPLATE template0 ENCODING UTF8 LC_COLLATE 'en_US.UTF-8' LC_CTYPE 'en_US.UTF-8';

配置 pg_hba.conf#

编辑 /etc/postgresql/15/main/pg_hba.conf：

1
local    giteadb    gitea    scram-sha-256
2
host    giteadb    gitea    127.0.0.1/32    scram-sha-256

重启 PostgreSQL：

1
sudo systemctl restart postgresql

四、配置 Gitea 服务#

创建 systemd 服务文件#

1
sudo wget https://raw.githubusercontent.com/go-gitea/gitea/master/contrib/systemd/gitea.service -P /etc/systemd/system/

或者手动创建 /etc/systemd/system/gitea.service 文件，内容如下：

1
[Unit]
2
Description=Gitea (Git with a cup of tea)
3
After=network.target
4
###
5
# Don't forget to add the database service dependencies
6
###
7
#
8
#Wants=mysql.service
9
#After=mysql.service
10
#
11
#Wants=mariadb.service
12
#After=mariadb.service
13
#
14
Wants=postgresql.service
15
After=postgresql.service
16
#
17
#Wants=memcached.service
18
#After=memcached.service
19
#
20
#Wants=redis.service
21
#After=redis.service
22
#
23
###
24
# If using socket activation for main http/s
25
###
26
#
27
#After=gitea.main.socket
28
#Requires=gitea.main.socket
29
#
30
###
31
# (You can also provide gitea an http fallback and/or ssh socket too)
32
#
33
# An example of /etc/systemd/system/gitea.main.socket
34
###
35
##
36
## [Unit]
37
## Description=Gitea Web Socket
38
## PartOf=gitea.service
39
##
40
## [Socket]
41
## Service=gitea.service
42
## ListenStream=<some_port>
43
## NoDelay=true
44
##
45
## [Install]
46
## WantedBy=sockets.target
47
##
48
###
49

50
[Service]
51
# Uncomment the next line if you have repos with lots of files and get a HTTP 500 error because of that
52
# LimitNOFILE=524288:524288
53
RestartSec=2s
54
Type=simple
55
User=git
56
Group=git
57
WorkingDirectory=/var/lib/gitea/
58
# If using Unix socket: tells systemd to create the /run/gitea folder, which will contain the gitea.sock file
59
# (manually creating /run/gitea doesn't work, because it would not persist across reboots)
60
#RuntimeDirectory=gitea
61
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
62
Restart=always
63
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea
64
# If you install Git to directory prefix other than default PATH (which happens
65
# for example if you install other versions of Git side-to-side with
66
# distribution version), uncomment below line and add that prefix to PATH
67
# Don't forget to place git-lfs binary on the PATH below if you want to enable
68
# Git LFS support
69
#Environment=PATH=/path/to/git/bin:/bin:/sbin:/usr/bin:/usr/sbin
70
# If you want to bind Gitea to a port below 1024, uncomment
71
# the two values below, or use socket activation to pass Gitea its ports as above
72
###
73
#CapabilityBoundingSet=CAP_NET_BIND_SERVICE
74
#AmbientCapabilities=CAP_NET_BIND_SERVICE
75
###
76
# In some cases, when using CapabilityBoundingSet and AmbientCapabilities option, you may want to
77
# set the following value to false to allow capabilities to be applied on gitea process. The following
78
# value if set to true sandboxes gitea service and prevent any processes from running with privileges
79
# in the host user namespace.
80
###
81
#PrivateUsers=false
82
###
83

84
[Install]
85
WantedBy=multi-user.target

创建 Gitea 配置目录#

1
sudo mkdir /etc/gitea
2
sudo touch /etc/gitea/app.ini
3
sudo chown root:git /etc/gitea/app.ini
4
sudo chmod 660 /etc/gitea/app.ini

启动 Gitea 服务#

1
sudo systemctl daemon-reload
2
sudo systemctl enable --now gitea.service

五、验证安装#

检查服务状态#

1
sudo systemctl status gitea

测试数据库连接#

1
psql -U gitea -d giteadb

访问 Gitea Web 界面#

打开浏览器，访问 http://<服务器IP>:3000，按照向导完成初始化配置。

六、添加法律页面和备案信息#

一些法域（例如中国大陆）要求在网站上添加特定的法律页面和备案信息。按照以下步骤将它们添加到你的 Gitea 实例中。

添加隐私政策页面#

获取隐私政策模板#

Gitea 源代码附带了示例页面，位于 contrib/legal 目录中。将它们复制到 custom/public/assets/ 目录下：

1
# 创建必要的目录
2
sudo -u git mkdir -p /var/lib/gitea/custom/public/assets
3

4
# 下载隐私政策模板
5
sudo -u git wget -O /var/lib/gitea/custom/public/assets/privacy.html \
6
  https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/legal/privacy.html.sample

编辑隐私政策页面#

现在，你需要编辑该页面以满足你的需求。特别是，你必须更改电子邮件地址、网址以及与 “Your Gitea Instance” 相关的引用，以匹配你的情况：

1
sudo -u git vim /var/lib/gitea/custom/public/assets/privacy.html

请务必不要放置会暗示 Gitea 项目对你的服务器负责的一般服务条款或隐私声明。

添加备案信息#

创建自定义页脚链接模板#

创建或编辑页脚链接模板文件：

1
# 创建必要的目录
2
sudo -u git mkdir -p /var/lib/gitea/custom/templates/custom
3

4
# 创建页脚链接模板
5
sudo -u git tee /var/lib/gitea/custom/templates/custom/extra_links_footer.tmpl << 'EOF'
6
<a class="item" href="AppSubUrl/assets/privacy.html">隐私政策</a>
7
<a class="item" href="https://beian.miit.gov.cn/">湘ICP备2024072853号-1</a>
8
<a class="item" href="https://www.beian.gov.cn/portal/registerSystemInfo?recordcode=43010402002198">湘公网安备43010402002198号</a>
9
EOF

验证模板文件内容#

1
sudo -u git cat /var/lib/gitea/custom/templates/custom/extra_links_footer.tmpl

预期输出应该类似于：

1
<a class="item" href="AppSubUrl/assets/privacy.html">隐私政策</a>
2
<a class="item" href="https://beian.miit.gov.cn/">湘ICP备2024072853号-1</a>
3
<a class="item" href="https://www.beian.gov.cn/portal/registerSystemInfo?recordcode=43010402002198">湘公网安备43010402002198号</a>

6.3 重启 Gitea 服务#

应用所有更改后，重启 Gitea 服务以使配置生效：

1
sudo systemctl restart gitea

6.4 验证配置#

检查服务状态#

1
sudo systemctl status gitea

在浏览器中验证#

打开浏览器访问你的 Gitea 实例
滚动到底部页脚区域
确认能看到”隐私政策”、“湘ICP备2024072853号-1”和”湘公网安备43010402002198号”链接
点击”隐私政策”链接验证页面是否正常显示

七、补充：使用 Supervisor 管理 Gitea#

如果您更喜欢使用 Supervisor 而不是 systemd，可以创建 Supervisor 配置：

1
sudo -u git mkdir -p /home/git/gitea/log/supervisor
2
vim /etc/supervisor/conf.d/gitea.conf

在配置文件中添加：

1
[program:gitea]
2
command=/usr/bin/gitea web --config /etc/gitea/app.ini
3
directory=/var/lib/gitea
4
user=git
5
autostart=true
6
autorestart=true
7
redirect_stderr=true
8
stdout_logfile=/home/git/gitea/log/supervisor/gitea.log