HHostingByteSoftware
Ctrl K
ComunidadGuías…

env.conf

Rama main · réplica de lectura del repositorio original.

Archivo original ↗Preguntar a KiBot
# DSH框架站点配置（随仓库分发）
# 这是站点唯一的配置源：框架参数与插件业务配置都在这里维护一份，部署机拉取后直接使用，
# 不再需要在服务器上现场创建配置文件。
# KEY=VALUE是字面量，不执行shell；复杂值用单行JSON，路径相对显式项目root。
# 留空采用该入口默认行为；修改文件后通过正常部署流程受控重启。
# API空值不是删除；若启动环境有同名密钥，官方仍会优先使用且网页只读。
# DSH_PLUGIN_CONFIG 是插件业务参数的唯一人工维护处：构建时按插件ID派生到各插件运行位置，
# 写了某个插件就以它为准（改了配置在下次构建生效）；没有写的插件沿用现场文件。
# 本文件描述的是部署目标站点；在开发机上做本地发布验证时用 --config 指向本机配置，避免互相覆盖。

# 一、常用配置：公网访问时核对地址，只填写需要使用的模型凭据

# 对外访问地址。不带路径或末尾斜杠；本机默认为 http://127.0.0.1:7902，公网部署填写自己的地址。
DSH_PUBLIC_URL="https://dsh.pelycloud.com"

# 认证请求来源。留空沿用 DSH_PUBLIC_URL；认证启用时必须与实际浏览器来源一致。
DSH_PUBLIC_ORIGIN="https://dsh.pelycloud.com"

# 官方控制台信任主机，JSON数组，例如 ["dsh.example.com"]。公网访问需配置；不带协议或路径，不使用通配符。
DSH_TRUSTED_HOSTS=["dsh.pelycloud.com"]

# 私密：官方DeepSeek API Key。非空时文件优先、网页只读；留空不添加覆盖，沿用官方已有凭据。
DEEPSEEK_API_KEY=

# 私密：智谱API Key。非空时文件优先、网页只读；留空不添加覆盖。还需在官方DSH配置相应模型路由。
ZHIPU_API_KEY=

# 二、高级部署配置：通常无需填写，改变默认行为或迁移旧站点时使用

# 非容器宿主监听地址，默认 127.0.0.1。源码Compose仍使用回环监听，公网通过反向代理访问。
DSH_BIND_HOST=

# 监听端口，默认7902，范围1到65535；自定义后同时核对访问URL。
DSH_PORT=7902

# 官方profile，默认web。已有站点切换需要迁移，不能当成无损改名。
DSH_PROFILE="web"

# 候选插件ID的JSON数组。留空表示清单里的全部候选（builtin 加全部 incoming）；[]表示空选集。
DSH_PLUGINS=["auth","agents-group","example","butler","niuma-boss"]

# release或development。独立管理器及有配置的启动默认release；源码容器部署只使用release。
DSH_MODE=

# owned或external。独立同步默认external，需要原管理者停服证据；start由管理器拥有宿主。
DSH_HOST_MODE=

# 持久数据根，默认.local/data。已有目录必须沿用或正式迁移，不能删除排错。
# 下面五条持久路径显式写成相对路径：相对路径锚定显式项目root，任何部署机解析结果一致；
# 显式声明还让「沿用既有目录」的判定不依赖现场是否碰巧存在同名旧目录。
DSH_DATA_DIR=".local/data"

# DSH数据目录，默认数据根下dsh-home。含凭据、账号与会话；沿用旧站点已解析路径。
DSH_HOME=".local/data/dsh-home"

# 工作目录，默认数据根下workspace。相对路径以显式项目root为基准。
DSH_WORKSPACE=".local/data/workspace"

# 官方控制台认证地址输出，默认数据根下dsh-web-auth-url.txt。此文件含令牌，勿公开。
DSH_AUTH_URL_FILE=".local/data/dsh-web-auth-url.txt"

# 管理器产物目录，默认.local/artifacts；源码构建记录始终位于仓库.local/artifacts/source-release-*。不得与持久数据重叠或通过clean删除。
DSH_DEPLOY_ARTIFACTS=".local/artifacts"

# 非容器运行的官方源码根，需提前准备独立依赖。与已安装CLI来源按原优先级选择，不自动下载。
DSH_HARNESS_ROOT=

# 非容器运行的已安装官方CLI JavaScript入口；独立交付按实际安装位置填写。
DSH_CLI_JS=

# 非容器官方CLI可执行文件；未指定其他宿主来源时默认从PATH使用dsh。
DSH_CLI=

# 额外官方patch文件路径的JSON数组，默认[]。模型路由和默认模型复用官方设置；API Key不会自动创建路由。
DSH_PATCHES=

# 按插件ID组织的文件引用，支持settingsFile/runtimeConfig/configRevision。业务参数由DSH_PLUGIN_CONFIG维护。
DSH_INSTANCES={}

# 是否离线安装，true/false，默认false。须预先准备完整依赖闭包，仅填写true不代表已具备离线能力。
# 宿主 0.1.7 升级（2026-09-24）：官方 vendor 3.18.4 刚发布，历史离线闭包不含，转在线安装一次
# 待依赖落盘后再评估恢复离线。
DSH_OFFLINE=false

# 独立安装的pnpm store位置；留空沿用包管理器默认，容器使用受管数据根。
DSH_STORE_DIR=

# 独立安装的包缓存位置；留空沿用默认。
DSH_CACHE_DIR=

# 已准备的离线store输入目录；容器只读挂载，不修改源。
DSH_OFFLINE_STORE_DIR=".local/offline/store"

# 已准备的离线cache输入目录；容器只读挂载，不修改源。
DSH_OFFLINE_CACHE_DIR=".local/offline/cache"

# Compose项目名，默认dsh-plugins。每站点独占，已有站点不得随意更换。
DSH_COMPOSE_PROJECT="dsh-plugin-manager"

# 容器非root用户ID，通用默认1000；自动新站点按平台初始化，macOS采用当前非root用户；显式配置保留，不自动递归修改已有属主。
DSH_CONTAINER_UID=1000

# 容器非root用户组ID，通用默认1000；自动新站点按平台初始化，macOS采用当前用户组；显式配置保留，须能访问运行输入与数据。
DSH_CONTAINER_GID=1000

# 可选预构建宿主镜像，必须为不可变仓库@sha256摘要；留空按源码部署流程构建/复用。
DSH_HOST_IMAGE=

# 可选部署镜像推送目标：仓库主机/项目/镜像，不含tag。留空仅使用本机镜像。
DSH_PUBLISH_IMAGE=

# 仅独立apply-compose输入：不可变镜像ID或仓库摘要。源码一键构建自动生成，必须留空。
DSH_CONTAINER_IMAGE=

# 仅独立归档消费：发布清单路径。源码一键构建自动生成，必须留空。
DSH_MANIFEST=

# 独立健康验收的宿主地址；留空沿用相应启动入口的原默认行为。
DSH_BASE_URL=

# 插件业务配置：按插件ID组织的JSON对象，值是该插件运行配置文件的完整内容（JSON）。
# 构建时按插件ID派生到各插件运行位置；各 Agent 从自己的小节读，字段名与该 Agent 原有的环境变量/配置保持一致。
DSH_PLUGIN_CONFIG={"agents-group":{"$comment":"智能体群组的业务配置。各 Agent 从自己的小节读取，字段名与该 Agent 原有的环境变量/配置保持一致；dsn 供群组存储层使用。","closedoff":{"CLOSEDOFF_BASE_URL":"https://btsys.btgyyq.cn/api","CLOSEDOFF_OPEN_CLIENT_ID":"GwyV4FM8zttxaDevKvvX","CLOSEDOFF_OPEN_CLIENT_SECRET":"VK6watpuxHVKZeMuxntmKbQRvbkCcC","CLOSEDOFF_APP_CODE":"closed-off-mgt","CLOSEDOFF_APP_CLIENT_ID":"1216011633617272832","CLOSEDOFF_APP_CLIENT_SECRET":"Ay9HMDMwMjIwMjYxMDM3MTE0ODkL5q","CLOSEDOFF_USERNAME":"cqbtadmin"},"blog":{"blog":{"url":"https://pelyblog.com","username":"dpl","password":"dengpeilin123"},"image":{"url":"https://img.pelycloud.com","username":"544010165@qq.com","password":"dengpeilin@123","strategyId":2,"maxBytes":10485760},"schemaVersion":1,"backup":{"url":"http://127.0.0.1:7913","token":"ad425e675e4394ac922e5d91c2ea85a289f22209bdef154f457a77e4020b8ce4","allowedUserIds":["c09c318c-8c39-4f6d-9fa7-ac1b332456a4"]},"models":{"text":{"provider":"zhipu","model":"glm-5.3"},"vision":{"provider":"zhipu","model":"glm-5v-turbo"}}},"huiyu":{"HUIYU_MINIO_ENDPOINT":"http://127.0.0.1:3101","HUIYU_MINIO_BUCKET":"huiyu","HUIYU_MINIO_REGION":"us-east-1","HUIYU_MINIO_ACCESS_KEY":"dpl","HUIYU_MINIO_SECRET_KEY":"dengpeilin@123","HUIYU_PUBLIC_BASE_URL":"https://img.pelycloud.com","HUIYU_IMAGE_PROVIDER":"ciyuan-images","HUIYU_IMAGE_BASE_URL":"https://img.ciyuan.fast","HUIYU_IMAGE_MODEL":"gpt-image-2"},"dsn":"postgresql://postgres:dengpeilin%40123@127.0.0.1:7780/dsh"},"butler":{"dsn":"postgresql://postgres:dengpeilin%40123@127.0.0.1:7780/dsh"}}

# 三、可选镜像仓库与构建环境：不使用Harbor、不调整构建环境时留空

# 是否使用Harbor镜像分流，true/false，默认false。
HARBOR_ENABLED=

# Harbor明确缺少镜像时是否允许上游回退，默认true；认证、网络和TLS错误不能回退。
ALLOW_UPSTREAM=

# 可选镜像仓库主机，可带端口，不带协议或路径。启用Harbor时必填。
REGISTRY_HOST=

# 镜像仓库基础镜像项目，默认library。
BASE_PROJECT=

# 宿主与工具链镜像项目，默认dsh。
APP_PROJECT=

# 宿主镜像名称，默认dsh-host，不含仓库、项目或tag。
IMAGE_NAME=

# 私密：仓库登录用户名；需要认证时与密码成对填写，匿名访问留空。
REGISTRY_USERNAME=

# 私密：仓库登录密码；仅用于临时Docker登录，不传给业务宿主、不写入镜像或命令参数。
REGISTRY_PASSWORD=

# 官方源码构建基础镜像；默认docker.io/library/node:24-bookworm-slim。
DSH_SOURCE_BASE_IMAGE=

# Debian软件源地址，默认http://deb.debian.org，可按网络情况设置镜像源。
DSH_DEBIAN_MIRROR=http://mirrors.tuna.tsinghua.edu.cn

# 容器构建平台：linux/amd64或linux/arm64，通用默认linux/amd64；自动新站点按Docker引擎初始化，显式配置保留。
DSH_IMAGE_PLATFORM=