在香港服务器部署GitLab,如何配置HTTPS与仓库SSH访问?
在香港服务器上部署 GitLab,HTTPS 与仓库 SSH 访问需要分别配置:HTTPS 由 GitLab 内置 Nginx 提供,用于网页登录、API 和 Git over HTTPS;仓库 SSH 访问则由服务器的 OpenSSH 接收连接,再交给 GitLab Shell 校验用户密钥与项目权限。浏览器能打开 GitLab,并不代表 SSH 拉取、推送已经可用,两条链路必须独立验收。

下面采用 Ubuntu 22.04 LTS、GitLab CE Linux 软件包、单台服务器直连公网的部署方式,使用 git.example.com 作为示例域名。上线目标是:网页通过有效的 HTTPS 证书访问,HTTP 自动跳转 HTTPS,开发人员使用自己的 SSH 密钥操作仓库,同时保留配置备份与故障回退路径。香港服务器所在机房不改变这些配置原理,实际需要核对的是公网地址、DNS、机房访问控制及客户端到服务器的连通性。
A5数据提供中国香港物理服务器资源,覆盖Xeon Gold、AMD EPYC等平台,并配备SSD或NVMe存储及不同内存配置,可承载GitLab网页服务、仓库数据、数据库与多用户协作等工作负载。结合CN2和国际带宽线路,能够为HTTPS访问、SSH仓库连接及企业研发团队的日常代码管理提供相应的服务器与网络基础。
一、确认服务器、域名与端口条件
部署环境与资源边界
本文命令适用于 Ubuntu 22.04,使用带 sudo 权限的运维账号执行。安装前先确认 GitLab 软件仓库仍为该系统版本和 CPU 架构提供所需版本,不要把其他发行版的软件源直接套用过来。
| 项目 | 本文采用的条件 | 核对重点 |
|---|---|---|
| 操作系统 | Ubuntu 22.04 LTS | 系统版本、软件源支持情况 |
| CPU 架构 | x86_64,即 amd64 | 软件包架构必须匹配 |
| 部署形式 | GitLab CE Linux 软件包 | 使用内置 Nginx、数据库及相关组件 |
| 示例资源 | 4 vCPU、8~16 GiB 内存、100 GiB SSD | 仅作为小团队部署起点,按仓库、并发及后台任务调整 |
| 域名 | git.example.com | 替换为实际拥有并可修改 DNS 的域名 |
| 公网入口 | TCP 80、443、22 | 分别用于证书验证、HTTPS、SSH |
| 现有服务 | 不占用上述端口 | 本文不覆盖与现有网站共用 Nginx 的情形 |
CI Runner 不在本篇部署范围内。若把构建任务也放在同一台服务器上,需要额外评估 CPU、内存和磁盘,不能直接沿用上表的参考资源。
执行以下检查:
cat /etc/os-release
dpkg --print-architecture
free -h
df -h / /var
timedatectl status
sudo ss -ltnp
应确认系统为 Ubuntu 22.04、架构输出为 amd64,磁盘有足够空间,系统时间同步正常。ss 输出中若已有程序占用 80 或 443,应先处理冲突;不要直接停止来源不明的服务。
DNS 与公网地址
在 DNS 控制台为 git.example.com 创建 A 记录,指向香港服务器的公网 IPv4。没有可用公网 IPv6 时,不要保留指向旧地址的 AAAA 记录,否则浏览器或证书验证机构可能优先连接错误地址。
在客户端查询:
dig +short A git.example.com
dig +short AAAA git.example.com
A 记录应返回目标服务器公网 IPv4;AAAA 记录应为空,或返回确实可访问该服务器的 IPv6 地址。
本文默认 DNS 直接指向服务器,不经过额外的 CDN 或 TLS 终止设备。如果使用这些组件,需要分别核对 HTTPS 回源和证书验证路径;普通 HTTP CDN 接入也不意味着仓库 SSH 流量会被转发。
必须区分三个配置层次:DNS 决定访问地址,防火墙决定能否连接,GitLab 配置决定页面及克隆地址如何生成。三者不能相互替代。
二、放通入口并安装 GitLab
先保护现有管理连接
修改防火墙前,保留当前 SSH 会话,并确认可以使用服务器控制台。再核对管理 SSH 实际监听的端口:
sudo /usr/sbin/sshd -T | grep '^port '
sudo ss -ltnp | grep sshd
sudo ufw status verbose
本文后续采用 SSH 端口 22。如果服务器管理端口已改为其他值,必须先允许实际管理端口,否则启用防火墙可能导致失联。
先备份现有 UFW 配置与状态:
sudo install -d -m 700 /root/gitlab-deploy-backup
sudo cp -a /etc/ufw /root/gitlab-deploy-backup/ufw.before
sudo sh -c 'ufw status verbose > /root/gitlab-deploy-backup/ufw-status.before.txt'
以下规则适用于没有复杂既有防火墙策略的新服务器,会允许对应端口从公网访问:
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable
sudo ufw status numbered
如果 UFW 已有业务规则,应在现有策略上增加必要规则,不要执行 ufw reset。SSH 来源固定时,可以改为仅允许团队办公地址或受信任网段;这样做也会限制仓库 SSH 访问,必须把开发人员和自动化任务的出口地址一起考虑。
机房控制台的安全组或访问控制还需放通相同端口。完成后,另开一个终端重新登录服务器,确认新管理连接成功,再继续安装。
回退边界:只有在 UFW 原本未启用、且本次首次启用导致连接异常时,才考虑从服务器控制台执行 sudo ufw disable。已有防火墙不能简单关闭,应依据备份恢复原规则。机房安全组的修改也要单独撤回。安装依赖并核验软件源
安装依赖会修改系统软件包状态,生产服务器应先创建系统快照或确认已有可恢复备份:
sudo apt-get update
sudo apt-get install -y curl ca-certificates openssh-server tzdata perl
sudo systemctl enable --now ssh
sudo systemctl status ssh --no-pager
ssh 服务应处于 active (running)。本文不依赖本机邮件服务器;邀请邮件和密码找回需要后续配置可用的 SMTP 服务。
添加 GitLab CE 软件源。下面的脚本来源为 GitLab 软件包站点,建议先查看内容,再以管理员权限执行:
curl -fL \
https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh \
-o /tmp/gitlab-ce-repository.sh
less /tmp/gitlab-ce-repository.sh
sudo bash /tmp/gitlab-ce-repository.sh
sudo apt-get update
apt-cache policy gitlab-ce
apt-cache madison gitlab-ce
成功时,apt-cache policy 应显示可安装的候选版本,而不是 Candidate: (none)。候选为空时,先检查系统代号、架构、软件源及下载连接,不要靠修改发行版代号强行安装。
以 HTTPS 外部地址安装
先确认 DNS 已生效,且公网 TCP 80、443 已放通,再执行:
sudo EXTERNAL_URL="https://git.example.com" apt-get install -y gitlab-ce
这里的 EXTERNAL_URL 会生成 GitLab 的外部访问地址。在满足条件的新安装中,HTTPS 地址会启用内置的 Let's Encrypt 证书申请流程。
安装过程会启动多个组件,耗时受服务器性能和软件包下载速度影响。若软件包已安装,但初始化因证书申请失败而中断,不要反复卸载重装,应先检查 DNS 和 80 端口,再执行重新配置。
安装后检查:
dpkg-query -W gitlab-ce
sudo gitlab-ctl status
sudo ss -ltnp | grep -E ':(22|80|443)\b'
关键组件应显示 run:,包括 Nginx、Puma、Sidekiq、PostgreSQL、Redis 等。首次启动时部分组件可能仍在初始化,可稍后复查;持续异常则查看对应日志,不要仅凭“安装命令结束”判断上线成功。
三、明确 HTTPS 配置并验证证书
固化域名、重定向与续期设置
GitLab Linux 软件包的主要配置文件是:
/etc/gitlab/gitlab.rb
先备份,再编辑:
sudo cp -a /etc/gitlab/gitlab.rb \
/root/gitlab-deploy-backup/gitlab.rb.before-https
sudoedit /etc/gitlab/gitlab.rb
找到已有配置项并修改,避免在文件末尾不断追加重复项:
external_url 'https://git.example.com'
nginx['redirect_http_to_https'] = true
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['ops@example.com']
letsencrypt['auto_renew'] = true
gitlab_rails['gitlab_shell_ssh_port'] = 22
把邮箱替换为实际维护邮箱。external_url 应是对外访问地址,不是服务器内网 IP;SSH 端口配置只影响 GitLab 展示的仓库地址,不会修改 OpenSSH 的监听端口。
应用配置:
sudo gitlab-ctl reconfigure
sudo gitlab-ctl status
重新配置可能使相关组件重新加载或重启,已有用户环境应放在维护窗口执行。如果失败,保留终端错误信息,先定位失败项,不要连续重复触发证书申请。
HTTP-01 证书验证需要公网能够访问 TCP 80。启用 HTTPS 重定向后,GitLab 的证书挑战路径仍由相应配置处理。若上线后关闭 80,后续续期可能失败,因此应持续保留该入口,或改用经过验证的其他证书管理方式。
从客户端验证 HTTPS
以下检查应从服务器外部的客户端执行:
curl -I http://git.example.com
curl -I https://git.example.com/users/sign_in
HTTP 请求应返回重定向,Location 指向 HTTPS。HTTPS 登录页通常返回成功响应或正常跳转,不应出现证书校验错误。
进一步检查证书链与域名:
openssl s_client \
-connect git.example.com:443 \
-servername git.example.com \
-verify_hostname git.example.com \
-verify_return_error </dev/null
正常情况下,输出中可见:
Verify return code: 0 (ok)
这是示例结果,不是本次实际执行记录。若提示证书过期、域名不匹配或无法验证签发者,应修复证书或证书链,而不是使用 curl -k 绕过验证作为验收结果。
随后在浏览器打开 https://git.example.com,确认地址栏无证书警告,页面中的链接也使用 HTTPS。
使用已有证书时的替代配置
如果已经持有适用于该域名的证书,可以不用内置 Let's Encrypt。以下文件路径仅为示例,执行前必须确认来源文件存在,且证书与私钥匹配。
sudo install -d -m 700 /etc/gitlab/ssl
sudo install -m 644 /secure/fullchain.pem \
/etc/gitlab/ssl/git.example.com.crt
sudo install -m 600 /secure/privkey.pem \
/etc/gitlab/ssl/git.example.com.key
证书文件应包含服务器证书及必要的中间证书链。修改配置为:
external_url 'https://git.example.com'
letsencrypt['enable'] = false
nginx['redirect_http_to_https'] = true
nginx['ssl_certificate'] = '/etc/gitlab/ssl/git.example.com.crt'
nginx['ssl_certificate_key'] = '/etc/gitlab/ssl/git.example.com.key'
然后执行 sudo gitlab-ctl reconfigure,重新进行客户端证书验证。更换已有证书前,要备份原证书、私钥和配置;失败时恢复这些文件再重新配置。
两种证书管理方式选择一种即可。自行提供证书时,续期、替换文件以及服务加载新证书均由运维人员负责,不能再依赖 GitLab 内置续期流程。
四、建立账号并打通仓库 SSH 访问
完成首次登录与访问控制
新安装的初始管理员密码通常保存在:
sudo cat /etc/gitlab/initial_root_password
该文件包含敏感信息,不要贴到工单、截图或文章示例中。使用 root 登录后立即修改密码,并启用适当的多因素认证策略。初始密码文件是临时文件,不应作为长期密码保存方式。
面向内部团队使用时,在管理员设置中检查注册限制,按需要关闭公开注册。日常开发使用普通账号,不要让所有人共享管理员账号。
在开发者电脑上生成密钥
以下命令在开发者本地电脑执行,适用于 Linux、macOS 或提供 OpenSSH 的终端环境,不是在 GitLab 服务器上替所有用户生成密钥。
先确认目标文件不存在;如已存在,选择其他文件名,避免覆盖原私钥:
ssh-keygen -t ed25519 \
-C "developer@example.com" \
-f ~/.ssh/id_ed25519_gitlab
建议为私钥设置口令。然后读取公钥:
cat ~/.ssh/id_ed25519_gitlab.pub
登录 GitLab,在个人设置的 SSH Keys 页面添加完整公钥。个人开发使用的密钥应具有认证用途,并设置符合团队要求的有效期。
私钥文件 id_ed25519_gitlab 不应上传到 GitLab,也不应发送给服务器维护人员。
如果本地存在多把密钥,在 ~/.ssh/config 中新增或调整对应主机段,不要覆盖其他已有配置:
Host git.example.com
HostName git.example.com
User git
Port 22
IdentityFile ~/.ssh/id_ed25519_gitlab
IdentitiesOnly yes
在上述本地环境下设置文件权限:
chmod 700 ~/.ssh
chmod 600 ~/.ssh/config ~/.ssh/id_ed25519_gitlab
chmod 644 ~/.ssh/id_ed25519_gitlab.pub
这些权限调整只作用于当前用户的 SSH 目录和所列文件,不要扩展到整个家目录。
校验主机指纹与身份映射
首次连接前,由管理员通过服务器控制台或已经可信的管理会话读取 SSH 主机公钥指纹:
sudo ssh-keygen -lf /etc/ssh/ssh_host_ed25519_key.pub
开发者执行:
ssh -T git@git.example.com
如果客户端提示的是 ED25519 主机密钥,应与管理员提供的指纹核对后再接受。若提示其他类型,则核对对应的服务器主机公钥,不要忽略类型差异。

认证成功的典型提示为:
Welcome to GitLab, @developer!
GitLab 不向仓库用户提供普通交互式 Shell,因此不能要求它进入命令行才算成功;部分版本下也不能只用命令退出码判断,应结合欢迎信息与仓库操作确认。
仓库连接使用 git 这个系统入口账号,GitLab 根据公钥识别实际用户。不要为每位开发者创建同名 Linux 用户,也不要手工改写 GitLab 管理的仓库 SSH 授权文件。
用私有测试项目验证读取和写入
在 GitLab 中创建一个空的私有项目,例如 ops/deploy-check,给测试账号分配允许推送的角色。以下操作仅用于新建测试项目,避免在已有生产仓库中执行分支改名或测试提交。
在开发者电脑执行:
WORKDIR=$(mktemp -d)
cd "$WORKDIR"
git clone git@git.example.com:ops/deploy-check.git
cd deploy-check
git config user.name "Deployment Check"
git config user.email "developer@example.com"
printf 'GitLab HTTPS and SSH deployment check\n' > deployment-check.txt
git add deployment-check.txt
git commit -m "Verify SSH repository access"
git branch -M main
git push -u origin main
git ls-remote origin
克隆空仓库时出现空仓库警告属于正常现象。推送后,网页应能看到 main 分支、提交及文件;git ls-remote 应返回对应引用。
如果默认分支受保护,按团队权限规则授予测试账号写入权限,或改用允许推送的测试分支,不要为验收而全局关闭分支保护。
HTTPS 仓库访问与 SSH 不共用认证机制。使用 Git over HTTPS 时,应按实例策略使用访问令牌或其他受支持方式,不要把令牌直接写入克隆 URL,以免进入 Shell 历史和 Git 配置。
五、按访问链路处理常见异常
域名无法访问、连接超时
先从客户端检查 DNS,再检查机房访问控制、服务器防火墙,最后检查服务监听:
dig +short A git.example.com
dig +short AAAA git.example.com
sudo ufw status verbose
sudo ss -ltnp | grep -E ':(22|80|443)\b'
sudo gitlab-ctl status
- DNS 返回旧地址:修改解析并等待相关缓存更新。
- DNS 正确、服务器有监听但客户端超时:重点检查机房规则、来源限制和网络路径。
- 返回
Connection refused:通常表示目标可达,但该端口没有服务接收,或被主动拒绝。 - 443 没有监听:先查 Nginx 与重新配置结果,而不是修改 GitLab 用户权限。
安装前服务器尚未监听 80,此时单次连接失败不能单独证明防火墙有问题,需要结合控制台规则判断。
证书申请失败或浏览器提示证书异常
优先核对域名所有权、A/AAAA 记录、80 端口,以及域名前是否存在额外转发层,然后查看:
sudo gitlab-ctl tail nginx
sudo gitlab-ctl tail
tail 会持续输出日志,按 Ctrl+C 退出。日志可能包含用户名、地址和内部路径,对外提供前应脱敏。
如果证书申请受到频率限制,应修复原因并等待允许重试,而不是不断更换域名或重复安装。使用已有证书时,检查证书域名、有效期和完整链,不能仅确认 .crt 文件存在。
SSH 出现 Permission denied (publickey)
先在客户端观察实际使用的用户名与密钥:
ssh -vT git@git.example.com
依次检查:
- 是否使用
git,而不是 GitLab 页面登录名。 - 公钥是否添加到正确账号,是否过期或缺少认证用途。
- 客户端是否提交了指定私钥。
- 该私钥对应的公钥是否与网页保存的一致。
- 服务器 SSH 服务及 GitLab Shell 是否正常。
必要时查看服务器日志:
sudo journalctl -u ssh -n 100 --no-pager
sudo gitlab-ctl tail gitlab-shell
不要为解决公钥错误而开启 git 用户的密码登录,也不要给仓库目录执行宽泛的权限放开。
若已经出现欢迎信息,但克隆提示项目不存在或无权访问,说明 SSH 身份认证基本完成,应转查项目路径和成员权限;若能读取但不能推送,则检查角色、受保护分支和推送规则。

网页返回 502 或服务启动失败
先检查资源与组件状态:
free -h
df -h
sudo gitlab-ctl status
sudo gitlab-ctl tail puma
sudo gitlab-ctl tail sidekiq
502 通常需要继续检查应用进程、内存、磁盘或启动过程,并不直接说明 TLS 配置错误。低风险检查完成后,再依据日志处理具体组件,避免一次性重启全部服务掩盖原因。
六、上线验收与回滚检查项
上线验收清单
交付前至少完成以下检查,并记录实际软件版本、检查时间和结果:
- DNS 的 A/AAAA 记录均符合部署设计,没有旧地址残留。
- HTTPS 证书受客户端信任,域名匹配,证书链完整。
- HTTP 跳转到 HTTPS,页面与克隆地址使用正确域名。
- 证书续期责任明确;使用内置续期时,公网验证入口持续可用。
- 管理员密码已更换,注册限制与多因素认证策略已检查。
- 普通账号通过 SSH 认证,并能按授权读取、推送测试仓库。
- 无项目权限的账号不能读取私有仓库。
- 新开管理 SSH 会话正常,机房与系统防火墙规则均已记录。
- 磁盘、内存和关键组件状态正常,后续有容量与证书到期监控。
保存配置与业务备份
在服务正常时执行:
sudo gitlab-backup create
sudo gitlab-ctl backup-etc
前者用于生成 GitLab 数据备份,后者用于保存 /etc/gitlab 配置。执行前应确认备份目录所在磁盘有足够空间,并检查命令是否成功、生成的文件是否存在。
/etc/gitlab/gitlab-secrets.json 必须纳入受保护的配置备份,否则恢复后可能无法解密部分数据。备份包含代码、配置或密钥等敏感内容,应限制访问并保存到独立位置。外部对象存储等附加数据需要另行核对备份范围,不能只凭一个备份文件认定完整可恢复。
同时记录:
dpkg-query -W gitlab-ce
业务备份恢复要求使用匹配的 GitLab 版本与版本类型,不应直接安装任意新版本后尝试恢复。服务正常时应安排恢复演练,而不只是确认文件已经生成。
按变更范围回滚
仅修改 HTTPS 或 SSH 展示配置时,可以恢复本文保存的配置备份:
sudo cp -a /root/gitlab-deploy-backup/gitlab.rb.before-https \
/etc/gitlab/gitlab.rb
sudo gitlab-ctl reconfigure
sudo gitlab-ctl status
该操作会覆盖当前 gitlab.rb,只适用于确认备份正确、且没有其他必须保留的配置变更时。若同时替换过证书文件,也要恢复原证书和私钥;恢复后重新检查网页、证书及仓库访问。
若只改错了 SSH 展示端口,应恢复 gitlab_shell_ssh_port,不用修改数据库。若实际调整过 OpenSSH 监听端口,则需同步恢复 SSH 服务、防火墙和机房规则,并通过新连接验证。
新服务器上线失败且尚无业务数据时,可以按变更记录恢复安装前快照,但必须明确快照之后产生的数据会丢失。已有仓库、用户或提交的实例,不能通过卸载软件包、删除目录来“回滚”;涉及数据库迁移的版本回退,应按匹配版本的备份恢复流程处理。
最终回滚检查应同时覆盖 HTTPS 网页、SSH 仓库读写、管理登录、证书续期和备份可恢复性。这些项目分别通过验证,才说明 GitLab 的访问入口与恢复路径均已建立。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3480.html



