git 多用户管理 跨平台

一、概述

​ 相信大家都遇到过这样的问题，实际开发中需要在一台PC上用到 不同平台git的账号甚至同一个平台的多个账号（比如本人gitee 、字自己在nas上搭建的gitea ，另外还有github账号，有时还会有公司的代码仓库，账号就更多了）。

​ 于是就有了这次的笔记，多用户管理，即在同一台设备上，使用 git管理来自 Gitee 和 Gitea、 Github 的不同仓库，各自使用不同的身份（SSH 密钥或账号），互不冲突。

二、方案

简单整理一下要求：

1. 一键操作切换用户配置，不希望额外单步配置 用户名 邮件 密码 等一系列繁琐操作
2. 配置管理简单，不能有用户配置冲突
3. 扩展复用性需要较强，适合随时添加用户
4. 跨平台使用，Linux / Termux（android） / Git Bash(windows)

那么目前可以想到的最优方案就是为每个用户创建不同的空目录并单独局部配置，项目结构如下：

/project_git/
├── gitee/
│   ├── user_a
│   │   ├── env.sh
│   │   ├── .gitconfig
│   │   ├── .ssh/
│   │   │   ├── config
│   │   │   ├── id_rsa
│   │   │   ├── id_rsa.pub
│   │   └── project/
│   ├── user_b
│   │   ├── ...
│   ├── ...
├── gitea/
│   ├── user_a
│   │   ├── env.sh
│   │   ├── .gitconfig
│   │   ├── .ssh/
│   │   │   ├── config
│   │   │   ├── id_rsa
│   │   │   ├── id_rsa.pub
│   │   └── project/
│   ├── user_b
│   │   ├── ...
│   ├── ...
├── ...

三、具体步骤

1、创建目录并生成密钥

# 创建目录结构
mkdir -p /project_git/gitee/.ssh
mkdir -p /project_git/gitee/project

# 为Gitee创建SSH密钥，建议gitee@example.com替换为实际邮箱（即使错误也不影响，仅用于管理区分）
# 注意检查 .ssh/id_rsa 权限需要为 600
ssh-keygen -t rsa -b 4096 -f /project_git/gitee/.ssh/id_rsa -C "gitee@example.com"

2、配置 Git 身份信息

• 为每一个用户环境新建/gitee/.gitconfig文件

  [user]
      name = user_name
      email = gitee@example.com
  

• 注意：

  • gitee_user 改成实际用户名。
  • gitee@example.com 改成实际邮件名。

3、配置 SSH 文件

• /project_git/gitee/.ssh/config

  Host gitee
          HostName gitee.example.com
          Port 23
          User git
          IdentityFile /project-git/gitee/.ssh/id_rsa
          IdentitiesOnly yes
  

• 注意：

  • gitee 自定义
  • gitee.example.com 改为实际服务器地址或 IP。
  • 23 改为实际服务器端口（如果是服务器域名则不需要）。
  • IdentityFile 需要绝对地址（使用realpath ../.ssh/id_rsa获取绝对地址）

4、写入环境启动脚本

1. 为每一个用户环境新建env.sh文件

   #!/bin/bash
   
   ENV_DIR="$(dirname "$(realpath "$0")")"
   export GIT_CONFIG_GLOBAL="$ENV_DIR/.gitconfig"
   export GIT_SSH_COMMAND="ssh -F $ENV_DIR/.ssh/config"
   
   echo "✅ 已启用 GIT 环境"
   echo "👤 用户名: $(git config --global user.name)"
   echo "📧 邮箱: $(git config --global user.email)"
   echo "📁 工作目录: $ENV_DIR/project"
   
   cd "$ENV_DIR/project" || exit
   bash
   

2. 赋权

   chmod +x env.sh
   

5、使用方法

# 配置环境
./env.sh

# 测试验证环境配置，正确返回结果包含 “Hi there, user_name! You've successfully ...”
ssh -F ../.ssh/config -T gitee

# gitee环境拉取或推送代码
git clone gitee:user_name/project.git

需要先将生成的密钥添加到对应的服务器（具体的步骤可以参考 gitee 使用笔记 —基础篇），

然后执行./env.sh后自动进入project文件夹，进入后就是处于当前账号绑定的 shell 环境下了，所有 Git 操作都使用它的身份和 SSH 密钥。

6、补充说明

四、极简超强方式

下载链接：(多用户管理一键执行应用git-env.bin)[https://download.csdn.net/download/Primary_rookie/91161710]

当前制作了适用于Linux / Termux（android）的一键执行应用git-env.bin,操作如下：

work@work:~/user_project/project-gitee$ ls
git-env.bin
work@work:~/user_project/project-gitee$ sudo chmod +x git-env.bin 
[sudo] work 的密码： 
work@work:~/user_project/project-gitee$ ./git-env.bin 
▶ Git 用户姓名 (user.name): aaa
▶ Git 用户邮箱 (user.email): aaa@aaaa.com
▶ SSH 主机别名(如 gitee/gitea/github): 
   👉 gitee
▶ 服务器域名或 IP (HostName): gitee.com
▶ SSH 端口[回车默认22]: 
📁 已创建目录: /home/work/user_project/project-gitee/{.ssh,project}
✅ 生成 .gitconfig
✅ 生成 SSH 密钥: .ssh/id_rsa(.pub)
✅ 生成 .ssh/config
✅ 生成 env.sh

🎉 全部完成！接下来 3 步即可开始使用：
1) 打开远程平台（如 Gitee）> 个人设置 > SSH 公钥 > 添加：
----------------------------------------------------------------
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCfMVj/w6kVMDh2ox6Ee2NtgtQkXTarllo2Rx/pb4/8NZY5gR/jmeXcOBH9ByEbFwXAzZZp8NpomZvu4QhC6ogFN4jsPdxXvJbVigIJB0U+yocRE8St+FkHYkY1NIkqDyQhu+7oGyG7IkV469Q7wW7Z64DDCD7ZIkB2Qc2qKvK/212XX1HWAjtNGTUMxTfbLHf4fnYABSOY/MBC+/3qdvo/2xo8CYhsuuH1YvVL3UD0nAT1nywR1fAdUHaIK8G3kps7+hbAvBVrLdRr51scdj0RWTqKDkGt6MDgj/U2h3V1cW8gSeRuMzSyjiu5ojXG120iY0LJS4iUrAhlr/WhWVMYiHb71/xF7bFjOcbFWsIPE3PGwuDQNJZKbCVmT/0wFpdDw5dG9f3QkVzYktgupHRMmkM46QKX8wTTzbkqbOcPE5oEXs08OSU+kvOMfnye3uWKSMW4phPII2ebqMi3uXiGQyjNnds+QL4CSug+8gFGwoL1oqzQZkDJarcQsC+fRLbWdM9nqq2bYZ+YOBkx3IeowA4kg6HJLe8Qc31Og4JV4GfLqghJQwcV5h2juUuWsIDjoYGFNogIPb9vPGk1yFEKJpqlLmmyOpD+/3haTDv5XdiCzwhN4K0I6OT8ix58fs96ZL/K995DYQRuF+ERfqG/uLQMAETKrx7Q/h4IphHHvw== aaa@aaaa.com
----------------------------------------------------------------
2) 在本机运行:  ./env.sh
   将自动进入 project/ 并载入 Git 身份。
3) 在 project/ 里执行 git clone gitee:<user>/<repo>.git   即可。
work@work:~/user_project/project-gitee$ ls -a
.  ..  env.sh  .gitconfig  git-env.bin  project  .ssh
work@work:~/user_project/project-gitee$ ./env.sh 
✅ 启动 GIT 环境：Gitea
👤 用户名: aaa
📧 邮箱: aaa@aaaa.com
📁 工作目录: /home/work/user_project/project-gitee/project
🔧 当前操作: git pull
📝 自动提交模式: false

🔍 正在扫描 Git 仓库...

📋 执行摘要:
✅ 成功仓库: 0
❌ 失败仓库: 0
⏭️ 跳过非 Git 目录: 1
  - */

🚀 操作完成，进入交互环境
work@work:~/user_project/project-gitee/project$