### 如何使用 Docker Compose 在 Linux 上部署 RuoYi-Plus #### 准备工作 在开始之前，确保已经安装并配置好 Docker 和 Docker Compose 工具。可以通过以下命令验证其版本： ```bash docker --version docker-compose --version ``` 如果未安装，则需先完成安装操作[^1]。 --- #### 创建项目目录结构 为了遵循最佳实践，建议将所有与 RuoYi-Plus 相关的文件存储在 `home` 用户目录下，而不是根目录 `/` 下[^2]。创建一个新的目录用于存放项目的必要文件： ```bash mkdir -p ~/ruoyi-plus && cd ~/ruoyi-plus ``` 在此目录中，准备必要的资源文件，例如 MySQL 的配置文件以及后续可能使用的其他依赖项。 --- #### 编写 `docker-compose.yml` 以下是适用于 RuoYi-Plus 的典型 `docker-compose.yml` 文件内容示例： ```yaml version: '3.8' services: mysql: image: mysql:8.0 container_name: ruoyi-mysql environment: MYSQL_ROOT_PASSWORD: rootpassword MYSQL_DATABASE: ruoyi_plus_db MYSQL_USER: ruoyi_user MYSQL_PASSWORD: user_password ports: - "3306:3306" volumes: - ./mysql/my.cnf:/etc/mysql/conf.d/my.cnf - ./mysql/data:/var/lib/mysql restart: always redis: image: redis:latest container_name: ruoyi-redis ports: - "6379:6379" volumes: - ./redis/data:/data restart: always ruoyi: build: context: . dockerfile: Dockerfile container_name: ruoyi-plus-app depends_on: - mysql - redis ports: - "8080:8080" environment: SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/ruoyi_plus_db?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=false&serverTimezone=GMT%2B8 SPRING_REDIS_HOST: redis SPRING_REDIS_PORT: 6379 restart: on-failure ``` 此配置定义了三个主要的服务组件：MySQL 数据库、Redis 缓存服务器和 RuoYi-Plus 应用程序本身。其中需要注意的是数据库连接字符串中的主机名应指向容器名称（即 `mysql`），而非本地地址。 --- #### 构建自定义镜像 (可选) 如果有特定需求定制化应用镜像，可以编写简单的 `Dockerfile` 来实现这一点。下面是一个基础模板供参考： ```dockerfile FROM openjdk:17-jdk-slim-buster WORKDIR /app COPY target/*.jar app.jar ENTRYPOINT ["java", "-jar", "/app/app.jar"] ``` 构建完成后，记得更新 `docker-compose.yml` 中对应部分以引用新生成的镜像。 --- #### 运行环境调整 对于某些高级场景下的远程访问控制或者性能优化参数设定，可能还需要进一步修改系统级服务启动选项。比如通过编辑 systemd 单元文件来允许外部客户端连接至宿主机上的 Docker Daemon API 接口[^3]: ```bash sudo systemctl edit docker.service ``` 追加如下字段到 `[Service]` 节点内部即可生效: ```ini ExecStart= ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock --containerd=/run/containerd/containerd.sock ``` 最后重启守护进程使更改立即可用： ```bash sudo systemctl daemon-reload && sudo systemctl restart docker ``` --- #### 启动整个架构 当一切准备工作就绪之后，在终端执行以下指令便可一键拉起全部关联实例及其网络拓扑关系图谱： ```bash docker-compose up -d ``` 此时应该能够正常浏览前端界面并通过浏览器测试后端接口调用了！ ---