GPM - Git & NPM Proxy Manager

一个简单的 Git 和 NPM 代理管理工具，支持代理切换、NPM 镜像切换和缓存管理。

🚀 功能特性

• ✅ Git 代理管理 - 快速设置和切换 Git HTTP/HTTPS 代理
• ✅ NPM 代理管理 - 管理 NPM 的代理设置
• ✅ NPM 镜像管理 - 快速切换常用的 NPM 镜像源
• ✅ 缓存管理 - 查看和清理配置文件
• ✅ 预设支持 - 内置常用镜像源配置

📦 安装

npm install -g @momei-x/gpm

🎯 使用方法

基础代理管理

# 配置代理（保存到缓存，不立即应用）
gpm config http://127.0.0.1:7890       # 默认为 Git 代理
gpm config --git 127.0.0.1:7890        # 明确指定为 Git 代理
gpm config --npm 127.0.0.1:7890        # 配置为 NPM 代理

# 应用缓存的代理配置
gpm use                                 # 应用到 Git（默认）
gpm use --git                          # 应用到 Git
gpm use --npm                          # 应用到 NPM
gpm use --all                          # 应用到 Git 和 NPM

# 移除代理配置
gpm unuse                              # 从 Git 移除（默认）
gpm unuse --git                        # 从 Git 移除
gpm unuse --npm                        # 从 NPM 移除
gpm unuse --all                        # 从 Git 和 NPM 移除

# 查看代理状态
gpm get                                # 查看 Git 代理状态（默认）
gpm get --git                          # 查看 Git 代理状态
gpm get --npm                          # 查看 NPM 代理状态
gpm get --all                          # 查看所有代理状态
gpm get --config                       # 查看缓存的代理配置

NPM 镜像管理

# 设置 NPM 镜像（使用预设名称）
gpm registry set taobao
gpm registry set npm
gpm registry set cnpm

# 设置自定义镜像
gpm registry set https://registry.npm.your-domain.com/

# 使用已保存的镜像设置
gpm registry use

# 查看当前 NPM 镜像
gpm registry get

# 列出所有可用的预设镜像
gpm registry list

缓存管理

# 查看缓存文件位置和内容
gpm cache info

# 清理所有缓存文件
gpm cache clear

📋 可用的 NPM 镜像预设

| 名称 | 地址 | 说明 | | ------- | -------------------------------------------- | ---------- | | npm | https://registry.npmjs.org/ | 官方镜像 | | taobao | https://registry.npmmirror.com/ | 淘宝镜像 | | cnpm | https://r.cnpmjs.org/ | CNPM 镜像 | | yarn | https://registry.yarnpkg.com/ | Yarn 镜像 | | tencent | https://mirrors.cloud.tencent.com/npm/ | 腾讯云镜像 | | huawei | https://repo.huaweicloud.com/repository/npm/ | 华为云镜像 | | aliyun | https://npm.aliyun.com/ | 阿里云镜像 |

💾 缓存文件位置

• 代理配置: ~/.gpm-proxy
• NPM 镜像配置: ~/.gpm-npm-registry

🔧 常用场景

场景 1: 设置完整的开发环境代理

# 1. 配置代理（保存到缓存）
gpm config 127.0.0.1:7890

# 2. 一键应用到所有服务
gpm use --all

# 3. 设置国内镜像加速
gpm registry set taobao

场景 2: 切换到公司网络

# 移除所有代理设置
gpm unuse --all

# 使用公司镜像
gpm registry set https://npm.company.com/

场景 3: 重置到默认状态

# 清理所有配置
gpm cache clear

# 恢复 NPM 官方镜像
gpm registry set npm

场景 4: 分别管理 Git 和 NPM 代理

# 只为 Git 设置代理
gpm config --git 127.0.0.1:7890
gpm use --git

# NPM 不使用代理，但使用国内镜像
gpm registry set taobao

🛠️ 开发

# 克隆项目
git clone https://github.com/your-username/gpm.git

# 安装依赖
pnpm install

# 开发模式
pnpm dev

# 构建
pnpm build

# 运行测试
pnpm test

📝 License

MIT