Linux GitLab如何添加用户

在 Linux 服务器上部署的 GitLab 中，添加用户主要有 两种方式：
✅ 管理员后台添加（最常用）
✅ 用户自行注册（需开启注册功能）

下面按 最常见场景详细说明。

一、管理员后台添加用户（推荐）

适用于：你拥有 GitLab 管理员权限

1️⃣ 登录 GitLab

浏览器访问你的 GitLab 地址，例如：

https://gitlab.example.com

使用 管理员账号（root 或 admin） 登录。

2️⃣ 进入用户管理页面

点击右上角 头像 → Admin（管理员）

然后左侧菜单选择：

Overview → Users

3️⃣ 创建新用户

点击右上角按钮：

New user

填写用户信息：

字段	说明
Name	用户显示名
Username	登录用户名（唯一）
Email	邮箱（用于通知 & 密码重置）
Password	可选（可后续让用户自己设置）

✅ 建议勾选：

✅ Send password reset link（发送密码重置链接）

4️⃣ 设置用户权限（重要）

在用户详情页中，可设置：

Access Level
- Regular user（普通用户）
- Admin（管理员，谨慎授予）
Projects limit
Can create group

5️⃣ 保存

点击 Create user

✅ 用户会收到邮件，设置密码后即可登录。

二、允许用户自行注册（可选）

1️⃣ 开启注册功能

进入：

Admin → Settings → General

展开：

Sign-up restrictions

✅ 勾选：

Enable sign-up

保存设置。

2️⃣ 用户注册

访问：

https://gitlab.example.com/users/sign_up

填写邮箱、用户名、密码即可。

三、通过命令行添加用户（不推荐）

GitLab 不推荐直接操作数据库，但如果你必须：

sudo gitlab-rails console

示例（仅供了解，不建议生产使用）：

user = User.new(
  name: 'testuser',
  username: 'testuser',
  email: 'test@example.com',
  password: 'password123',
  password_confirmation: 'password123'
)
user.save!

⚠️ 风险：可能破坏 GitLab 数据一致性。

四、添加用户到项目 / 群组

1️⃣ 添加用户到项目

进入项目：

Project → Members

点击 Invite member

输入用户名 / 邮箱
选择角色：
- Guest
- Reporter
- Developer
- Maintainer
- Owner

2️⃣ 添加用户到群组（推荐）

Group → Members

✅ 群组下的所有项目自动继承权限。

五、常见权限说明

角色	权限
Guest	只读
Reporter	查看 + 下载
Developer	提交代码
Maintainer	管理项目
Owner	完全控制

六、常见问题

❓ 用户收不到邮件？

检查：

sudo gitlab-rake gitlab:env:info

确认 SMTP 已配置：

Admin → Settings → Email

❓ 忘记管理员密码？

sudo gitlab-rake "gitlab:password:reset[root]"

七、总结（最常用流程）

✅ 管理员添加用户

Admin → Users → New user → 发送重置密码邮件

✅ 加入项目

Project / Group → Members → 添加用户

如果你愿意，可以告诉我：

✅ GitLab 版本（gitlab-rake gitlab:env:info）
✅ 是否是 CE / EE
✅ 是否使用 LDAP / SSO

我可以给你更精确的配置方案。