如何安装 CrapAPI 源码？

CrapApi是一款开源的API管理平台，其源码安装过程相对简单，但需要一定的技术基础，以下是详细的安装步骤和注意事项：

一、环境准备

1、操作系统：建议使用Linux系统，如CentOS或Ubuntu，Windows用户也可以进行安装，但需要注意一些路径和权限问题。

2、JDK：确保已安装JDK 8或更高版本，因为CrapApi是基于Java开发的。

3、Tomcat：需要一个Tomcat服务器来部署CrapApi，建议使用Tomcat 8或更高版本。

4、MySQL：CrapApi需要一个MySQL数据库来存储数据，建议使用MySQL 5.7或更高版本。

5、Git（可选）：如果打算从源码编译，需要安装Git。

二、下载源码或编译后的文件

1、下载源码：可以从Gitee或GitHub上下载CrapApi的源码。

   git clone https://gitee.com/crap-api/CrapApi.git
   cd CrapApi

2、下载编译后的文件：如果不想从源码编译，可以直接下载编译后的文件。

三、导入数据库脚本

1、在MySQL中新建一个数据库，例如命名为crap_api。

   CREATE DATABASE crap_api;

2、将下载的SQL脚本导入到新建的数据库中，SQL脚本通常位于源码的sql目录下。

   mysql -u root -p crap_api < path/to/CrapApi.V7.8.sql

四、修改配置文件

1、修改数据库连接配置：打开CrapApi/WEB-INF/classes/config.properties文件，修改数据库连接配置。

   spring.datasource.url=jdbc:mysql://localhost:3306/crap_api?useUnicode=true&characterEncoding=utf-8&useSSL=false
   spring.datasource.username=root
   spring.datasource.password=your_password

2、修改日志输出地址：打开CrapApi/WEB-INF/classes/log4j.properties文件，修改日志输出地址。

   log4j.appender.file.File=/path/to/logs/crapapi.log

3、其他配置：根据需要修改其他配置文件，如github授权及秘钥、系统加密密钥等。

五、部署到Tomcat

1、手动部署：将编译后的CrapApi包放到Tomcat的webapps目录下，解压并重命名目录为crapapi或其他自定义名称。

2、自动部署：如果Tomcat开启了自动部署，直接将CrapApi包放到webapps目录下即可。

3、修改Tomcat配置：在tomcat/conf/server.xml文件中添加以下配置信息。

   <Host name="localhost" unpackWARs="true" autoDeploy="true">
       <Context path="" docBase="path/to/crapapi" debug="0" reloadable="true" crossContext="true"/>
   </Host>

六、启动Tomcat并访问系统

1、启动Tomcat服务。

2、在浏览器中访问http://localhost:8080/crapapi（或你自定义的访问路径），系统会自动跳转到首页。

3、使用默认管理员账号（admin）和密码（123456）登录系统。

七、修改系统设置

1、登录后进入系统管理-》系统设置管理，修改系统相关设置，如域名、Lucene索引文件存储地址等。

2、修改【SECRETKEY】：系统加密、下载等秘钥，不能包含特殊字符，建议使用大小写、数字、下划线、逗号、点等。

八、调整Tomcat内存配置

Tomcat默认只使用了64M内存，对于CrapApi这种应用来说可能不够用，需要调整内存配置，编辑tomcat/bin/catalina.sh（Linux）或catalina.bat（Windows）文件，新增如下配置。

JAVA_OPTS="-Xms100m -Xmx200m -XX:PermSize=100m -XX:MaxPermSize=200m -Xss512K"

九、添加GitHub登录（可选）

如果需要添加GitHub登录功能，修改config.properties文件中的GitHub授权及秘钥配置，并在GitHub中添加OAuth Application，回调地址填写http://部署域名/github/login.do。

十、常见问题及解决方法

1、数据库连接失败：检查数据库URL、用户名和密码是否正确，以及MySQL服务是否启动。

2、Tomcat启动失败：检查Tomcat日志文件，查看错误信息，通常是端口被占用或缺少依赖库。

3、页面无法访问：检查Tomcat的server.xml配置，确保上下文路径和文档基目录设置正确。

4、系统功能异常：检查配置文件是否正确，特别是数据库连接和秘钥配置。

通过以上步骤，您应该能够成功安装并运行CrapApi，如果在过程中遇到任何问题，可以参考官方文档或社区论坛寻求帮助。