JSP项目在Ubuntu上的迁移做法

作者:袖梨 2026-07-31

一、迁移前准备

JSP项目在Ubuntu上的迁移方法

  1. 确认源环境信息:记录原服务器的JDK版本(如OpenJDK 8/11)、Tomcat版本(如9.x)、项目依赖(如MySQL数据库、第三方库)、项目结构(如WEB-INF/lib下的JAR包、web.xml配置)及端口设置(如Tomcat默认8080端口)。
  2. 准备目标服务器:确保Ubuntu系统已更新(sudo apt update && sudo apt upgrade),并具备root或sudo权限。

二、安装基础环境

  1. 安装JDK:
    1. 更新软件包列表:sudo apt update
    2. 安装OpenJDK(以11为例,兼容大多数JSP项目):sudo apt install openjdk-11-jdk
    3. 验证安装:java -version(需显示Java版本信息)。
    4. (可选)配置环境变量:编辑/etc/profile,添加JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64PATH=$JAVA_HOME/bin:$PATH,执行source /etc/profile使配置生效。
  2. 安装Tomcat:
    1. 下载Tomcat二进制包(如9.0.56):wget https://downloads.apache.org/tomcat/tomcat-9/v9.0.56/bin/apache-tomcat-9.0.56.tar.gz
    2. 解压到指定目录(如/usr/local):sudo tar -zxvf apache-tomcat-9.0.56.tar.gz -C /usr/local/
    3. 创建符号链接便于管理:sudo ln -s /usr/local/apache-tomcat-9.0.56 /usr/local/tomcat
    4. 启动Tomcat:cd /usr/local/tomcat/bin && ./startup.sh
    5. 验证启动:浏览器访问http://localhost:8080,显示Tomcat欢迎页面则成功。
    6. (可选)配置环境变量:编辑/etc/profile,添加CATALINA_HOME=/usr/local/tomcatPATH=$CATALINA_HOME/bin:$PATH,执行source /etc/profile
  3. 安装数据库(如项目需要):
    1. 安装MySQL:sudo apt install mysql-server
    2. 启动服务:sudo systemctl start mysql,设置开机自启:sudo systemctl enable mysql
    3. 运行安全脚本:sudo mysql_secure_installation(设置root密码、移除匿名用户等)。

三、迁移JSP项目

  1. 打包项目:将原项目编译为WAR文件(如使用IDE导出或jar -cvf project.war *命令),确保包含WEB-INF/lib下的所有依赖JAR包和web.xml配置文件。
  2. 上传WAR文件:使用scp命令将WAR文件上传至目标服务器(如scp project.war user@ubuntu_ip:/tmp/)。
  3. 部署项目:将WAR文件复制到Tomcat的webapps目录(如sudo cp /tmp/project.war /var/lib/tomcat9/webapps/),Tomcat会自动解压并部署(生成project文件夹)。

四、配置与验证

  1. 配置数据库连接(如项目需要):
    1. 登录MySQL:sudo mysql -u root -p
    2. 创建数据库和用户:CREATE DATABASE jsp_db; CREATE USER 'jsp_user'@'localhost' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON jsp_db.* TO 'jsp_user'@'localhost'; FLUSH PRIVILEGES;
    3. 修改项目中的数据库配置(如WEB-INF/classes/jdbc.properties),更新URL、用户名和密码。
  2. 调整Tomcat配置(可选):
    1. 修改端口:编辑conf/server.xml中的<Connector port="8080">(如改为8081,避免端口冲突)。
    2. 配置虚拟主机:在server.xml<Engine>标签内添加<Host>,设置域名或IP绑定。
  3. 验证部署:
    1. 重启Tomcat:sudo systemctl restart tomcat9
    2. 访问项目:浏览器输入http://ubuntu_ip:8080/project_nameproject_name为WAR文件名或webapps下的文件夹名),检查页面显示和功能是否正常。
  4. 检查日志:若部署失败,查看Tomcat日志定位问题:tail -f /usr/local/tomcat/logs/catalina.out(或/var/log/tomcat9/catalina.out)。

五、可选优化

  1. 配置反向代 理:使用Nginx作为前端代 理,处理HTTPS请求和静态资源,编辑Nginx配置文件(/etc/nginx/sites-available/default),添加:
    server {listen 80;server_name your_domain.com;location / {proxy_pass http://localhost:8080/project_name;proxy_set_header Host $host;proxy_set_header X-Real-IP $remote_addr;}}
    重启Nginx:sudo systemctl restart nginx
  2. 配置SSL证书:使用Certbot获取免费SSL证书,命令:sudo certbot --nginx -d your_domain.com,按提示完成配置,实现HTTPS访问。

相关文章

精彩推荐