在Linux服务器上配置本地代码仓库可以有效提升代码管理的自主性和安全性。GitLab作为一体化的DevOps平台,支持自托管部署,适合中小型团队搭建内部仓库服务。下面以Ubuntu系统为例说明具体步骤。

一、环境准备
建议准备一台至少4GB内存、2核CPU的Linux主机,系统可以是Ubuntu 20.04或22.04。先更新系统软件包并安装依赖:
# 更新软件源 sudo apt update sudo apt upgrade -y # 安装必要依赖 sudo apt install -y curl openssh-server ca-certificates postfix
二、安装GitLab
GitLab官方提供了便捷的安装脚本,我们可以直接添加仓库并安装社区版:
# 下载并执行GitLab仓库添加脚本 curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash # 安装GitLab社区版,请替换为你自己的域名或IP sudo EXTERNAL_URL="http://192.168.0.1" apt install gitlab-ce
三、修改配置文件
安装完成后,主要配置位于 /etc/gitlab/gitlab.rb 文件中。如果需要调整访问地址或端口,可以修改以下项:
# 设置外部访问地址 external_url 'http://192.168.0.1' # 若端口冲突可改用其他端口,例如 # external_url 'http://192.168.0.1:8080'
修改后执行重新配置命令使生效:
sudo gitlab-ctl reconfigure
四、启动与访问
使用如下命令管理GitLab服务:
- 启动:sudo gitlab-ctl start
- 停止:sudo gitlab-ctl stop
- 重启:sudo gitlab-ctl restart
服务启动后,浏览器访问配置的地址即可进入GitLab页面。首次登录需使用 root 账户,密码保存在 /etc/gitlab/initial_root_password 中。
五、创建第一个仓库
登录后点击新建项目,填写名称与描述,选择可见级别,即可创建本地仓库。之后在开发机上使用 git 命令关联远程地址:
# 初始化本地仓库 git init git remote add origin http://192.168.0.1/root/demo.git git add . git commit -m "init" git push -u origin master
六、常见问题
| 问题 | 处理方式 |
|---|---|
| 页面无法打开 | 检查防火墙是否放行端口,确认gitlab-ctl status正常 |
| 内存占用高 | 可关闭部分不需要的服务,如Pages、Registry |
提示:生产环境建议配置HTTPS与定期备份,避免数据丢失。
小结
通过上述步骤,我们完成了在Linux上配置本地GitLab代码仓库的过程。后续可结合CI配置文件实现自动构建与测试,进一步提升研发效率。