统一代理配置方案

一个简单高效的方案，让终端、VSCode 和 Cursor 都使用相同的代理配置，修改一处即可全局生效。

✨ 特性

• 🎯 统一管理：所有代理配置集中在一处
• 🔄 一键同步：自动同步到 VSCode 和 Cursor
• ⚡ 灵活配置：支持自定义代理地址和端口
• 🛠️ 易于使用：简单的命令行操作
• 📦 无依赖：纯 Shell 脚本实现

🚀 快速开始

1. 克隆仓库

git clone <your-repo-url>
cd sync_proxy

2. 安装配置

将以下内容添加到您的 ~/.zshrc 或 ~/.bashrc 文件末尾：

# ==================== 代理配置 ====================
# 第一步：设置代理主机和端口
PROXY_HOST="10.106.1.36"  # 修改为您的代理地址
PROXY_PORT="7897"         # 修改为您的代理端口

# 第二步：应用代理设置（以下行无需修改）
export http_proxy=http://${PROXY_HOST}:${PROXY_PORT}
export https_proxy=http://${PROXY_HOST}:${PROXY_PORT}
export all_proxy=socks5://${PROXY_HOST}:${PROXY_PORT}
# export no_proxy=localhost,127.0.0.1,localaddress,.localdomain.com,10.0.0.0/8

# 同步代理配置到 VSCode/Cursor
alias sync-proxy='~/sync_proxy/sync-proxy-config.sh'

3. 设置脚本权限

chmod +x ~/sync_proxy/sync-proxy-config.sh

4. 重新加载配置

source ~/.zshrc  # 或 source ~/.bashrc

5. 同步到编辑器

sync-proxy

📖 使用方法

修改代理配置

1. 编辑配置文件

   vim ~/.zshrc

2. 修改代理地址/端口

   PROXY_HOST="新的IP地址"
   PROXY_PORT="新的端口号"

3. 重新加载配置

   source ~/.zshrc

4. 同步到编辑器

   sync-proxy

5. 重新加载编辑器窗口

   • 在 VSCode/Cursor 中按 Cmd+Shift+P 或 Ctrl+Shift+P
   • 输入 Reload Window 并选择

临时禁用代理

# 禁用代理
unset http_proxy https_proxy all_proxy

# 重新启用
source ~/.zshrc

📁 文件说明

文件	说明
sync-proxy-config.sh	代理同步脚本
proxy-setup-guide.md	完整配置指南
proxy-quick-reference.md	快速参考文档
.zshrc	Zsh 配置示例文件

🎯 工作原理

┌─────────────────────────────────────┐
│         ~/.zshrc                    │
│   PROXY_HOST + PROXY_PORT           │
│         (唯一配置源)                 │
└─────────────┬───────────────────────┘
              │
     ┌────────┴────────┐
     ▼                 ▼
┌──────────┐   ┌──────────────┐
│  终端     │   │  sync-proxy   │
│  环境变量 │   │  (同步脚本)    │
└──────────┘   └────────┬──────┘
                        │
                   ┌────┴────┐
                   ▼         ▼
              ┌────────┐ ┌────────┐
              │ Cursor │ │ VSCode │
              └────────┘ └────────┘

🔧 支持的工具

• ✅ 终端命令（curl, wget, git 等）
• ✅ Python requests
• ✅ VSCode 插件
• ✅ Cursor 插件
• ✅ npm/yarn
• ✅ 其他支持 http_proxy 的工具

📚 文档

• 完整配置指南 - 详细的配置说明和故障排除
• 快速参考 - 常用命令速查

参考laprf：服务器使用本地代理_laprf.pdf

⚠️ 注意事项

1. 端口冲突：确保代理端口未被占用
2. 内网地址：如需访问内网服务，启用 no_proxy 配置
3. 编辑器重载：修改配置后需要重新加载编辑器窗口

🐛 故障排除

校园网认证失败（脚本卡死）

问题：运行校园网登录脚本时程序卡住，无法连接认证网关（如 10.0.0.55）

原因：系统代理拦截了对内网认证服务器的请求

快速解决：

export NO_PROXY="10.0.0.55,10.0.0.0/8,localhost,127.0.0.1"
export no_proxy="$NO_PROXY"

详见：校园网认证失败排查与解决

---

连接被拒绝

问题：Connection Refused 错误

解决：

• 检查代理服务器是否运行
• 验证 IP 地址和端口是否正确
• 启用 no_proxy 排除内网地址

sync-proxy 命令不存在

问题：command not found: sync-proxy

解决：

source ~/.zshrc
# 或直接运行
bash ~/sync_proxy/sync-proxy-config.sh

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🙏 致谢

感谢所有贡献者的支持！

---

系统要求

• Linux / macOS
• Bash / Zsh
• VSCode / Cursor (可选)

最后更新: 2025-03-03