Help us learn about your current experience with the documentation. Take the survey.

用户账户

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

每个 GitLab 账户都有一个用户资料，其中包含关于您和您的 GitLab 活动的信息。

您的资料还包括设置，您可以使用这些设置来自定义您的 GitLab 体验。

访问您的用户资料

要访问您的资料：

  1. 在左侧边栏中，选择您的头像。
  2. 选择您的姓名或用户名。

您也可以通过 ID 而不是用户名访问用户的资料页面，格式为 https://gitlab.example.com/-/u/<id>。 例如，如果您的用户名是 gitlab-user 且 ID 为 12345，您可以通过 https://gitlab.example.com/gitlab-user 或 https://gitlab.example.com/-/u/12345 访问资料页面。

查找用户 ID

如果您想通过 GitLab API 与用户交互，您可能需要用户 ID。

要查找用户 ID：

  1. 转到用户的资料页面。
  2. 在资料页面右上角，选择 操作（ ellipsis_v ）。
  3. 选择 复制用户 ID。

访问您的用户设置

要访问您的用户设置：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。

生成或更改您的支持 PIN

GitLab 支持可能会要求提供个人识别号码（PIN）来验证您的身份。 PIN 在创建后七天后过期。

要生成新的支持 PIN：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在左侧边栏中，选择 账户。
  4. 选择 生成新 PIN。

访问您的支持 PIN

如果您之前创建了支持 PIN， 该 PIN 可以在您的资料中访问，并在创建后七天后过期。

要访问您的支持 PIN：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在左侧边栏中，选择 账户。

更改您的用户名

您的用户名有一个唯一的 命名空间， 更改用户名时会更新该命名空间。在更改用户名之前，请阅读 重定向如何工作。 如果您不想更新命名空间，可以创建新用户或组并将项目转移给它。

先决条件：

  • 您的命名空间不得：
  • 您的用户名：
    • 长度必须在 2 到 255 个字符之间。
    • 只能包含非重音字母、数字、_、- 和 .。
    • 不得：
      • 以 _、- 或 . 开头。
      • 包含表情符号。
      • 以 . 或 .<保留的文件扩展名> 结尾，例如 jon.png、jon.git 或 jon.atom。但是， jonpng 是有效的。

要更改您的用户名：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在左侧边栏中，选择 账户。
  4. 在 更改用户名 部分，输入新用户名作为路径。
  5. 选择 更新用户名。

向您的用户资料添加电子邮件

要向您的账户添加新电子邮件地址：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在左侧边栏中，选择 电子邮件。
  4. 选择 添加新电子邮件。
  5. 在 电子邮件 文本框中，输入新电子邮件。
  6. 选择 添加电子邮件地址。
  7. 使用收到的验证电子邮件验证您的电子邮件地址。

新电子邮件地址将添加为次要电子邮件地址。 您可以使用次要电子邮件地址重置密码，但不能用于身份验证。 您可以更新您的主要电子邮件地址。

将您的电子邮件设为非公开 并不能阻止它用于提交匹配、 项目导入 和组迁移。

从您的用户资料删除电子邮件地址

您可以从账户中删除次要电子邮件地址。您不能删除您的 主要电子邮件地址。

如果删除的电子邮件地址用于任何用户电子邮件，这些用户电子邮件将 发送到主要电子邮件地址。

未验证的次要电子邮件地址将在三天后自动删除。

由于问题 438600，组通知仍会发送到 已删除的电子邮件地址。

要从账户中删除电子邮件地址：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在左侧边栏中，选择 电子邮件。
  4. 选择 删除（ remove ）并确认您要移除。

您也可以使用 API 删除次要电子邮件地址。

将您的用户资料设为私有

您可以让您的用户资料仅对您和 GitLab 管理员可见。

GitLab 管理员可以禁用此设置，强制所有资料设为公开。

要将您的资料设为私有：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 选择 私有资料 复选框。
  4. 选择 更新资料设置。

以下内容将从您的用户资料页面（https://gitlab.example.com/username）中隐藏：

  • Atom 源
  • 账户创建日期
  • 活动、组、贡献项目、个人项目、星标项目、代码片段的标签页

将您的用户资料设为私有并不会隐藏您的所有公共资源， 使其无法通过 REST 或 GraphQL API 访问。例如，与您的提交签名关联的电子邮件地址是可访问的， 除非您使用自动生成的私有提交电子邮件。

用户可见性

用户的公共页面，位于 /username，无论您是否登录都始终可见。

当访问用户的公共页面时，您只能看到您有权限的项目。

如果公共级别受限， 用户资料仅对已认证用户可见。

通过 README 为您的资料添加详细信息

您可以使用 README 文件为您的资料页面添加更多信息。当您用信息填充 README 文件时，它将包含在您的资料页面中。

从新项目

要创建新项目并将其 README 添加到您的资料中：

  1. 在左侧边栏顶部，选择 新建（ plus ）和 新项目/仓库。
  2. 选择 创建空白项目。
  3. 输入项目详细信息：
    • 在 项目名称 字段中，输入您的新项目名称。
    • 在 项目 URL 字段中，选择您的 GitLab 用户名。
    • 在 项目标识符 字段中，输入您的 GitLab 用户名。 所有这些字段都区分大小写。如果您的用户名包含大写字母，请将大写字母包含在内输入到项目标识符字段。
  4. 对于 可见性级别，选择 公开。 托管产品上个人的正确项目路径
  5. 对于 项目配置，确保 使用 README 初始化仓库 已选中。
  6. 选择 创建项目。
  7. 在此项目中创建 README 文件。该文件可以是任何有效的README 或索引文件。
  8. 用 Markdown 或其他支持的标记语言填充 README 文件。

GitLab 在您的贡献图表下方显示您 README 的内容。

从现有项目

要将现有项目的 README 添加到您的资料中， 更新项目路径以匹配您的用户名。

向您的用户资料页面添加外部账户

您可以添加指向您可能拥有的其他外部账户的链接，如 Discord 和 X（前身为 Twitter）。 它们可以帮助其他用户在其他平台上与您联系。

要添加指向其他账户的链接：

  1. 在左侧边栏中，选择您的头像。

  2. 选择 编辑资料。

  3. 在 主要设置 部分，添加您的：

    您的用户 ID 或用户名必须为 500 个字符或更少。

  4. 选择 更新资料设置。

在您的用户资料页面上显示私有贡献

在用户贡献日历图和最近活动列表中，您可以看到您对私有项目的贡献操作。

要显示私有贡献：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 主要设置 部分，选择 在我的资料中包含私有贡献 复选框。
  4. 选择 更新资料设置。

添加您的性别代词

您可以将您的性别代词添加到您的 GitLab 账户中，以便在您的资料中显示在 您的姓名旁边。

要指定您的代词：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 代词 文本框中，输入您的代词。文本必须为 50 个字符或更少。
  4. 选择 更新资料设置。

添加您的姓名发音

您可以将您的姓名发音添加到您的 GitLab 账户中。这显示在您的资料中，位于 您的姓名下方。

要添加您的姓名发音：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 发音 文本框中，输入您的姓名发音方式。发音必须是纯文本，且为 255 个字符或更少。
  4. 选择 更新资料设置。

设置您的状态

设置您的状态以让他人了解您的可用性。当其他人将鼠标悬停到您的头像、姓名或用户名上时，他们可以看到您的状态。即使您已将您的用户资料设为私有，您的状态也是公开可见的。

您的状态包含以下元素。您可以单独使用每个元素来指示您的状态。

  • 一个表情符号来指示您的状态。
  • 一条描述您可用性的消息。您可以包含表情符号代码，如 :palm_tree: 或 :bulb:。最多 100 个字符。
  • 一个复选框，为您的状态添加一个"忙碌"徽章。

要设置您当前的状态：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 设置状态。如果您之前设置了状态，请选择 编辑状态。
  3. 可选。输入状态消息。
  4. 可选。选择 将自己设为忙碌 复选框。
  5. 可选。从 在以下时间清除状态 下拉列表中选择一个值。
  6. 选择 设置状态。

您的状态已更新。您也可以从用户设置页面或使用用户 API设置您的状态。

设置您的时区

您可以设置您的本地时区以：

  • 在您的资料中显示您的本地时间，以及在将鼠标悬停在您的姓名上显示您信息的地方。
  • 使您的贡献日历与您的本地时间对齐，以更好地反映您的贡献时间

要设置您的时区：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 时间设置 部分，从下拉列表中选择您的时区。

更改您提交中显示的电子邮件

提交电子邮件是在通过 GitLab 界面执行的每个 Git 相关操作中显示的电子邮件地址。

您自己的任何已验证电子邮件地址都可以用作提交电子邮件。 默认使用您的主要电子邮件。

要更改您的提交电子邮件：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 提交电子邮件 下拉列表中，选择一个电子邮件地址。
  4. 选择 更新资料设置。

更改您的主要电子邮件

您的主要电子邮件是您的登录、提交电子邮件和通知电子邮件的默认电子邮件地址。

要更改您的主要电子邮件：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 电子邮件 字段中，输入您的新电子邮件地址。
  4. 选择 更新资料设置。
  5. 可选。如果您之前未将此电子邮件添加到您的 GitLab.com 账户，请选择确认电子邮件。

设置您的公开电子邮件

您可以选择您的一个配置的电子邮件地址在您的公开资料上显示：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 公开电子邮件 字段中，选择一个可用的电子邮件地址。
  4. 选择 更新资料设置。

使用自动生成的私有提交电子邮件

GitLab 提供一个自动生成的私有提交电子邮件地址， 以便您可以保持您的电子邮件信息私密。

要使用私有提交电子邮件：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 在 提交电子邮件 下拉列表中，选择 使用私有电子邮件。
  4. 选择 更新资料设置。

每个 Git 相关操作都使用私有提交电子邮件。

要完全匿名，您还可以复制私有提交电子邮件 并使用以下命令在您的本地机器上配置它：

git config --global user.email <您的电子邮件地址>

关注用户

您可以从以下位置关注或取消关注用户：

  • 他们的用户资料。
  • 当您将鼠标悬停在用户姓名上时出现的小弹出框（在 GitLab 15.0 中引入）。

在GitLab 15.5 及更高版本中， 您可以关注的最大用户数为 300。

在GitLab 16.10 及更高版本中， 被屏蔽的用户不会出现在用户资料的关注者列表中。

禁止被其他用户关注和关注其他用户

您可以禁止被其他用户关注和关注其他用户。

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 选择 偏好设置。
  4. 清除 启用关注用户 复选框。
  5. 选择 保存更改。

当此功能被禁用时，所有当前的关注/被关注连接将被删除。

查看用户的活动

GitLab 跟踪用户贡献活动。 要查看用户的活动：

  1. 转到用户的资料。
  2. 在 GitLab 菜单中，选择 活动。

将显示最近活动贡献列表。

查看您的活动

要查看您的活动：

  1. 在左侧边栏中，选择 搜索或转到。

  2. 选择 您的工作。

  3. 选择 活动。

  4. 可选。要通过贡献类型过滤您的活动，在 您的活动 标签页中，选择一个标签页：

    • 全部：您在组和项目中做的所有贡献。
    • 推送事件：您在项目中做的推送事件。
    • 合并事件：您在项目中接受的合并请求。
    • 问题事件：您在项目中打开和关闭的问题。
    • 评论：您在项目中发表的评论。
    • Wiki：您在项目中创建和更新的 Wiki 页面。
    • 设计：您在项目中添加、更新和移除的设计。
    • 团队：您加入和离开的项目。

登录服务

除了使用常规的用户名和密码登录 GitLab 外，您也可以使用登录服务。

连接登录服务

要连接用于登录 GitLab 的登录服务：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 选择 账户。
  4. 找到 服务登录 部分。
  5. 在 已连接账户 部分，选择与您要登录的服务对应的按钮。
  6. 按照所选服务的说明开始使用它登录。

断开登录服务

要断开用于登录 GitLab 的登录服务：

  1. 在左侧边栏中，选择您的头像。
  2. 选择 编辑资料。
  3. 选择 账户。
  4. 找到 服务登录 部分。
  5. 在 已连接账户 部分，选择您不再想要登录的服务旁边的断开连接。

会话持续时间

保持登录一周

默认情况下，在七天（10080 分钟）不活动或您关闭浏览器窗口后（以先到者为准），您将被登出 GitLab。

GitLab 管理员可以 更改此默认设置。

保持无限期登录

要无限期保持登录状态，请在 GitLab 登录页面选择记住我复选框。

您保持登录状态是因为，尽管服务器设置了一周的会话时间，但您的浏览器存储了一个安全令牌， 该令牌可以启用自动重新认证。

GitLab 管理员可以为需要出于安全或合规目的定期使会话过期的环境 关闭记住我设置。

当您登录时，会设置三个 Cookie：

  • 一个名为 _gitlab_session 的会话 Cookie。 此 Cookie 没有设置过期日期。但是，它根据其 session_expire_delay 过期。
  • 一个名为 gitlab_user 的会话 Cookie。 此 Cookie 被营销网站使用，以确定用户是否有活动的 GitLab 会话。没有用户信息传递给该 Cookie，它从登录起两周后过期。
  • 一个名为 remember_user_token 的持久 Cookie，仅在您在登录页面选择记住我时设置。

当您关闭浏览器时，_gitlab_session 和 gitlab_user Cookie 通常会在客户端清除。 当它过期或不可用时，GitLab：

  • 使用 remember_user_token Cookie 获取新的 _gitlab_session Cookie 并让您保持登录状态，即使您关闭浏览器。
  • 将 gitlab_user 设置为 true。

当 remember_user_token 和 _gitlab_session Cookie 都消失或过期时，您必须重新登录。

当任何会话被登出，或者会话从活动会话列表中被撤销时， 所有记住我令牌都会被撤销。虽然其他会话保持活动状态，但记住我功能不会 在浏览器关闭或现有会话过期时恢复会话。

相关主题