远程开发是将ide后端运行于服务器，本地仅作轻量客户端。代码编辑、调试、npm安装等全在服务端执行，无需sftp同步，依赖远端环境配置，需确保ssh权限、glibc版本≥2.28、内存≥2gb及密钥格式正确。
远程开发不是“上传代码”，而是把 IDE 后端搬到服务器上运行
WebStorm 的远程开发（Remote Development）和传统 SFTP 部署根本不是一回事：它不靠本地 IDE 操作远端文件，而是通过 JetBrains Gateway 在远程服务器启动一个完整的 IDE 后端，本地只保留轻量客户端。你写的代码、运行的 node 进程、调试器、甚至 npm install 全都在服务器上发生——本地几乎不消耗 CPU 或内存。
这意味着：
• 你不再需要手动配置 SFTP 映射、自动上传、远程解释器路径；
• node_modules 不用同步，package.json 改完直接在远端装；
• 断点调试走的是真实远端进程，不是 SSH 转发或代理调试；
• 项目 SDK、插件、Git 凭据都默认在远端生效。
常见错误现象：
• 误以为“远程开发 = SFTP + 远程 Node.js 解释器”，结果配了一堆却没启用 Gateway；
• 在欢迎页看到 远程开发 但点了没反应——其实是没装 JetBrains Gateway（WebStorm 自带，但 macOS/Linux 可能需手动启动）；
• 用旧版 WebStorm（
连接前必须确认服务器环境是否达标
远程开发对服务器有硬性要求，不是“能 SSH 登录就能用”。缺一不可：
- Linux x64 或 ARM64 系统（Windows Server / macOS 远端暂不支持）；
- 已安装
glibc >= 2.28（Ubuntu 20.04+/CentOS 8+/AlmaLinux 8+ 基本满足，CentOS 7 默认2.17，会启动失败且报错GLIBC_2.28 not found）； - 至少 2GB 内存（IDE 后端自身占约 1.2–1.5GB）；
- SSH 服务开启，且用户有
shell权限（不能是/usr/sbin/nologin或/bin/false）； - 服务器能访问
https://download.jetbrains.com（用于自动下载 IDE 后端，若无法联网，得提前传WebStorm-*.tar.gz并选“从本地上传”）。
实操建议：
• 连接前先 SSH 登录，执行 ldd --version 和 free -h 快速核验；
• 若用 Docker 容器，需加 --cap-add=SYS_PTRACE --security-opt seccomp=unconfined，否则调试器无法 attach 进程；
• 防火墙要放行 SSH 端口，但**不需要额外开其他端口**——Gateway 全走 SSH 隧道。
配置时最易卡在“检查连接并继续”这一步
点击 检查连接并继续 后长时间转圈或报错，90% 是认证或权限问题，不是网络不通。
常见错误现象：
• 报错 Authentication failed：密钥格式不对（WebStorm 只接受 OpenSSH 格式，PuTTY 的 .ppk 不支持）；
• 报错 Permission denied (publickey)：服务器 ~/.ssh/authorized_keys 权限是 644（应为 600），或 ~/.ssh 目录权限 > 755；
• 报错 Failed to start JetBrains backend：用户家目录磁盘满、/tmp 不可写、或 SELinux 拦截（临时关掉验证：sudo setenforce 0）。
实操建议：
• 密钥务必用 ssh-keygen -t ed25519 生成，避免 RSA + 密码短语组合（WebStorm 当前对含密码的私钥支持不稳定）；
• 在服务器上手动执行一次 ssh -T user@host，确保无交互式提示；
• 如果用非 root 用户，确认其 ulimit -n ≥ 4096（IDE 后端大量用文件描述符）；
• “检查连接”成功后，别急着点下一步——先看终端日志里有没有 Starting backend...，有才代表真通了。
远程项目里 Git、Node.js、数据库工具链怎么用
远程开发模式下，所有命令行工具都运行在服务器环境，本地设置基本无效。Git 提交、node 版本、psql 连接，全看远端装了什么。
使用场景举例：
• 你在本地改了 package.json，保存后想装依赖 → 在远端终端（Terminal 工具窗口）直接敲 npm install，不是本地装完再同步；
• 用 Database 工具连 MySQL → 连接地址填 localhost:3306，因为这是服务器本机，不是你本地机器；
• Git 提交前想看 diff → 右键文件选 Git | Compare with Branch，背后调的是远端 git 命令。
容易踩的坑：
• 误在本地 Terminal 执行 git commit，结果提交记录留在本地仓库，远端没变；
• 给远端配了 nvm，但 WebStorm 启动时没读到 ~/.nvm/nvm.sh → 在 Settings | Language and Frameworks | Node.js 里手动指定 node 路径为 ~/.nvm/versions/node/v18.19.0/bin/node；
• 数据库连接测试通过，但代码里连不上 → 检查远端应用是否监听 127.0.0.1（而非 0.0.0.0），或 MySQL 是否限制了 localhost 用户登录。
复杂点在于：你得习惯“本地只是屏幕，服务器才是大脑”。所有环境变量、PATH、权限、防火墙规则，都以远端为准。这点和 SFTP 模式思维完全不同，切勿混用。
