切换主题
🚀 快速开始
📋 系统要求
系统兼容性
仅支持64位操作系统,请确保满足以下要求
配置项 | 最低要求 | 推荐配置 | 说明 |
---|---|---|---|
CPU | 2核 64位 | 4核+ | 仅支持x86_64/ARM64 |
内存 | 2GB | 4GB+ | 可用内存 |
磁盘 | 20GB | 50GB+ | 系统盘剩余空间 |
操作系统 | Windows/Linux | - | 64位系统 |
数据库 | MySQL 5.7 | MySQL 8.0 | 支持utf8mb4 |
📥 下载安装包
bash
# Windows 64位安装包
wget https://software.wueasy.com/app-upgrade/latest/app_upgrade_win_64.zip
bash
# Linux AMD64安装包
wget https://software.wueasy.com/app-upgrade/latest/app_upgrade_linux_amd64.zip
# 解压到指定目录
unzip app_upgrade_linux_amd64.zip -d /srv/app-upgrade
chmod +x /srv/app-upgrade/app_upgrade_linux_amd64
bash
# Linux ARM64安装包
wget https://software.wueasy.com/app-upgrade/latest/app_upgrade_linux_arm64.zip
# 解压到指定目录
unzip app_upgrade_linux_arm64.zip -d /srv/app-upgrade
chmod +x /srv/app-upgrade/app_upgrade_linux_arm64
⚙️ 配置文件
目录结构
bash
app-upgrade/
├── config.yaml # 主配置文件
├── app_upgrade_linux_amd64 # Linux执行文件
└── logs/ # 日志目录
├── app-upgrade.log # 运行日志
配置示例
yaml
# 服务基础配置
server:
port: 9820 # 服务监听端口
name: app-upgrade # 应用名称
# Nacos服务注册配置(可选)
nacos:
enabled: false # 是否启用Nacos
server-addr: nacos.lb.wueasy.cn:8848 # Nacos服务器地址
username: example # Nacos用户名
password: example # Nacos密码
group: dev # 服务分组
namespace: dev # 命名空间
#ip: 192.168.3.54 # 可选:指定服务IP
#port: 9720 # 可选:指定服务端口
# 数据库配置
db:
uri: app_upgrade:123456@tcp(127.0.0.1:3306)/app_upgrade?charset=utf8mb4&parseTime=True&loc=Asia%2fShanghai
max-open-conns: 200 # 最大连接数
max-idle-conns: 10 # 最大空闲连接数
配置项说明
分类 | 配置项 | 必填 | 说明 | 默认值 |
---|---|---|---|---|
服务配置 | server.port | 是 | 服务监听端口 | 9820 |
server.name | 是 | 服务名称 | app-upgrade | |
Nacos配置 | nacos.enabled | 否 | 是否启用Nacos | false |
nacos.server-addr | 否 | Nacos服务器地址 | - | |
nacos.username | 否 | Nacos用户名 | - | |
nacos.password | 否 | Nacos密码 | - | |
nacos.group | 否 | 服务分组 | dev | |
nacos.namespace | 否 | 命名空间 | dev | |
数据库配置 | db.uri | 是 | 数据库连接串 | - |
db.max-open-conns | 否 | 最大连接数 | 200 | |
db.max-idle-conns | 否 | 最大空闲连接 | 10 |
📦 部署安装
Linux环境安装
bash
# 1. 创建安装目录
mkdir -p /srv/app-upgrade
cd /srv/app-upgrade
# 2. 复制文件
cp app_upgrade_linux_amd64 config.yaml /srv/app-upgrade/
# 3. 设置权限
chmod +x app_upgrade_linux_amd64
chmod 640 config.yaml
# 4. 创建日志目录
mkdir -p /var/log/app-upgrade
chmod 755 /var/log/app-upgrade
# 5. 安装并启动服务
./app_upgrade_linux_amd64 install
./app_upgrade_linux_amd64 start
✅ 部署验证
1. 服务状态检查
bash
# Linux环境
systemctl status app-upgrade.service | grep Active
2. 日志检查
bash
# 检查运行日志
tail -f /var/log/app-upgrade/app-upgrade.log
3. 接口测试
bash
# 版本检查接口
curl "http://localhost:9820/checkVersion?appNo=demo&channelNo=none&platform=ANDROID&version=1.0.0"
🔍 故障排查
常见问题
服务启动失败
bash# 检查端口占用 netstat -tunlp | grep 9820 # 检查日志 tail -f /var/log/app-upgrade/app-upgrade.log
数据库连接失败
bash# 检查数据库连接 mysql -h 127.0.0.1 -u app_upgrade -p app_upgrade # 验证数据库权限 SHOW GRANTS FOR 'app_upgrade'@'localhost';
配置文件错误
bash# 检查配置文件权限 ls -l config.yaml # 验证配置文件格式 yaml-lint config.yaml
运维建议
- 定期检查服务状态
- 监控系统资源使用
- 及时清理日志文件
- 定期备份配置文件