开源代码托管工具Gitea 1.24.x安装教程

开源软件身份卡
名称 Gitea
开发语言 Go
官网 官网
代码托管 Github
开发团队 Lunny Xiao
开源协议 MIT
本文档使用版本 1.24.6
本文档更新日期 2025年10月12日
配套视频教程

本教程使用Debian 12系统,采用二进制安装方式。

为服务器安装git(如已安装可跳过):

apt install git
# 验证安装
git --version

下载gitea并放置在系统目录:

# 下载二进制文件
wget -O gitea https://dl.gitea.com/gitea/1.24.6/gitea-1.24.6-linux-amd64
# 授予执行权限
chmod +x gitea
# 将gitea复制到对应目录中
cp gitea /usr/local/bin/gitea

创建git用户:

adduser --system --shell /bin/bash --gecos 'Git Version Control' --group --disabled-password --home /home/git git

创建文件夹并授予相应的权限(逐行复制并执行以下命令):

mkdir -p /var/lib/gitea/{custom,data,log}
chown -R git:git /var/lib/gitea/
chmod -R 750 /var/lib/gitea/
mkdir /etc/gitea
chown root:git /etc/gitea
chmod 770 /etc/gitea

将gitea注册为Linux系统服务:

nano /etc/systemd/system/gitea.service
# 将以下内容填入其中
[Unit]
Description=Gitea (Git with a cup of tea)
After=network.target

[Service]
RestartSec=2s
Type=simple
User=git
Group=git
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=git HOME=/home/git GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

保存后启动服务(并设置开机自启):

systemctl enable gitea && systemctl start gitea

使用浏览器打开Web安装控制台:

http://192.168.1.91:3000/

数据库我选择轻量的sqlite(会创建122个表):

gitea-sqlite.jpg

HTTP服务这里我选择默认的3000端口:

gitea-http.jpg

在下方“服务器和第三方服务设置”中,由于我是自己使用,所以要关闭自主注册功能:

gitea-forbid-register.jpg

在最底下的“管理员账号设置”中,创建管理员账号和密码:

gitea-config.jpg

点击“立即安装”:

gitea-installing.jpg

稍等刷新后即可进入首页:

gitea-home.jpg

以在1Panel中设置反向代理为例,我们的目标是:

将192.168.1.91:3000反向代理为git.demo.com

在1Panel中依次执行“网站-创建网站-反向代理”后,填入以下内容:

gitea-reverse.jpg

打开git.demo.com首页后登录,顶部会出现警告信息,这里需要修改app.ini文件:

gitea-url-error.jpg

nano /etc/gitea/app.ini
# 修改ROOT_URL
ROOT_URL = http://git.demo.com/

保存修改后并重启gitea,这时安装就结束了,同时将必要的文件夹和文件修改为推荐的权限:

chmod 750 /etc/gitea
chmod 640 /etc/gitea/app.ini
systemctl restart gitea

现在就可以享受自己的gitea服务了!

  • docs/code/gitea.txt
  • 最后更改: 2025/10/12 22:45
  • ossdate