本文档总结了如何配置本地代理(魔法)、WSL 环境、Cursor 编辑器以及 SSH 远程反向隧道,确保在各种环境下都能顺利使用 AI 和访问外网。
一、 基础概念
1. 正向代理 vs 反向隧道
- 正向代理 (Proxy): 也就是平常说的"魔法"。你的电脑通过代理服务器去访问谷歌。
- SSH 隧道 (Tunnel): 通过 SSH 连接建立的加密通道。
- SSH 反向隧道 (Reverse Forwarding): 让远程服务器(如学校内网服务器)"借用" 你本地电脑的网络去访问外网。
- 场景:服务器没网,但你需要用 pip 安装包,或者服务器在内网无法连接 GitHub。
二、 Windows 本地准备工作 (宿主机)
在开始任何配置前,必须确保你的 Windows 本地代理软件设置正确。
- 开启"允许局域网连接" (Allow LAN):
- 在代理软件设置中找到
Allow LAN并开启。 - 端口号 (Port): 记住你的 HTTP 端口(通常是
7890,10809等)。
- 在代理软件设置中找到
- 防火墙设置 (至关重要):
- 去 Windows 安全中心 -> "允许应用通过防火墙"。
- 找到你的代理软件,确保 "专用 (Private)" 和 "公用 (Public)" 两个框都勾选。
三、 WSL (Linux 子系统) 连接宿主机代理
WSL 是一个隔离的虚拟机,它不能直接用 127.0.0.1 连接 Windows 的代理,需要用宿主机 IP。
1. 获取宿主机 IP
在 WSL 终端中,尝试以下两种地址:
- 方案 A (推荐):
host.docker.internal(WSL2 新版支持)。 - 方案 B (通用): 运行
ip route show | grep default | awk '{print $3}'获取的 IP(通常是172.xx.xx.1)。
2. 测试连通性
在 WSL 终端运行:
# 将 172.xx.xx.1 换成你查到的 IP
curl -I -x http://172.xx.xx.1:7890 https://www.google.com
如果返回 HTTP 200,说明该 IP 可用。
四、 Cursor 配置指南
1. 解决 "Region Not Supported" / AI 无法连接
即使开了全局代理,Cursor 有时也需要手动指定代理地址。
-
快捷键:
Ctrl+,打开设置。 -
搜索:
proxy。 -
配置项 (User / Remote 标签):
-
Http: Proxy: 填入你在"第三步"测通的地址。
-
如果在 Windows 直接用:
http://127.0.0.1:7890 -
如果在 WSL 里用:
http://172.xx.xx.1:7890(填那个测通的 IP)
-
-
Http: Proxy Strict SSL: 取消勾选 (关掉证书验证,防止报错)。
-
-
搜索:
http2。- Http: Http2 Support: 设为 Disabled (禁用 HTTP2 可大幅提高稳定性)。
2. 避免内存溢出 (OOM)
-
原则: 永远不要 直接打开
/(根目录) 或/home/username(用户主目录)。 -
操作: 只打开具体的项目子文件夹(如
/home/user/my_project)。 -
补救: 如果项目文件夹太大,新建
.cursorignore文件,写入anaconda3/或大数据库文件夹名以忽略索引。
五、 让远程服务器借用本地网络 (SSH 反向隧道)
让没网的服务器通过你的电脑上网(pip/wget/curl)。
1. 修改本地 SSH 配置 (一次性配置)
修改本地电脑的 ~/.ssh/config (或 Windows 的 C:\Users\用户名\.ssh\config):
Host my-server
HostName 192.168.xx.xx # 服务器 IP
User root # 用户名
# 反向隧道配置:
# 将服务器的 37890 端口(高位端口避免权限冲突) 映射到 本地的 7890
RemoteForward 37890 127.0.0.1:7890
注意:修改后必须彻底重启 SSH 连接(关闭 Cursor 窗口重连)。
2. 在服务器端启用代理
连接到服务器终端后,输入:
# 告诉服务器去 localhost:37890 找网络
export http_proxy="http://127.0.0.1:37890"
export https_proxy="http://127.0.0.1:37890"
3. 验证服务器网络
# 1. 测连通性 (应返回 HTTP 200)
curl -I https://www.google.com
# 2. 测 IP 归属 (应显示你代理节点的国家,如日本/美国)
curl https://ipinfo.io
# 3. 测分流 (应显示中国/本地 IP,说明国内流量没走代理)
curl https://cip.cc
六、 常用命令速查表
| 场景 | 命令 / 操作 |
|---|---|
| WSL 查宿主机 IP | `ip route show |
| 测试代理连通 | curl -I -x http://IP:端口 https://www.google.com |
| 查看服务器用谁的网 | curl https://ipinfo.io |
| 查看端口占用 | `netstat -tlnp |
| 查看内存占用 | htop 或 free -h |