在UOS上安装GitLab需先确认VersionID="20"以适配Ubuntu 20.04源,手动添加清华镜像源并更新;再依次安装依赖、执行GitLab CE安装脚本并指定EXTERNAL_URL绑定本机IP和8080端口;修改/etc/gitlab/gitlab.rb中external_url保持一致后运行reconfigure,成功后查看/etc/gitlab/initial_root_password获取初始密码,浏览器访问http://IP:8080用root登录。

在UOS(统信操作系统)上安装和使用GitLab,需绕过其默认不兼容的APT源策略,手动适配Ubuntu 20.04(focal)软件包体系,并完成服务配置与首次访问初始化。
确认系统版本并启用兼容源
打开终端,执行 cat /etc/os-release,确认 UOS 版本号中包含 20(如 VersionID="20"),这表示底层基于 Ubuntu 20.04,可复用 focal 源。
运行 sudo apt update 后若报错“无法定位软件包”,说明默认源未启用 focal 兼容层;此时需手动添加 Ubuntu 20.04 官方源地址到 /etc/apt/sources.list 中,否则后续所有安装命令都会失败。
执行 sudo sed -i 's/archive.ubuntu.com/mirrors.tuna.tsinghua.edu.cn/g' /etc/apt/sources.list 加速下载,再运行 sudo apt update 确保源可用。
安装必要依赖与 GitLab CE
依次执行以下三条命令:
sudo apt install -y curl openssh-server ca-certificates tzdata perl postfix
安装 postfix 时弹出图形化配置界面,选择 【Internet Site】 → 回车 → 在“mail name”字段输入本机主机名(如 gitlab-uos),不要留空或填 IP。
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
sudo EXTERNAL_URL="http://$(hostname -I | awk '{print $1}'):8080" apt install -y gitlab-ce —— 这条命令自动获取本机主IP并绑定到 8080 端口,避免因端口冲突导致 Web 无法访问。
配置并启动 GitLab 服务
编辑主配置文件:sudo vim /etc/gitlab/gitlab.rb。
找到 external_url 行,将其改为与安装时一致的地址,例如:external_url 'http://192.168.1.100:8080';必须保留 http:// 前缀且不可省略端口号,否则重配置后页面跳转会丢失端口,返回 502 错误。
保存退出后,执行 sudo gitlab-ctl reconfigure。该过程耗时约 3~5 分钟,期间会编译 Nginx 配置、初始化数据库、生成证书等,终端持续滚动日志即为正常。
等待出现 gitlab Reconfigured! 提示后,运行 sudo gitlab-ctl start 确保所有组件已就绪。
获取初始密码并登录
首次启动完成后,root 用户密码被写入固定路径:sudo cat /etc/gitlab/initial_root_password。
复制输出中 Password: 后的那串随机字符(含大小写字母、数字、符号),它仅显示一次,关闭终端后无法再次查看,务必立即保存。
在浏览器中访问 http://本机IP:8080(例如 http://192.168.1.100:8080),输入用户名 root 和刚复制的密码即可进入 GitLab 主界面。


















