This is an automated email from the ASF dual-hosted git repository.
lizhimins pushed a commit to branch rocketmq-studio
in repository https://gitbox.apache.org/repos/asf/rocketmq-dashboard.git
The following commit(s) were added to refs/heads/rocketmq-studio by this push:
new 77ca0fae chore(deploy): share a single rocketmq_net network and drop
static IPs (#2049)
77ca0fae is described below
commit 77ca0fae90a458d2e5cc8d301b1532bc0d897e8b
Author: lizhimins <[email protected]>
AuthorDate: Thu Aug 13 11:51:41 2026 +0800
chore(deploy): share a single rocketmq_net network and drop static IPs
(#2049)
Studio and the bundled RocketMQ cluster now attach to one external
rocketmq_net network and resolve nameserver/broker hostnames via
container DNS, so the stale 10.89.2.x static IPs and extra_hosts
overrides are removed. The web build also wires VITE_GIT_COMMIT for
the footer build info. The deploy-rocketmq skill is rewritten for the
docker compose flow (en_US.UTF-8 locale prerequisite, Maven 3.9.16
from the Aliyun apache mirror).
---
.claude/skills/deploy-rocketmq/SKILL.md | 310 ++++++++++++++++++++++++++------
README.md | 2 +-
README_zh.md | 2 +-
deploy/docker-compose.yml | 8 +-
deploy/rocketmq/docker-compose.yml | 16 +-
5 files changed, 265 insertions(+), 73 deletions(-)
diff --git a/.claude/skills/deploy-rocketmq/SKILL.md
b/.claude/skills/deploy-rocketmq/SKILL.md
index 0447a18e..865b182f 100644
--- a/.claude/skills/deploy-rocketmq/SKILL.md
+++ b/.claude/skills/deploy-rocketmq/SKILL.md
@@ -1,93 +1,276 @@
---
name: deploy-rocketmq
-description: 部署 studio 测试集群。从 Apache RocketMQ 开源 develop 分支源码构建镜像，用 docker
compose 在本地拉起 NameServer + 双 Broker + Proxy 集群，并启动 1 TPS 持续收发消息的 Producer /
Consumer（均开启消息轨迹）。当用户说 部署 studio 测试集群 时触发。
+description: 部署 RocketMQ Studio 与开源 RocketMQ。当用户说 部署 studio、把 studio
部署到远程机器/测试机、更新远程 studio、单机部署开源 rocketmq、远程部署 rocketmq 集群、单机部署 rocketmq 测试客户端、部署
studio 测试集群 时触发。
---
-# 部署 studio 测试集群
+# 部署 RocketMQ Studio / 开源 RocketMQ
-在本地用 docker compose 部署一套开源 RocketMQ 集群（NameServer + 双 Broker + Proxy），
-集群名 `rocketmq-studio`，Broker 开启消息轨迹，附带 Producer / Consumer 容器以
-1 TPS 持续收发消息并上报轨迹，供 RocketMQ Studio 本地调试使用。
+三种部署模式，全部遵循同一条主线：
-所有部署产物在 `deploy/rocketmq/` 目录，详见其中的 `README.md`。
+> **本地把源码打成 tar.gz → 复制到目标机器 → 在目标机器上构建镜像并启动。**
+> 构建统一在目标机执行，复用目标机本地缓存（Maven `~/.m2`、docker 层缓存），
+> 不做镜像中转。
-## 前置条件
+| 模式 | 场景 |
+|------|------|
+| A. Studio 部署到目标机器 | 把本项目（server + web + mysql）部署到一台远程 Linux 机器，浏览器访问 |
+| B. 单机部署开源 RocketMQ | 在目标机器部署纯净开源集群（nameserver + 双 broker + proxy），不带测试挂具 |
+| C. 单机部署 RocketMQ 测试客户端 | 在目标机器部署模式 B 集群 + producer/consumer 1 TPS 轨迹挂具，供
Studio 调试 |
+
+> ⚠️ `deploy/deploy.sh` 是旧的 podman 时代脚本，与当前 docker compose 流程不一致，**不要使用**。
+
+## 通用前置条件（目标机器）
+
+- 已安装 `docker`（含 `docker compose`）。国内机器安装要点：
+ - 用阿里源：`dnf config-manager
--add-repo=https://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo`；
+ Alibaba Cloud Linux 3 需 `sed -i 's#$releasever#8#g'
/etc/yum.repos.d/docker-ce.repo`（releasever=3 无对应目录）。
+ - 配 registry-mirrors（国内拉不动 Docker Hub，mysql:8.0 / dragonwell 等基础镜像必需），
+ 写入 `/etc/docker/daemon.json` 的 `registry-mirrors`（如
`https://docker.m.daocloud.io` 等可用镜像站），
+ 然后 `systemctl enable --now docker`。
+- 用户已配置好到目标机的 SSH 密钥/证书访问（可免密登录；用
+ `ssh -o BatchMode=yes <user>@<host> whoami` 验证）。未配置时先与用户确认登录方式。
+- 目标机器语言必须为 `en_US.UTF-8`：`export LANG=en_US.UTF-8`。SSH 会话内临时生效；
+ 需持久化时追加到 `~/.bashrc` 或 `/etc/profile.d/`。用 `ssh <user>@<host> 'echo $LANG'`
验证。
+- 放行所需端口：模式 A 放行 web 端口（默认 6789）；模式 B/C 如需跨机访问放行
+ 9876、10909、10911、10912、20909、20911、20912、8080、8081。
+
+---
+
+## 模式 A：部署 Studio 到目标机器
+
+### 核心原则
+
+- **后端编译在目标机器上做**：复用目标机宿主机 `~/.m2/repository` 缓存，增量构建快。
+- **国内目标机必须先检查 Maven 镜像源**（见步骤 2），否则依赖下载极慢或失败。
+- 默认 `STUDIO_AUTH_LOGIN_REQUIRED=false` 免登录，方便直接查看效果；如需开启登录，
+ 改为 `true` 并配好 admin 账号密码后重建 server。
+
+### 1. 初始化部署目录与 .env（仅首次）
+
+```bash
+SSH="ssh <user>@<host>"
+$SSH bash -s <<'EOF'
+mkdir -p /opt/rocketmq-studio
+docker network inspect rocketmq_net >/dev/null 2>&1 || docker network create
rocketmq_net
+cat > /opt/rocketmq-studio/.env <<'ENV'
+TZ=Asia/Shanghai
+MYSQL_ROOT_PASSWORD=rocketmq
+STUDIO_AUTH_LOGIN_REQUIRED=false
+STUDIO_AUTH_ADMIN_USERNAME=admin
+STUDIO_AUTH_ADMIN_PASSWORD=rocketmq
+RMQ_LLM_TOKEN=
+RMQ_ANTHROPIC_BASE_URL=
+ENV
+chmod 600 /opt/rocketmq-studio/.env
+EOF
+```
+
+- `MYSQL_ROOT_PASSWORD` 同时被 compose 用于 mysql 和 server 的
`SPRING_DATASOURCE_PASSWORD`，务必一致。
+- compose 中 `rocketmq` 网络声明为 external（名 `rocketmq_net`），不存在时 `up` 会失败，必须先创建。
+
+### 2. 检查并配置 Maven 阿里源（国内目标机必做）
+
+后端 JAR 用 maven 容器挂载宿主机 `~/.m2` 编译，镜像源配置来自宿主机 `~/.m2/settings.xml`。
+先检查：
+
+```bash
+$SSH 'grep -q "maven.aliyun.com" ~/.m2/settings.xml 2>/dev/null && echo OK ||
echo MISSING'
+```
+
+输出 `MISSING` 时帮目标机写入（已有 settings.xml 则把 mirror 合并进 `<mirrors>`，不要整文件覆盖）：
+
+```bash
+$SSH 'mkdir -p ~/.m2 && cat > ~/.m2/settings.xml <<'"'"'XML'"'"'
+<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0";>
+ <mirrors>
+ <mirror>
+ <id>aliyun</id>
+ <mirrorOf>central</mirrorOf>
+ <url>https://maven.aliyun.com/repository/public</url>
+ </mirror>
+ </mirrors>
+</settings>
+XML'
+```
-- 已安装 `docker`（含 `docker compose`）。
-- 网络可访问 `github.com`（构建阶段 git clone）；国内环境由 `build.sh` 自动切换
- apt / Maven 阿里源。
-- 宿主机端口 9876、10909、10911、10912、20909、20911、20912、8080、8081 未被占用
- （与 studio 主 compose 的端口约定一致，不冲突）。
+### 3. 本地打包源码并复制到目标机
-## 执行步骤
+```bash
+cd <项目根目录> # rocketmq-studio 仓库根
+tar czf /tmp/src.tar.gz --exclude='web/node_modules' --exclude='web/dist'
--exclude='server/target' server web deploy
+scp /tmp/src.tar.gz <user>@<host>:/opt/rocketmq-studio/
+$SSH 'cd /opt/rocketmq-studio && rm -rf server web deploy && tar xzf
src.tar.gz && rm src.tar.gz'
+```
+
+### 4. 在目标机上编译后端 + 构建镜像
+
+复用宿主机 `~/.m2` 缓存编译 JAR，再用 Dockerfile 的 `runtime-prebuilt` target 打镜像
+（不要走默认多阶段 build target，那会在 Docker 内从零下载依赖、用不上宿主机缓存）：
+
+```bash
+$SSH 'cd /opt/rocketmq-studio && \
+ docker run --rm -e HOME=/tmp \
+ -v $PWD/server:/app -v $HOME/.m2:/maven-cache -w /app \
+ maven:3.9.16-eclipse-temurin-21 \
+ mvn -B -ntp -s /maven-cache/settings.xml
-Dmaven.repo.local=/maven-cache/repository package -DskipTests && \
+ docker build --target runtime-prebuilt -t rocketmq-server:latest server/'
+```
+
+- 若目标机 `~/.m2/settings.xml` 不存在（海外机器通常不需要镜像源），去掉 `-s
/maven-cache/settings.xml`。
+- maven 基础镜像本身也要拉取，国内依赖通用前置条件里的 registry-mirrors。
+
+构建 web（页脚「构建 <短commit>」由 `VITE_GIT_COMMIT` 注入，先取当前 git 短 commit）：
+
+```bash
+$SSH 'cd /opt/rocketmq-studio && \
+ docker build --build-arg VITE_GIT_COMMIT=$(git rev-parse --short HEAD
2>/dev/null || echo dev) -t rocketmq-web:latest web/'
+```
-### 1. 构建镜像
+### 5. 启动与验证
```bash
-cd deploy/rocketmq
-./build.sh # 自动判断地理位置：国内走阿里源，国外用默认源
+$SSH 'cd /opt/rocketmq-studio && docker compose --env-file .env -f
deploy/docker-compose.yml up -d'
+
+# 三容器均 healthy 即成功
+$SSH 'docker ps'
+$SSH 'docker exec rocketmq-server curl -fsS
http://localhost:8888/actuator/health'
+curl -s -o /dev/null -w 'web %{http_code}\n' http://<host>:6789/
```
+### 6. 更新代码后重新部署
+
+重复步骤 3 → 5 即可。注意：
+
+- mysql 数据在独立数据卷 `mysql-data`，重建 server/web 不影响数据；**不要 `down -v`**。
+- 仅改 server 时只需重编 server（步骤 4 前半段）并 `docker compose ... up -d rocketmq-server`。
+
+### 可选：注入演示数据
+
+`deploy/mysql/upgrade-demo-instance.sql` / `upgrade-demo-acl.sql` 可注入演示实例/ACL。
+导入后必须补 vendor，否则 `/api/instances` 报 500（demo SQL 早于 vendor 功能）：
+
+```bash
+$SSH 'docker exec rocketmq-studio-mysql mysql -uroot -procketmq rocketmq \
+ -e "UPDATE rmq_instance SET vendor=\"APACHE\" WHERE vendor IS NULL OR
vendor=\"\";"'
+```
+
+---
+
+## 模式 B：单机部署开源 RocketMQ（纯净集群）
+
+在目标机器部署一套开源 RocketMQ 集群（NameServer + 双 Broker + Proxy，集群名
+`rocketmq-studio`，Broker 开启消息轨迹），不带 producer/consumer 测试挂具，
+供任意客户端或 Studio 接入。部署产物在仓库 `deploy/rocketmq/` 目录。
+
+### 1. 本地打包并复制到目标机
+
+```bash
+SSH="ssh <user>@<host>"
+tar czf /tmp/rocketmq-deploy.tar.gz -C deploy rocketmq
+scp /tmp/rocketmq-deploy.tar.gz <user>@<host>:/tmp/
+$SSH 'mkdir -p /opt/rocketmq && rm -rf /opt/rocketmq/rocketmq && \
+ tar xzf /tmp/rocketmq-deploy.tar.gz -C /opt/rocketmq && rm
/tmp/rocketmq-deploy.tar.gz'
+```
+
+### 2. 在目标机上构建镜像
+
+```bash
+$SSH 'cd /opt/rocketmq/rocketmq && ./build.sh'
+```
+
+- `build.sh` 自动判断地理位置：国内切阿里 apt/Maven 源，国外用默认源。
- Dockerfile 为多阶段构建：builder 阶段 `git clone --depth 1 -b develop
https://github.com/apache/rocketmq.git` 后执行
`mvn -Prelease-all -DskipTests clean install`，运行阶段仅保留
`bin/ conf/ lib/` 产物，基础镜像 `alibabadragonwell/dragonwell:17-anolis`（yum
系，国内拉取快）。
+- 构建阶段需访问 github.com，国内机器若 clone 慢或失败，用
+ `--build-arg ROCKETMQ_REPO=<镜像仓库地址>` 换源。
- 首次构建需 10-20 分钟；如需指定其他分支或 tag：
- `docker build --build-arg ROCKETMQ_BRANCH=rocketmq-all-5.5.0 -t
apache-rocketmq:develop .`
+ `./build.sh --build-arg ROCKETMQ_BRANCH=rocketmq-all-5.5.0`
+
+### 3. 启动（仅核心服务）
+
+```bash
+$SSH 'docker network inspect rocketmq_net >/dev/null 2>&1 || docker network
create rocketmq_net'
+$SSH 'cd /opt/rocketmq/rocketmq && docker compose up -d nameserver broker-0
broker-1 proxy'
+```
+
+- broker-0 监听 10909/10911/10912，broker-1 在 broker-1.conf 里通过 `listenPort=20911`
+ 直接监听 20909/20911/20912（fast/ha 端口自动 -2/+1），容器与宿主机端口 1:1 映射。
+- 堆内存通过 `JAVA_OPT_EXT` 环境变量收敛（开源启动脚本会将其追加到 JVM 参数末尾，
+ 覆盖脚本内置的大堆默认值），适合小内存环境。
-### 2. 拉起集群
+### 4. 验证
```bash
-docker compose up -d
+$SSH 'cd /opt/rocketmq/rocketmq && docker compose ps'
+$SSH 'cd /opt/rocketmq/rocketmq && \
+ docker compose exec -T nameserver sh bin/mqadmin clusterList -n
nameserver:9876'
```
-服务说明：
+通过标准：clusterList 能看到 `rocketmq-studio` 集群下 `rocketmq-studio-0`、
+`rocketmq-studio-1` 两个 broker，且 `#ACTIVATED=true`。
+
+### 5. 网络接入说明
+
+- **与 Studio 同机部署**：两边共用 `rocketmq_net` 网络，Studio server 容器直接用
+ `nameserver:9876` 接入（compose 默认
`STUDIO_ROCKETMQ_NAMESRV_ADDR=nameserver:9876`）。
+- **跨机访问**：`brokerIP1=broker-{0,1}` 仅容器网络内可达，宿主机/其他机器直连需改
+ `conf/broker-{0,1}.conf` 为 `brokerIP1=<目标机器 IP>` 并重启 broker，同时放行
+ 9876、10909、10911、10912、20909、20911、20912、8080、8081。
+- proxy 对外提供 remoting 8080 / gRPC 8081 接入点，已关闭 topic 消息类型校验
+ （`enableTopicMessageTypeCheck=false`，避免自动建 topic 类型为 UNSPECIFIED 时发送被拒）。
+
+---
+
+## 模式 C：单机部署 RocketMQ 测试客户端
+
+在目标机器部署模式 B 的集群，并额外拉起 Producer / Consumer 容器以 1 TPS 持续
+收发消息并上报轨迹，供 RocketMQ Studio 调试使用。
+
+### 1. 准备与构建
+
+同模式 B 步骤 1 → 3，但启动全部服务（含 producer/consumer）：
+
+```bash
+$SSH 'cd /opt/rocketmq/rocketmq && docker compose up -d'
+```
+
+producer / consumer 服务说明（容器名均带 `rmq-` 前缀）：
| 服务 | 说明 |
|------|------|
-| nameserver | `mqnamesrv`，端口 9876 |
-| broker-0 / broker-1 | `mqbroker -c broker-{0,1}.conf`，集群
`rocketmq-studio`，broker 名 `rocketmq-studio-{0,1}`，各限 1C2G，已开启
`traceOn=true`、`traceTopicEnable=true` |
-| proxy | `mqproxy -pc rmq-proxy.json`，集群模式，remoting 8080 / gRPC 8081，1C2G，已关闭
topic 消息类型校验（`enableTopicMessageTypeCheck=false`，避免自动建 topic 类型为 UNSPECIFIED
时发送被拒） |
-| producer | 编译并运行 `clients/TraceProducer.java`，1 TPS 发送到 `StudioTest`（带 Key
`studio-key-<n>`），`enableMsgTrace=true`，接入点 `proxy:8080`（流量经 proxy 转发） |
-| consumer | 编译并运行 `clients/TraceConsumer.java`，Push 消费
`StudioTest`，`enableMsgTrace=true`，接入点 `proxy:8080` |
+| producer | 编译并运行 `clients/TraceProducer.java`，1 TPS 发送到 `StudioTest`（带 Key
`studio-key-<n>`），`enableMsgTrace=true`，直连 `nameserver:9876` |
+| consumer | 编译并运行 `clients/TraceConsumer.java`，Push 消费
`StudioTest`，`enableMsgTrace=true`，直连 `nameserver:9876` |
-- broker-0 监听 10909/10911/10912，broker-1 在 broker-1.conf 里通过 `listenPort=20911`
- 直接监听 20909/20911/20912（fast/ha 端口自动 -2/+1），容器与宿主机端口 1:1 映射，
- 容器网络内访问 `broker-0:10911` / `broker-1:20911`。
-- 堆内存通过 `JAVA_OPT_EXT` 环境变量收敛（开源启动脚本会将其追加到 JVM 参数末尾，
- 覆盖脚本内置的大堆默认值），适合本地小内存环境。
-- producer / consumer 直接用运行镜像自带 JDK + `lib/*` 依赖现场编译，无需额外构建。
+producer / consumer 直接用运行镜像自带 JDK + `lib/*` 依赖现场编译，无需额外构建。
-### 3. 验证
+### 2. 验证
```bash
-# 全部容器 Up
-docker compose ps
-
# 收发日志：producer 每秒一条 SEND_OK，consumer 对应 consume
-docker compose logs -f producer consumer
-
-# 集群注册正常：应看到 rocketmq-studio 下两个 broker
-docker compose exec nameserver sh bin/mqadmin clusterList -n nameserver:9876
+$SSH 'docker logs -f --tail 50 rmq-producer'
# 消息轨迹已落盘（RMQ_SYS_TRACE_TOPIC 有数据即轨迹链路打通）
-docker compose exec broker-0 sh bin/mqadmin consumeMessage \
- -n nameserver:9876 -t RMQ_SYS_TRACE_TOPIC -c 5
+$SSH 'cd /opt/rocketmq/rocketmq && docker compose exec -T broker-0 \
+ sh bin/mqadmin consumeMessage -n nameserver:9876 -t RMQ_SYS_TRACE_TOPIC -c 5'
```
-验证通过标准：clusterList 能看到 `rocketmq-studio` 集群下 `rocketmq-studio-0`、
-`rocketmq-studio-1` 两个 broker；producer 日志持续输出 `SEND_OK`；
+验证通过标准：模式 B 的 clusterList 标准之外，producer 日志持续输出 `SEND_OK`；
`RMQ_SYS_TRACE_TOPIC` 能消费出轨迹数据。
-### 4. 清理
+### 3. 清理
```bash
-docker compose down -v
+$SSH 'cd /opt/rocketmq/rocketmq && docker compose down -v'
```
+---
+
## 常用查询命令（mqadmin）
-以下命令均已实测可用，在任意集群容器内执行（示例用 nameserver）。
+以下命令均已实测可用，在任意集群容器内执行（示例用 nameserver）。远程执行时
+用 `ssh <user>@<host> 'cd /opt/rocketmq/rocketmq && docker compose exec -T
...'` 包装。
msgId / Key 可从 producer 日志获取：`send #16 SEND_OK <msgId> key=studio-key-16`。
### 查看集群状态 clusterList
@@ -96,7 +279,7 @@ msgId / Key 可从 producer 日志获取：`send #16 SEND_OK <msgId>
key=studio-
docker compose exec nameserver sh bin/mqadmin clusterList -n nameserver:9876
```
-输出每个 broker 的地址、版本、InTPS/OutTPS（本集群稳态约 1.0，对应 1 TPS 收发）、
+输出每个 broker 的地址、版本、InTPS/OutTPS（测试集群稳态约 1.0，对应 1 TPS 收发）、
磁盘水位等。`#ACTIVATED=true` 表示 broker 心跳正常。
### 按 msgId 精确查消息 queryMsgByUniqueKey
@@ -129,17 +312,40 @@ docker compose exec nameserver sh bin/mqadmin
queryMsgByKey \
-n nameserver:9876 -t StudioTest -k studio-key-16
```
-- 依赖发送时 `msg.setKeys(...)` 建立的索引（本集群 producer 已设置
+- 依赖发送时 `msg.setKeys(...)` 建立的索引（测试集群 producer 已设置
`studio-key-<序号>`），返回命中的 msgId、Queue、Offset。
- 拿到 msgId 后可再用 `queryMsgByUniqueKey` / `queryMsgTraceById` 深挖详情与轨迹。
## 常见问题
-- **producer 启动初期报 route not found / 类型校验失败**：broker 注册与 topic
- 自动创建需要几秒，发送循环与 `restart: on-failure` 会自动重试，稍等即可。
+- **producer 启动初期报 route not found / 类型校验失败**（模式 C）：broker 注册与
+ topic 自动创建需要几秒，发送循环与 `restart: on-failure` 会自动重试，稍等即可。
- **宿主机客户端连不上 broker**：`brokerIP1=broker-{0,1}` 仅容器网络内可达；
- 宿主机直连需改 `conf/broker-{0,1}.conf` 为 `brokerIP1=127.0.0.1` 并重启。
- Studio 后端若跑在另一个 compose 网络中，建议共享同一个 docker network。
+ 直连需改 `conf/broker-{0,1}.conf` 的 `brokerIP1`（同机宿主机改 `127.0.0.1`，
+ 跨机改为机器 IP）并重启。Studio 后端若跑在另一个 compose 网络中，建议共享
+ 同一个 docker network（`rocketmq_net`）。
- **构建阶段 clone 慢或失败**：确认能访问 github.com，或用
`--build-arg ROCKETMQ_REPO=<镜像仓库地址>` 换源；Maven 慢用 `./build.sh`
自动切阿里源。
+- **compose 报 external 网络不存在**：先 `docker network create rocketmq_net`。
+- **目标机拉基础镜像超时/403**：国内机器配置 `/etc/docker/daemon.json`
+ registry-mirrors 后重启 docker。
+- **公共 Docker Hub 镜像源全部失效**（2026-08 实测：1ms.run / xuanyuan / daocloud /
+ 1panel / ustc 均限流或停服，`docker pull` 永久 Waiting）：
+ - dragonwell 基础镜像可改从厂商仓库拉：
+ `docker pull
dragonwell-registry.cn-hangzhou.cr.aliyuncs.com/dragonwell/dragonwell:17-anolis`
+ （拉完 `docker tag` 成 Dockerfile 期望的名字），阿里云 ECS 上秒拉。
+ - `maven:3.9.16-eclipse-temurin-21` 拉不下来时，用 dragonwell 镜像容器内自装 Maven 编译：
+ ```bash
+ docker run --rm -e HOME=/tmp -v $PWD/server:/app -v $HOME/.m2:/maven-cache
-w /app \
+ alibabadragonwell/dragonwell:21 sh -c '
+ export JAVA_HOME=$(dirname $(dirname $(readlink -f $(command -v
java))))
+ curl -fsSL
https://mirrors.aliyun.com/apache/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz
| tar xz -C /opt
+ export PATH=/opt/apache-maven-3.9.16/bin:$PATH
+ mvn -B -ntp -s /maven-cache/settings.xml
-Dmaven.repo.local=/maven-cache/repository package -DskipTests'
+ ```
+- **Maven 分发包下载慢**：`archive.apache.org` 国内常只有几 KB/s；改从
+
`https://mirrors.aliyun.com/apache/maven/maven-3/<版本>/binaries/apache-maven-<版本>-bin.tar.gz`
+ 下载（阿里源实测 10MB/s+；如 3.9.16 即
`maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz`）。
+- **目标机已有同名镜像**（如上次部署遗留的 `apache-rocketmq:develop`、`mysql:8.0`）：
+ 可跳过构建直接 `docker compose up -d`，先 `docker images` 确认。
diff --git a/README.md b/README.md
index 03b6dc92..9f317cd4 100644
--- a/README.md
+++ b/README.md
@@ -16,7 +16,7 @@ cd .. && docker compose up -d --build
Visit **http://127.0.0.1:6789** after startup.
The first command starts the bundled RocketMQ topology and creates the
-`rocketmq_default` Docker network used by the Studio services. Check that it
+`rocketmq_net` Docker network used by the Studio services. Check that it
is healthy before starting Studio with `docker compose ps` from
`deploy/rocketmq`.
The default schema creates only Studio tables. It does not seed instances,
topics, consumer groups, or ACL
records. Development-only sample data can be imported explicitly from
`deploy/mysql/`; it is not part of the
diff --git a/README_zh.md b/README_zh.md
index e78da728..2929f2e2 100644
--- a/README_zh.md
+++ b/README_zh.md
@@ -14,7 +14,7 @@ cd .. && docker compose up -d --build
```
第一条命令会启动内置 RocketMQ 拓扑，并创建 Studio 服务所需的
-`rocketmq_default` Docker 网络。启动 Studio 前，可在 `deploy/rocketmq` 目录执行
+`rocketmq_net` Docker 网络。启动 Studio 前，可在 `deploy/rocketmq` 目录执行
`docker compose ps` 确认 RocketMQ 已就绪。
启动后访问 **http://127.0.0.1:6789** 即可使用。
diff --git a/deploy/docker-compose.yml b/deploy/docker-compose.yml
index aeb294e5..d131c86e 100644
--- a/deploy/docker-compose.yml
+++ b/deploy/docker-compose.yml
@@ -49,10 +49,6 @@ services:
RMQ_ANTHROPIC_BASE_URL: ${RMQ_ANTHROPIC_BASE_URL:-}
expose:
- "8888"
- extra_hosts:
- - "nameserver:10.89.2.10"
- - "broker-0:10.89.2.11"
- - "broker-1:10.89.2.12"
networks:
- studio-net
- rocketmq
@@ -70,6 +66,8 @@ services:
build:
context: ../web
dockerfile: Dockerfile
+ args:
+ VITE_GIT_COMMIT: ${STUDIO_BUILD_COMMIT:-dev}
image: rocketmq-web:latest
container_name: rocketmq-web
restart: unless-stopped
@@ -86,7 +84,7 @@ networks:
driver: bridge
rocketmq:
external: true
- name: rocketmq_default
+ name: rocketmq_net
volumes:
mysql-data:
diff --git a/deploy/rocketmq/docker-compose.yml
b/deploy/rocketmq/docker-compose.yml
index 8b83e683..8b5e3c32 100644
--- a/deploy/rocketmq/docker-compose.yml
+++ b/deploy/rocketmq/docker-compose.yml
@@ -13,9 +13,6 @@ services:
JAVA_OPT_EXT: -Xms512m -Xmx512m -Xmn256m
ports:
- "9876:9876"
- networks:
- default:
- ipv4_address: 10.89.2.10
broker-0:
image: apache-rocketmq:develop
@@ -34,9 +31,6 @@ services:
- "10909:10909"
- "10911:10911"
- "10912:10912"
- networks:
- default:
- ipv4_address: 10.89.2.11
depends_on:
- nameserver
@@ -58,9 +52,6 @@ services:
- "20909:20909"
- "20911:20911"
- "20912:20912"
- networks:
- default:
- ipv4_address: 10.89.2.12
depends_on:
- nameserver
@@ -119,11 +110,8 @@ services:
networks:
default:
- name: rocketmq_default
- driver: bridge
- ipam:
- config:
- - subnet: 10.89.2.0/24
+ name: rocketmq_net
+ external: true
volumes:
broker-0-store:
