跳到主要内容

🚀 AikanPro API 安装

API 核心服务

AikanPro API 是系统的核心服务,提供数据接口和业务逻辑处理

🔧

全自动安装

一键脚本快速部署

⚙️

手动安装

完全可控的部署方式

🌐

反向代理

域名访问配置

🎯 快速导航

📹 在线视频教程

🎥 视频安装教程

⚙️ 系统要求

💻 配置要求

📊 硬件配置

最低配置
  • • CPU: 1核
  • • 内存: 700MB
推荐配置
  • • CPU: 2核
  • • 内存: 2GB

🖥️ 系统环境

  • 系统:CentOS 7.9(其他系统命令大同小异)
  • Java:JDK 1.8 及以上版本
  • 仅限 AikanPro 正式用户,AikanFree 用户请查看开源版安装

⚠️

重要提醒

部署 AikanPro 版之前,请先停止之前的版本,这个很重要,不然可能会造成数据文件损坏。

🛠️ 环境准备

🔧 安装环境要求

由于软件运行环境原因,系统必须安装以下环境,请提前部署,以免在正式安装造成安装问题。

🐘

PHP 7.2

需要安装插件 SG15 和 Redis。

SG15 安装教程

📦

Redis (5.0-7.0)

推荐 6.0 版本,Redis 是现在最受欢迎的 NoSQL 数据库之一。

🗄️

MySQL (5.5-5.7)

推荐 5.6 版本

🌐

Nginx

稳定版即可,没有版本要求

📦 配置文件准备

📋 必需文件清单

购买后请联系负责人,获取以下文件,缺一不可!

AikanProApi.jar

核心 API 服务文件

🐘

AikanPro(PHP 后台)

管理后台程序

📱

App 源码

移动应用源代码

💡 建议安装顺序:AikanProApi.jar → AikanPro(PHP后台)→ App 源码

🤖 第一种:全自动安装

🚀 一键自动部署

⚠️

重要注意事项

  • • 选择全自动安装请不要在服务器自己安装 Java 环境和 Tomcat
  • • 这将直接导致 API 安装后无法运行
  • • 并且造成后续的一系列问题,相当于五分钟的事情变成一两个小时搞不定

1️⃣

执行安装脚本

首先,执行如下命令,进入服务器 opt 目录:

cd /opt

📞 获取脚本:请联系作者获取最新的安装脚本

2️⃣

按照脚本提示输入信息

配置参数说明:
  • 运行端口:输入 8080 或其它端口,千万别 80 或 443
  • 数据库信息:如果安装了 Typecho,填写一致的数据库信息
  • Redis 密码:一般为空
  • 系统管理密码:建议英文加数字,也叫访问 Key

3️⃣

外网访问配置

安装完成 AikanProApi 后,需要配置反向代理才能外网访问。

配置步骤:
  • 1. 新建纯静态网站(不需要 FTP 和数据库)
  • 2. 分配单独域名(一般是二级域名)
  • 3. 配置 SSL 证书
  • 4. 添加反向代理配置
Nginx 反向代理配置:
location ^~ / {
  add_header 'Access-Control-Allow-Origin' '*';
  add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE';
  add_header 'Access-Control-Allow-Credentials' 'true';
  add_header 'Access-Control-Allow-Headers' 'Authorization,Content-Type,Accept,Origin,User-Agent,DNT,Cache-Control,X-Mx-ReqToken,X-Data-Type,X-Requested-With,X-Data-Type,X-Auth-Token';
  if ( $request_method = 'OPTIONS' ) { 
    return 200;
  }
  proxy_pass http://127.0.0.1:8080;  # 8080 要以你实际端口为准
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header REMOTE-HOST $remote_addr;
}

🎉 安装完成

访问您配置的域名,看到如下界面表示安装成功。点击"安装程序"按钮,输入系统管理密钥即可完成安装。

安装成功界面

🛠️ 第二种:纯手动安装

⚙️ 手动部署(推荐)

1️⃣

获取安装文件

⚠️

重要提醒

在完成环境准备后,将以下三个文件放进一个英文文件夹(如:/usr/local/aikanpro/), 上传到服务器,记清楚目录路径。

必需文件:
  • AiKanPro.sh:核心 API 的手动启停脚本
  • AikanProApi.jar:核心 API 服务
  • application.properties:核心 API 的配置文件
AiKanPro.sh 脚本示例:
#!/bin/bash
# 定义变量
# 要运行的jar包路径,注意:等号两边不能有空格
JAR_NAME="/usr/local/AikanProApi/AikanProApi.jar"
# 日志路径
LOG_PATh=/www/wwwlogs/AikanPro/AikanPro.log

2️⃣

启动程序

假如您的脚本名为 AikanPro.sh,执行以下命令启动项目:

sh aiKnaProApi.sh start    # API 启动命令
启动后访问:
http://ip:8080  # IP 是你服务器 IP 地址

如启动后无法访问,请检查:

  • • 端口是否冲突
  • • 防火墙/安全组是否开启
启动成功界面

3️⃣

域名访问配置

使用 Nginx 做反向代理,用域名直接访问 API。

配置步骤:
  • 1. 新建纯静态网站(不需要 FTP 和数据库)
  • 2. 分配单独域名(一般是二级域名)
  • 3. 配置 SSL 证书(提升安全性)
  • 4. 添加以下伪静态配置
Nginx 伪静态配置:
location ^~ / {
  add_header 'Access-Control-Allow-Origin' '*';
  add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE';
  add_header 'Access-Control-Allow-Credentials' 'true';
  add_header 'Access-Control-Allow-Headers' 'Authorization,Content-Type,Accept,Origin,User-Agent,DNT,Cache-Control,X-Mx-ReqToken,X-Data-Type,X-Requested-With,X-Data-Type,X-Auth-Token';
  if ( $request_method = 'OPTIONS' ) { 
    return 200;
  }
  proxy_pass http://127.0.0.1:8080;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header REMOTE-HOST $remote_addr;
}
配置文件修改:

您可以编辑 application.properties 文件,修改默认端口、数据库和 Redis 配置:

# 服务端口
server.port=8080  # 修改后记得在 nginx 中同步修改

# mysql配置
spring.datasource.driverClassName=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/数据库名?characterEncoding=UTF-8
spring.datasource.username=数据库用户名
spring.datasource.password=数据库密码
# mysql数据表前缀,如果没改过就别动
mybatis.configuration.variables.prefix=typecho

4️⃣

系统配置

域名可以访问后,进行数据库配置操作。

配置界面

点击按钮进行数据库配置

配置表单

正确填写信息,记住每个密码

🔧 常用命令

⌨️ API 管理命令

脚本管理命令:

sh aiKnaProApi.sh start # API 启动命令
sh aiKnaProApi.sh restart # API 重启命令(最常用)
sh aiKnaProApi.sh stop # API 停止命令
sh aiKnaProApi.sh yunxing # 查看 API 状态命令

检查服务状态:

  • 连接被拒绝:表示未启动成功
  • 返回 HTML:表示启动成功
  • IP 无法访问:一般是防火墙/安全组未放行端口

✅ 安装完成

🎉 安装完成!

恭喜您成功完成 AikanPro API 的安装配置

🔍 需要帮助?

联系技术支持

😆 联系作者

获取技术支持