ubuntu下搭建Gitea代码托管平台

在 Ubuntu 上部署 Gitea 是设置本地代码托管平台的简洁和高效选择。以下是详细步骤：

步骤 1：更新系统

sudo apt update && sudo apt upgrade -y

步骤 2：安装依赖

sudo apt install git sqlite3 curl -y

Gitea 支持多种数据库，默认使用 SQLite。如果需要 MySQL 或 PostgreSQL，可以先安装这些数据库。

步骤 3：创建用户用于运行 Gitea

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

新建了一个系统用户/home/git,用户控制运行Gitea

步骤 4：下载 Gitea

从官方站点下载最新版本的 Gitea：

wget -O gitea https://dl.gitea.com/gitea/1.23.1/gitea-1.23.1-linux-amd64

需要替换最新版本，可以在 Gitea 的官方下载页面找到最新版本的下载链接

步骤 5：安装 Gitea

sudo mv gitea /usr/local/bin/
sudo chmod +x /usr/local/bin/gitea

步骤 6：创建必要的目录

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

步骤 7：创建 Systemd 服务文件

创建服务配置文件：

sudo nano /etc/systemd/system/gitea.service

内容如下：

[Unit]
Description=Gitea (Git with a cup of tea)
After=syslog.target
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

保存并退出。

步骤 8：启动和启用 Gitea 服务

sudo systemctl enable gitea
sudo systemctl start gitea

步骤 9：配置防火墙

默认情况下，Gitea 运行在端口 3000。允许此端口访问：

sudo ufw allow 3000/tcp
sudo ufw enable

步骤 10：访问 Gitea

打开浏览器，访问 http://<your-server-ip>:3000。

按照界面完成安装配置，使用默认或手动配置数据库。

完成后即可使用 Gitea 提供的 Web 界面进行代码托管和管理。

首次登陆时需要设置文件目录等。

---

常见问题解决：

1. 服务器IP变更后导致的无法登录问题解决

Gitea 由于 IP 修改导致无法登录，可能的原因包括配置文件绑定了旧 IP、数据库中的回调地址未更新，或者缓存问题。可以尝试以下方法解决：

检查 Gitea 配置文件

Gitea 的配置文件通常位于：

/etc/gitea/app.ini  # Linux
C:\gitea\custom\conf\app.ini  # Windows

• 找到 app.ini 文件，并检查 [server] 部分：

  [server]
  DOMAIN = <新IP地址>
  ROOT_URL = http://<新IP地址>:3000/
  

• 修改 DOMAIN 和 ROOT_URL 为新的 IP 地址，确保端口号正确。
• 保存文件后，重启 Gitea：

  systemctl restart gitea  # Linux
  

2. 重置管理员密码

使用命令行重置管理员密码

如果你可以访问服务器，可以使用 Gitea 内置的命令工具重置密码。

1. 切换到 Gitea 运行用户（如果是 git 用户运行 Gitea）：

   sudo -u git -H sh -c '/path/to/gitea admin user change-password --username admin --password "newpassword"'
   

   • 例如：

     sudo -u git -H sh -c '/usr/local/bin/gitea --config /etc/gitea/app.ini admin user change-password --username admin --password "newpassword"'
     

   • 如果 Gitea 运行在 root 账户下，可以直接运行：

     /path/to/gitea admin user change-password --username admin --password "newpassword"
     

--config /etc/gitea/app.ini手动指定配置文件的路径

1. 重启 Gitea

   systemctl restart gitea  # 如果是 systemd 方式运行
   

2. 使用新密码登录

---