Skip to content

system proxy usage

heyongxian edited this page Oct 15, 2025 · 1 revision

系统代理设置工具使用说明

📖 简介

system_proxy.py 是一个跨平台的系统代理配置工具,支持 Windows、macOS 和 Linux 三大操作系统。该工具可以帮助你快速设置、查看和取消系统级别的代理设置。

🌟 主要特性

  • ✅ 跨平台支持: Windows、macOS、Linux
  • ✅ 默认配置: 默认使用本地 10808 端口
  • ✅ 智能检测: 自动检测当前系统代理状态
  • ✅ 友好界面: 提供交互式命令行界面
  • ✅ 安全可靠: 支持代理的启用和禁用

🚀 快速开始

运行脚本

python system_proxy.py

基本操作流程

  1. 启动脚本: 运行后会自动检测当前操作系统和代理状态
  2. 查看状态: 显示当前系统代理设置情况
  3. 选择操作: 根据提示选择要执行的操作
  4. 完成设置: 按照向导完成代理配置

🔧 详细功能说明

1. 代理状态检测

脚本启动时会自动检测:

  • 当前操作系统类型
  • 系统代理是否已启用
  • 当前代理服务器地址和端口

2. 设置系统代理

当系统未设置代理时,可以选择"设置代理":

📝 代理地址格式说明:
  • 格式: IP:端口 (例如: 127.0.0.1:10808)
  • 默认使用本地10808端口

请输入代理地址 (默认: 127.0.0.1:10808):
  • 直接按回车使用默认地址 127.0.0.1:10808
  • 或输入自定义代理地址,如 192.168.1.100:8080

3. 取消系统代理

当系统已设置代理时,可以选择"取消当前代理设置"来禁用代理。

4. 重新设置代理

当系统已有代理设置时,可以选择"重新设置代理"来更改代理服务器。

🖥️ 各平台实现方式

Windows 系统

  • 实现方式: 通过修改注册表设置系统代理
  • 权限要求: 建议以管理员身份运行
  • 生效范围: 影响系统级别的 HTTP/HTTPS 代理设置
# Windows 建议以管理员身份运行
# 右键点击命令提示符 -> "以管理员身份运行"
python system_proxy.py

macOS 系统

  • 实现方式: 使用 networksetup 命令设置网络代理
  • 权限要求: 可能需要输入管理员密码
  • 生效范围: 应用到所有网络服务的 HTTP/HTTPS 代理

Linux 系统

  • 实现方式: 通过环境变量设置代理
  • 配置文件: 自动写入 .bashrc、.zshrc、.profile
  • 生效方式: 需要重新启动终端或执行 source ~/.bashrc
# Linux 设置代理后需要重新加载配置
source ~/.bashrc
# 或重新启动终端

📋 使用示例

示例 1: 首次设置代理

🔧 系统代理设置工具
============================================================
当前操作系统: Darwin

📋 当前系统代理设置 (Darwin):
--------------------------------------------------
❌ 未设置代理
--------------------------------------------------

🎯 请选择操作:
1. 设置代理
2. 退出

请输入选择 (1-2): 1

📝 代理地址格式说明:
  • 格式: IP:端口 (例如: 127.0.0.1:10808)
  • 默认使用本地10808端口

请输入代理地址 (默认: 127.0.0.1:10808): 

正在设置系统代理为: 127.0.0.1:10808
✅ 系统代理设置成功!

示例 2: 取消现有代理

📋 当前系统代理设置 (Windows):
--------------------------------------------------
✅ 代理已启用: 127.0.0.1:10808
--------------------------------------------------

🎯 请选择操作:
1. 取消当前代理设置
2. 重新设置代理
3. 退出

请输入选择 (1-3): 1

正在取消系统代理设置...
✅ 系统代理已取消!

⚠️ 注意事项

Windows 用户

  1. 管理员权限: 建议以管理员身份运行脚本
  2. 防火墙设置: 确保代理软件已添加到防火墙例外
  3. 重启浏览器: 设置后可能需要重启浏览器使代理生效

macOS 用户

  1. 系统权限: 可能需要输入管理员密码
  2. 网络服务: 代理设置会应用到所有网络服务
  3. 应用重启: 某些应用可能需要重启才能使用新的代理设置

Linux 用户

  1. 环境变量: 代理通过环境变量实现,仅影响支持代理的应用
  2. 配置持久化: 设置会写入 shell 配置文件
  3. 终端重启: 设置后需要重新启动终端或重新加载配置文件

🔍 故障排除

常见问题

Q: Windows 下设置失败怎么办? A: 确保以管理员身份运行脚本,并检查是否有安全软件阻止注册表修改。

Q: macOS 下提示权限不足? A: 输入管理员密码,或使用 sudo python system_proxy.py 运行。

Q: Linux 下设置后代理不生效? A: 执行 source ~/.bashrc 重新加载配置,或重新启动终端。

Q: 如何验证代理是否生效? A: 可以使用以下命令测试:

# 测试 HTTP 代理
curl -I http://www.google.com

# 查看当前 IP(通过代理)
curl ipinfo.io

手动验证

Windows

打开"设置" -> "网络和 Internet" -> "代理",查看代理设置是否正确。

macOS

打开"系统偏好设置" -> "网络" -> 选择网络服务 -> "高级" -> "代理"。

Linux

检查环境变量:

echo $http_proxy
echo $https_proxy

🔗 相关工具

📝 更新日志

  • v1.0.0: 初始版本,支持 Windows、macOS、Linux 三平台
  • 支持系统代理的设置、查看、取消功能
  • 提供友好的交互式界面
  • 默认使用本地 10808 端口