在美国服务器上部署GitLab,怎样配置HTTPS入口并验证团队可以访问?
在美国服务器上首次部署 GitLab,比较直接的做法是使用 Ubuntu LTS 与 GitLab Omnibus 软件包,并启用其自带的 Nginx 作为 HTTPS 入口。域名的 A 记录指向服务器公网 IPv4,GitLab 监听 80、443 端口,Let's Encrypt 负责签发证书,团队成员通过域名访问登录页和项目。

本文以 Ubuntu 22.04/24.04 LTS、GitLab CE、域名 gitlab.example.com 为例。美国服务器所在地区不会改变 GitLab 的 HTTPS 配置方式,但必须确保域名解析、云平台安全组、服务器本机防火墙和系统时间均正常。示例中的域名、IP 和邮箱需要替换成实际值。
一、准备条件
1. 确认服务器和域名
建议先准备以下条件:
| 项目 | 示例值 | 核对要求 |
|---|---|---|
| 操作系统 | Ubuntu 22.04/24.04 LTS | 使用 64 位系统 |
| 服务器公网 IPv4 | 203.0.113.20 | 能从互联网访问 |
| GitLab 域名 | gitlab.example.com | 使用完整域名,不建议直接用 IP |
| HTTPS 端口 | TCP 443 | 对团队成员开放 |
| HTTP 端口 | TCP 80 | 用于首次证书签发和后续续期 |
| SSH 管理端口 | TCP 22 | 只对管理员来源地址开放更安全 |
| 资源参考 | 4 vCPU、8 GB 内存、50 GB SSD 起步 | 实际容量取决于仓库、制品和流水线数据 |
4 vCPU、8 GB 内存属于小型团队的实践起点,不是固定配置。仓库数量、CI Runner、容器镜像和制品文件增长后,磁盘与内存需要单独评估。
在服务器上核对系统、内存、磁盘和监听端口:
. /etc/os-release
printf 'OS: %s\n' "$PRETTY_NAME"
printf 'Kernel: '
uname -r
printf 'CPU: '
nproc
free -h
df -h /
sudo ss -lntp
如果服务器上已经有 Nginx、Apache 或其他服务占用 80/443 端口,不要直接停止它们。本文使用 GitLab Omnibus 自带的 Nginx,80/443 必须由这一套入口服务负责,或者需要另行设计外部反向代理,不能让多个服务同时绑定同一端口。
2. 配置 DNS
在域名服务商处创建 A 记录:
gitlab.example.com. A 203.0.113.20
如果服务器启用了 IPv6,还要检查 AAAA 记录。AAAA 记录如果指向错误地址,部分用户会优先通过 IPv6 连接,导致浏览器表现为偶发打不开。
从服务器或管理员电脑检查解析:
dig +short A gitlab.example.com
dig +short AAAA gitlab.example.com
预期至少能看到服务器公网 IPv4:
203.0.113.20
如果返回的 A 记录不是当前服务器地址,应先修正 DNS。若存在不正确的 AAAA 记录,应删除或改为可正常提供 80/443 服务的 IPv6 地址。
3. 放行云防火墙和服务器防火墙
先在云平台安全组或网络 ACL 中放行:
- TCP 80:来源
0.0.0.0/0,用于 ACME HTTP 验证和 HTTP 跳转。 - TCP 443:来源
0.0.0.0/0,用于团队访问 GitLab。 - TCP 22:仅允许管理员办公出口 IP 或堡垒机 IP。
如果使用 UFW,修改前应确认当前 SSH 来源地址,并保留云平台控制台或串口作为救援入口。防火墙规则会影响服务器所有入站服务,错误启用默认拒绝策略可能导致当前 SSH 会话无法重新连接。
先备份 UFW 配置:
sudo cp -a /etc/ufw "/root/ufw-before-gitlab.$(date +%Y%m%d%H%M%S)"
以下命令中的 198.51.100.10 需要替换为管理员实际公网 IP:
sudo ufw allow from 198.51.100.10/32 to any port 22 proto tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw default allow outgoing
sudo ufw default deny incoming
sudo ufw --force enable
sudo ufw status verbose
预期能看到 SSH、HTTP、HTTPS 规则。执行前必须先添加 SSH 放行规则,不要在远程会话中直接启用“拒绝所有入站”而没有管理端口例外。
如果规则配置错误,可以从云平台控制台进入服务器后执行 sudo ufw disable 临时恢复访问,再根据备份或规则编号修正。不要把 SSH 端口长期开放给所有来源,除非有额外的登录防护和访问控制。
4. 检查系统时间
证书验证依赖正确的系统时间:
timedatectl status
timedatectl show -p NTPSynchronized --value
NTPSynchronized=yes 表示时间同步正常。如果时间未同步,应先修复系统时间服务,否则可能出现证书尚未生效、证书已经过期或 ACME 验证失败。
二、安装 GitLab
1. 安装基础依赖
更新软件索引并安装 GitLab 常用依赖:
sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates tzdata perl
确认 SSH 服务正在运行:
sudo systemctl enable --now ssh
sudo systemctl is-active ssh
预期输出为:
active
本文不安装单独的 Postfix。GitLab 的首次登录、项目访问和 HTTPS 验证不依赖邮件服务;如果后续需要发送邀请、密码重置或通知邮件,再单独配置 SMTP。
2. 添加 GitLab 软件源
下载 GitLab CE 软件源安装脚本。正式执行前可以先查看脚本内容:
curl -fsSL 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
安装 GitLab CE。这里先用 HTTP 作为初始化入口,随后立即切换到 HTTPS:
sudo EXTERNAL_URL="http://gitlab.example.com" apt-get install -y gitlab-ce
安装过程会运行首次配置,时间取决于服务器磁盘和网络速度。完成后检查主要服务:
sudo gitlab-ctl status
正常情况下,Nginx、Puma、Sidekiq、PostgreSQL、Redis 等组件会显示 run。如果安装过程报错,不要立刻反复执行安装命令,应先保留终端错误信息并检查磁盘、内存、软件源和端口占用。
3. 读取初始管理员密码
安装完成后,GitLab 通常会将临时 root 密码写入本地文件:
sudo sed -n '/Password:/p' /etc/gitlab/initial_root_password
该密码只用于第一次登录,不要复制到工单、聊天记录或脚本中。若文件已经不存在,可能是安装时间超过了临时保留期限,此时需要按照 GitLab 管理员密码恢复流程处理。
在 HTTPS 配置完成后,再用该密码登录 root 账户并立即修改密码。
三、配置 HTTPS 入口
1. 备份 GitLab 配置
修改 /etc/gitlab/gitlab.rb 前先备份配置文件。这个备份用于回滚配置,不代替 GitLab 数据库、仓库和制品备份。
sudo cp -a /etc/gitlab/gitlab.rb \
"/etc/gitlab/gitlab.rb.before-https.$(date +%Y%m%d%H%M%S)"
如果服务器上已经存在重要 GitLab 数据,还应额外制定仓库、数据库、附件和配置密钥的备份方案。首次部署尚未投入使用时,至少不要删除 /var/opt/gitlab 和 /etc/gitlab 目录。
2. 写入域名和证书配置
编辑配置文件:
sudoedit /etc/gitlab/gitlab.rb
确认或修改以下配置。admin@example.com 必须替换为能够接收证书异常通知的真实邮箱:

external_url 'https://gitlab.example.com'
nginx['redirect_http_to_https'] = true
letsencrypt['enable'] = true
letsencrypt['contact_emails'] = ['admin@example.com']
这几个配置的作用分别是:
external_url:声明 GitLab 对外使用的正式访问地址。nginx['redirect_http_to_https']:让普通 HTTP 请求跳转到 HTTPS。letsencrypt['enable']:启用 Omnibus 内置的证书申请和管理逻辑。letsencrypt['contact_emails']:为证书相关通知提供联系邮箱。
不要把 external_url 写成服务器 IP。Let's Encrypt 证书通常签发给域名,用户通过 IP 访问会出现域名不匹配,即使 443 端口本身可用,也不能视为 HTTPS 配置成功。
3. 应用配置并申请证书
保存文件后执行:
sudo gitlab-ctl reconfigure
这一步会重新生成 GitLab 和 Nginx 配置,并尝试通过 80 端口完成证书验证。域名必须已经解析到当前服务器,云防火墙和 UFW 也必须允许外部访问 TCP 80。
配置完成后检查服务和端口:
sudo gitlab-ctl status
sudo ss -lntp | grep -E ':(80|443)\b'
预期可以看到 80 和 443 由 GitLab 管理的 Nginx 监听,GitLab 相关服务保持 run 状态。
如果 reconfigure 输出中出现证书申请失败,不要连续多次重试。先确认 DNS、80 端口和 IPv6 状态,再重新执行。频繁申请证书可能触发证书颁发机构的频率限制。
四、逐项验证 HTTPS 和团队访问
1. 验证 HTTP 是否跳转
从服务器或一台外部电脑执行:
curl -sS -D - -o /dev/null http://gitlab.example.com/
正常结果通常包含类似响应头:
HTTP/1.1 301 Moved Permanently
Location: https://gitlab.example.com/
具体状态码也可能是 302,但 Location 应指向 https://gitlab.example.com/。如果仍然返回 GitLab 页面而不是跳转,检查 external_url 和 nginx['redirect_http_to_https'] 是否生效,并重新执行 gitlab-ctl reconfigure。
2. 验证 HTTPS 响应
curl -sS -o /dev/null \
-w 'HTTP %{http_code}\n' \
https://gitlab.example.com/users/sign_in
常见正常结果是:
HTTP 200
如果 GitLab 将请求重定向到其他登录地址,返回 302 也可能是正常的,关键是不能出现证书校验错误、连接超时或 502。
进一步检查证书主题、签发者和有效期:
openssl s_client \
-connect gitlab.example.com:443 \
-servername gitlab.example.com </dev/null 2>/dev/null |
openssl x509 -noout -subject -issuer -dates
检查项包括:
subject或 SAN 中包含gitlab.example.com。notBefore已经生效。notAfter尚未过期。issuer为受信任的证书颁发机构,而不是临时自签名证书。
如果只用浏览器访问 IP,出现证书警告属于预期结果。团队成员应统一使用 https://gitlab.example.com,不要将 IP 当作正式访问入口。
3. 验证 GitLab 自身健康状态
执行 GitLab 内部检查:
sudo gitlab-rake gitlab:check SANITIZE=true
该命令会检查数据库连接、Redis、仓库访问和部分应用配置。输出中若存在失败项,应先处理失败项,再进行团队验收。
同时检查磁盘空间:
df -h /
sudo du -sh /var/opt/gitlab 2>/dev/null
GitLab 仓库、上传文件、CI 制品和日志都可能持续增长。HTTPS 访问成功不代表磁盘容量已经满足长期运行要求。
GitLab 持续承载代码仓库、项目文件与团队协作任务,服务器的计算、存储和网络资源会影响部署所依托的基础环境。A5数据提供美国物理服务器方案,涵盖 Xeon、AMD EPYC 等平台及不同存储和网络配置,可为面向美国用户的代码托管、业务后台和数据库等场景提供资源选择;部分 AMD 方案配备大内存与 NVMe 存储,适合承载多类服务和数据读写负载。
4. 用团队成员账号进行访问验收
不要只在服务器本机打开页面。至少使用两台不同网络环境的办公电脑或移动网络进行验证,避免把本机 DNS、缓存或内网路由误认为公网访问成功。
建议按照以下顺序验证:

- 在成员电脑上执行
nslookup gitlab.example.com或dig +short A gitlab.example.com,确认解析到正确的公网 IP。 - 用浏览器打开
https://gitlab.example.com,确认浏览器地址栏没有证书警告,且访问过程中不会回到 HTTP。 - 使用两个普通成员账号分别登录,确认账号状态正常。
- 建立一个测试项目,给一名成员
Maintainer或Developer权限,给另一名成员Reporter或Guest权限,分别确认其可见范围符合预期。 - 使用 HTTPS 地址执行项目克隆。私有项目会要求输入账号凭据或个人访问令牌,不要把密码直接写入 URL。
示例:
git clone https://gitlab.example.com/team/https-entry-check.git
如果项目为空或为私有项目,Git 可能要求输入凭据,这是权限验证的一部分。重点检查克隆地址是否为 HTTPS、证书是否可信、具有项目权限的账号是否能够正常读取仓库。
团队访问验收至少应覆盖以下结果:
| 验收项 | 预期结果 |
|---|---|
| DNS 解析 | 成员网络解析到正确公网 IP |
| HTTP 访问 | 跳转到 HTTPS |
| HTTPS 证书 | 域名匹配且浏览器无警告 |
| 登录页 | 能打开 /users/sign_in |
| 普通成员登录 | 能登录且进入 GitLab 首页 |
| 项目权限 | 不同角色看到的项目和操作范围符合设置 |
| HTTPS 克隆 | 有权限的成员能够克隆测试项目 |
| 服务状态 | GitLab 主要组件均为运行状态 |
五、常见失败处理
DNS 正确但无法连接 80/443
先从外部电脑检查:
curl -v --connect-timeout 10 http://gitlab.example.com/
curl -v --connect-timeout 10 https://gitlab.example.com/
如果显示 Connection timed out,优先检查云平台安全组、网络 ACL、UFW 和服务器公网路由。如果显示 Connection refused,检查服务监听情况:

sudo ss -lntp | grep -E ':(80|443)\b'
sudo gitlab-ctl status
没有监听端口时,检查最近一次配置输出,不要直接重装 GitLab。
证书申请失败
重点检查以下条件:
- A 记录已经传播到当前服务器。
- AAAA 记录没有指向错误的 IPv6 地址。
- TCP 80 从公网可以访问。
- 80 端口没有被其他 Nginx 或 Apache 占用。
- 系统时间已经同步。
- 域名没有被错误的 CDN 或代理配置转发到其他服务器。
查看 GitLab Nginx 日志:
sudo gitlab-ctl tail nginx
如果该版本单独记录了 ACME 日志,可以查看相关目录:
sudo find /var/log/gitlab -maxdepth 2 -type f \
| grep -Ei 'letsencrypt|acme|nginx'
找到日志后再查看最近内容。不同 GitLab 版本的日志文件布局可能不同,以服务器实际输出为准。
HTTPS 返回 502
502 通常表示 Nginx 能够接收请求,但后端应用服务没有正常响应。先执行:
sudo gitlab-ctl status
sudo gitlab-rake gitlab:check SANITIZE=true
如果某个组件不是 run 状态,先查看资源情况:
free -h
df -h /
sudo gitlab-ctl tail
内存不足、磁盘写满或初始化尚未完成,都可能导致后端服务异常。确认原因后再执行针对性的服务重启,不要在原因不明时反复重启整台服务器。
团队成员能打开页面但不能登录或访问项目
这类问题通常不是 HTTPS 入口问题,应分别核对:
- 成员访问的是否为正确域名,而不是旧 IP 或旧域名。
- 账号是否被禁用、锁定或尚未完成初始化。
- 成员是否加入了正确的群组。
- 项目是否为私有项目。
- 成员角色是否有读取或推送权限。
- 浏览器是否保留了旧账号会话。
- 公司出口网络是否对域名或 443 端口有额外限制。
可以使用浏览器隐私窗口重新登录,并让另一名成员从不同网络访问,以区分账号问题和网络问题。
六、验收与回滚检查项
正式验收清单
部署完成后,建议保留以下记录:
- [ ] 服务器系统版本、GitLab 版本和公网 IP 已记录。
- [ ]
gitlab.example.com的 A/AAAA 记录已核对。 - [ ] 云防火墙放行 80/443,SSH 仅对管理来源开放。
- [ ]
sudo gitlab-ctl status中主要服务均为run。 - [ ] HTTP 请求会跳转到 HTTPS。
- [ ] HTTPS 证书的域名、签发者和有效期正确。
- [ ] 浏览器访问无证书警告。
- [ ] 两个不同网络环境能够打开登录页。
- [ ] 至少两个团队账号完成登录。
- [ ] 测试项目的角色权限符合预期。
- [ ] 至少一个成员能够通过 HTTPS 克隆测试项目。
- [ ]
/etc/gitlab/gitlab.rb和防火墙配置已经备份。 - [ ] 已明确仓库、数据库、附件和制品的后续备份方案。
HTTPS 配置回滚
如果 HTTPS 配置失败,优先恢复配置文件,不要删除 GitLab 数据目录。先列出之前生成的备份:
sudo ls -lt /etc/gitlab/gitlab.rb.before-https.*
确认备份文件后,使用实际文件名恢复:
sudo cp -a \
/etc/gitlab/gitlab.rb.before-https.YYYYMMDDHHMMSS \
/etc/gitlab/gitlab.rb
sudo gitlab-ctl reconfigure
sudo gitlab-ctl status
如果需要临时退回部署前的 HTTP 配置,可将配置恢复为原来的 HTTP 入口:
external_url 'http://gitlab.example.com'
nginx['redirect_http_to_https'] = false
letsencrypt['enable'] = false
然后执行:
sudo gitlab-ctl reconfigure
HTTP 回滚只适合故障隔离和临时恢复,不应作为团队长期访问方式,因为账号密码和项目数据可能通过明文连接传输。证书问题修复后,应重新启用 HTTPS,并再次完成外部网络、证书和团队权限验收。
如果是 UFW 规则导致 SSH 无法连接,应通过云平台控制台进入服务器,使用之前的 UFW 备份或执行 sudo ufw disable 临时恢复管理通道,再逐条修复规则。回滚过程中不要执行 rm -rf /var/opt/gitlab、删除 /etc/gitlab 或直接清空数据库;这些操作会扩大影响范围,且无法通过恢复 HTTPS 配置来挽回。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5713.html



