在银河麒麟V10上实战TongWEB部署前后端分离War包全指南国产化技术栈的普及让越来越多的企业开始关注基于银河麒麟操作系统和东方通TongWEB应用服务器的部署方案。不同于常见的Tomcat环境这套国产组合在项目部署时会遇到一些特有的配置挑战。本文将带您完整走通从环境准备到服务启动的全流程特别针对前后端分离项目的War包部署进行深度解析。1. 环境准备与项目适配银河麒麟V10兆芯版作为国产操作系统的代表其文件权限管理与路径规范与Windows存在显著差异。在开始部署前需要确保以下基础环境就位系统层面确认已安装JDK建议1.8并配置JAVA_HOME环境变量中间件TongWEB 7.0及以上版本正确安装服务可正常启停依赖服务MySQL/达梦等数据库、Redis等缓存服务已部署并网络可达对于从Windows环境迁移的项目需要特别注意# 检查目录权限示例 ls -l /opt/TongWEB/ chmod -R 755 /opt/TongWEB/webapps提示银河麒麟默认的权限控制较严格建议为TongWEB安装目录设置专门的用户组权限避免部署时出现Permission denied错误。2. 前后端War包的特殊处理前后端分离项目在TongWEB上的部署需要将前端资源打包为独立的War包。与Tomcat不同TongWEB对静态资源的处理有特定要求前端项目处理在Vue/React打包后的dist目录中创建WEB-INF/web.xml典型web.xml内容应包含web-app welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list error-page error-code404/error-code location/index.html/location /error-page /web-app使用jar命令打包cd /path/to/dist jar -cvf frontend.war *后端项目调整检查pom.xml中打包方式为war确保没有Tomcat特有依赖如spring-boot-starter-tomcat推荐依赖配置dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId scopeprovided/scope /dependency3. TongWEB核心配置详解3.1 虚拟主机创建TongWEB的管理控制台与传统应用服务器有所不同虚拟主机创建需要注意配置项建议值说明主机名称your_domain与后续HTTP通道关联默认Web应用ROOT保持默认工作目录/path/to/workdir建议独立于安装目录注意虚拟主机的域名字段在实际生产环境应配置真实的备案域名测试环境可用IP替代。3.2 HTTP通道配置HTTP通道是TongWEB特有的网络通信配置模块关键参数包括端口设置默认8080可能存在冲突建议改为8000-9000区间连接超时国产环境建议适当延长至300秒最大POST大小前后端分离项目建议设置为50MB以上典型问题解决方案# 修改TongWEB内存配置 vi /opt/TongWEB/bin/external.vmoptions # 添加以下参数示例 -Xms1024m -Xmx2048m -XX:MaxPermSize512m4. 项目部署与排错实战4.1 分步部署流程登录TongWEB管理控制台默认端口9060进入应用管理→应用部署选择前端War包上下文路径设为/front部署后端War包上下文路径设为/api启动顺序先启动后端服务再启动前端4.2 典型问题处理事务注解失效问题 这是TongWEB较常见的兼容性问题解决方法# 修改TongWEB配置 vi /opt/TongWEB/bin/external.vmoptions # 确保包含以下参数 -DWebModuleOnlytrue静态资源404错误 检查前端War包结构是否正确确保WEB-INF/web.xml存在且配置正确静态资源位于War包根目录没有多余的META-INF目录跨域问题解决方案 在后端项目中添加配置类Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(*) .allowedHeaders(*); } }5. 性能调优与监控国产环境下的性能优化需要特别关注JVM参数调优# 建议配置8G内存机器示例 -Xms4096m -Xmx4096m -XX:UseG1GC -XX:MaxGCPauseMillis200TongWEB线程池配置参数名生产环境建议值说明maxThreads200最大工作线程数minSpareThreads20最小空闲线程数acceptCount100等待队列长度监控建议定期检查/opt/TongWEB/logs下的服务日志使用JDK自带工具监控JVM状态jstat -gcutil pid 1000 10配置国产化监控系统如麒麟自带监控工具在实际项目部署中我们发现TongWEB对静态资源的缓存策略与Tomcat有所不同。通过修改WEB-INF/tongweb.xml需要手动创建可以优化缓存控制tongweb static-resources cache-control max-age86400/ /static-resources /tongweb
在银河麒麟V10上，手把手教你用TongWEB部署前后端分离的War包项目
发布时间：2026/5/24 2:33:18
在银河麒麟V10上实战TongWEB部署前后端分离War包全指南国产化技术栈的普及让越来越多的企业开始关注基于银河麒麟操作系统和东方通TongWEB应用服务器的部署方案。不同于常见的Tomcat环境这套国产组合在项目部署时会遇到一些特有的配置挑战。本文将带您完整走通从环境准备到服务启动的全流程特别针对前后端分离项目的War包部署进行深度解析。1. 环境准备与项目适配银河麒麟V10兆芯版作为国产操作系统的代表其文件权限管理与路径规范与Windows存在显著差异。在开始部署前需要确保以下基础环境就位系统层面确认已安装JDK建议1.8并配置JAVA_HOME环境变量中间件TongWEB 7.0及以上版本正确安装服务可正常启停依赖服务MySQL/达梦等数据库、Redis等缓存服务已部署并网络可达对于从Windows环境迁移的项目需要特别注意# 检查目录权限示例 ls -l /opt/TongWEB/ chmod -R 755 /opt/TongWEB/webapps提示银河麒麟默认的权限控制较严格建议为TongWEB安装目录设置专门的用户组权限避免部署时出现Permission denied错误。2. 前后端War包的特殊处理前后端分离项目在TongWEB上的部署需要将前端资源打包为独立的War包。与Tomcat不同TongWEB对静态资源的处理有特定要求前端项目处理在Vue/React打包后的dist目录中创建WEB-INF/web.xml典型web.xml内容应包含web-app welcome-file-list welcome-fileindex.html/welcome-file /welcome-file-list error-page error-code404/error-code location/index.html/location /error-page /web-app使用jar命令打包cd /path/to/dist jar -cvf frontend.war *后端项目调整检查pom.xml中打包方式为war确保没有Tomcat特有依赖如spring-boot-starter-tomcat推荐依赖配置dependency groupIdjavax.servlet/groupId artifactIdjavax.servlet-api/artifactId scopeprovided/scope /dependency3. TongWEB核心配置详解3.1 虚拟主机创建TongWEB的管理控制台与传统应用服务器有所不同虚拟主机创建需要注意配置项建议值说明主机名称your_domain与后续HTTP通道关联默认Web应用ROOT保持默认工作目录/path/to/workdir建议独立于安装目录注意虚拟主机的域名字段在实际生产环境应配置真实的备案域名测试环境可用IP替代。3.2 HTTP通道配置HTTP通道是TongWEB特有的网络通信配置模块关键参数包括端口设置默认8080可能存在冲突建议改为8000-9000区间连接超时国产环境建议适当延长至300秒最大POST大小前后端分离项目建议设置为50MB以上典型问题解决方案# 修改TongWEB内存配置 vi /opt/TongWEB/bin/external.vmoptions # 添加以下参数示例 -Xms1024m -Xmx2048m -XX:MaxPermSize512m4. 项目部署与排错实战4.1 分步部署流程登录TongWEB管理控制台默认端口9060进入应用管理→应用部署选择前端War包上下文路径设为/front部署后端War包上下文路径设为/api启动顺序先启动后端服务再启动前端4.2 典型问题处理事务注解失效问题 这是TongWEB较常见的兼容性问题解决方法# 修改TongWEB配置 vi /opt/TongWEB/bin/external.vmoptions # 确保包含以下参数 -DWebModuleOnlytrue静态资源404错误 检查前端War包结构是否正确确保WEB-INF/web.xml存在且配置正确静态资源位于War包根目录没有多余的META-INF目录跨域问题解决方案 在后端项目中添加配置类Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(*) .allowedHeaders(*); } }5. 性能调优与监控国产环境下的性能优化需要特别关注JVM参数调优# 建议配置8G内存机器示例 -Xms4096m -Xmx4096m -XX:UseG1GC -XX:MaxGCPauseMillis200TongWEB线程池配置参数名生产环境建议值说明maxThreads200最大工作线程数minSpareThreads20最小空闲线程数acceptCount100等待队列长度监控建议定期检查/opt/TongWEB/logs下的服务日志使用JDK自带工具监控JVM状态jstat -gcutil pid 1000 10配置国产化监控系统如麒麟自带监控工具在实际项目部署中我们发现TongWEB对静态资源的缓存策略与Tomcat有所不同。通过修改WEB-INF/tongweb.xml需要手动创建可以优化缓存控制tongweb static-resources cache-control max-age86400/ /static-resources /tongweb
