debian gitlab如何调权限

在 Debian 上部署的 GitLab（无论是 Omnibus 包还是源码安装），“调权限”通常涉及 用户/组权限、项目权限、仓库权限、系统文件权限 等几个层面。下面按常见场景给你说明。

一、GitLab 用户与系统权限（Linux 层）

1. GitLab 运行用户

GitLab 默认使用 git 用户运行：

ps aux | grep gitlab

不要手动改 /var/opt/gitlab 或 /home/git 的属主，否则会导致 GitLab 无法启动。

2. 修复 GitLab 文件权限（常用）

如果权限异常：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart

更彻底修复权限：

sudo gitlab-rake gitlab:check

二、GitLab Web 中的用户/组/项目权限（最常见）

1. 用户角色（Project 级别）

在项目 → Members 中添加用户，角色包括：

示例（Web）：

Project → Members → Invite member → Role: Developer

2. 组（Group）权限

在 Group → Members 中设置，子项目可继承组权限。

三、Git 仓库推送/分支权限

1. 保护分支（Protected Branches）

Project → Settings → Repository → Protected branches

可设置：

• 谁可以 push
• 谁可以 merge

例如只允许 Maintainer 合并 main 分支。

2. 禁止 Developer 直接 push

在 Protected Branch 中：

• Allowed to push: Maintainers
• Allowed to merge: Maintainers

四、SSH / 仓库访问权限

1. 用户 SSH Key

User → Preferences → SSH Keys

用户无 Key 不能 clone/push（除非用 Personal Access Token）。

2. 使用 Deploy Key（服务器拉代码）

Project → Settings → Repository → Deploy keys

五、API / 自动化权限（Token）

1. Personal Access Token

User → Preferences → Access Tokens

权限范围：

• read_api
• read_repository
• write_repository

2. Project Access Token（推荐）

Project → Settings → Access Tokens

六、管理员权限（Admin）

1. 设某用户为 Admin

Admin → Users → 编辑用户 → Admin 勾选

⚠️ Admin 可控制整个 GitLab，谨慎授予。

七、常见排错

1. permission denied (publickey)

• 用户没加 SSH Key
• 用的是错误用户

2. 无法 push

• 分支被保护
• 用户角色不够

3. GitLab 无法启动

sudo gitlab-ctl status
sudo gitlab-rake gitlab:check

八、你具体想调哪类权限？

你可以告诉我：

• GitLab 版本（gitlab-rake gitlab:env:info）
• Omnibus 还是 Docker
• 是 用户权限 / 分支权限 / 系统权限 / CI 权限

我可以直接给你对应命令或配置示例。