Skip to content

配置参数

指定配置文件

运行面板程序时通过 -f 参数指定配置文件。

shell
dpanel server:start -f /etc/dpanel/config.yaml

修改配置

直接修改 config.yaml

直接修改 config.yaml 文件中的对应配置即可。

通过启动命令覆盖配置

shell
dpanel server:start -f /etc/dpanel/config.yaml -e STORAGE_LOCAL_PATH=/home/dpanel

通过环境变量覆盖配置

shell
export STORAGE_LOCAL_PATH=/home/dpanel && dpanel server:start -f /etc/dpanel/config.yaml

参数说明

名称描述默认值版本
APP_NAME程序名称dpanel-
APP_VERSION程序版本--
APP_SERVER_HOST程序运行绑定地址0.0.0.0-
APP_SERVER_PORT程序运行绑定端口8086-
APP_SERVER_SOCKET程序运行额外监听的 Unix Socket 文件路径,留空表示不启用--
STORAGE_LOCAL_PATH程序运行产生的数据目录./-
DP_DB_MODE数据库读写模式 ro|rw|rwcrwc-
DP_ACME_COMMAND_NAME覆盖 acme 的命令路径/root/.acme/acme.sh-
DP_ACME_CONFIG_HOME覆盖 acme 的配置目录/root/.acme/-
DP_SYSTEM_BASEURL面板访问 baseurl-> 1.9.1
DP_LOG_CONSOLE_LEVEL日志级别 info|debuginfo> 1.10.0
DP_RUN_IN_CONTAINER是否在容器中运行1> 1.10.0
DP_DB_JOURNALsqlite 模式 WAL | DELETEDELETE> 1.10.0

Unix Socket 监听

APP_SERVER_SOCKET 用于在原有 HTTP 端口之外额外开启一个 Unix Socket 监听,例如:

shell
dpanel server:start -f /etc/dpanel/config.yaml -e APP_SERVER_SOCKET=/run/dpanel/dpanel.sock

启用后程序会监听 APP_SERVER_SOCKET 指定的 socket 文件路径,并自动创建父级目录。如果该路径已经存在且是 socket 文件,启动时会先删除旧文件再重新监听;如果该路径存在但不是 socket 文件,程序会启动失败。

配置文件

yaml
app:
  name: ${APP_NAME-dpanel}
  version: ${APP_VERSION}
  env: ${APP_ENV-lite}
  family: ${APP_FAMILY-ce}
  server: ${APP_SERVER-http}
  cors:
    - http://localhost:8000
server:
  http:
    host: ${APP_SERVER_HOST-0.0.0.0}
    port: ${APP_SERVER_PORT-8086}
    socket: ${APP_SERVER_SOCKET}
  prof:
    host: 0.0.0.0
    port: 8087
log:
  default:
    driver: stack
    channels:
      - file
      - console
  file:
    driver: file
    path: ${STORAGE_LOCAL_PATH}/logs/dpanel.log
    level: warn
  console:
    driver: console
    level: debug
database:
  default:
    driver: sqlite
    user_name: ${DB_USERNAME-root}
    password: ${DB_PASSWORD-123456}
    db_name: ${STORAGE_LOCAL_PATH}/dpanel.db
    charset: utf8mb4
    prefix: ims_
    options:
      mode: ${DP_DB_MODE}
system:
  baseurl: ${DP_SYSTEM_BASEURL}
  storage:
    local:
      path: ${STORAGE_LOCAL_PATH}
  permission:
    default_username: __public__
  docker:
    timeout: ${DP_SYSTEM_DOCKER_TIMEOUT-10}