🚀 快速开始

本文档帮助你快速完成 WuEasy Admin 的完整部署，包含服务端、PC 端和移动端。

📐 系统架构

┌─────────────────────────────────────────────┐
│                  客户端                       │
│         PC 端 (Vue3)  /  移动端 (uni-app)     │
└──────────────────┬──────────────────────────┘
                   │ HTTP 请求
┌──────────────────▼──────────────────────────┐
│              管理端网关 :29813                │
│   签名验证 / 会话管理 / 验证码 / 路由转发      │
└──────────────────┬──────────────────────────┘
                   │ 内部转发
┌──────────────────▼──────────────────────────┐
│           管理端业务服务 :9813                │
│      账号 / 角色 / 菜单 / 字典 / 组织 ...     │
└──────────────────┬──────────────────────────┘
                   │
        ┌──────────┴──────────┐
        ▼                     ▼
   MySQL 数据库           Redis 缓存

📋 前置依赖

在开始之前，请确保以下服务已就绪：

依赖	版本要求	说明
MySQL	≥ 5.7	业务数据存储
Redis	≥ 5.0	会话缓存
Nacos	≥ 2.x（可选）	服务注册与发现，单机部署可关闭

单机快速部署

不使用 Nacos 时，在配置文件中将 nacos.discovery.enabled 和 nacos.config.enabled 设为 false 即可。

---

第一步：部署业务服务

1. 下载安装包

根据服务器架构选择对应版本：

Linux x86_64

wget https://software.wueasy.com/admin/latest/admin_linux_amd64.tar.gz
tar -zxvf admin_linux_amd64.tar.gz
chmod +x admin_linux_amd64

Linux ARM64

wget https://software.wueasy.com/admin/latest/admin_linux_arm64.tar.gz
tar -zxvf admin_linux_arm64.tar.gz
chmod +x admin_linux_arm64

Windows

# 下载并解压
https://software.wueasy.com/admin/latest/admin_win_64.zip

2. 配置文件

创建 config/config.yaml：

server:
  port: 9813
  name: admin

db:
  uri: admin:password@tcp(127.0.0.1:3306)/admin?charset=utf8mb4&parseTime=True&loc=Asia%2fShanghai
  max-open-conns: 200
  max-idle-conns: 10

redis:
  addrs: 127.0.0.1:6379
  password: "123456"
  db: 1

i18n:
  default-lang: zh

security:
  rsaPrivateKey: "your-rsa-private-key"
  firstLoginUpdatePwd: true
  failedLock: true
  failedMaxNum: 5
  lockMinutes: 60

nacos:
  server-addr: 127.0.0.1:8848
  discovery:
    enabled: false   # 单机部署设为 false
  config:
    enabled: false

完整配置说明请参考 业务服务部署

3. 安装并启动

Linux

# 安装为系统服务
sudo ./admin_linux_amd64 install

# 启动
sudo ./admin_linux_amd64 start

# 查看状态
sudo ./admin_linux_amd64 status

Windows（管理员）

admin_win_64.exe install
admin_win_64.exe start

---

第二步：部署网关

需要授权

网关为闭源部署包，需要授权文件才能启动。详见 网关部署

1. 下载网关包

# 参考网关文档获取下载地址
# https://gateway.wueasy.com/guide/getting-started.html

2. 关键配置

server:
  port: 29813
  name: gateway

gateway:
  routes:
    - id: admin
      uri: http://127.0.0.1:9813   # 指向业务服务
      predicates:
        - Path=/api/admin/**
      filters:
        - StripPrefix=2

  filter:
    merchant:
      enabled: true
      rules:
        - urls:
            - /api/admin/login
            - /api/admin/captcha
          apps:
            - app-id: admin
              app-secret: your-app-secret   # 与客户端配置保持一致

redis:
  addrs: 127.0.0.1:6379
  password: "123456"
  db: 6

完整配置说明请参考 网关部署

---

第三步：部署 PC 端

1. 修改配置

编辑 .env.production：

VITE_API_URL=https://your-domain.com/api
VITE_MERCHANT_APP_ID=admin
VITE_MERCHANT_APP_SECRET=your-app-secret
VITE_RSA_PUBLIC_KEY=your-rsa-public-key

2. 构建

yarn install
yarn build

构建产物在 dist/ 目录，部署到 nginx 静态目录即可。

详见 PC 端配置说明 和 nginx 配置

---

第四步：部署移动端

1. 修改配置

编辑 .env.production：

VITE_BASE_URL=https://your-domain.com/api
VITE_APP_ID=admin
VITE_APP_SECRET=your-app-secret
VITE_RSA_PUBLIC_KEY=your-rsa-public-key

2. 构建

使用 HBuilderX 打开项目，选择对应平台进行发行打包。

详见 移动端配置说明

---

✅ 验证部署

所有服务启动后，访问以下地址验证：

服务	地址	说明
业务服务	http://127.0.0.1:9813	直接访问业务接口
网关	http://127.0.0.1:29813	对外统一入口
PC 端	http://your-domain.com	管理后台

默认账号

首次部署后，使用初始化 SQL 中的默认账号登录，登录后请立即修改密码。

---

🔧 常见问题

Q: 服务启动后无法访问？

检查防火墙是否放行对应端口：

# CentOS
sudo firewall-cmd --add-port=29813/tcp --permanent && sudo firewall-cmd --reload
# Ubuntu
sudo ufw allow 29813/tcp

Q: 登录提示签名错误？

确认网关配置中的 app-secret 与客户端 .env 中的 APP_SECRET 完全一致。

Q: 如何查看服务日志？

# 查看实时日志
tail -f logs/app.log