在银河麒麟V10上，手把手教你用TongWEB部署前后端分离项目（含war包制作与权限避坑）
银河麒麟V10系统下TongWEB全栈项目部署实战指南
在信创产业快速推进的背景下，国产操作系统与中间件的组合已成为企业级应用部署的新常态。银河麒麟V10作为国产操作系统的代表，搭配TongWEB应用服务器，为需要满足安全合规要求的项目提供了可靠的基础设施支撑。本文将深入探讨在这一特定环境下部署前后端分离项目的完整流程，特别针对从Windows环境迁移到银河麒麟系统时可能遇到的"水土不服"问题提供解决方案。
1. 环境准备与项目适配
部署前的环境配置是确保后续流程顺利的基础。银河麒麟V10 SP1（兆芯版）作为基于Linux内核的操作系统，与Windows环境存在显著差异，这要求开发者在迁移项目时特别注意环境适配问题。
基础环境要求：
- 银河麒麟V10 SP1操作系统（建议更新至最新补丁）
- TongWEB应用服务器（本文基于7.0版本）
- Java开发环境（JDK 1.8或以上）
- 构建工具（Maven/Gradle）
- 数据库服务（如达梦、金仓等国产数据库）
注意：在国产化环境中，建议使用与系统架构匹配的软件版本，避免因兼容性问题导致部署失败。
对于从Windows迁移过来的项目，需要特别注意以下差异点：
- 文件系统权限：Linux系统严格的权限控制机制
- 路径分隔符：使用正斜杠(/)而非反斜杠()
- 环境变量：配置方式与Windows不同
- 服务管理：不使用Windows服务机制
2. 前端项目War包制作详解
传统的前端静态资源部署方式在TongWEB环境中需要进行适当调整。将Vue/React等框架构建的dist目录打包为War包，是实现前后端统一部署管理的有效方案。
2.1 标准War包结构改造
在已完成构建的前端项目dist目录中，需要创建符合Java EE规范的目录结构：
cd /path/to/project/dist mkdir -p WEB-INF创建web.xml文件，解决SPA应用的路由问题：
<!-- WEB-INF/web.xml --> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1"> <error-page> <error-code>404</error-code> <location>/index.html</location> </error-page> </web-app>2.2 War包生成与验证
使用jar命令打包前端资源：
jar -cvf frontend.war *生成的War包应包含以下结构：
frontend.war ├── index.html ├── static/ │ ├── css/ │ ├── js/ │ └── img/ └── WEB-INF/ └── web.xml常见问题排查：
- 权限不足：使用
sudo或调整目录权限 - 路径错误：确保在dist目录下执行命令
- 文件缺失：检查WEB-INF/web.xml是否存在
3. TongWEB服务配置精要
TongWEB作为国产主流应用服务器，其配置逻辑与Tomcat有相似之处但也有独特之处，正确配置是项目稳定运行的关键。
3.1 虚拟主机创建
在TongWEB管理控制台中创建虚拟主机：
- 登录TongWEB管理控制台（默认端口9060）
- 导航至"服务器→虚拟主机"
- 点击"新建"，填写必要信息：
- 主机名：建议使用域名格式
- 文档根目录：指定项目部署路径
关键参数说明：
| 参数项 | 推荐值 | 说明 |
|---|---|---|
| 主机别名 | 留空或*.domain.com | 支持泛域名解析 |
| 传输保障 | HTTP | 生产环境建议HTTPS |
| 线程池 | default | 高并发可单独配置 |
3.2 HTTP通道配置
HTTP通道决定了应用对外提供服务的网络配置：
# 示例：在server.xml中配置HTTP连接器 <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" maxThreads="200" minSpareThreads="10"/>提示：生产环境建议关闭AJP协议，仅保留HTTP/HTTPS通道以增强安全性。
4. 项目部署实战流程
4.1 前端项目部署
- 在TongWEB控制台选择"应用→部署"
- 上传准备好的frontend.war文件
- 设置上下文路径（如/frontend）
- 选择目标虚拟主机
- 完成部署并启动应用
权限避坑指南：
- 部署前确保TongWEB用户对安装目录有读写权限
- 检查
/opt/TongWEB/目录权限：chown -R tongweb:tongweb /opt/TongWEB chmod -R 755 /opt/TongWEB - 项目运行时生成的临时文件目录需可写
4.2 后端项目部署
后端War包部署流程与前端类似，但需注意：
- 数据库连接配置适配国产数据库
- 文件存储路径使用Linux格式
- 事务配置检查（特别关注@Transactional注解行为）
事务问题解决方案： 编辑bin/external.vmoptions文件：
-DWebModuleOnly=true修改后需重启TongWEB服务使配置生效。
5. 部署后管理与优化
项目部署成功后，还需要进行适当的配置优化和日常管理，以确保应用稳定运行。
5.1 文件管理规范
TongWEB部署后的项目结构与Tomcat类似但管理机制不同：
- 部署目录：
/opt/TongWEB/webapps/ - 配置文件：
/opt/TongWEB/conf/ - 日志文件：
/opt/TongWEB/logs/
重要原则：
- 避免直接操作webapps目录下的项目文件
- 修改配置后通过控制台重新加载应用
- 备份重要配置后再进行调整
5.2 性能调优建议
根据项目特点调整JVM参数：
# 在bin/external.vmoptions中配置 -Xms2048m -Xmx2048m -XX:MaxMetaspaceSize=512m -XX:+UseG1GC监控指标参考值：
| 指标 | 正常范围 | 应对措施 |
|---|---|---|
| CPU使用率 | <70% | 优化代码或扩容 |
| 内存使用 | <80% | 调整JVM参数 |
| 线程数 | <最大线程数80% | 优化或扩容 |
6. 跨平台迁移专项问题解决
从Windows环境迁移到银河麒麟系统时，文件路径问题是最常见的障碍之一。以下是典型问题及解决方案：
路径问题表现：
- 文件找不到异常（FileNotFoundException）
- 权限拒绝（Permission denied）
- 路径分隔符导致的路径解析失败
系统化解决方案：
- 路径标准化处理：
// 使用File.separator替代硬编码的路径分隔符 String path = "config" + File.separator + "application.properties";- 权限统一配置：
# 递归设置项目目录权限 find /path/to/project -type d -exec chmod 755 {} \; find /path/to/project -type f -exec chmod 644 {} \;- 符号链接处理：
# 为Windows风格的路径创建符号链接 ln -s /mnt/c/ProgramData/AppConfig ./config在实际项目迁移中，我们曾遇到一个典型案例：某系统的文件上传功能在Windows下正常，但在银河麒麟系统中无法保存文件。根本原因是代码中硬编码了"C:\upload"路径，而Linux系统不存在该目录。解决方案是改为从配置文件中读取路径，并确保应用运行用户对该目录有写权限。