• 本文目录导读：
• 1、安装准备
• 2、步骤一：下载并解压 Gogs
• 3、步骤二：创建 Gogs 用户
• 4、步骤三：安装并配置 MariaDB
• 5、步骤四：配置 Gogs
• 6、步骤五：启动 Gogs
• 7、问题解决

在进行软件开发的过程中，代码托管是不可或缺的一环。Git 是目前最流行的版本控制工具之一，而 Gogs 则是一个轻量级、易于安装和部署的 Git 服务。

本文将介绍如何在 Ubuntu 14.04 上安装 Gogs，并解决可能遇到的问题。

安装准备

在开始安装之前，请确保已经按照以下步骤完成了必要的准备工作：

1. 确认你已经拥有一个可用的域名或者 IP 地址。

2. 确认你已经拥有一个 sudo 权限用户账号。

3. 确认你已经安装了 Git。

步骤一：下载并解压 Gogs

首先，在官方网站上下载最新版本的 Gogs 压缩包。可以使用以下命令来完成：

“`

$ wget

然后，将下载好的压缩包解压到 /home/yourusername/gogs 目录下（注意替换 yourusername 为你自己用户名）：

$ tar -zxvf gogs_latest.tar.gz -C /home/yourusername/

接下来，进入该目录并重命名文件夹为 gogs：

$ cd /home/yourusername/

$ mv gogs_x.x.x gogs

步骤二：创建 Gogs 用户

为了保证 Gogs 的正常运行，我们需要创建一个专门的用户来运行 Gogs 服务。

首先，使用以下命令创建一个新用户（注意替换 yourgogsusername 为你自己的用户名）：

$ sudo adduser –system –group –shell /bin/bash –disabled-password yourgogsusername

然后，将该用户添加到当前登录用户所在的组中：

$ sudo usermod -a -G yourloginusergroup yourgogsusername

最后，将 Gogs 目录所有权更改为该用户：

$ sudo chown -R yourgogsusername:yourloginusergroup /home/yourusername/gogs

步骤三：安装并配置 MariaDB

Gogs 需要一个数据库来存储数据。在本教程中，我们将使用 MariaDB（MySQL 的分支）作为数据库。

首先，在终端中输入以下命令以安装 MariaDB：

$ sudo apt-get update

$ sudo apt-get install mariadb-server mariadb-client

然后，在终端中输入以下命令以启动 MariaDB 并设置 root 密码：

$ sudo mysql_secure_installation

Enter current password for root (enter for none):

Set root password? [Y/n] Y # 输入 Y 并回车设置新密码。

Remove anonymous users? [Y/n] Y # 移除匿名账户，保留 root 账户。

Disallow root login remotely? [Y/n] Y # 禁止远程登录 root 账户。

Remove test database and access to it? [Y/n] Y # 移除测试数据库和相关权限。

Reload privilege tables now? [Y/n] Y # 重新加载权限表以使更改生效。

最后，我们需要创建一个新用户并为该用户分配一个新的数据库。在终端中输入以下命令：

$ sudo mysql -u root -p

MariaDB [(none)]> CREATE DATABASE gogsdb;

MariaDB [(none)]> GRANT ALL PRIVILEGES ON gogsdb.* TO ‘gogsuser’@’localhost’ IDENTIFIED BY ‘yourpassword’;

MariaDB [(none)]> FLUSH PRIVILEGES;

MariaDB [(none)]> EXIT;

其中，yourpassword 是你自己设置的密码。

步骤四：配置 Gogs

接下来，我们需要对 Gogs 进行一些基本设置。

首先，在终端中进入 /home/yourusername/gogs 目录，并复制 app.ini.sample 文件：

$ cd /home/yourusername/gogs

$ cp app.ini.sample app.ini

然后，编辑 app.ini 文件并修改以下字段（注意按照自己的实际情况进行修改）：

“`ini

APP_NAME = GOGS

[server]

DOMAIN = yourdomain.com # 替换为你自己的域名或 IP 地址

HTTP_PORT = 3000 # 可以根据需要更改端口号

ROOT_URL = # 替换为你自己的地址

DISABLE_SSH = false

[database]

DB_TYPE = mysql

HOST = 127.0.0.1:3306 # 数据库地址和端口号

NAME = gogsdb # 数据库名称，与之前创建的数据库一致

USER = gogsuser # 数据库用户名，与之前创建的用户一致

PASSWD = yourpassword # 数据库密码，与之前设置的密码一致

[repository]

ROOT = /home/yourusername/gogs-repositories # 存储代码仓库文件夹路径（可以根据需要更改）

步骤五：启动 Gogs

最后，在终端中输入以下命令以启动 Gogs：

$ sudo -u yourgogsusername ./gogs web &

然后，在浏览器中访问 即可进入 Gogs 的安装向导。

问题解决

在安装过程中可能会遇到各种问题。以下是一些常见问题及其解决方法：

1. 端口被占用

如果在启动 Gogs 时提示端口已经被占用，则可以尝试修改 HTTP_PORT 字段并重试。

2. 连接数据库失败

如果在连接数据库时出现错误，则有可能是用户名、密码或者其他配置信息不正确。请检查 app.ini 文件中的数据库配置项，并确保数据库已经正确安装和启动。

3. 无法访问 Gogs 界面

如果在访问 Gogs 界面时出现问题，则可能是防火墙或者其他网络配置问题。请检查防火墙设置、域名解析和网络连接等方面，并确保没有任何问题。

Gogs 是一个非常好用的 Git 服务，可以帮助我们轻松管理代码仓库。通过本文的介绍，相信大家已经了解了如何在 Ubuntu 14.04 上安装 Gogs，以及如何解决一些常见问题。希望这篇文章能够对大家有所帮助！