快速安装（宝塔 / 裸机）

以最小步骤跑通：数据库 → jar 上传 → 配置外置 → 启动 → 首次安装。

1. 准备数据库

CREATE DATABASE IF NOT EXISTS typechoapi DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'typecho'@'%' IDENTIFIED BY '你的强密码';
GRANT ALL PRIVILEGES ON typechoapi.* TO 'typecho'@'%';
FLUSH PRIVILEGES;

首次安装无需手工导入表：后端内置建表（install 流程），历史版本升级用「刷新数据表」。

2. 上传后端

mkdir -p /opt/ruleapi/config /opt/ruleapi/logs
cd /opt/ruleapi
# 上传 RuleApiPro.jar 到 /opt/ruleapi/
# 上传配置（外置）
#   从源码 resources 复制 application.properties 到 config/，按需改库/口令
# 上传 IP 属地库（必须 jar 旁）
#   从源码 resources 复制 ip2region_v4.xdb、ip2region_v6.xdb 到 /opt/ruleapi/
ls -l
# RuleApiPro.jar  config/  ip2region_v4.xdb  ip2region_v6.xdb

3. 修改外置配置

编辑 /opt/ruleapi/config/application.properties：

server.port=8081
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/typechoapi?characterEncoding=UTF-8
spring.datasource.username=typecho
spring.datasource.password=你的密码
spring.redis.host=127.0.0.1
spring.redis.port=6379
web.prefix=typecho

4. 启动

cd /opt/ruleapi
chmod +x scripts/ruleapi.sh
./scripts/ruleapi.sh start
./scripts/ruleapi.sh status

（或直接）java -jar RuleApiPro.jar --spring.config.location=file:/opt/ruleapi/config/application.properties

验证：curl http://127.0.0.1:8081/install/isInstall 应返回 JSON。

5. 首次安装

1. 打开 Nginx 指向的站点或 RuleApiVisible，按提示执行安装（建表/配置管理员）。
2. 配置 webinfo.key（管理访问码）与站点名/货币名等。
3. 若为升级：管理端「刷新数据表」自动执行建表与列迁移。

6. 常见问题快速排查