在美国服务器上部署GitLab,怎样配置HTTPS入口并验证团队可以访问?

发布人:A5数据发布时间:2026-10-25 14:59阅读量:180

在美国服务器上首次部署 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 位系统
服务器公网 IPv4203.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 必须替换为能够接收证书异常通知的真实邮箱:

三、配置 HTTPS 入口配图

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、缓存或内网路由误认为公网访问成功。

建议按照以下顺序验证:

四、逐项验证 HTTPS 和团队访问配图

  1. 在成员电脑上执行 nslookup gitlab.example.com 或 dig +short A gitlab.example.com,确认解析到正确的公网 IP。
  2. 用浏览器打开 https://gitlab.example.com,确认浏览器地址栏没有证书警告,且访问过程中不会回到 HTTP。
  3. 使用两个普通成员账号分别登录,确认账号状态正常。
  4. 建立一个测试项目,给一名成员 Maintainer 或 Developer 权限,给另一名成员 Reporter 或 Guest 权限,分别确认其可见范围符合预期。
  5. 使用 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

相关推荐