# 问题由来

因为需要给自己的项目做一个项目管理工具，
Git 无疑是最好的，也比较习惯，
但是又不想放在 Github ，所以想自己搭建，
然后找到了 Gitlab

# 问题解决

想要装一个东西，
最开始怎么办，当然是去找官网啦～
于是我就去 Gitlab 逛了一圈，
成功找到了官方正版的，最权威的安装教程。
那么下面开始吧
官网 Gitlab 安装文档(Ubuntu 16.04)

# 环境准备

Ubuntu 16.04
联网状态

# 操作记录

- 1.安装并配置必要的依赖项

在终端执行：

sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates

在官网的教程里，这里是还需要配置邮箱服务的，但是我没打算搭建邮件服务，所以我这就没有执行安装 postfix 了。

- 2.添加 Gitlab 软件包到存储库并且安装

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
sudo apt-get install gitlab-ee

（五百多兆，网速不好的话需要等一会）
在这里，官网教程是说要设置绑定的域名的，但是我打算直接改配置文件，所以直接安装了；
一般的教程这里都是选择安装 gitlab-ce （社区版本），但是我这里安装了 gitlab-ee（商业版本），其实差别不大；
想要使用商业版本的功能的话，就只需要添加商业许可就好，
如果安装的是 ce 版本，需要使用商业版本功能则需要重新安装，会特别麻烦。
在执行安装完毕之后会出现这个画面，就安装成功了：

安装成功

- 3.修改配置文件

首先找到配置文件

/etc/gitlab/gitlab.rb # 配置文件

修改以下配置项（如果你没有改的话，应该和我差不多）

• 修改绑定域名

 external_url 'http://gitlab.example.com'
 # 改为你的域名(我这里是本地运行，我就设置为 localhost )
external_url 'http://localhost'

如图：

修改绑定地址

官网配置url示例文档

• 修改发信邮箱
  找到配置文件中的邮箱设置

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "xxxx@xx.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = 'xxxx@xx.com'
# 把这些添加进去，注意修改为你的邮箱地址（我这里是设置的腾讯邮箱）

如图：（我直接使用的QQ邮箱，所以我把我邮箱打码了）

邮箱配置

官网配置email示例文档

- 4.重新载入配置文件（或者直接重启Gitlab）

执行

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

执行之后会刷很多东西出来，因为是第一次，可能需要点时间

- 5.进入网站设置 root 密码

如图：

设置 root 初始密码

- 6.进入设置并新增用户

Setting --> Admin Area --> Overview --> User --> New User

如图：

新增用户

然后填写用户名，邮箱什么的，会发送邮件到指定邮箱，让用户自己设置密码
（这一步也顺便测试一下邮箱设置是否对）

设置用户名和邮箱

创建用户

最后，成功拿到邮件，

收到邮件

- 7.登录刚刚创建的用户

测试一下看能不能用：

登录用户并创建项目

完美

PS: 如果有不对的地方，还请多多指教～

-- iNick
-- 2019/03/01