关键在于将Java服务与MySQL、Redis、RabbitMQ等中间件统一声明在docker-compose.yml中，通过build构建镜像、service_healthy依赖检查、服务名通信及healthcheck探活，再执行docker compose up -d一键拉起。
Java 项目用 docker-compose up -d 一键拉起整个分布式后端系统，关键不在 Java 本身调用命令，而在于把 Java 服务和它依赖的中间件（MySQL、Redis、RabbitMQ 等）全部声明在 docker-compose.yml 中，再用一条命令统一启动。Java 应用只需作为 Compose 中的一个 service 存在，不参与命令执行逻辑。
把 Java 服务写进 docker-compose.yml
Java 服务不能只写个 jar 包就完事，得先打包成镜像，再让 Compose 调用：
- 确保项目已构建出可运行的 jar（如
target/myapp.jar），并在项目根目录下准备Dockerfile，内容类似：FROM openjdk:17-jre-slim<br>WORKDIR /app<br>COPY target/myapp.jar app.jar<br>EXPOSE 8080<br>ENTRYPOINT ["java", "-jar", "app.jar"]
- 在
docker-compose.yml中定义该服务，指定镜像来源（build 路径或已推送到 registry 的镜像）：services:<br> api:<br> build: .<br> ports: ["8080:8080"]<br> environment:<br> - SPRING_PROFILES_ACTIVE=prod<br> - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/mydb
- 数据库地址必须用服务名（如
mysql），不能写localhost—— Compose 自动创建网络，容器间靠服务名互通
声明依赖并确保真正就绪
Java 服务启动快，但数据库、消息队列往往需要几秒初始化。光靠 depends_on 不够，必须加 healthcheck：
OpenClaw Docker Setup
下载
在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...
- 为 MySQL 加健康检查：
mysql:<br> image: mysql:8.0<br> healthcheck:<br> test: ["CMD-SHELL", "mysqladmin ping -h localhost -u root -p$$MYSQL_ROOT_PASSWORD --silent"]<br> interval: 10s<br> retries: 12
- Java 服务的
depends_on要指向带 healthcheck 的服务：depends_on:<br> mysql:<br> condition: service_healthy<br> redis:<br> condition: service_healthy
- Spring Boot 项目建议启用
spring-boot-starter-actuator并配置 readiness 探针，进一步增强启动容错
一键启动与后续管理
配置写完，所有服务就在同一套生命周期里了：
立即学习“Java免费学习笔记（深入）”；
- 启动：在
docker-compose.yml所在目录执行docker compose up -d，所有服务后台运行 - 查看状态：
docker compose ps查容器状态，docker compose logs api看 Java 日志 - 重启单个服务：
docker compose restart api，不影响其他组件 - 停用清理：
docker compose down停止并移除容器和网络（卷默认保留，数据不丢）
常见坑点提醒
Java 微服务容易在这里卡住：
- 环境变量拼写错误（比如
SPRING_DATASOURCE_URL写成SPRING_DATASOURCE_URLS），导致连接失败却无明显报错 - MySQL 初始化脚本没挂载或权限不对，容器启动成功但数据库为空，Java 连接后报表不存在
- RabbitMQ 或 Redis 没开 management 插件或没暴露对应端口，调试时无法访问控制台
- Java 应用镜像用了
openjdk:jre却在启动脚本里调用了sh以外的命令（如bash），导致容器启动即退出
