重置GitLab管理员密码指南

共计 781 个字符，预计需要花费 2 分钟才能阅读完成。

前言

在使用GitLab过程中，若遗忘管理员(root)账户密码，可通过服务端命令行快速重置。本教程适用于Docker部署的GitLab实例，其他部署方式操作类似。

操作步骤

1. 进入GitLab容器

# 查看运行中的容器ID
docker ps

# 进入容器内部（假设容器名为gitlab）
docker exec -it gitlab /bin/bash

2. 启动Rails控制台

gitlab-rails console -e production

等待加载完成后，控制台显示如下信息：

------------------------------------
 Ruby:         ruby 2.7.4p191 
 GitLab:       14.3.0 (ceec8accb09) FOSS
 GitLab Shell: 13.21.0
 PostgreSQL:   12.7
------------------------------------
Loading production environment (Rails 6.1.3.2)

3. 重置管理员密码

# 查找管理员账户（ID为1的默认管理员）
irb> user = User.where(id: 1).first
# 或通过邮箱查找
# irb> user = User.find_by(email: '[email protected]')

# 设置新密码（需满足复杂度要求）
irb> user.password = 'NewPassword123!'
irb> user.password_confirmation = 'NewPassword123!'

# 保存更改（返回true表示成功）
irb> user.save

4. 退出控制台

irb> exit

验证登录

1. 访问GitLab网页端
2. 使用root账户和新密码登录

3. 成功进入仪表盘即表示重置成功

   5. 参考

   https://cloud.tencent.com/developer/article/2028090