Skip to content

面板控制命令 DPanel Version >= 1.2.2

TIP

控制命令需要进入 DPanel 面板容器运行。如果你更改了 DPanel 面板的容器名称,请将下方命令中的 dpanel 替换成你的面板容器名字

  1. 登录服务器的 ssh
  2. 通过 docker exec 命令执行 DPanel 容器中的控制命令
  3. 根据需求,执行对应的命令

重置管理员用户

快速重置

将使用随机密码重置用户

docker exec dpanel ./dpanel -f config.yaml user:reset

重置密码

docker exec dpanel ./dpanel -f config.yaml user:reset --password 123456

重置用户名

重置用户名时,必须指定密码

docker exec dpanel ./dpanel -f config.yaml user:reset user:reset --password 123456 --username root

DANGER

调用以下命令时,安装面板时需要 配置面板的 DP_JWT_SECRET 环境变量

更新应用商店数据

  • --name 指定应用商店名称
docker exec dpanel ./dpanel -f config.yaml store:sync --name 应用商店标识

返回

{"total":151}

检测容器镜像是否有新版

  • --name 指定检测的容器名称
  • --docker-env 指定 docker env 环境名称
docker exec dpanel ./dpanel -f config.yaml container:upgrade --name 容器名称 --docker-env local

返回

upgrade 为 true 表示有更新

{"upgrade":false,"digest":"sha256:8f4ac2974ff707bace98ab14923fdf220f44a9803045b655f1d8d3e098f97e55","digestLocal":["registry.cn-hangzhou.aliyuncs.com/dpanel/dpanel@sha256:8f4ac2974ff707bace98ab14923fdf220f44a9803045b655f1d8d3e098f97e55"]}

当容器有更新时升级容器

  • --name 指定检测的容器名称
  • --upgrade 当容器有更新时升级容器
  • --docker-env 指定 docker env 环境名称
docker exec dpanel ./dpanel -f config.yaml container:upgrade --name 容器名称 --upgrade

返回

当容没有更新时,返回与 【检测容器镜像是否有新版】 一致

{"containerId": "14fc0a4d5e3e31f98f9179512085299b5c502ddf57d584ce39a7cadab6e3f643"}

生成容器快照

  • --name 指定检测的容器名称
  • --docker-env 指定 docker env 环境名称
  • --enable-image 是否备份容器镜像
docker exec dpanel ./dpanel -f config.yaml container:backup --name 容器名称 --enable-image 1

返回

{"path":"/dpanel/backup/dpanel-doc/dpanel-dpanel-doc-20250424175215.snapshot"}

部署或升级 compose 任务

  • --name compose 任务名称,面板已经部署或是可发现的任务名称
  • --docker-env 指定 docker env 环境名称
  • --environment yaml 中所需要的环境变量,可配置多个
  • --service-name 只定要部署的的服务名称,可配置多个
  • --remove-orphans 清理删除已失效的服务容器
  • --pull-image 指定拉取镜像方式 dpanel command
docker exec dpanel ./dpanel -f config.yaml compose:deploy --name 任务名称 --remove-orphans 1 --environment name=test --environment age=10 --service-name test --service-name test2 --pull-image dpanel

返回

{"name":"test123"}