IntelliJ IDEA 2023.2 Ultimate 版支持通过 SSH 协议配置远程部署 Spring Boot jar 包，Community 版原生不支持该自动化功能。适用场景为拥有 Linux 远程服务器权限且已安装 Java 运行环境的开发环境，风险边界在于 SSH 密钥权限配置错误会导致连接失败，远程 Java 版本不一致会导致启动报错。

命令速用版

远程服务器手动验证 Jar 包可运行的基础命令如下，配置 IDEA 前建议先在终端执行成功：

java -jar /path/to/your/app.jar `--server`.port=8080

测试 SSH 连通性命令：

ssh -p 22 username@remote_ip

为什么会这样

IDEA 通过 SSH 协议建立安全通道，将本地编译产物传输至远程指定目录并执行启动脚本。

该功能依赖 IDEA Ultimate 版的 Deployment 模块，底层使用 SFTP 传输文件并通过 SSH Session 执行 Shell 命令。若远程环境缺少 Java 运行时或路径配置错误，IDEA 无法自动修复环境依赖，仅负责文件传输与命令触发。

分步处理

步骤 1：确认版本与权限

检查 IDEA 版本是否为 Ultimate，Community 版无 Deployment 标签页。确认远程服务器 SSH 端口（默认 22）可访问，用户具备文件写入与执行权限。

步骤 2：配置 SSH 连接

进入菜单 Tools -> Deployment -> Configuration，添加 SSH 配置项。填写 Host、Port、Username，选择 Key pair 或 Password 认证。点击 Test Connection 确保显示 Success。

步骤 3：配置映射路径

在 Mappings 标签页，设置 Local path 为项目 target 目录，Remote path 为服务器部署目录（如 /home/user/app）。确保路径分隔符符合 Linux 规范。

步骤 4：配置运行脚本

编辑 Spring Boot Run/Debug Configuration，找到 Deployment 标签。勾选 Upload artifacts，设置 On 'Run'动作。在 After launch 脚本框填入远程启动命令，例如 nohup java -jar app.jar > log.txt &。

怎么验证是否生效

查看远程服务器进程列表，确认 Java 进程存在：

ps -ef | grep java

检查 IDEA 底部 Run 窗口，显示 Deployment 状态为 Success。访问远程服务器 IP 与端口，确认 HTTP 响应正常。查看远程日志文件，无 ClassNotFoundException 或 Port in use 报错。

常见坑

1. 路径分隔符错误：Windows 本地路径使用反斜杠，远程 Linux 路径必须使用正斜杠，映射配置错误会导致上传失败。

2. 环境变量缺失：远程 SSH 会话可能不加载 ~/.bashrc，导致 java 命令找不到，建议在启动脚本中使用 Java 绝对路径。

3. 进程残留：多次部署未停止旧进程会导致端口占用，需在启动脚本前增加 kill 旧进程命令。

4. 防火墙拦截：服务器安全组未放行应用端口，IDEA 显示部署成功但无法访问服务。

常见问题

IDEA Community 版能配置 SSH 部署吗

原生不支持，Community 版缺少 Deployment 配置标签，需使用 External Tools 调用脚本或手动上传。

远程启动后 IDEA 控制台为何无日志

远程进程独立运行，日志输出在服务器文件内，IDEA 仅监控部署状态，需查看远程日志文件或配置日志回调。

SSH 连接测试失败怎么办

检查服务器 SSH 服务状态、防火墙端口 22 是否开放、密钥权限是否为 600 以及用户名密码是否正确。

参考来源

• JetBrains Official Documentation, Deployment, https://www.jetbrains.com/help/idea/deployment.html
• JetBrains Official Documentation, Create a Run/Debug Configuration, https://www.jetbrains.com/help/idea/running-application.html