在 Idea 中配置远程 tomcat 并部署

1. 前言

在项目开发过程中，需要访问某公司的接口，由于将我们公司自己服务器的 IP 配置成了发起请求的主机 IP，所以只有在服务器上运行的项目请求那个接口才能请求成功。我们平常开发都是在自己电脑本地的 tomcat 中运行项目，这样显然不能访问该公司的接口，但是如果在本地编译完再部署到服务器上测试就太浪费时间了。所以需要在 Idea 中配置服务器上的tomcat，这样在本地写完代码之后，点击运行，项目就直接是跑在服务器上的了，省去了中间的部署过程。
所以就有了今天这篇文章。

2. 环境

本地环境：

• OS：Windows 10
• tomcat 9.0.26
• java 1.8.0_201
• Idea 2017.3

服务器环境：

• OS：CentOS7.6
• tomcat 9.0.26
• java 1.8.0_231

Idea 的帮助文档中有这样一句话：

When working with a remote server, the same server version must be available locally.

我的理解是说本地 tomcat 版本要和服务器上的完全一致，不知道理解的对不对。为了与服务器保持一致，我把原来本地的 tomcat 9.0.14 换成了 tomcat 9.0.26。

还有一点要注意，那就是最好保证你的服务器上只有一个 tomcat 在使用。我在这个地方吃了很多亏。

3. 修改服务器 tomcat 的启动脚本catalina.sh

通常我们启动 tomcat 时，本质上都是运行的 statup.sh，但是现在需要远程部署，启动脚本要换成 catalina.sh。

打开服务器 tomcat 安装目录下的 bin 目录，通常是 /usr/local/apache-tomcat-9.0.26/bin，里面有一个脚本文件 catalina.sh，打开这个脚本文件后，在开头的地方加入下面这段代码：

CATALINA_OPTS="-Dcom.sun.management.jmxremote 
-Dcom.sun.management.jmxremote.port=1099 
-Dcom.sun.management.jmxremote.ssl=false 
-Dcom.sun.management.jmxremote.authenticate=false 
-Djava.rmi.server.hostname="
export CATALINA_OPTS

其中的 就是你服务器的 IP 地址，1099 这个端口要记住，一会儿还要用到。

修改完成后来到 catalina.sh 所在的目录，使用下面这个命令运行该脚本，启动 tomcat：

./catalina.sh run > /dev/null 2>&1 &

如果出现下图中的提示，则说明启动成功。图中的 6595 是 tomcat 的进程号。

也可以用 jps 命令查看：

tomcat 运行起来之后，我们在本地浏览器中输入 http://:8080 进行访问，可以看到熟悉的 tomcat 主页：

4. 配置本地 Idea

在 Idea 右上角找到下图中的这个按钮：

点击左上角的 +，添加一个远程 tomcat：

然后开始配置。

第一步：Run / Debug Configuration -> Server：

第二步：Deployment -> Connection：
点击上图中 Host 右边的 … ，会出现 Deployment 对话框：
点击左上角的 +，添加远程主机，Type 选 SFTP。然后可以看到下图中的界面：

第三步：Deployment -> Mappings：

第四步：Run / Debug Configuration -> Deployment：

至此，Idea 的配置就完成了。

5. 运行

运行项目

若看到控制台输出以下内容，则说明配置远程 tomcat 成功！

在浏览器中访问服务器的 tomcat，就可以打开本地编写的项目了。

本地代码如下：

浏览器界面：

6. 参考链接

1. idea部署项目到远程tomcat
2. Idea 2017.3 帮助文档 - Run/Debug Configuration: Tomcat Server
   注： 如果你的 Idea 是其他版本的话，Idea 的配置过程可能会略有不同，具体可以参考相应 Idea 版本的帮助文档，只需把链接中的 2017.3 改成你自己的 Idea 的版本即可