统信UOS安装与使用GitLab完整教程

要在UOS上安装GitLab，有一个关键点需要注意：系统版本必须是20，这样才能复用Ubuntu 20.04的软件源。首先将软件源切换到清华镜像，安装依赖，再运行官方安装脚本，绑定本机IP和8080端口。修改配置后，重新执行reconfigure，最后获取初始密码登录——整套流程并不复杂，但中间的细节容易出错。

UOS（统信操作系统）默认的APT源与GitLab不兼容，需要手动处理，借用Ubuntu 20.04（focal）的包体系来使用。下面逐步说明。

确认系统版本并启用兼容源

打开终端，先执行 cat /etc/os-release，确认输出中的 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 }'):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主界面。