公司内网 GitLab 从零部署到使用全流程指南（含常见问题与用户教程）
本文详细记录了如何在公司内网服务器上，从零开始部署 GitLab，以及新员工如何快速上手 GitLab 使用。适用于技术团队内部知识沉淀与培训。
🧠 前置思考：搞清楚我们要做什么？
目标很明确：在公司内网服务器例如 192.168.21.32 上部署 GitLab，供内部团队使用、协作、管理代码仓库。
部署 GitLab 前，我们需要确认：
服务器操作系统类型（Linux or Windows）
是否有权限访问服务器并安装服务
是否允许改变服务端口（如 80 被占用）
第一步：确认服务器环境
🔍 判断系统是 Linux 还是 Windows：
如果你是通过 SSH 登录，并且看到终端命令行，说明是 Linux；
如果你是通过「远程桌面」登录，看到图形界面，那就是 Windows Server。
第二步：登录服务器
Linux 登录方式（推荐）：
ssh Administrator@192.168.21.32
# 密码：abcd123456
Windows 登录方式：
通过 Windows 自带的「远程桌面连接」，输入 IP 和账号密码连接。
第三步：选择安装方式
| 操作系统 | 推荐部署方式 |
|---|---|
| Linux | Omnibus 安装包 或 Docker |
| Windows | Docker Desktop（需开启 WSL2） |
本文主流程以最常见的 Linux + Omnibus 安装包方式 展开。
第四步：Linux 上部署 GitLab（以 Ubuntu 为例）
1️⃣ 系统更新 & 安装依赖
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl openssh-server ca-certificates tzdata perl
2️⃣ 添加 GitLab 软件源
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
3️⃣ 安装 GitLab CE 社区版
sudo EXTERNAL_URL="http://192.168.21.32" apt-get install gitlab-ce -y
⚠️ 如果端口 80 被占用，改成
EXTERNAL_URL="http://192.168.21.32:8060"。
4️⃣ 启动 GitLab 并初始化配置
sudo gitlab-ctl reconfigure
5️⃣ 验证服务是否启动成功
sudo gitlab-ctl status
第五步：访问 Web 界面
在浏览器中访问：
http://192.168.21.32/
若配置为其它端口（如 8060），访问：
http://192.168.21.32:8060/
首次登录需设置 root 密码。
🚧 常见问题：网页打不开怎么办？
❗ 报错：Not Found？
确认端口是否被占用，执行：
sudo ss -tlnp | grep :80
如果 80 被占用：
✅ 修改 GitLab 监听端口：
编辑配置文件：
sudo vi /etc/gitlab/gitlab.rb
修改为：
external_url 'http://192.168.21.32:8060'
重新加载配置：
sudo gitlab-ctl reconfigure
再次访问：
http://192.168.21.32:8060/
第六步：GitLab 初始配置建议
创建项目 → 点击 “New Project” → 填写项目名
创建团队组 → 管理多个项目
添加用户 → Admin Area → Users
启用 SSH 公钥登录（建议）
🌟 新同事快速上手指南
1️⃣ 登录系统
打开浏览器，访问：
http://192.168.20.147:8060/
输入用户名、密码登录；或点击 Register 自助注册（如开启）。
2️⃣ 配置 SSH Key（推荐）
在本地生成公钥：
ssh-keygen -t rsa -b 4096 -C "your.email@company.com"
登录 GitLab，进入：Settings → SSH Keys → 粘贴公钥 → 添加。
3️⃣ 克隆项目代码
找到项目 → 点击 Clone → 复制 SSH 地址 → 在终端执行：
git clone git@192.168.20.147:your-group/your-project.git
4️⃣ 提交与协作流程
新建分支
git checkout -b feature/your-feature
提交并推送
git add .
git commit -m "说明你的修改"
git push -u origin feature/your-feature
发起合并请求（MR）
GitLab 左侧 → Merge Requests → New merge request
选择源分支 & 目标分支 → 提交
审核与合并
同事评审 MR，合并至主分支（main/develop）
🛠 常用配置
通知偏好：Settings → Notifications
管理标签/里程碑：项目页面左侧 → Labels / Milestones
使用 Wiki & Issue：项目左侧
💡 小贴士
所有访问链接务必加上端口 :8060
可以配置内网 DNS，让 http://gitlab.company/ 代替 IP+端口
官方文档：https://docs.gitlab.com/ce/
✅ 总结
| 步骤 | 内容 |
|---|---|
| 1 | 判断系统类型 |
| 2 | 登录服务器 |
| 3 | 安装 GitLab（Omnibus） |
| 4 | 配置监听端口 |
| 5 | 启动与初始化 |
| 6 | 浏览器访问 GitLab |
| 7 | 项目管理与协作使用 |
部署 GitLab 不再神秘，希望本文能为你的团队打下坚实的代码协作基础。如果在部署或使用过程中遇到问题，欢迎团队成员及时反馈、提 issue ！
暂无评论内容