方式一 · 直接下载(推荐)

单个文件约 83MB,内置全部数据库驱动,无需联网。

方式二 · 源码构建

需要 JDK 17+ 与 Maven,构建产物在 target/muopt.jar。

git clone https://github.com/vfaner/muopt.git
cd muopt
mvn clean package
Run

一行命令启动

系统要求:JDK 17+ · Windows / macOS / Linux 均可 · 运行无需联网。

java -jar muopt.jar

# 可选:覆盖端口 / 监听地址(默认 8080,仅监听 127.0.0.1)
java -jar muopt.jar --server.port=8080 --server.address=0.0.0.0

启动后浏览器打开 http://localhost:8080,注册首个账号即可使用。公网 / 局域网暴露请自行加网关鉴权。

Container

Docker / Kubernetes 部署

镜像以非 root 用户运行,内置健康检查;数据与日志使用卷持久化。集群清单在仓库 deploy/k8s/。

Docker

多阶段构建,无需本机安装 Maven / JDK。

# 项目根目录构建镜像
docker build -t muopt:1.1.1 .

# 启动,数据/日志用命名卷持久化
docker run -d --name muopt -p 8080:8080 \
  -v muopt-data:/app/data -v muopt-logs:/app/logs \
  -e APP_CRYPTO_PASSWORD='强随机口令' \
  --restart unless-stopped muopt:1.1.1

Docker Compose

单机部署最省心,一条命令构建并启动。

# 可选:先设置加密口令
export APP_CRYPTO_PASSWORD='强随机口令'

docker compose up -d --build
docker compose logs -f
docker compose down

数据保存在命名卷 muopt-data,停止容器不会丢失。

Kubernetes

Namespace / PVC / Deployment / Service / Ingress 全套清单。

docker build -t registry.example.com/muopt:1.1.1 .
docker push registry.example.com/muopt:1.1.1

# 先创建加密口令 Secret
kubectl apply -f deploy/k8s/secret.yaml
kubectl apply -k deploy/k8s
kubectl -n muopt get pods
K8s 部署说明 →

⚠️ 内嵌 H2 配置库同一时刻只允许一个写进程:K8s 固定 单副本 + Recreate,请勿改为多副本或滚动更新;经 Ingress 访问时应用内「在线自更新」不可用,请通过更新镜像升级。

数据与备份

数据源、AI 模型、账号都存在 jar 同级的 ./data H2 文件库中,重启不丢;日志在 ./logs。备份 = 整目录拷走,升级前建议先备;切勿删除 data 目录。部署路径不便时可用环境变量 APP_DATA_DIR 指定绝对路径。

AI 配置(可选)

不配置 AI,规则引擎全功能可用;配置后可解锁深度改写与转换润色。支持 OpenAI 兼容与 Anthropic 双协议,保存前可一键测试连通性。

AI 模型配置详解 →