在现代软件开发过程中，版本控制和协作工具的作用不可忽视，GitLab作为一个开源的代码托管平台，提供了从代码管理到CI/CD的一整套解决方案，本文将指导你如何在本地环境中搭建GitLab服务器，让你能够更好地进行团队协作和项目管理。

准备工作

在开始之前，确保你的计算机满足以下基本配置要求：

操作系统：支持Docker（推荐使用Ubuntu 20.04 LTS或更高版本）。

内存：至少8GB RAM。

存储空间：至少10GB的可用空间。

网络：稳定的互联网连接，用于下载镜像和更新。

安装前的准备

1、更新系统：更新你的操作系统以确保所有包都是最新的。

sudo apt update && sudo apt upgrade -y

2、安装必要的软件包：安装Git、Docker.io以及GitLab相关的软件包。

curl -fsSL https://install.gitlab.net | sudo -E bash -- --unattended

3、创建非root用户：创建一个专用于GitLab的用户。

sudo adduser gitlab --disabled-password --gecos "GitLab" --home /home/gitlab --no-create-home --ingroup docker

4、设置密码：为新用户设置一个强密码。

sudo passwd gitlab

安装和配置GitLab Server

1、下载镜像：从官方仓库下载GitLab镜像。

sudo docker pull gitlab/gitlab-ce:latest

2、启动容器：使用--detach标志以后台模式运行容器，防止容器退出后服务停止。

sudo docker run 
    --hostname=gitlab.local 
    --publish=80:80 
    --publish=443:443 
    --volume=/var/run/docker.sock:/var/run/docker.sock 
    --restart=unless-stopped 
    --privileged=true 
    --userns=1:1 
    --env GITLABB_SECRET_KEY="your_secret_key" 
    --env GITLABB_OMNIBUS_CONFIG="external_url 'http://gitlab.local'" 
    --name=gitlab 
    --mount type=bind,source=/srv/gitlab,target=/home/gitlab/gitlab 
    gitlab/gitlab-ce:latest

3、访问GitLab：通过浏览器访问http://gitlab.local来查看GitLab控制面板，首次访问时，系统会提示你登录或注册一个新的账户，输入你先前设置的用户名和密码进行登录。

配置GitLab实例

1、修改配置文件：编辑配置文件/home/gitlab/gitlab/config.rb，根据需要修改配置选项，你可以修改omnibus_config部分来更改外部URL和SSH端口。

```ruby

config[:git_http] = { url: 'http://gitlab.local' } # 修改为你的域名或IP地址

config[:git_https] = { url: 'https://gitlab.local' } # 如果需要HTTPS支持，可以设置此项

```

你可以设置SSH端口，如果你希望使用其他端口，可以在omnibus_config中设置ssl_port和ssh_port。

```ruby

config[:ssh_port] = 2222 # 设置你想要的SSH端口号，如2222、3000等，但注意不要与系统端口冲突

```

保存文件并重启GitLab容器来应用新的配置。

```bash

sudo systemctl restart docker-container gitlab

```

2、设置数据库：根据你的需求选择适当的数据库驱动并配置数据库信息，默认使用的是PostgreSQL和MySQL，可以通过编辑database_setup脚本来自动配置数据库，如果选择PostgreSQL作为例子，执行以下命令：

```bash

sudo sh -c <<<'exec bash -l' > /dev/tty unsetpw -r /var/lib/postgresql/data/pg_hba.conf; echo "host all all trust" >> /var/lib/postgresql/data/pg_hba.conf; echo "host all all 0.0.0.0/0 md5" >> /var/lib/postgresql/data/pg_hba.conf; echo "host replication all trust" >> /var/lib/postgresql/data/pg_hba.conf; echo "host replication all md5" >> /var/lib/postgresql://localhost:5432/db' > /tmp/dbSetup.sh; chmod +x /tmp/dbSetup.sh; sudo ./dbSetup.sh; rm /tmp/dbSetup.sh' # dbSetup.sh是一个包含数据库初始化脚本的自动化脚本，执行后会自动创建数据库和用户，并设置权限规则，请根据实际情况调整脚本内容。