使用Gitea搭建git服務

文檔地址：https://gitea.io/zh-cn/

安裝

docker方式：

docker pull gitea/gitea:latest  # 拉取 Gitea 鏡像
sudo mkdir -p /var/lib/gitea  # 創建一個目錄作爲數據存儲
docker run -d --name=gitea -p 10022:22 -p 10080:3000 -v /var/lib/gitea:/data gitea/gitea:latest
# 10022 爲容器內部ssh端口綁定到主機端口10022
# 10080 爲容器內部的服務端口綁定到主機端口10080

瀏覽器訪問 http://hostname:10080/ 可看到git頁面。

配置說明

配置說明文檔地址：https://docs.gitea.io/zh-cn/config-cheat-sheet/

/var/lib/gitea 目錄結構：

/var/lib/gitea
- git
- gitea
	- conf
		-app.ini  # 可直接修改該配置文件
-ssh

由於是docker方式啓動，該配置文件在容器內生效，所以需要更改 server 配置中 HTTP_ADDR、HTTP_PORT、SSH_PORT 爲本地默認配置：HTTP_ADDR=127.0.0.1、HTTP_PORT=3000、SSH_PORT=22，以供容器使用。

API訪問

API訪問文檔地址：

• https://docs.gitea.io/zh-cn/api-usage/
• https://try.gitea.io/api/swagger

api訪問默認開啓，可在配置文件中調整 ENABLE_SWAGGER 關閉api訪問。

使用api時，需要認證通過才能正常訪問，有以下兩種認證方式：

1. url查詢參數方式

   • 指定 token=...

   • 指定 access_token=...

   • url訪問示例：

     http://120.132.27.75:31004/api/v1/admin/users?token=1f56a367be293111de36f17f15259fd161d28478

2. http header 方式

   • 指定 Authorization: token ...

   • 示例

     curl -X POST "http://localhost:4000/api/v1/repos/test1/test1/issues" \
         -H "accept: application/json" \
         -H "Authorization: token 65eaa9c8ef52460d22a93307fe0aee76289dc675" \
         -H "Content-Type: application/json" -d "{ \"body\": \"testing\", \"title\": \"test 20\"}" -i
     

以上兩種方式中的 token、access_token、Authorization：token 均是一樣的，可在 Gitea web 界面中得到：Settings | Applications | Generate New Token