面板控制命令 DPanel Version >= 1.2.2
调用方式
执行命令时请根据当前环境修改示例代码。
容器安装
TIP
请将下方命令中的 dpanel 替换成你的面板容器名字
在宿主机执行
- 登录服务器 ssh
- 通过
docker exec命令执行 DPanel 容器中的控制命令
docker exec dpanel system:info在操作台 / 容器内部执行
如果可以登录 DPanel 面板可以在操作台中的 本地 Shell 执行命令
dpanel system:info二进制调用
TIP
旧版本没有 service.sh 脚本，可使用 安装器 重新生成。飞牛系统请更新 DPanel 到最新版。
/root/dpanel-5/service.sh system:info飞牛系统
/vol1/@appcenter/dpanel/server/service.sh system:info查看系统信息
system:info 输出当前 DPanel 的运行环境、访问地址、安全入口以及管理员账号（密码脱敏）等信息。
dpanel system:info重置管理员用户
快速重置
使用随机密码重置用户
dpanel user:reset重置密码
dpanel user:reset --password 123456重置用户名
重置用户名时，必须指定密码
dpanel user:reset user:reset --password 123456 --username root设置安全入口
WARNING
配置 none 时为关闭安全入口访问功能
- --entrance 指定安全访问地址，为空为随机生成
dpanel system:reset --entrance系统清理与重置
- --cache 清理可重建缓存、通知、Docker 事件和临时文件
- --online-user 使所有在线用户失效
dpanel system:reset --cache --online-user更新应用商店数据
- --name 指定应用商店名称
dpanel store:sync --name test返回
{"total":151}检测容器更新
- --name 指定检测的容器名称
- --docker-env 指定 docker env 环境名称，默认: local
控制命令每次执行都会跳过已有检查缓存，直接查询远程仓库。
dpanel container:upgrade --name containerName --docker-env local返回
upgrade为true表示有更新。检查失败时，error会返回具体原因。
{"upgrade":false,"digest":"sha256:8f4ac2974ff707bace98ab14923fdf220f44a9803045b655f1d8d3e098f97e55","digestLocal":["registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel@sha256:8f4ac2974ff707bace98ab14923fdf220f44a9803045b655f1d8d3e098f97e55"],"error":""}升级容器
- --name 指定容器名称
- --docker-env 指定 docker env 环境名称
- --enable-bak 是否备份旧容器，默认: true
- --disable-bak 不备份旧容器，等同于 --enable-bak=false
- --image-tag 指定新的镜像名称，此镜像一定要与容器的镜像完全兼容
dpanel container:upgrade --upgrade --disable-bak --name containerName返回
执行升级前会先检查容器镜像更新，检查逻辑与【检测容器更新】一致。
{"containerId": "14fc0a4d5e3e31f98f9179512085299b5c502ddf57d584ce39a7cadab6e3f643"}生成容器快照
- --name 指定检测的容器名称
- --docker-env 指定 docker env 环境名称
- --enable-image 是否备份容器镜像
- --backup-image 备份镜像类型 image 或是 container (docker commit)
- --enable-volume 是否备份挂载目录
- --backup-volume 指定备份的挂载目录
dpanel container:backup --name 容器名称 --enable-image --enable-volume返回
{"path":"/dpanel/backup/dpanel-doc/dpanel-dpanel-doc-20250424175215.snapshot"}部署或升级 compose 任务
- --name compose 任务名称，面板已经部署或是可发现的任务名称
- --docker-env 指定 docker env 环境名称
- --environment yaml 中所需要的环境变量，可配置多个, --environment test=1
- --pull-image 指定拉取镜像方式 dpanel command
dpanel compose:deploy --name 任务名称 --environment name=test --environment age=10 --pull-image dpanel返回
{"name":"test123"}发送通知 DPanel Version >= 1.9.2
- --subject 通知的标题
- --content 通知的内容
- --target 通知的目标，邮件的方式为邮箱。
- --channel 通知的方式 email
dpanel system:notice --content test123 --target 914417117@qq.com --subject 我来测试一下返回
{"code":200,"error":"","data":"success"}简易缓存数据存储 DPanel Version >= 1.9.2
利用缓存数据存储功能，可在脚本中进行数据缓存或标志位检测。
- --key 缓存名称
- --value 缓存内容，为空时获取 --key 的内容
- --keep 缓存生命周期（秒），默认为 -1（直到主程序重启）
dpanel system:cache --key test1 --value 123返回
{"value":"123","found":true}备份面板数据 DPanel Version >= 1.9.4
备份 DPanel 面板的数据
- --backup-path 要备份的目录，留空为全部
- --ignore-path-prefix 跳过备份的目录前缀，--ignore-path-prefix storage/temp 跳过 storage/temp 开头的目录或是文件
dpanel system:backup返回
{"path":"dpanel-main-20260226191909.snapshot"}