[Gogs](https://gogs.io/) 一款极易搭建的自助 Git 服务

## Centos7 下安装Gogs

> 参考：
> Gogs 官方文档 https://gogs.io/docs/

环境要求：
* 安装了 git
* 安装了 mysql 

### 1. 下载压缩包，并解压

https://gogs.io/docs/installation/install_from_binary
或者 
https://dl.gogs.io/

```bash
tar -zxvf gogs_0.12.10_linux_amd64.tar.gz -C /usr/local/
```

### 2. 启动 gogs

```shell
cd /usr/local/gogs
./gogs web

#后台运行
nohup ./gogs web &>> null &
```

> 问题1：` [FATAL] [gogs.io/gogs/internal/cmd/web.go:769 runWeb()] Failed to start server: listen tcp 0.0.0.0:3000: bind: address already in use`
>
> 解决：说明端口被占了，改为别的端口即可。执行 `./gogs web -port 3001`

### 3. 初次安装
> 注意：
> * SSH 端口不能和已有的端口号冲突
> * MySQL数据库中必须存在 gogs 数据库
> * 系统用户 git 必须对仓库目录和日志目录具有操作权限（*可将用户改为root*）
![初次安装](./imgs/20201009175536.png)


### 4. 注册登录
> 如果在安装中没有设置管理员账号的话，会自动将一个用户作为管理员

![image-20201009180432018](imgs/image-20201009180432018.png)

![image-20201009180530452](imgs/image-20201009180530452.png)

### 5. 控制面板页面

![image-20201009180640423](imgs/image-20201009180640423.png)

## Windows7 下安装Gogs

### 1. 下载压缩包，并解压

https://gogs.io/docs/installation/install_from_binary
或者 
https://dl.gogs.io/

**gogs_0.12.1_windows_amd64.zip**

![image-20201106105335628](imgs/image-20201106105335628.png)

### 2. 创建数据库

执行 gogs/scripts/mysql.sql 里的数据库语句

```sql
SET @s = IF(version() < 8 OR version() LIKE '%MariaDB%', 
            'SET GLOBAL innodb_file_per_table = ON, 
                        innodb_file_format = Barracuda, 
                        innodb_large_prefix = ON;', 
            'SET GLOBAL innodb_file_per_table = ON;');
PREPARE stmt1 FROM @s;
EXECUTE stmt1; 

DROP DATABASE IF EXISTS gogs;
CREATE DATABASE IF NOT EXISTS gogs CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

```



### 3. 注册Windows服务

1. 下载[NSSM](http://nssm.cc/download)，并解压

2. 将 nssm.exe 所在目录添加到环境变量PATH中

    ![image-20201106112623117](imgs/image-20201106112623117.png)

3. 修改 GOGS_HOME/scripts/windows/install-as-service.bat 脚本，将gogspath改为本地gogs安装目录

    ```basic
    SET gogspath=D:\develop\gogs
    ```

4. 管理员权限运行 install-as-service.bat

    ![image-20201106134411798](imgs/image-20201106134411798.png)

### 4. 启动Gogs

在cmd命令窗口执行： `gogs web`

![image-20201106134514749](imgs/image-20201106134514749.png)



### 3. 初次安装

### 4. 注册登录

### 5. 控制面板页面



## Gogs 简单使用

### 创建仓库

![image-20201009180843329](imgs/image-20201009180843329.png)

![image-20201009180857780](imgs/image-20201009180857780.png)

> 注意：
> * 克隆、拉取、推送和 github 一样
> * 我使用的版本（gogs_0.12.1），在gogs的控制面板中没有创建分支的功能，只能本地创建之后推送