1、新建 Spring Boot 项目
2、 配置依赖（ pom.xml ）
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>3.5.9</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<properties>
<java.version>21</java.version>
</properties>
<dependencies>
......
<dependency>
<groupId>org.ssssssss</groupId>
<artifactId>magic-api-spring-boot-starter</artifactId>
<version>2.2.2</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.27</version>
</dependency>
</dependencies>
3、修改配置文件（ application.yml ）
server:
port: 9999
magic-api:
#配置web页面入口
web: /
resource:
#配置文件存储位置。当以classpath开头时，为只读模式
#mac用户请改为可读写的目录
#如果不想存到文件中，可以参考配置将接口信息存到数据库、Redis中（或自定义）
location: D:\pojo\magicapi-demo\data\magic-api
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/magic-api-test?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8
username: magic-api
password: 123456
4、运行项目，访问 MagicApi
运行项目后，访问 http://localhost:9999/
此处使用 Docker Compose 方式部署，相关环境请提前准备，此处不做介绍，如有需要，请查看本站相关文章（ Docker 专题导航 ）。
1、将上述 magicapi-demo 项目打包
后续使用 war 包部署，因此打包为 war
2、编写 dockerfile
ARG BASE_TAG=11.0.15-jre21
FROM tomcat:$BASE_TAG
COPY magicapi-demo /usr/local/tomcat/webapps/magicapi-demo
CMD ["catalina.sh", "run"]
3、构建 Docker 镜像
docker build --no-cache -t magicapi-demo:0.1.0 .
4、编写 compose.yaml
version: "3.9"
services:
magicapi-demo:
image: magicapi-demo:0.1.0
container_name: magicapi-demo
hostname: tomcat
restart: always
networks:
- app_network
ports:
- "8080:8080"
volumes:
- /usr/share/zoneinfo/Asia/Shanghai:/etc/localtime:ro
- ./conf/server.xml:/usr/local/tomcat/conf/server.xml
- ./conf/context.xml:/usr/local/tomcat/conf/context.xml
- ./conf/application.yml:/usr/local/tomcat/webapps/magicapi-demo/WEB-INF/classes/application.yml
- ./data:/data
networks:
app_network:
name: app_network
external: true
# driver: bridge
# driver_opts:
# encrypted: 'true'
# ipam:
# driver: default
# config:
# - subnet: 10.21.22.1/24
5、准备配置文件
......
<Context path="/" docBase="magicapi-demo" reloadable="true" />
......
......
server:
port: 9999
magic-api:
#配置web页面入口
web: /
resource:
#配置文件存储位置。当以classpath开头时，为只读模式
#mac用户请改为可读写的目录
#如果不想存到文件中，可以参考配置将接口信息存到数据库、Redis中（或自定义）
location: /data/magic-api
spring:
datasource:
driver-class-name: com.mysql.jdbc.Driver
url: jdbc:mysql://mysql8:3306/magic-api-test?allowMultiQueries=true&useUnicode=true&characterEncoding=UTF-8
username: magic-api
password: 123456
6、运行项目
docker-compose up -d
7、访问项目
运行项目后，访问 http://服务器IP:8080/