Skip to content

Mac系统部署指南 💻

概述

Gateway服务是一个基于Spring Cloud的微服务网关,提供了强大的路由转发、安全认证等功能。本指南将帮助您在Mac系统上完成Gateway服务的部署。

系统要求

  • macOS 10.15+
  • 最小内存:2GB
  • 磁盘空间:500MB
  • Java 17+

安装准备

下载安装包

bash
# M1/M2 芯片的Mac系统
curl -O https://software.wueasy.com/gateway/latest/gateway_mac_arm64.zip

⚠️ 注意:这是体验版安装包。如需正式版本,请联系:

  • 📞 QQ:535412000
  • 📧 邮箱:server@wueasy.com

环境配置

必要配置

环境变量说明默认值示例值
GATEWAY_SPRING_APPLICATION_NAME应用名称gatewaygateway-prod
GATEWAY_NACOS_SERVER_ADDRNacos地址-10.10.10.10:8848
GATEWAY_NACOS_USERNAMENacos用户名-nacos
GATEWAY_NACOS_PASSWORDNacos密码-password123
GATEWAY_NACOS_GROUP配置分组-PROD_GROUP
GATEWAY_NACOS_NAMESPACE命名空间-prod

可选配置

环境变量说明默认值示例值
GATEWAY_NACOS_DISCOVERY_IP服务注册IP自动获取192.168.1.100
GATEWAY_NACOS_DISCOVERY_PORT服务注册端口服务端口8080

部署步骤

1. 创建部署目录

bash
# 创建并进入部署目录
mkdir -p ~/gateway
cd ~/gateway

# 解压安装包
unzip gateway_mac_arm64.zip

2. 配置环境变量

bash
# 在当前终端会话中配置
export GATEWAY_SPRING_APPLICATION_NAME=gateway
export GATEWAY_NACOS_SERVER_ADDR=127.0.0.1:8848
export GATEWAY_NACOS_USERNAME=nacos
export GATEWAY_NACOS_PASSWORD=123456
export GATEWAY_NACOS_GROUP=dev
export GATEWAY_NACOS_NAMESPACE=dev
bash
# 编辑 ~/.zshrc 或 ~/.bash_profile
echo '# Gateway环境变量
export GATEWAY_SPRING_APPLICATION_NAME=gateway
export GATEWAY_NACOS_SERVER_ADDR=127.0.0.1:8848
export GATEWAY_NACOS_USERNAME=nacos
export GATEWAY_NACOS_PASSWORD=123456
export GATEWAY_NACOS_GROUP=dev
export GATEWAY_NACOS_NAMESPACE=dev' >> ~/.zshrc

# 使配置生效
source ~/.zshrc

3. 设置权限

bash
# 添加执行权限
chmod u+x gateway
chmod u+x run.sh

4. 服务管理

bash
./run.sh start
bash
./run.sh stop
bash
./run.sh restart
bash
./run.sh status
bash
./run.sh log

故障排除

常见问题

服务无法启动
  1. 检查环境变量是否正确配置
bash
# 验证环境变量
env | grep GATEWAY_
  1. 检查端口占用
bash
# 检查8080端口占用
lsof -i :8080
  1. 查看详细日志
bash
tail -f logs/gateway.log
服务异常退出
  1. 检查系统资源
bash
# 查看内存使用
top -l 1 | grep PhysMem
  1. 检查日志错误
bash
grep "ERROR" logs/gateway.log

日志分析

Gateway服务的日志文件位于 logs 目录下:

  • gateway.log - 主日志文件

技术支持

如果您在部署过程中遇到问题,可以通过以下方式获取帮助:

联系我们: - 📞 QQ:535412000 - 📧 邮箱:server@wueasy.com