梵医云开发文档

Appearance

宝塔部署 ​

1. 概述 ​

宝塔面板是一款简单好用的服务器运维管理面板，支持 Linux 系统，提供 Web 界面管理服务器。本文档介绍如何使用宝塔面板部署梵医云系统。

2. 环境要求 ​

2.1 硬件要求 ​

组件最低配置推荐配置
CPU4 核8 核及以上
内存8 GB16 GB 及以上
硬盘100 GB200 GB 及以上
网络100 Mbps1 Gbps

2.2 软件要求 ​

软件版本要求说明
操作系统CentOS 7+ / Ubuntu 20.04+Linux 发行版
宝塔面板7.9+服务器管理面板

3. 安装宝塔面板 ​

3.1 CentOS 安装宝塔 ​

bash
# 安装宝塔面板
yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

# 查看宝塔面板信息
bt default

3.2 Ubuntu 安装宝塔 ​

bash
# 安装宝塔面板
wget -O install.sh http://download.bt.cn/install/install-ubuntu_6.0.sh && sudo bash install.sh

# 查看宝塔面板信息
bt default

3.3 访问宝塔面板 ​

  1. 打开浏览器访问宝塔面板地址（安装完成后会显示）
  2. 输入用户名和密码登录

3.4 宝塔面板常用命令 ​

bash
# 启动宝塔
bt start

# 停止宝塔
bt stop

# 重启宝塔
bt restart

# 查看宝塔信息
bt default

# 修改宝塔端口
bt 14

# 修改宝塔密码
bt 5

# 修改宝塔用户名
bt 6

4. 安装环境软件 ​

4.1 安装 JDK ​

  1. 登录宝塔面板
  2. 进入"软件商店"
  3. 搜索"Java"
  4. 选择"Java 项目管理器"
  5. 点击"安装"
  6. 选择 JDK 版本（推荐 JDK 17）
  7. 点击"提交"

4.2 安装 MySQL ​

  1. 进入"软件商店"
  2. 搜索"MySQL"
  3. 选择"MySQL 8.0"
  4. 点击"安装"
  5. 选择安装版本（推荐 8.0.39）
  6. 点击"提交"

4.3 安装 Redis ​

  1. 进入"软件商店"
  2. 搜索"Redis"
  3. 选择"Redis 6.0"
  4. 点击"安装"
  5. 选择安装版本（推荐 6.2.13）
  6. 点击"提交"

4.4 安装 Nginx ​

  1. 进入"软件商店"
  2. 搜索"Nginx"
  3. 选择"Nginx"
  4. 点击"安装"
  5. 选择安装版本（推荐 1.20+）
  6. 点击"提交"

4.5 安装 Docker ​

  1. 进入"软件商店"
  2. 搜索"Docker"
  3. 选择"Docker"
  4. 点击"安装"
  5. 点击"提交"

5. 配置 MySQL ​

5.1 创建数据库 ​

  1. 进入"数据库"
  2. 点击"添加数据库"
  3. 配置数据库：
    • 数据库名：db-fanyi-cloud
    • 用户名：fanyi
    • 密码：your_password
    • 访问权限：本地服务器
  4. 点击"提交"

5.2 导入数据库 ​

  1. 进入"数据库"
  2. 找到创建的数据库
  3. 点击"导入"
  4. 选择 SQL 文件
  5. 点击"开始导入"

5.3 配置 MySQL ​

  1. 进入"软件商店"
  2. 找到"MySQL"
  3. 点击"设置"
  4. 配置参数：
    • 最大连接数：1000
    • 字符集：utf8mb4
  5. 点击"保存"

5.4 数据库备份 ​

  1. 进入"数据库"
  2. 找到要备份的数据库
  3. 点击"备份"
  4. 点击"立即备份"

6. 配置 Redis ​

6.1 配置 Redis ​

  1. 进入"软件商店"
  2. 找到"Redis"
  3. 点击"设置"
  4. 配置参数：
    • 最大内存：1GB
    • 最大连接数：10000
  5. 点击"保存"

6.2 启动 Redis ​

  1. 进入"软件商店"
  2. 找到"Redis"
  3. 点击"启动"

6.3 测试 Redis 连接 ​

bash
# 连接 Redis
redis-cli -h 127.0.0.1 -p 6379

# 测试连接
ping

7. 部署应用 ​

7.1 创建网站 ​

  1. 进入"网站"
  2. 点击"添加站点"
  3. 配置站点：
    • 域名：fanyi.example.com
    • 根目录：/www/wwwroot/fanyi-cloud
    • FTP：不创建
    • 数据库：不创建
    • PHP 版本：纯静态
  4. 点击"提交"

7.2 配置 SSL 证书 ​

  1. 进入"网站"
  2. 找到创建的站点
  3. 点击"设置"
  4. 选择"SSL"
  5. 选择证书类型：
    • Let's Encrypt（免费）
    • 其他证书（上传）
  6. 点击"申请"或"上传"
  7. 点击"强制 HTTPS"

7.3 配置反向代理 ​

  1. 进入"网站"
  2. 找到创建的站点
  3. 点击"设置"
  4. 选择"反向代理"
  5. 点击"添加反向代理"
  6. 配置代理：
    • 代理名称：fanyi-gateway
    • 目标 URL：http://127.0.0.1:48080
    • 发送域名：$host
  7. 点击"提交"

8. 部署 Java 应用 ​

8.1 创建 Java 项目 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 点击"添加 Java 项目"
  4. 配置项目：
    • 项目名称：fanyi-gateway
    • 项目类型：Spring Boot
    • JDK 版本：JDK 17
    • 项目路径：/www/wwwroot/fanyi-cloud/fanyi-gateway
    • 启动方式：Jar 包启动
    • Jar 包路径：/www/wwwroot/fanyi-cloud/fanyi-gateway/target/fanyi-gateway.jar
    • 端口：48080
    • JVM 参数：-Xms512m -Xmx512m
  5. 点击"提交"

8.2 配置环境变量 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 找到创建的项目
  4. 点击"设置"
  5. 选择"环境变量"
  6. 添加环境变量：
    • SPRING_PROFILES_ACTIVE=prod
    • SPRING_CLOUD_NACOS_CONFIG_SERVER_ADDR=127.0.0.1:8848
    • SPRING_CLOUD_NACOS_CONFIG_NAMESPACE=prod
    • SPRING_CLOUD_NACOS_SERVER_ADDR=127.0.0.1:8848
    • SPRING_CLOUD_NACOS_DISCOVERY_NAMESPACE=prod
  7. 点击"保存"

8.3 启动项目 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 找到创建的项目
  4. 点击"启动"

8.4 查看项目日志 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 找到创建的项目
  4. 点击"日志"

9. 部署 Nacos ​

9.1 下载 Nacos ​

bash
cd /www/wwwroot
wget https://github.com/alibaba/nacos/releases/download/2.2.3/nacos-server-2.2.3.tar.gz
tar -zxvf nacos-server-2.2.3.tar.gz
mv nacos nacos-2.2.3

9.2 配置 Nacos ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 点击"添加 Java 项目"
  4. 配置项目：
    • 项目名称：fanyi-nacos
    • 项目类型：Spring Boot
    • JDK 版本：JDK 17
    • 项目路径：/www/wwwroot/nacos-2.2.3
    • 启动方式：Shell 命令启动
    • 启动命令：sh bin/startup.sh -m standalone
    • 端口：8848
  5. 点击"提交"

9.3 配置 Nacos 数据库 ​

编辑 Nacos 配置文件 /www/wwwroot/nacos-2.2.3/conf/application.properties：

properties
spring.datasource.platform=mysql
db.num=1
db.url.0=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai
db.user.0=root
db.password.0=your_password
nacos.core.auth.enabled=true
nacos.core.auth.server.identity.key=serverIdentity
nacos.core.auth.server.identity.value=security
nacos.core.auth.plugin.nacos.token.secret.key=SecretKey01234567890123456789012345678901234567890123456789

10. 部署 Gateway ​

10.1 创建 Gateway 项目 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 点击"添加 Java 项目"
  4. 配置项目：
    • 项目名称：fanyi-gateway
    • 项目类型：Spring Boot
    • JDK 版本：JDK 17
    • 项目路径：/www/wwwroot/fanyi-cloud/fanyi-gateway
    • 启动方式：Jar 包启动
    • Jar 包路径：/www/wwwroot/fanyi-cloud/fanyi-gateway/target/fanyi-gateway.jar
    • 端口：48080
    • JVM 参数：-Xms512m -Xmx512m
  5. 点击"提交"

10.2 配置环境变量 ​

添加环境变量：

bash
SPRING_PROFILES_ACTIVE=prod
SPRING_CLOUD_NACOS_CONFIG_SERVER_ADDR=127.0.0.1:8848
SPRING_CLOUD_NACOS_CONFIG_NAMESPACE=prod
SPRING_CLOUD_NACOS_SERVER_ADDR=127.0.0.1:8848
SPRING_CLOUD_NACOS_DISCOVERY_NAMESPACE=prod

10.3 启动 Gateway ​

点击"启动"按钮。

11. 部署 System ​

11.1 创建 System 项目 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 点击"添加 Java 项目"
  4. 配置项目：
    • 项目名称：fanyi-system
    • 项目类型：Spring Boot
    • JDK 版本：JDK 17
    • 项目路径：/www/wwwroot/fanyi-cloud/fanyi-module-system/fanyi-module-system-biz
    • 启动方式：Jar 包启动
    • Jar 包路径：/www/wwwroot/fanyi-cloud/fanyi-module-system/fanyi-module-system-biz/target/fanyi-module-system-biz.jar
    • 端口：48081
    • JVM 参数：-Xms512m -Xmx512m
  5. 点击"提交"

11.2 配置环境变量 ​

添加环境变量：

bash
SPRING_PROFILES_ACTIVE=prod
SPRING_CLOUD_NACOS_CONFIG_SERVER_ADDR=127.0.0.1:8848
SPRING_CLOUD_NACOS_CONFIG_NAMESPACE=prod
SPRING_CLOUD_NACOS_SERVER_ADDR=127.0.0.1:8848
SPRING_CLOUD_NACOS_DISCOVERY_NAMESPACE=prod

11.3 启动 System ​

点击"启动"按钮。

12. 部署其他服务 ​

按照相同的方式部署其他服务：

  • fanyi-infra（端口：48082）
  • fanyi-member（端口：48087）
  • fanyi-pay（端口：48083）
  • fanyi-bpm（端口：48084）
  • fanyi-report（端口：48085）
  • fanyi-mp（端口：48086）
  • fanyi-product（端口：48088）
  • fanyi-promotion（端口：48089）
  • fanyi-trade（端口：48090）
  • fanyi-statistics（端口：48091）
  • fanyi-crm（端口：48092）
  • fanyi-erp（端口：48093）
  • fanyi-ai（端口：48094）
  • fanyi-appointment（端口：48095）
  • fanyi-partner（端口：48096）

13. 文件管理 ​

13.1 上传文件 ​

  1. 进入"文件"
  2. 选择目标目录
  3. 点击"上传"
  4. 选择文件
  5. 点击"开始上传"

13.2 下载文件 ​

  1. 进入"文件"
  2. 找到要下载的文件
  3. 点击"下载"

13.3 编辑文件 ​

  1. 进入"文件"
  2. 找到要编辑的文件
  3. 点击"编辑"
  4. 修改文件内容
  5. 点击"保存"

13.4 压缩和解压 ​

  1. 进入"文件"
  2. 选择文件或目录
  3. 点击"压缩"或"解压"

14. 计划任务 ​

14.1 创建备份任务 ​

  1. 进入"计划任务"
  2. 点击"添加任务"
  3. 配置任务：
    • 任务类型：备份数据库
    • 执行周期：每天
    • 执行时间：02:00
    • 备份到：/www/backup
  4. 点击"提交"

14.2 创建日志清理任务 ​

  1. 进入"计划任务"
  2. 点击"添加任务"
  3. 配置任务：
    • 任务类型：Shell 脚本
    • 执行周期：每周
    • 执行时间：03:00
    • 脚本内容：
    bash
    find /www/wwwroot/fanyi-cloud/logs -name "*.log" -mtime +7 -delete
  4. 点击"提交"

14.3 创建数据库优化任务 ​

  1. 进入"计划任务"
  2. 点击"添加任务"
  3. 配置任务：
    • 任务类型：Shell 脚本
    • 执行周期：每周
    • 执行时间：04:00
    • 脚本内容：
    bash
    mysql -u root -p -e "OPTIMIZE TABLE db-fanyi-cloud.*;"
  4. 点击"提交"

15. 安全设置 ​

15.1 配置防火墙 ​

  1. 进入"安全"
  2. 选择"防火墙"
  3. 添加规则：
    • 端口：48080（Gateway）
    • 端口：48081（System）
    • 端口：48082（Infra）
    • 端口：8848（Nacos）
    • 端口：3306（MySQL）
    • 端口：6379（Redis）
  4. 点击"保存"

15.2 配置 SSH ​

  1. 进入"安全"
  2. 选择"SSH 管理"
  3. 修改 SSH 端口（建议改为非默认端口）
  4. 禁用 root 登录
  5. 点击"保存"

15.3 配置面板访问限制 ​

  1. 进入"面板设置"
  2. 选择"安全设置"
  3. 配置访问限制：
    • 允许访问的 IP：your-ip-address
    • 禁止海外 IP 访问：勾选
  4. 点击"保存"

16. 监控和日志 ​

16.1 系统监控 ​

  1. 进入"监控"
  2. 查看 CPU、内存、磁盘、网络使用情况

16.2 应用监控 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 查看项目运行状态和资源使用

16.3 查看日志 ​

  1. 进入"软件商店"
  2. 找到"Java 项目管理器"
  3. 找到项目
  4. 点击"日志"

17. 常见问题 ​

17.1 宝塔面板无法访问 ​

问题：无法访问宝塔面板

解决方案：

  1. 检查防火墙是否开放宝塔端口
  2. 检查宝塔服务是否运行
bash
bt status
  1. 重启宝塔服务
bash
bt restart

17.2 Java 项目启动失败 ​

问题：Java 项目无法启动

解决方案：

  1. 检查 JDK 版本是否正确
  2. 检查 Jar 包路径是否正确
  3. 检查端口是否被占用
  4. 查看项目日志

17.3 数据库连接失败 ​

问题：无法连接到数据库

解决方案：

  1. 检查 MySQL 是否启动
  2. 检查数据库配置是否正确
  3. 检查防火墙设置
  4. 检查数据库用户权限

17.4 Redis 连接失败 ​

问题：无法连接到 Redis

解决方案：

  1. 检查 Redis 是否启动
  2. 检查 Redis 配置是否正确
  3. 检查防火墙设置

17.5 Nacos 启动失败 ​

问题：Nacos 无法启动

解决方案：

  1. 检查 Nacos 配置是否正确
  2. 检查数据库连接是否正常
  3. 查看启动日志

18. 性能优化 ​

18.1 MySQL 优化 ​

  1. 进入"软件商店"
  2. 找到"MySQL"
  3. 点击"设置"
  4. 配置参数：
    • innodb_buffer_pool_size：1G
    • innodb_log_file_size：256M
    • innodb_flush_log_at_trx_commit：2
  5. 点击"保存"

18.2 Redis 优化 ​

  1. 进入"软件商店"
  2. 找到"Redis"
  3. 点击"设置"
  4. 配置参数：
    • maxmemory：1GB
    • maxmemory-policy：allkeys-lru
  5. 点击"保存"

18.3 JVM 参数优化 ​

在 Java 项目配置中优化 JVM 参数：

bash
-Xms1024m -Xmx1024m -XX:+UseG1GC -XX:MaxGCPauseMillis=200

19. 备份和恢复 ​

19.1 备份网站 ​

  1. 进入"网站"
  2. 找到要备份的网站
  3. 点击"备份"
  4. 点击"立即备份"

19.2 备份数据库 ​

  1. 进入"数据库"
  2. 找到要备份的数据库
  3. 点击"备份"
  4. 点击"立即备份"

19.3 恢复网站 ​

  1. 进入"网站"
  2. 找到要恢复的网站
  3. 点击"备份"
  4. 选择备份文件
  5. 点击"恢复"

19.4 恢复数据库 ​

  1. 进入"数据库"
  2. 找到要恢复的数据库
  3. 点击"导入"
  4. 选择备份文件
  5. 点击"开始导入"

20. 注意事项 ​

  1. 安全配置：定期修改宝塔密码，配置访问限制
  2. 资源管理：合理配置 JVM 参数，避免资源争抢
  3. 日志管理：定期清理日志文件，避免磁盘空间不足
  4. 备份策略：定期备份网站和数据库
  5. 监控告警：配置系统监控，及时发现问题
  6. 版本管理：记录应用版本，便于回滚
  7. 权限管理：合理配置文件和目录权限
  8. 网络配置：合理配置防火墙，确保安全性

21. 相关文档 ​