ubuntu gitlab 使用教程有哪些

Ubuntu 上 GitLab 使用教程精选与快速上手

一 安装与部署

• 使用 Omnibus 包安装（推荐）
  • 更新系统并安装依赖：sudo apt update && sudo apt install -y curl openssh-server ca-certificates tzdata perl
  • 添加官方仓库并安装：curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash，随后 sudo apt install -y gitlab-ce
  • 首次配置：sudo gitlab-ctl reconfigure
  • 访问地址：http://<服务器IP或域名>；管理员账号为 root，初始密码在 /etc/gitlab/initial_root_password，该文件会在 24 小时后自动删除，请尽快登录并修改密码
• 使用 Docker 部署（便于迁移与隔离）
  • 运行示例：docker run --detach --hostname localhost --publish 443:443 --publish 80:80 --publish 22:22 --name gitlab --restart always --volume /srv/gitlab/config:/etc/gitlab --volume /srv/gitlab/logs:/var/log/gitlab --volume /srv/gitlab/data:/var/opt/gitlab gitlab/gitlab-ce:latest
  • 说明：将主机端口 80/443/22 映射到容器内，持久化目录分别为 config、logs、data

二 基础配置与运维

• 核心配置文件与生效方式
  • 编辑：sudo vim /etc/gitlab/gitlab.rb，常见项为 external_url ‘http://your_domain_or_ip’
  • 使配置生效：sudo gitlab-ctl reconfigure
• 服务管理常用命令
  • 启动/停止/重启/状态：sudo gitlab-ctl start|stop|restart|status
• 邮件通知 SMTP 示例
  • 在 /etc/gitlab/gitlab.rb 中启用并填写：gitlab_rails[‘smtp_enable’] = true；gitlab_rails[‘smtp_address’] = “smtp.example.com”；gitlab_rails[‘smtp_port’] = 465；gitlab_rails[‘smtp_user_name’] = “user@example.com”；gitlab_rails[‘smtp_password’] = “password”；gitlab_rails[‘smtp_authentication’] = “login”；gitlab_rails[‘smtp_enable_starttls_auto’] = true；gitlab_rails[‘smtp_tls’] = true
• 防火墙放行
  • UFW 示例：sudo ufw allow 80/tcp；sudo ufw allow 443/tcp；sudo ufw allow 22/tcp；sudo ufw reload

三 日常使用流程

• 登录与初始设置
  • 使用浏览器访问实例地址，使用 root 和初始密码登录，并立即修改密码
• 创建项目与代码托管
  • 在 Web 界面点击 “New Project”，填写项目名称、描述与可见性后创建
  • 本地初始化并推送示例：git init；git add .；git commit -m “init”；git remote add origin <项目URL>；git push -u origin main
• 克隆与分支管理
  • 克隆方式：HTTPS：git clone https://<your_domain_or_ip>//.git；SSH：git clone git@<your_domain_or_ip>:/.git
  • 分支操作：git branch new-branch；git checkout new-branch；开发完成后合并到 main 并推送

四 备份恢复与安全加固

• 备份与恢复
  • 创建备份：sudo gitlab-backup create（Omnibus 新版本推荐）或 sudo gitlab-rake gitlab:backup:create（旧版本）；备份文件默认位于 /var/opt/gitlab/backups
  • 恢复备份：先确保实例已安装同版本，将备份文件放入备份目录后执行 sudo gitlab-backup restore BACKUP= 或 sudo gitlab-rake gitlab:backup:restore BACKUP=
• 安全与可用性建议
  • 修改默认管理员账户名与强密码策略，开启 2FA
  • 配置 HTTPS/TLS（Let’s Encrypt 或自有证书），对外仅暴露 80/443，SSH 使用非默认端口时同步调整防火墙与 GitLab 配置
  • 定期升级 GitLab 版本，保持安全补丁更新；限制管理接口与内网访问，审计关键操作日志