【安装日记】Gitea服务器搭建与使用

以下是关于Gitea服务器的下载、搭建与使用的详细分步指南：

---

一、下载Gitea

1. 访问官网
   前往 Gitea 官网 或 GitHub Releases 下载最新版本。

2. 选择适合的版本
   根据操作系统选择对应的二进制文件（如 gitea-1.21.0-linux-amd64 或 gitea-1.21.0-windows-4.0-amd64.exe）。

3. Linux 下载示例

   wget -O gitea https://dl.gitea.io/gitea/1.21.0/gitea-1.21.0-linux-amd64
   chmod +x gitea
   

---

二、搭建Gitea

Linux 环境（以Ubuntu为例）

1. 安装依赖

   sudo apt update
   sudo apt install git sqlite3  # 若使用SQLite数据库
   

2. 创建运行用户(可选)

   sudo adduser --system --group --disabled-password --home /var/lib/gitea git
   

3. 配置目录权限

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

4. 移动Gitea二进制文件

   sudo mv gitea /usr/local/bin/gitea
   

5. 配置Systemd服务
   创建文件 /etc/systemd/system/gitea.service，内容如下：

   [Unit]
   Description=Gitea
   After=network.target
   
   [Service]
   User=git
   Group=git
   WorkingDirectory=/var/lib/gitea/
   ExecStart=/usr/local/bin/gitea web --config /var/lib/gitea/custom/conf/app.ini
   Restart=always
   
   [Install]
   WantedBy=multi-user.target
   

6. 启动服务

   sudo systemctl daemon-reload
   sudo systemctl enable --now gitea
   

---

Windows 环境

1. 直接运行二进制文件
   双击 gitea.exe，首次运行会自动生成配置文件 custom/conf/app.ini。

2. 注册为服务（可选）
   使用工具如 NSSM 将Gitea注册为服务：

   nssm install Gitea "C:\path\to\gitea.exe" web --config "C:\path\to\custom\conf\app.ini"
   nssm start Gitea
   

---

三、配置Gitea

1. 初始化安装
   访问 http://服务器IP:3000，按向导完成配置：

   • 数据库类型：SQLite3（简单）或 MySQL/PostgreSQL（生产环境）。
   • 站点名称：自定义名称（如 My Git Server）。
   • 管理员账号：设置管理员账户。

2. 修改配置文件（可选）
   编辑 /var/lib/gitea/custom/conf/app.ini，调整以下参数：

   [server]
   HTTP_PORT = 3000
   DOMAIN   = git.example.com
   ROOT_URL = http://git.example.com:3000/  # 或HTTPS地址
   

3. 反向代理（Nginx示例）
   配置Nginx转发到Gitea的3000端口：

   server {
       listen 80;
       server_name git.example.com;
   
       location / {
           proxy_pass http://localhost:3000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }
   

   重启Nginx：sudo systemctl restart nginx

---

四、使用Gitea

1. 创建仓库

   • 登录后点击右上角 + → 新建仓库。
   • 输入仓库名称，选择公开/私有。

2. 推送本地项目

   git remote add origin http://git.example.com/用户名/仓库名.git
   git push -u origin master
   

3. 用户与权限管理

   • 添加用户：管理员进入 管理面板 → 用户管理 → 创建用户。
   • 团队协作：在仓库设置中添加协作者或创建组织。

4. Web钩子（Webhooks）
   在仓库设置中配置Webhook，用于触发CI/CD或通知（如Jenkins、Discord）。

5. 备份与恢复

   • 备份：使用Gitea内置命令：

     gitea dump -c /var/lib/gitea/custom/conf/app.ini
     

   • 恢复：停止Gitea后替换数据目录并重启。

---

五、维护与升级

1. 升级Gitea

   • 下载新版本二进制文件，替换旧文件。
   • 重启服务：sudo systemctl restart gitea。

2. 日志查看

   journalctl -u gitea -f  # 查看实时日志
   

---

常见问题

1. 无法访问页面

   • 检查防火墙是否开放端口（3000或80）。
   • 确认Gitea服务是否运行：systemctl status gitea。

2. 数据库连接失败

   • 检查 app.ini 中的数据库配置路径和权限。

3. 迁移旧仓库

   • 本地仓库修改远程地址后直接推送即可。

---

通过以上步骤，您可以快速搭建一个私有Git服务器，满足个人或团队的代码托管需求。如需更高级功能（如LDAP集成、OAuth登录），请参考 Gitea 官方文档。