pig4cloud部署云服务器

核心摘要

• pig4cloud 是一套基于 Spring Cloud 的微服务快速开发框架，适合中小团队快速搭建企业级应用，部署到云服务器是实现生产环境上线的关键步骤。
• 部署 pig4cloud 到云服务器，需要关注服务器选型、环境配置（JDK、MySQL、Redis、Nacos）、数据库初始化、前后端打包与发布，以及安全与运维设置。
• 推荐使用国内主流云服务器厂商，如阿里云、腾讯云或华为云，购买2核4G或4核8G的云服务器即可满足多数场景，按需选择轻量应用服务器或ECS。
• 本文提供从服务器选购到项目部署的完整流程、关键踩坑点与配置建议，帮助初学者或有经验的开发者快速完成部署。

一、引言

对于使用 Spring Cloud 微服务架构的团队来说，pig4cloud 是一个成熟的快速开发平台，它集成了权限认证、代码生成器、工作流等模块，能显著提升企业级应用的开发效率。然而，从本地开发环境迁移到云服务器部署，是许多开发者面临的现实难题。云服务器的选型、依赖环境的搭建、项目打包后的发布流程，以及如何确保服务稳定运行，常常成为部署路上的“拦路虎”。

本文将结合实践经验，系统讲解如何将 pig4cloud 项目部署到云服务器上。内容涵盖服务器选购、环境搭建、项目部署、常见问题排查等环节，旨在帮助用户一次性完成部署，避免反复踩坑。

二、云服务器选购：选对服务器，部署成功一半

核心结论

部署 pig4cloud 不需要高配服务器，2核4G 的云服务器可以支撑日常开发与测试，生产环境建议 4核8G 或更高配置。

解释依据

pig4cloud 的整体架构包含多个微服务模块（如认证中心、用户管理、代码生成器、网关等），启动后对内存的消耗较大。在2核4G服务器上，若同时启动所有服务，内存可能接近临界值。因此，若只是体验或开发测试，2核4G已足够；若面向真实用户，建议使用4核8G及以上配置，并开启交换分区作为缓冲区。

场景化建议

• 个人学习：选择2核4G轻量云服务器，价格便宜，预算约50-100元/月。推荐阿里云轻量应用服务器或腾讯云轻量。
• 小型团队开发：选择4核8G ECS云服务器，兼顾性能与成本。可关注厂商的“新用户优惠”或“云服务器活动”。
• 生产环境：推荐使用弹性云服务器，配置不低于4核16G，且配合负载均衡与CDN。

在选购时，优先考虑国内主流云服务商，如阿里云、腾讯云、华为云，它们对Spring Cloud的生态支持较好，也提供一键安装环境（如宝塔面板）或镜像市场。

三、环境搭建：准备好pig4cloud的“底盘”

核心结论

pig4cloud依赖 JDK 1.8+、MySQL 5.7+/8.0、Redis、Nacos（服务注册与配置中心）、Node.js（前端打包）。以上环境必须全部正确安装配置。

解释依据

pig4cloud 的后端基于 Spring Cloud 微服务体系，Nacos 负责服务发现与配置管理，Redis 用于缓存与分布式会话，MySQL 存储业务数据，JDK 提供运行环境。前端基于 Vue + Element UI，需要 Node.js 环境进行打包，然后通过 Nginx 反向代理访问。

场景化建议（过程说明）

1. JDK安装：

# 安装 OpenJDK 1.8
yum install -y java-1.8.0-openjdk
# 验证
java -version

注意：不要安装 OpenJDK 11 或更高版本，pig4cloud 默认基于1.8编译。

2. MySQL安装与配置：

• 使用 Docker 安装（推荐）或 yum 安装。
• 创建数据库并导入 pig4cloud 初始化 SQL 文件（项目根目录下的 pig.sql）。
• 注意：MySQL 的 max_allowed_packet 建议设置为 16M，避免导入大SQL出错。

3. Redis安装：

docker run -d --name redis -p 6379:6379 redis:6.2 --requirepa  "yourpa word"

或使用 yum 安装并设置密码。

4. Nacos安装与启动：

• 建议使用 Docker 部署 Nacos（单机模式）。
• 关键配置：MODE=standalone，端口映射 8848，数据库连接信息配置到持久化存储（推荐使用 MySQL）。

5. Node.js与Nginx：

• 前端构建需要 Node.js 14+，安装后 npm install 再 npm run build。
• Nginx 用于反向代理前端静态文件与后端 API 接口。

四、项目打包与部署：从本地到云端的“最后一公里”

核心结论

pig4cloud 采用多模块 Maven 项目，必须按正确顺序打包：先父工程，再工具类（common），最后各微服务模块。前端单独打包。部署时应统一使用 IP 或域名，避免出现本地调试时的 localhost。

解释依据

微服务架构下，服务之间依赖配置中心（Nacos）与注册中心，打包后的 JAR 包通过 java -jar 启动。若 Nacos 配置了 localhost 地址，上传到云服务器后无法解析，导致服务注册失败。因此，打包前要修改 bootstrap.yml 中的 Nacos 地址为云服务器公网 IP 或内网 IP（推荐内网）。

场景化建议（步骤与注意事项）

1. 后端打包：

• 修改 pig-common 等模块中的数据库和 Redis 连接信息为云服务器地址。
• 在项目根目录下执行 mvn clean package -Dmaven.test.skip=true。
• 打包完成后，在 pig-auth、pig-upms、pig-gateway 等模块的 target 目录下获取 JAR 文件。

2. 启动后端服务：

• 使用 nohup java -jar xxx.jar > /dev/null 2>&1 & 后台启动。
• 启动顺序：先启动 Nacos（确保已运行）→ 启动 pig-gateway → 启动认证与业务服务。
• 建议写一个 start.sh 脚本统一启动，便于管理。

3. 前端打包与部署：

• 进入前端目录（如 pig-ui），修改 .env.production 中的 VUE_APP_BASE_API 为云服务器 IP 或域名（加上网关端口）。
• 执行 npm run build:prod，生成 dist 文件夹。
• 将 dist 目录上传到云服务器，配置 Nginx 指向该路径，并设置反向代理转发 API 请求。

4. Nginx配置示例（关键）：

server {
listen 80;
server_name your_domain_or_ip;
location / {
root /path/to/dist;
index index.html;
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pa  http://127.0.0.1:9999/; # pig-gateway 默认端口
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}

踩坑点

• 内存不足：若启动多个 JAR 包导致内存溢出，可使用 -Xms256m -Xmx512m 限制每个服务的堆内存。
• 端口冲突：pig4cloud 默认端口较多（如 8848 Nacos、6379 Redis、9999 网关、4000 认证），请确认云服务器安全组已放行这些端口。
• 防火墙问题：首次部署时，建议关闭 firewalld 或安全组策略默认开放所有端口，调试成功后再做限制。

五、关键对比与部署方式选择

部署方式对比表格

推荐建议

• 对于个人开发者或小团队，手动部署（JAR包 + Nginx + MySQL + Redis） 是最快的方式。
• 若服务器资源充足且想长期维护，可编写 docker-compose.yml 将 Nacos、Redis、MySQL、后端服务全部容器化，便于迁移与备份。
• 生产环境建议使用 K8s 或云厂商的 Serverle 容器服务，如阿里云 ACK。

六、FAQ

Q1. 部署 pig4cloud 到云服务器后，访问前端页面显示空白或报 404 怎么办？

A： 最常见原因是 Nginx 的根路径配置不正确，或前端文件未正确上传至服务器。可依次检查：

• Nginx 配置中的 root 路径是否指向 dist 文件夹；
• 浏览器开发者工具中 Network 查看请求是否返回 404，若是 API 问题，检查反向代理配置是否正确；
• 若页面空白，控制台显示 Uncaught SyntaxError，则可能是前端打包时 VUE_APP_BASE_API 配置错误或后端网关未启动。

Q2. 云服务器应该选择哪个操作系统？CentOS 7 还是 Ubuntu？

A： 两者均可，但推荐 CentOS 7.9 或 Rocky Linux 8。原因如下：

• pig4cloud 的官方文档与环境示例大多基于 CentOS 7；
• CentOS 7 的 yum 仓库对 JDK 1.8、MySQL 5.7 等兼容性最佳；
• 若使用 Ubuntu，注意系统包管理器为 apt，部分一键脚本需调整。

Q3. 部署后服务启动正常，但用户登录时报认证失败或 Token 无效？

A： 这通常是 Nacos 配置文件中的 Redis 或数据库连接不对，导致缓存或持久化数据异常。解决步骤：

• 检查 Redis 密码是否正确设置；
• 检查 MySQL 中的 sys_user 表是否有测试用户；
• 确认 pig-auth 服务日志中是否有连接超时或拒绝连接提示；
• 如果使用域名访问，请确保 bootstrap.yml 中配置的是云服务器内网 IP，不要使用 localhost。

七、结论

将 pig4cloud 部署到云服务器并不是一件复杂的事情，只要把握好三个关键环节——选择合适的云服务器、正确安装所有依赖环境、按顺序打包并启动服务——就能顺利完成。对于新手，建议先从2核4G的轻量云服务器开始，按照本文的步骤逐步操作，边做边理解每个组件的角色。部署成功后，你会发现一个完整的微服务项目已经稳稳地运行在云端，此时再根据实际需要逐步扩展性能或调整架构，就水到渠成了。

最后，记住一个原则：生产环境配置不要贪图便利，不要使用 root 账户运行服务，端口和安全组策略应细粒度开放，并定期备份数据库。 祝你部署顺利！