Ubuntu 22.04 LTS 安装 gitlab

ubuntu 22.04 安装 gitlab

1. 前置条件

  。已安装 Docker（建议 20.10 + 版本）和 Docker Compose（可选，用于简化配置）。。服务器至少 4GB 内存（生产环境建议 8GB+，否则可能因内存不足启动失败）。。开放必要端口：80（HTTP）、443（HTTPS）、22（SSH，若需通过 SSH 访问仓库）。

2. 安装 Docker（若未安装）：

 sudo apt update && sudo apt install -y docker.io docker-compose-pluginsudo systemctl enable --now dockersudo usermod -aG docker $USER  # 非root用户添加docker权限（需重启生效）

步骤 1：准备数据持久化目录

 # 创建宿主机目录（可自定义路径，建议放在大磁盘下）sudo mkdir -p /data/gitlab/{config,data,logs}# 设置权限（避免容器内进程无权限读写，GitLab容器内默认用户ID为998）sudo chmod -R 777 /data/gitlab  # 简单粗暴（测试环境可用）# 生产环境建议更精细：sudo chown -R 998:998 /data/gitlab

步骤 2：启动 GitLab 容器

方式 1：直接用docker run命令

一行命令启动，适合快速测试：

docker run --detach \--hostname gitlab.example.com  # 替换为你的域名或服务器IP（如192.168.1.100）\--publish 80:80 \               # 宿主机80端口映射到容器80（HTTP）--publish 443:443 \             # 宿主机443端口映射到容器443（HTTPS，若需）--publish 2222:22 \             # 宿主机2222端口映射到容器22（SSH，避免与宿主机22冲突）--name gitlab \                 # 容器名称--restart always \              # 开机自启--volume /data/gitlab/config:/etc/gitlab \  # 配置文件挂载--volume /data/gitlab/data:/var/opt/gitlab \ # 数据挂载--volume /data/gitlab/logs:/var/log/gitlab \ # 日志挂载gitlab/gitlab-ce:latest         # 官方社区版镜像（latest为最新版，可指定版本如16.0.0-ce.0）

方式 2：用 Docker Compose（推荐，便于管理）

1.创建docker-compose.yml文件：

version: '3.8'
services:gitlab:image: gitlab/gitlab-ce:latestcontainer_name: gitlabrestart: alwayshostname: gitlab.example.com  # 替换为你的域名/IPenvironment:# 核心配置：外部访问URL（必须设置，否则页面跳转异常）GITLAB_OMNIBUS_CONFIG: |external_url 'http://gitlab.example.com'  # 替换为你的URL（http/https）# 若需SSH访问，指定SSH端口（与宿主机映射的端口一致）gitlab_rails['gitlab_shell_ssh_port'] = 2222ports:- "80:80"       # HTTP- "443:443"     # HTTPS- "2222:22"     # SSHvolumes:- /data/gitlab/config:/etc/gitlab- /data/gitlab/data:/var/opt/gitlab- /data/gitlab/logs:/var/log/gitlab# 可选：限制资源（避免GitLab占用过多内存）deploy:resources:limits:cpus: '2'memory: 8G

2.启动容器：

docker compose up -d  # 后台启动

步骤 3：首次访问与配置

1.等待启动完成：

GitLab 启动较慢（首次需初始化数据库等），可通过日志查看进度：

docker logs -f gitlab  # 实时查看日志，出现"gitlab Reconfigured!"即启动完成

2.访问 GitLab：

浏览器打开你设置的external_url（如http://192.168.1.100），首次访问会提示设置root用户的密码（需牢记）。

3.登录：

输入root用户名和刚才设置的密码，即可进入 GitLab 控制台。

关键配置说明

1.修改外部 URL：

若需修改访问地址，编辑/data/gitlab/config/gitlab.rb（宿主机目录）：

sudo vim /data/gitlab/config/gitlab.rb

找到并修改：

external_url 'http://新的域名或IP'
gitlab_rails['gitlab_shell_ssh_port'] = 2222  # 若SSH端口变更

然后进入容器执行重新配置：

docker exec -it gitlab gitlab-ctl reconfigure

2.配置 HTTPS：

需提前准备 SSL 证书（如server.crt和server.key），将证书放到宿主机/data/gitlab/config/ssl/目录，然后修改gitlab.rb：

external_url 'https://gitlab.example.com'
nginx['ssl_certificate'] = "/etc/gitlab/ssl/server.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/server.key"

重新配置生效。

3.邮件通知：

编辑gitlab.rb配置 SMTP（以 QQ 邮箱为例）：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "你的QQ邮箱@qq.com"
gitlab_rails['smtp_password'] = "邮箱授权码"  # 非登录密码，需在邮箱设置中获取
gitlab_rails['smtp_domain'] = "qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = "你的QQ邮箱@qq.com"

注意事项

1.端口冲突：若宿主机 80/443/22 端口已被占用，需修改映射端口（如-p 8080:80将宿主机 8080 映射到容器 80），同时更新external_url（如http://ip:8080）。
2.内存不足：若启动失败或频繁崩溃，检查内存是否≥4GB，可通过free -h查看，不足时建议增加内存或启用 Swap。
3.数据备份：直接备份宿主机/data/gitlab目录即可（tar -zcvf gitlab_backup.tar.gz /data/gitlab）。
4.版本更新：停止容器→删除容器→拉取新镜像→重新启动（数据目录不变则数据保留）。