gitea安装使用教程

### Gitea 安装与使用指南 #### 一、Gitea 简介 Gitea 是一款轻量级的自托管软件开发服务平台，提供了完整的 Git 托管解决方案以及丰富的功能集，如代码审查、团队协作、包注册表和 CI/CD 支持[^2]。 --- #### 二、安装准备 在 Ubuntu 22.04 上安装 Gitea 需要完成以下准备工作： 1. **更新系统** 更新系统的软件包列表并升级现有软件包。 ```bash sudo apt update && sudo apt upgrade -y ``` 2. **安装依赖项** 安装必要的工具和服务，例如 `curl` 和数据库服务（推荐 SQLite 或 MySQL）。 ```bash sudo apt install curl sqlite3 mysql-server -y ``` 3. **创建运行用户** 创建一个专用用户用于运行 Gitea 进程。 ```bash sudo adduser --system --group --disabled-password --home /var/lib/gitea gitea ``` --- #### 三、下载与安装 Gitea 1. **获取最新版本** 访问官方发布页面或镜像站点以获取最新的 Gitea 版本号。以下是示例命令： ```bash VERSION=$(curl -s https://api.gitea.io/version | grep tag_name | cut -d '"' -f 4) wget "https://dl.gitea.io/gitea/${VERSION}/gitea-${VERSION}-linux-amd64" mv gitea-${VERSION}-linux-amd64 /usr/local/bin/gitea chmod +x /usr/local/bin/gitea ``` 2. **设置目录结构** 创建所需的文件夹并调整权限。 ```bash mkdir -p /var/lib/gitea/{custom,data,indexers,logs} chown -R gitea:gitea /var/lib/gitea/ chmod -R 750 /var/lib/gitea/ ``` 3. **配置 systemd 服务** 编辑 `/etc/systemd/system/gitea.service` 文件，定义 Gitea 的启动脚本。 ```ini [Unit] Description=Gitea (Git with a cup of tea) After=syslog.target After=network.target [Service] RestartSec=2s Type=simple User=gitea Group=gitea WorkingDirectory=/var/lib/gitea/ ExecStart=/usr/local/bin/gitea web -c /etc/gitea/app.ini Restart=always Environment=USER=gitea HOME=/var/lib/gitea [Install] WantedBy=multi-user.target ``` 启动并启用服务： ```bash systemctl daemon-reload systemctl start gitea systemctl enable gitea ``` --- #### 四、初始化配置 首次访问 Gitea Web 界面时会进入向导模式，需填写如下信息： - 数据库类型：SQLite、MySQL 或 PostgreSQL。 - 基础 URL 地址。 - SSH 端口号（默认为 22）。 - 日志路径及其他高级选项。 完成后即可登录管理员账户开始使用。 --- #### 五、API 集成（可选） 如果需要通过 Java 应用调用 Gitea 功能，则可以借助 Java-Gitea-API 工具库[^3]。其基本流程包括： 1. 添加 Maven 依赖到项目的 `pom.xml` 中。 ```xml <dependency> <groupId>com.github.gitea</groupId> <artifactId>java-gitea-api</artifactId> <version>1.18.0</version> </dependency> ``` 2. 初始化客户端实例并与服务器建立连接。 ```java import io.gitea.api.GiteaApi; public class Main { public static void main(String[] args) throws Exception { String token = "your-access-token"; GiteaApi api = new GiteaApi("http://localhost:3000", token); System.out.println(api.getUser().getLogin()); } } ``` --- #### 六、安全性增强 为了保护私有仓库的安全性，建议采取以下措施： - 修改默认 HTTP 端口至非标准值（如 3001）。 - 开启 HTTPS 加密通信。 - 设置防火墙规则仅允许特定 IP 范围内的请求。 ---