通过本地代理结合 SSH 反向隧道,可以实现远程服务器的稳定代理访问,从而顺利使用 JetBrains Gateway 与 Claude Code。本文将从本地代理配置到服务器端安装及稳定运行,提供系统化、专业化的操作步骤。
一、配置本地代理(略)
二、确认本地代理监听端口
不同代理软件监听的端口不同,请根据实际情况确认。
示例:假设本地代理端口为 7890,在后续配置中以此为例。
检查端口监听
Bash
netstat -tunlp | grep 7890
三、配置 SSH 实现持久反向隧道
在本地主机上,编辑 ~/.ssh/config 文件,添加如下配置:
config
Host 服务器别名
HostName 服务器IP或域名
User 用户名
Port SSH远程端口
RemoteForward 7891 127.0.0.1:7890
ServerAliveInterval 60
ServerAliveCountMax 3
说明:
ServerAliveInterval 与 ServerAliveCountMax 用于保持 SSH 会话活跃,避免长时间闲置断线。
测试方法:
Test
ssh myserver
# 连接成功后,执行
curl -x http://127.0.0.1:7891 https://www.google.com -I
若返回 200 OK 或其他正常状态码,说明隧道已生效。
四、SSH服务器端配置
登录远程服务器,修改 SSH 服务配置 /etc/ssh/sshd_config:
bash
AllowTcpForwarding yes
GatewayPorts yes
解释:
AllowTcpForwarding yes允许 SSH 转发端口。GatewayPorts yes允许远程端口绑定到服务器公网地址,从而可以被外部访问。
修改后重启 SSH 服务:
systemctl restart sshd
也可以重新进行SSH连接。
五、设置服务器环境变量(可选全局配置)
为方便后续使用代理,可在服务器端暴露环境变量:
arduino
export HTTP_PROXY=http://127.0.0.1:7891
export HTTPS_PROXY=http://127.0.0.1:7891
export http_proxy=http://127.0.0.1:7891
export https_proxy=http://127.0.0.1:7891
若希望全局长期生效,可追加到 ~/.bashrc 文件末尾:
.bashrc
vim ~/.bashrc
# 添加以下内容
export HTTP_PROXY=http://127.0.0.1:7891
export HTTPS_PROXY=http://127.0.0.1:7891
export http_proxy=http://127.0.0.1:7891
export https_proxy=http://127.0.0.1:7891
然后刷新配置:
bash
source ~/.bashrc
六、反向隧道测试
在服务器端执行:
Test
curl https://www.google.com -I
- 成功:返回
200 OK或正常响应头。 - 失败:若你使用的是Gateway对服务器进行连接,并且显示报错
curl: (7) Failed to connect to 127.0.0.1 port 7891 after 0 ms: Connection refused,则继续七、为 JetBrains Gateway 配置稳定隧道,否则跳过。
七、为 JetBrains Gateway 配置稳定隧道
在笔者的不断尝试之下发现,即使Jetbrains Gateway阅读了我们的配置文件,也不保证执行所有的配置项,并且反向隧道会随着SSH会话的关闭而关闭,这就导致隧道时好时坏。因此建议创建自动重连批处理脚本。
创建批处理脚本如下,命名随意:
start_tunnel.bat
@echo off
:loop
echo Starting SSH tunnel...
ssh -N -R 7891:127.0.0.1:7890 root@服务器地址 -p 远程端口
echo Connection lost, retrying in 5 seconds...
timeout /t 5
goto loop
八、在服务器安装 Claude Code
在远程服务器终端执行:
arduino
curl -fsSL https://claude.ai/install.sh | bash
安装完成后,根据提示登录 Claude Code CLI。
九、安装与配置 GUI 插件(CC GUI 推荐)
由于官方插件还处于Beta模式,很不稳定并且与终端没有区别,这里使用 CC GUI 插件。
- 安装 CC GUI 插件到本地主机。
- 安装 Node.js(官方 LTS 版本):
下载命令
# 下载官方 Node LTS 版本安装脚本
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
# 安装 Node
apt install -y nodejs
# 检查
node -v
which node
十、Claude Code CLI 登录授权注意事项
不建议使用 root 用户连接 CLI,否则会报错:
ERROR
SDK-STDERR:
--dangerously-skip-permissions cannot be used with root/sudo privileges for security reasons
Claude Code process exited with code 1
反向隧道代理与 Claude Code + Jetbrains 部署总结
通过以上步骤,即可通过反向隧道优雅、稳定地保证 Claude Code + Jetbrains 的长期运行。