📦 软件安装指南

📋 前置准备

在开始安装之前，请确保您的服务器满足以下要求：

系统要求

操作系统：支持 Linux (CentOS, Ubuntu, Debian 等) / Windows / macOS
系统架构：仅支持 64 位系统 (x86_64/AMD64, ARM64)
内存要求：建议 ≥ 1GB
磁盘空间：建议 ≥ 10GB
端口要求：默认占用 9813 端口（可在配置文件中修改）

📥 下载安装包

根据您的服务器架构选择对应的安装包：

WindowsLinux x86_64Linux ARM64macOS

shell

# Windows 64位
https://software.wueasy.com/admin/latest/admin_win_64.zip

shell

# Linux (Intel/AMD处理器)
https://software.wueasy.com/admin/latest/admin_linux_amd64.tar.gz

shell

# Linux (飞腾/鲲鹏等ARM处理器)
https://software.wueasy.com/admin/latest/admin_linux_arm64.tar.gz

shell

# Mac (M1/M2/M3芯片)
https://software.wueasy.com/admin/latest/admin_mac_arm64.tar.gz

# Mac (Intel处理器)
https://software.wueasy.com/admin/latest/admin_mac_amd64.tar.gz

如何查看系统架构？

在 Linux/macOS 终端执行 uname -m：

输出 x86_64：选择 Linux x86_64 或 Mac Intel 版本
输出 aarch64 或 arm64：选择 Linux ARM64 或 Mac ARM64 版本

🚀 快速安装

1. 解压文件

建议将程序安装在 /srv/admin (Linux) 或 C:\admin (Windows) 目录下。

Linux/macOSWindows

bash

# 1. 创建目录并下载（以Linux x86_64为例）
mkdir -p /srv/admin && cd /srv/admin
wget https://software.wueasy.com/admin/latest/admin_linux_amd64.tar.gz

# 2. 解压文件
tar -zxvf admin_linux_amd64.tar.gz

# 3. 赋予执行权限
chmod +x admin_linux_amd64

cmd

# 1. 下载压缩包并解压
# 2. 将解压后的文件夹移动到 C:\admin
# 3. 进入目录
cd C:\admin

2. 安装服务

⚠️ 重要提醒

必须先执行 install 命令！这会将网关注册为系统服务，确保能通过系统命令管理并在后台运行。

LinuxWindows

bash

# 需要 root 权限
sudo ./admin_linux_amd64 install

# 成功输出：
# 安装服务成功

cmd

# 以管理员身份运行 CMD
admin_win_64.exe install

# 成功输出：
# 安装服务成功

3. 启动服务

LinuxWindows

bash

# 启动服务
sudo ./admin_linux_amd64 start

# 或者使用 systemctl
sudo systemctl start admin

cmd

# 启动服务
admin_win_64.exe start

4. 验证安装

服务启动后（默认端口 8080），可以通过以下方式验证：

命令行验证浏览器验证

bash

# 检查端口监听
netstat -tlnp | grep 8080

# 发送测试请求
curl http://127.0.0.1:8080/

bash

# 在浏览器访问
http://localhost:8080/

5. 配置文件设置（可选）

推荐配置结构

为了更好地组织配置文件，建议创建 config/ 子目录：

Linux/macOSWindows

bash

# 创建配置目录
mkdir -p config/i18n

# 将配置文件移入（如果已存在）
# mv config.yaml config/
# mv i18n/* config/i18n/

cmd

# 创建配置目录
mkdir config
mkdir config\i18n

# 将配置文件移入（如果已存在）
# move config.yaml config\
# move i18n\* config\i18n\

程序会自动按以下优先级查找配置：

优先：config/config.yaml 和 config/i18n/
备选：根目录的 config.yaml 和 i18n/

6.配置参考

yaml

server: 
  port: 9813 #服务端口
  name: admin #应用名称
log:
  level: info
nacos:
  server-addr: ${NACOS_SERVER_ADDR:192.168.3.179:8848}  #地址，多个逗号分隔
  username: ${NACOS_USERNAME:dev}
  password: ${NACOS_PASSWORD:dev}
  config:
    namespace: ${NACOS_NAMESPACE:dev}
    group: ${NACOS_GROUP:dev}
    enabled: false
  discovery:
    namespace: ${NACOS_NAMESPACE:dev}
    group: ${NACOS_GROUP:dev}
    enabled: false
    # metadata:  #元数据
    #   version: gray-2  # 指定灰度版本号
    #ip: 192.168.3.54   #指定本机ip
    #port: 9720 #服务端口
db:
  uri: admin:123456@tcp(127.0.0.1:3306)/admin?charset=utf8mb4&parseTime=True&loc=Asia%2fShanghai #数据库连接
  max-open-conns: 200 #最大连接数
  max-idle-conns: 10 #最大空闲连接数
  show-sql: true #是否输出SQL日志（需同时将log.level设为debug）
# Redis配置
redis:
  addrs: 192.168.3.181:6379
  password: "123456"
  db: 1
# 安全登录配置
i18n:
  default-lang: zh  # 默认语言（zh/en）
security:
  rsaPrivateKey: "MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDFjA530trHmOojT6FxyteAmSnsstoVek0wl2OlKgf8KRwP5BjhIqVwwunW8G9Xg9z1kYn96u9vB1PO0AG+Jc0UVQW1kGH3Rqa3UeVrepPPgwZJca/9qRyM6OHxOoodj6aMedA5PCTcTOC4GURlvjSgf5hKGiNWRfSyfe1J1qdNq7Kooh/vVONinGtYnDonlBsH8Igd038j7Has/JUj5xnT51g2REKAC2V5Yos+rLjvPhDn3KGpyu6TLsJr+zwIbYRGH84ViYu1DNPPq7zqJdxSgDcJJWUx/YUxWbZRIsLkNj4k5FbHbtMrNLT84CXZaTheTjs7XSXm0TI1whzHWpvrAgMBAAECggEBAIE6ddx82xHnPoOK/Bnsj71YdMya039pWkWHQ3AwZrjWS705ge0FNSTm3QH2l1+wq0MZyiOJJMiFCpYoDHvPTrEWTX3QzcVtOnKB6Iq+zSLam6o/7NkLX9nuHqAno2JjLpiGt2g5qANVZ0wHe27zVooH7h/LqYIukTySlD/RY/CyUtQ7aw5jrgSIOqIlaBwqhlX8gLh0W2pp5xlxcUiuDUhnIP4LymsuiaHdyJue/nyb89cBmwd54JaupDnNkFi8p7hhnZcjhZrowNuomp9kZYOG8eob3x29K5hs9LGJ/oiri547w2puGW0FL3elZtyYAKvt9WC+f0QiaINgh4dOo0ECgYEA6ujJquEnoFoPbbphISzXZyjRCs7NMAF1X9bXg3XLOr2iJ8DYJs84uMdy45N5t3txb9KHIYQMWmJUHIlKaqXmM0l8inIIdKULPbATLJSFIyRfUptGbDjGldKs4SE95c0zYdQemA5lV8eUth1ar5bQGxj6cmv0YDgTW8iLvgDcHp8CgYEA10iGuhKIC+fKec5iBEkctKICEiF4K4FmgQJsqQDNimZauavaBj+BrO524JoyCaW0W/121PsOcznjIjp7QTmPSo47qbgJ7FFRVwpglma8QeYQhb4XGFlNbUInMG/dsps59jJAQ/bj6WKVE8SAjPBkfO5MX0s0zFrMqpY9nSoCmzUCgYBBoxn2bUMtQvzcpB9Prb/iSz1dz7r1lvK8/MLrMJbAqwwMH45GCdDHkLNBc4unAQ8JN8IaU1NATglCj/oDIqfX3Mi3xnUmYpdpfTFeW4F3+EnKQyjCRHr4kg1MOoWZGGUrCKIjyqH2jQW4fStBtNohODGClzeJSyHdm4Owa30V8QKBgQDPSACYlhExzVrxjtpnH/IopbhytpEa6nvEiY4P5zsAH+8IyMOisnDsDaqeNTkqesa+r7xD8vqFzV25bi+QrJggA/TEQ/Qh+mXj9ZTsGzz2Aks0SsO36PwYz9Il2//M4ZKcTuP7zHLDGu1I3DGeAjPu6g7UzfenL2HSedgXRATAZQKBgAXMijH5waNFTX1CPHCtXTaE6iwJLEI60DtLTnWhWVIDZaUI9GiFoui8ca1jilHuWMxoDTUN8k/qlpHpLoEZrllwN9SWiK3AQRg2+Uj+bBz2vbIZsREPRHuf5YqDXB3An5hBNjL0M8uCvBFBT0KfWxxBNT0YdJ3CVUkGWkADEsIH"             #RSA密码私钥
  firstLoginUpdatePwd: true    #首次登录修改密码
  resetLoginUpdatePwd: true    #重置密码后修改密码
  pwdExpire: false              #密码过期
  pwdExpireDays: 90             #密码过期时间（天）
  failedLock: true              #连续登录失败锁定
  failedMaxNum: 5               #连续登录失败次数
  failedMinutes: 60             #连续登录失败间隔时间（分钟）
  lockMinutes: 60               #连续登录失败锁定时间（分钟）

# 配置加密配置
configEncrypt:
  sm4Key: "1234567890abcdef"   # SM4加密密钥(必须16字节)

📂 目录结构说明

安装完成后的建议目录结构如下：

plaintext

/srv/admin/
├── admin_linux_amd64    # 主程序文件
├── config.yaml           # 配置文件（根目录，可选）
├── config/               # 配置目录（推荐）
│   ├── config.yaml      # 主配置文件
│   └── i18n/            # 国际化配置目录
│       ├── zh-CN.yaml   # 中文配置
│       ├── en-US.yaml   # 英文配置
│       └── ...          # 其他语言配置
├── i18n/                 # 国际化配置目录（根目录，可选）
├── logs/                 # 日志目录
│   ├── app.log          # 应用日志
└── license.dat           # 授权文件

配置文件优先级

程序会按以下优先级查找配置文件：

config 子目录：优先从 config/config.yaml 和 config/i18n/ 读取（推荐）
根目录：如果 config/ 目录不存在，则从根目录的 config.yaml 和 i18n/ 读取

建议使用 config/ 子目录，这样可以更好地组织配置文件，保持根目录整洁。

🛠️ 命令参考手册

服务管理命令

功能	Linux 命令	Windows 命令	说明
安装服务	`./admin install`	`admin.exe install`	注册系统服务（首选）
启动服务	`./admin start`	`admin.exe start`	启动后台服务
停止服务	`./admin stop`	`admin.exe stop`	停止后台服务
重启服务	`./admin restart`	`admin.exe restart`	重启服务
查看状态	`./admin status`	`admin.exe status`	查看运行状态
卸载服务	`./admin uninstall`	`admin.exe uninstall`	移除系统服务

注：命令中的 admin 指代实际的程序名称，如 admin_linux_amd64。

系统服务管理 (Linux Only)

安装后，您也可以使用标准的 systemctl 命令管理：

bash

# 启动/停止/重启
sudo systemctl start admin
sudo systemctl stop admin
sudo systemctl restart admin

# 查看状态
sudo systemctl status admin

# 开机自启设置
sudo systemctl enable admin  # 开启自启
sudo systemctl disable admin # 关闭自启

🔧 常见问题 (FAQ)

Q1: 启动时提示 "Permission denied"？

A: 权限不足。请确保：

程序文件有执行权限：chmod +x admin_linux_amd64
使用 sudo 或 root 用户执行命令。

Q2: 执行 start 命令无反应或失败？

确保已经先执行了 install 命令。
检查日志文件（通常在 logs/ 目录下）查看错误信息。

Linux 下检查 SELinux 设置：

bash

# 临时测试是否为 SELinux 问题
sudo setenforce 0

# 永久修复文件上下文
sudo chcon -R -t bin_t /srv/admin/admin_linux_amd64

Q3: 如何修改默认端口？

A: 修改配置文件（推荐在 config/config.yaml，如果没有请新建），添加如下配置：

yaml

server:
  port: 9090 # 修改为你需要的端口

修改后需重启服务：./admin restart。

配置文件位置

推荐：创建 config/config.yaml（程序会优先读取此位置）
备选：在根目录创建 config.yaml（当 config/ 目录不存在时使用）

Q4: 无法从外部访问？

A: 请检查服务器防火墙设置，放行对应端口：

bash

# CentOS/RedHat (firewalld)
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --reload

# Ubuntu/Debian (ufw)
sudo ufw allow 8080/tcp

Q5: 如何组织配置文件？

A: 推荐使用 config/ 子目录来管理所有配置文件：

bash

# 创建配置目录结构
mkdir -p config/i18n

# 将配置文件放入 config 目录
mv config.yaml config/
mv i18n/* config/i18n/

优势：

✅ 根目录更整洁，只保留可执行文件和授权文件
✅ 配置文件集中管理，便于备份和迁移
✅ 程序会自动优先读取 config/ 目录下的配置
✅ 如果 config/ 目录不存在，会自动降级到根目录读取（向后兼容）

Q6: 配置文件在哪里？

A: 程序启动时会在日志中输出配置文件的实际读取位置：

配置根目录: /srv/admin/config
初始化国际化配置，默认语言: zh-CN, i18n目录: /srv/admin/config/i18n

查看日志即可确认程序使用的配置路径。

📦 软件安装指南 ​

📋 前置准备 ​

📥 下载安装包 ​

🚀 快速安装 ​

1. 解压文件 ​

2. 安装服务 ​

3. 启动服务 ​

4. 验证安装 ​

5. 配置文件设置（可选） ​

6.配置参考 ​

📂 目录结构说明 ​

🛠️ 命令参考手册 ​

服务管理命令 ​

系统服务管理 (Linux Only) ​

🔧 常见问题 (FAQ) ​

Q1: 启动时提示 "Permission denied"？ ​

Q2: 执行 start 命令无反应或失败？ ​

Q3: 如何修改默认端口？ ​

Q4: 无法从外部访问？ ​

Q5: 如何组织配置文件？ ​

Q6: 配置文件在哪里？ ​

📦 软件安装指南

📋 前置准备

📥 下载安装包

🚀 快速安装

1. 解压文件

2. 安装服务

3. 启动服务

4. 验证安装

5. 配置文件设置（可选）

6.配置参考

📂 目录结构说明

🛠️ 命令参考手册

服务管理命令

系统服务管理 (Linux Only)

🔧 常见问题 (FAQ)

Q1: 启动时提示 "Permission denied"？

Q2: 执行 start 命令无反应或失败？

Q3: 如何修改默认端口？

Q4: 无法从外部访问？

Q5: 如何组织配置文件？

Q6: 配置文件在哪里？