GitHub仓库基础配置与权限设置包括：一、创建远程仓库并关联本地；二、设置默认分支及保护规则；三、管理协作者与团队权限；四、配置Secrets密钥管理；五、启用2FA与访问日志审计。
如果您正在初始化一个 GitHub 仓库，但尚未完成基本配置与访问控制设定，则可能面临代码无法推送、协作者无权访问或敏感信息暴露等风险。以下是完成 GitHub 仓库基础配置与权限设置的具体步骤：
一、创建并初始化远程仓库
此步骤用于在 GitHub 平台上生成一个空的远程仓库，并建立本地与远程的关联关系，为后续提交和协作奠定基础。
1、登录 GitHub 官网，点击右上角“+”号，选择“New repository”。
2、输入仓库名称，选择公开（Public）或私有（Private）可见性，可选是否添加 README 文件、.gitignore 模板及许可证。
3、点击“Create repository”按钮完成创建。
4、在本地项目根目录执行 git init 初始化本地 Git 仓库。
5、执行 git remote add origin https://github.com/用户名/仓库名.git 关联远程地址。
二、配置默认分支与保护规则
设置默认分支可统一团队开发入口，启用分支保护规则能防止直接推送至主干分支，保障代码质量与历史完整性。
1、进入仓库主页，点击 “Settings” → “Branches” 标签页。
2、在 “Default branch” 区域点击铅笔图标，将默认分支更改为 main 或其他指定分支名。
3、在 “Branch protection rules” 下方点击 “Add rule”，输入分支匹配模式（如 main）。
4、勾选 “Require pull request reviews before merging” 和 “Include administrators” 等关键选项。
5、点击 “Create” 保存规则。
三、管理协作者与团队权限
通过明确分配不同角色权限，可控制用户对仓库的读写执行能力，避免越权操作或误删行为。
1、进入仓库 “Settings” → “Collaborators and teams” 页面。
2、点击 “Add people”，输入协作者 GitHub 用户名，选择权限级别：Read（只读）、Triage（问题与拉取请求管理）、Write（推送代码）、Maintain（管理设置与协作者）、Admin（完全控制）。
3、点击 “Add collaborator” 发送邀请，对方需接受后生效。
4、若使用组织账户，可在 “Teams” 标签下将已有团队添加至该仓库，并为其分配对应权限。
四、配置仓库级访问令牌与密钥管理
避免将敏感凭证硬编码于代码中，利用 GitHub Secrets 可安全存储 API 密钥、密码等机密信息，供 Actions 自动化流程调用。
1、进入仓库 “Settings” → “Secrets and variables” → “Actions”。
2、点击 “New repository secret”，输入名称（如 API_KEY）与对应值。
3、确认值已加密存储且不可被日志输出，仅在 workflow 中通过 ${{ secrets.API_KEY }} 引用。
4、定期审核现有 secrets 列表，删除已废弃或泄露的条目。
五、启用两步验证与访问日志审计
强化账户安全边界，确保所有仓库操作行为可追溯，降低未授权访问导致的数据泄露风险。
1、个人账户需在 “Settings” → “Security” 中启用 Two-factor authentication (2FA)。
2、组织管理员应前往 “Organization settings” → “Audit log”，筛选事件类型如 repo.add_member、repo.remove_admin、secret.create。
3、设置邮件或 webhook 告警，当检测到异常地理位置登录或批量删除操作时即时响应。
4、限制组织内成员的 SSO 访问策略，绑定企业身份提供商并强制会话超时。
