宝塔面板一键安装gitlab虽便捷但踩坑率高，推荐docker部署以规避内存不足、环境冲突和升级难题；需严格配置端口/卷/环境变量三类映射，并确保external_url协议与访问方式一致。
直接用宝塔面板的「软件商店」一键安装 GitLab 是最省事的路径，但实际踩坑率极高——尤其是内存不足 4GB 的机器，安装中途大概率卡死或启动失败；而用 Docker 部署虽然多几步操作，却能精准控制资源、规避 Ruby 环境冲突、支持数据持久化，更适合长期稳定运行。
为什么不能直接点「安装」按钮？
宝塔软件商店里的 GitLab 插件本质是封装了 Omnibus 安装包的 Shell 脚本，它会强行拉起内置 PostgreSQL、Redis、Nginx 和 GitLab-Rails 全栈服务。问题在于：
- 它默认不检查
swap是否启用，内存低于 4GB 时容器常因 OOM 被系统 kill - 无法自定义
external_url，导致 HTTPS 反向代理后出现 502 或静态资源加载失败 - 升级困难：面板内无平滑升级入口，手动执行
gitlab-ctl reconfigure容易破坏面板管理状态 - 日志和配置分散在
/var/opt/gitlab、/etc/gitlab等路径，宝塔文件管理器无法直观定位
用 Docker 管理器部署 GitLab 的关键配置项
必须手动设置三类映射 + 一组环境变量，缺一不可：
-
端口映射：至少开放
80（HTTP）、443（HTTPS）、22（SSH）。若服务器已有 Nginx 占用 80/443，可改映射为8999→80、8443→443，后续再配反向代理 -
卷映射：必须挂载三个目录：
/var/opt/gitlab（代码仓库与数据库）、/var/log/gitlab（日志）、/etc/gitlab（配置），目标路径建议统一放在/www/wwwroot/gitlab-*下，方便宝塔备份 -
环境变量：唯一必须填的是
GITLAB_OMNIBUS_CONFIG，值为单行字符串，例如：external_url "https://git.example.com"; gitlab_rails["time_zone"] = "Asia/Shanghai"; gitlab_rails["initial_root_password"] = "MyPass123!";
域名访问失败的常见原因和验证步骤
容器创建后能 ping 通但网页打不开，大概率是以下某个环节断了：
- 域名未真正解析到服务器 IP：用
dig git.example.com +short或nslookup git.example.com确认返回值是否为你的服务器公网 IP - 宝塔防火墙没放行对应端口：进入【安全】→【防火墙】，确认
8999或443已添加；云服务器还需检查厂商安全组（如阿里云 ECS 的「安全组规则」） -
external_url协议与实际不符：如果用 HTTP 访问却写了https://，GitLab 会强制跳转并报错；反之亦然 - 容器日志报
gitlab-workhorse启动失败：进入【Docker 管理器】→【容器列表】→点击容器名→【日志】，搜索关键词failed to start或address already in use
后续维护必须注意的两个硬约束
Docker 部署的 GitLab 不像传统安装那样“一劳永逸”，有两件事你得定期盯紧：
-
/www/wwwroot/gitlab-data目录会随仓库增长持续膨胀，建议每月用du -sh /www/wwwroot/gitlab-data检查，超过磁盘 70% 就得清理旧项目或扩容 - 镜像更新不能只拉新版本：必须先停旧容器、删旧镜像、再拉
gitlab/gitlab-ce:16.11.0这类具体 tag（别用latest），否则配置可能被覆盖；升级前务必备份整个/www/wwwroot/gitlab-*目录
