全栈开发网络配置指南:Cursor、WSL 与 远程服务器

本文档总结了如何配置本地代理(魔法)、WSL 环境、Cursor 编辑器以及 SSH 远程反向隧道,确保在各种环境下都能顺利使用 AI 和访问外网。


一、 基础概念

1. 正向代理 vs 反向隧道

  • 正向代理 (Proxy): 也就是平常说的"魔法"。你的电脑通过代理服务器去访问谷歌。
  • SSH 隧道 (Tunnel): 通过 SSH 连接建立的加密通道。
  • SSH 反向隧道 (Reverse Forwarding): 让远程服务器(如学校内网服务器)"借用" 你本地电脑的网络去访问外网。
    • 场景:服务器没网,但你需要用 pip 安装包,或者服务器在内网无法连接 GitHub。

二、 Windows 本地准备工作 (宿主机)

在开始任何配置前,必须确保你的 Windows 本地代理软件设置正确。

  1. 开启"允许局域网连接" (Allow LAN):
    • 在代理软件设置中找到 Allow LAN 并开启。
    • 端口号 (Port): 记住你的 HTTP 端口(通常是 789010809 等)。
  2. 防火墙设置 (至关重要):
    • 去 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
查看内存占用 htopfree -h
相关推荐
weixin_430750931 小时前
OpenMediaVault debian Linux安装配置企业私有网盘(三) 静态ip地址配置
linux·服务器·debian·nas·网络存储系统
上海云盾安全满满2 小时前
选择高防IP时需要重点关注哪些因素
网络·网络协议·tcp/ip
智在碧得2 小时前
碧服打造DataOps全链路闭环,定义大数据工程化发布新标杆
大数据·网络·数据库
孟无岐2 小时前
【Laya】Byte 二进制数据处理
网络·typescript·游戏引擎·游戏程序·laya
负二代0.03 小时前
Linux下的网络管理
linux·网络
大房身镇、王师傅3 小时前
【VirtualBox】VirtualBox 7.1.6 RockyLinux10 配置增强功能 设置共享目录
运维·服务器·virtualbox·rockylinux10
betazhou3 小时前
rsync使用案例分析
linux·运维·服务器·rsync·同步数据
欧洵.4 小时前
深入理解TCP/IP协议栈:数据链路层核心知识点解析
网络
SmartBrain4 小时前
Agent 知识总结
服务器·数据库·笔记
QQ__17646198244 小时前
为Windows系统安装Codex(保姆级教程)
服务器·大模型·codex