至轻云

使用Docker部署至轻云

镜像选择

Docker Hub官方镜像仓库

docker run -p 8080:8080 isxcode/zhiqingyun

阿里云镜像仓库(国内用户推荐）

registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64
registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-arm64

架构说明：

latest-amd64: 适用于 x86_64 架构服务器（常见的 Intel/AMD 处理器）
latest-arm64: 适用于 ARM64 架构服务器（如 Apple M1/M2 芯片的 macOS）

快速启动

docker run \
    --restart=always \
    --name zhiqingyun \
    -e ADMIN_PASSWORD=admin1234 \
    -p 8088:8080 \
    -d registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64

启动后访问

访问地址: http://localhost:8088
管理员账号: admin
管理员密码: admin1234

⚠️ 安全提示: 生产环境请务必修改默认密码！

变量配置

变量名	说明	默认值	示例
ADMIN_PASSWORD	管理员初始密码	admin123	admin1234
LOG_LEVEL	日志级别	info	info, debug, warn
ACTIVE_ENV	环境配置文件	docker	dev, prod
PARAMS	SpringBoot参数	-	--spring.flyway.enabled=true

📝 注意: ADMIN_PASSWORD 仅在首次启动时生效，密码会保存到数据库中。如需修改密码，请在系统中操作或清空数据库重新初始化。

数据持久化

创建本地目录

mkdir -p /data/zhiqingyun/data
mkdir -p /data/zhiqingyun/conf

配置文件下载

# 下载默认配置文件
curl -o /data/zhiqingyun/conf/application-docker.yml \
  https://raw.githubusercontent.com/isxcode/spark-yun/refs/heads/main/spark-yun-backend/spark-yun-main/src/main/resources/application-docker.yml

挂载说明

容器路径	说明	推荐挂载
`/var/lib/zhiqingyun`	数据存储目录（数据库、文件等）	`/data/zhiqingyun/data`
`/etc/zhiqingyun/conf`	配置文件目录	`/data/zhiqingyun/conf`

参考命令

docker run \
    --restart=always \
    --name zhiqingyun \
    -e ADMIN_PASSWORD=admin123 \
    -e LOG_LEVEL=info \
    -e ACTIVE_ENV=docker \
    -e PARAMS="--spring.flyway.enabled=true" \
    -v /data/zhiqingyun/data:/var/lib/zhiqingyun \
    -v /data/zhiqingyun/conf:/etc/zhiqingyun/conf \
    -p 8088:8080 \
    -d registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64

查看容器状态

# 查看容器运行状态
docker ps -a | grep zhiqingyun

# 查看容器日志
docker logs -f zhiqingyun

# 停止容器
docker stop zhiqingyun

# 重启容器
docker restart zhiqingyun

# 停止并删除旧容器和镜像
docker stop zhiqingyun && docker rm zhiqingyun
docker tag registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64 registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64-bak-20250728 
docker rmi registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64

# 拉取最新镜像
docker pull registry.cn-shanghai.aliyuncs.com/isxcode/zhiqingyun:latest-amd64