Quick Start
快速开始
五分钟跑起来:下载 → 启动 → 注册 → 连库开跑。
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
# 可选:覆盖端口 / 监听地址(默认 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 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
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 部署说明 →
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
⚠️ 内嵌 H2 配置库同一时刻只允许一个写进程:K8s 固定 单副本 + Recreate,请勿改为多副本或滚动更新;经 Ingress 访问时应用内「在线自更新」不可用,请通过更新镜像升级。
数据与备份
数据源、AI 模型、账号都存在 jar 同级的 ./data H2 文件库中,重启不丢;日志在 ./logs。备份 = 整目录拷走,升级前建议先备;切勿删除 data 目录。部署路径不便时可用环境变量 APP_DATA_DIR 指定绝对路径。
Video
视频教程
三分钟看完核心用法。