Dashy 自托管平台部署全指南Portainer、Coolify、1Panel 等一键安装方案与 Dashy 4 配置挂载要点【免费下载链接】dashy A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!项目地址: https://gitcode.com/GitHub_Trending/da/dashyDashy 官方为 Portainer、Coolify、1Panel、CasaOS、Umbrel、Easypanel 等常见自托管控制面板与家用服务器平台提供了现成的应用模板、一键安装脚本与应用商店条目。本文以官方部署文档为主体结合仓库内真实的 Docker 镜像、Compose 配置与 Node 服务端源码系统讲解在这些平台上安装 Dashy 的完整步骤、Dashy 4.x 最关键的配置目录变化/app/user-data以及每个方案需要注意的版本与权限坑位。读完本文你可以根据自己已有的自托管基础设施选出一条最省事且可长期维护的 Dashy 部署路径。部署前必读Dashy 4 的核心变化与通用原则在动手之前官方文档给出了两条适用于所有平台的前提务必先确认版本必须新请确保安装的 Dashy 版本是近期版本或最新版例如 4.x 及以上。社区模板普遍滞后许多第三方模板仍停留在 3.x安装后需要手动修正镜像标签。第三方集成不提供官方支持下文列出的多数集成属于非官方/第三方维护如社区应用商店、Helm Chart、Ansible 角色Dashy 官方无法为这些集成本身提供支持遇到问题应在对应集成仓库中反馈。为什么说/app/user-data是 Dashy 4 的关键本文几乎所有平台条目都在反复强调同一个问题Dashy 4 将配置目录从/app/public/conf.yml迁移到了/app/user-data。旧模板把配置挂载在/app/public这在新版本中已经不再生效。这一变化的底层依据可以从仓库中直接找到官方 docker-compose.yml 中明确注释Mount the directory for your conf and assets to/app/user-data该目录必须包含一个conf.ymlDashy 的主配置文件同时还可以存放子配置、图标、样式表、字体等任何希望从 Web 根目录/对外服务的静态资源。Dockerfile 在构建镜像时会预置./user-data/conf.yml到/app/user-data/conf.yml并设置PORT8080、HOST0.0.0.0、IS_DOCKERtrue。服务端通过环境变量USER_DATA_DIR定位配置目录默认./user-data/相关读写逻辑集中在 services/endpoints/api/config-files.js 与 services/endpoints/save-config.js 中后文会展开说明。因此无论使用哪个平台最终目标都是把宿主上包含conf.yml的目录挂载到容器内的/app/user-data并把容器端口 8080 映射到宿主端口。镜像与标签选择建议官方 Docker 文档docs/deployment/docker.md给出了镜像使用规范可作为所有平台的通用参考镜像同时发布在 Docker Hublissy93/dashy与 GHCRghcr.io/lissy93/dashy均为多架构镜像amd64 arm64同一标签可自动适配宿主机架构。标签体系latest、精确版本如4.6.5即当前 package.json 中声明的版本、滚动小版本/主版本标签4.3、4.x。容器内以node用户uid 1000运行。若挂载的user-data目录属主不一致会出现权限错误可通过chown修正或在 Compose 中用user: 1000:1000覆盖先用id -u/id -g查看宿主 uid。逐平台部署指南Portainer通过 Stacks 或应用模板部署Portainer 是 Docker 宿主最常用的图形化管理面板官方推荐两种方式方式一Stacks 直接部署打开 Portainer进入Stacks Add stack粘贴 docker-compose.yml 的内容或直接指向该文件 URL 让 Portainer 拉取按需调整端口与卷映射点击 Deploy the stack 部署。官方文档特别提醒部分旧版 Portainer 模板把配置挂载在/app/public/conf.ymlDashy 4 必须改为/app/user-data。以仓库根目录的 docker-compose.yml 为基准正确的卷映射写法是services: dashy: image: lissy93/dashy:latest container_name: Dashy ports: - 4000:8080 # 宿主端口:容器端口容器端口必须保持 8080 volumes: - ./user-data:/app/user-data # 目录内必须包含 conf.yml environment: - NODE_ENVproduction restart: unless-stopped方式二应用模板市场在 Portainer 的Settings App Templates中添加社区模板列表lissy93/portainer-templates源地址为https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json之后便可在 Templates 标签页中直接安装 Dashy。Coolify服务模板一键部署Coolify 是自托管的 PaaS 平台Heroku/Netlify 的替代品Dashy 已收录为其服务模板在 New Resource Service中搜索 Dashy 即可部署。需要注意当前模板仍可能将配置挂载在/app/public/conf.yml与 Portainer 一样部署后请将挂载目录改为/app/user-data以适配 Dashy 4。模板源文件位于 Coolify 仓库的templates/compose/dashy.yaml。1Panel官方应用商店安装1Panel 是基于 Web 的 Linux 服务器管理面板Dashy 已上架其官方应用商店打开应用商店App Store搜索 Dashy点击安装Install设置对外端口即可。注意1Panel 公开应用页当前仍列出较旧的 Dashy 3.x 版本。如果安装器允许修改镜像请将镜像改为lissy93/dashy:latest或近期 4.x 标签否则将无法获得 4.x 的功能与配置目录行为。Runtipi家用服务器管理平台Runtipi 是家用服务器管理平台Dashy 应用源码维护在 runtipi 社区应用商店中。安装步骤先安装 Runtipi 本体curl -L https://setup.runtipi.io | bash浏览器打开tipi.local进入App Store应用商店→ 搜索 → Dashy一键安装Cosmos Cloud内置市场安装Cosmos Cloud 是自带反向代理和应用市场的自托管服务器管理器Dashy 已在官方市场中无需额外添加源打开 Cosmos 管理后台进入Market市场搜索 Dashy 并点击Install安装接受默认设置或为你的conf.yml指定挂载路径然后确认。Cosmos 会自动拉取lissy93/dashy:latest并为你配置好反向代理。与前述平台类似当前 Cosmos 模板仍把配置挂在/app/public。Dashy 4 下请编辑该服务将配置目录挂载到/app/user-data。CasaOS含 ZimaOS通过 BigBear 社区商店安装Dashy 不在 CasaOS 内置商店中但社区维护的BigBear 应用商店提供了 Dashy v4 条目在 CasaOS 的App Store应用商店中打开菜单选择Add Source添加源粘贴社区商店源码地址https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zip并保存商店中出现BigBearCasaOS分类搜索Dashy v4并点击Install安装。重要警告该商店中列有两个 Dashy 应用。务必选择 Dashy v4对应镜像lissy93/dashy:4.0.8另一个名为 Dashy 的条目被固定在了旧版3.3.1请勿选择。同一 BigBear 商店的安装步骤同样适用于ZimaOSZimaboard。Umbrel仅存社区商店且已停止维护Dashy 不在 Umbrel 官方商店中。社区商店dennys-umbrel-app-store曾收录 Dashy但该商店已由维护者停止维护且锁定 Dashy3.x不会获得任何更新官方文档将其定位为最后手段last resort。如果坚持安装在 Umbrel 的App Store应用商店中打开三点菜单选择Community App Stores社区应用商店添加https://github.com/dennysubke/dennys-umbrel-app-store打开该商店找到Dashy并点击Install安装运行在 4444 端口。更推荐的替代方案直接在 Umbrel 宿主上使用 Docker 方式运行 Dashy参见 Docker 部署指南以获得最新版本与完整功能。Easypanel模板一键部署Easypanel 是自托管服务器控制面板提供 Dashy 模板https://easypanel.io/docs/templates/dashy。该模板运行完整的 Docker 镜像因此包括 Node 服务端在内的全部功能状态检查、UI 保存配置等均可使用。注意Easypanel 模板锁定了旧版本3.3.1。部署完成后请将镜像标签改为lissy93/dashy:latest或近期 4.x 版本以获得当前版本。SaltboxAnsible 自动化安装Saltbox 是基于 Ansible 的服务器自动化项目将 Dashy 作为 sandbox 应用收录。Saltbox 配置完成后执行sb install sandbox-dashy即可完成安装详见 Saltbox 官方 Dashy 文档。部署后的通用配置要点源码级解析无论选择哪个平台部署完成后都建议对照以下要点核对环境它们直接决定 Dashy 4 的可用性。端口与宿主映射容器内部服务端口固定为 8080可通过PORT环境变量覆盖这在 server.js 中有明确逻辑const port process.env.PORT || (isDocker ? 8080 : 4000);——Docker 环境下默认 8080裸金属bare metal默认 4000宿主映射时保持容器端口为 8080即可。宿主端口如 4000、4444、8080可自由选择避免与已有服务冲突。配置目录挂载与文件权限挂载目录必须包含conf.yml且属主应匹配容器内node用户uid 1000。一个最小可用的配置可参考仓库中的 user-data/conf.yml它由pageInfo页面元信息、appConfig主题等应用设置与sections分区与条目数组三大部分构成。从服务端实现看services/endpoints/api/config-files.jsUSER_DATA_DIR环境变量决定配置目录位置REST API 会读取该目录下所有.yml/.yaml文件根配置conf.yml在写入时会用 src/utils/config/ConfigSchema.jsonJSON Schema做严格校验子页面则不做全量校验。通过 UI 保存配置时的备份行为Dashy 4 的在 UI 中保存配置功能依赖 Node 服务端services/endpoints/save-config.js。写入前服务端会自动把旧配置备份到config-backups/目录文件名形如conf-时间戳.backup.yml因此要求挂载目录对容器可写。相关可调环境变量USER_DATA_DIR配置目录默认./user-data/BACKUP_DIR备份目录默认在配置目录下的config-backupsDISABLE_CONFIG_BACKUPS设为true可关闭自动备份配置大小上限为 256 KBMAX_CONFIG_BYTES。这也解释了为什么基于静态构建的部署如 NixOS 的dashy-ui包会缺少这类服务端专属能力——详见 docs/deployment/self-hosted-os.md。健康检查Healthcheck官方 docker-compose.yml 与 Dockerfile 均内置健康检查实际执行逻辑在 services/healthcheck.js向/healthz发送请求返回 200 则退出码为 0健康否则为 1。镜像内置的检查默认每 5 分钟执行一次Compose 中也可自定义间隔例如healthcheck: test: [CMD, node, /app/services/healthcheck.js] interval: 1m30s timeout: 10s retries: 3 start_period: 30s在支持健康检查状态的平台如 Portainer上配置后可直接在面板中观察 Dashy 的运行状态。版本核对与升级由于多数第三方模板滞后安装后请务必核实版本通过容器镜像标签确认latest或 4.x 具体标签当前仓库版本为 4.6.5见 package.json进入 Dashy 界面后在设置/关于中查看版本号遇到异常行为时先排除是否仍是 3.x 旧版本这一因素——特别是配置挂载路径、UI 编辑器等 4.x 新增/变更的功能。选型小结平台安装方式需手动修正的点PortainerStacks 粘贴 Compose / 社区模板模板若挂/app/public改为/app/user-dataCoolify服务模板搜索同上1Panel官方应用商店镜像标签换为latest或 4.xRuntipi社区应用商店一般无需Cosmos Cloud官方市场配置挂载路径改为/app/user-dataCasaOS / ZimaOSBigBear 社区商店必须选 Dashy v4避开 3.3.1 条目Umbrel已停维护的社区商店建议改用 Docker 直装Easypanel官方模板镜像标签换为latest或 4.xSaltboxsb install sandbox-dashy按 Saltbox 文档配置通用原则只有三条镜像用 4.x、配置挂载到/app/user-data、容器端口保持 8080。如果部署后遇到问题可进一步查阅 Docker 部署文档 与 故障排查指南如需在具体操作系统TrueNAS SCALE、Proxmox、Unraid、Synology、NixOS、Kubernetes 等上部署参见 自托管操作系统部署文档。【免费下载链接】dashy A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!项目地址: https://gitcode.com/GitHub_Trending/da/dashy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Dashy 自托管平台部署全指南：Portainer、Coolify、1Panel 等一键安装方案与 Dashy 4 配置挂载要点
Dashy 自托管平台部署全指南Portainer、Coolify、1Panel 等一键安装方案与 Dashy 4 配置挂载要点【免费下载链接】dashy A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!项目地址: https://gitcode.com/GitHub_Trending/da/dashyDashy 官方为 Portainer、Coolify、1Panel、CasaOS、Umbrel、Easypanel 等常见自托管控制面板与家用服务器平台提供了现成的应用模板、一键安装脚本与应用商店条目。本文以官方部署文档为主体结合仓库内真实的 Docker 镜像、Compose 配置与 Node 服务端源码系统讲解在这些平台上安装 Dashy 的完整步骤、Dashy 4.x 最关键的配置目录变化/app/user-data以及每个方案需要注意的版本与权限坑位。读完本文你可以根据自己已有的自托管基础设施选出一条最省事且可长期维护的 Dashy 部署路径。部署前必读Dashy 4 的核心变化与通用原则在动手之前官方文档给出了两条适用于所有平台的前提务必先确认版本必须新请确保安装的 Dashy 版本是近期版本或最新版例如 4.x 及以上。社区模板普遍滞后许多第三方模板仍停留在 3.x安装后需要手动修正镜像标签。第三方集成不提供官方支持下文列出的多数集成属于非官方/第三方维护如社区应用商店、Helm Chart、Ansible 角色Dashy 官方无法为这些集成本身提供支持遇到问题应在对应集成仓库中反馈。为什么说/app/user-data是 Dashy 4 的关键本文几乎所有平台条目都在反复强调同一个问题Dashy 4 将配置目录从/app/public/conf.yml迁移到了/app/user-data。旧模板把配置挂载在/app/public这在新版本中已经不再生效。这一变化的底层依据可以从仓库中直接找到官方 docker-compose.yml 中明确注释Mount the directory for your conf and assets to/app/user-data该目录必须包含一个conf.ymlDashy 的主配置文件同时还可以存放子配置、图标、样式表、字体等任何希望从 Web 根目录/对外服务的静态资源。Dockerfile 在构建镜像时会预置./user-data/conf.yml到/app/user-data/conf.yml并设置PORT8080、HOST0.0.0.0、IS_DOCKERtrue。服务端通过环境变量USER_DATA_DIR定位配置目录默认./user-data/相关读写逻辑集中在 services/endpoints/api/config-files.js 与 services/endpoints/save-config.js 中后文会展开说明。因此无论使用哪个平台最终目标都是把宿主上包含conf.yml的目录挂载到容器内的/app/user-data并把容器端口 8080 映射到宿主端口。镜像与标签选择建议官方 Docker 文档docs/deployment/docker.md给出了镜像使用规范可作为所有平台的通用参考镜像同时发布在 Docker Hublissy93/dashy与 GHCRghcr.io/lissy93/dashy均为多架构镜像amd64 arm64同一标签可自动适配宿主机架构。标签体系latest、精确版本如4.6.5即当前 package.json 中声明的版本、滚动小版本/主版本标签4.3、4.x。容器内以node用户uid 1000运行。若挂载的user-data目录属主不一致会出现权限错误可通过chown修正或在 Compose 中用user: 1000:1000覆盖先用id -u/id -g查看宿主 uid。逐平台部署指南Portainer通过 Stacks 或应用模板部署Portainer 是 Docker 宿主最常用的图形化管理面板官方推荐两种方式方式一Stacks 直接部署打开 Portainer进入Stacks Add stack粘贴 docker-compose.yml 的内容或直接指向该文件 URL 让 Portainer 拉取按需调整端口与卷映射点击 Deploy the stack 部署。官方文档特别提醒部分旧版 Portainer 模板把配置挂载在/app/public/conf.ymlDashy 4 必须改为/app/user-data。以仓库根目录的 docker-compose.yml 为基准正确的卷映射写法是services: dashy: image: lissy93/dashy:latest container_name: Dashy ports: - 4000:8080 # 宿主端口:容器端口容器端口必须保持 8080 volumes: - ./user-data:/app/user-data # 目录内必须包含 conf.yml environment: - NODE_ENVproduction restart: unless-stopped方式二应用模板市场在 Portainer 的Settings App Templates中添加社区模板列表lissy93/portainer-templates源地址为https://raw.githubusercontent.com/Lissy93/portainer-templates/main/templates.json之后便可在 Templates 标签页中直接安装 Dashy。Coolify服务模板一键部署Coolify 是自托管的 PaaS 平台Heroku/Netlify 的替代品Dashy 已收录为其服务模板在 New Resource Service中搜索 Dashy 即可部署。需要注意当前模板仍可能将配置挂载在/app/public/conf.yml与 Portainer 一样部署后请将挂载目录改为/app/user-data以适配 Dashy 4。模板源文件位于 Coolify 仓库的templates/compose/dashy.yaml。1Panel官方应用商店安装1Panel 是基于 Web 的 Linux 服务器管理面板Dashy 已上架其官方应用商店打开应用商店App Store搜索 Dashy点击安装Install设置对外端口即可。注意1Panel 公开应用页当前仍列出较旧的 Dashy 3.x 版本。如果安装器允许修改镜像请将镜像改为lissy93/dashy:latest或近期 4.x 标签否则将无法获得 4.x 的功能与配置目录行为。Runtipi家用服务器管理平台Runtipi 是家用服务器管理平台Dashy 应用源码维护在 runtipi 社区应用商店中。安装步骤先安装 Runtipi 本体curl -L https://setup.runtipi.io | bash浏览器打开tipi.local进入App Store应用商店→ 搜索 → Dashy一键安装Cosmos Cloud内置市场安装Cosmos Cloud 是自带反向代理和应用市场的自托管服务器管理器Dashy 已在官方市场中无需额外添加源打开 Cosmos 管理后台进入Market市场搜索 Dashy 并点击Install安装接受默认设置或为你的conf.yml指定挂载路径然后确认。Cosmos 会自动拉取lissy93/dashy:latest并为你配置好反向代理。与前述平台类似当前 Cosmos 模板仍把配置挂在/app/public。Dashy 4 下请编辑该服务将配置目录挂载到/app/user-data。CasaOS含 ZimaOS通过 BigBear 社区商店安装Dashy 不在 CasaOS 内置商店中但社区维护的BigBear 应用商店提供了 Dashy v4 条目在 CasaOS 的App Store应用商店中打开菜单选择Add Source添加源粘贴社区商店源码地址https://github.com/bigbeartechworld/big-bear-casaos/archive/refs/heads/master.zip并保存商店中出现BigBearCasaOS分类搜索Dashy v4并点击Install安装。重要警告该商店中列有两个 Dashy 应用。务必选择 Dashy v4对应镜像lissy93/dashy:4.0.8另一个名为 Dashy 的条目被固定在了旧版3.3.1请勿选择。同一 BigBear 商店的安装步骤同样适用于ZimaOSZimaboard。Umbrel仅存社区商店且已停止维护Dashy 不在 Umbrel 官方商店中。社区商店dennys-umbrel-app-store曾收录 Dashy但该商店已由维护者停止维护且锁定 Dashy3.x不会获得任何更新官方文档将其定位为最后手段last resort。如果坚持安装在 Umbrel 的App Store应用商店中打开三点菜单选择Community App Stores社区应用商店添加https://github.com/dennysubke/dennys-umbrel-app-store打开该商店找到Dashy并点击Install安装运行在 4444 端口。更推荐的替代方案直接在 Umbrel 宿主上使用 Docker 方式运行 Dashy参见 Docker 部署指南以获得最新版本与完整功能。Easypanel模板一键部署Easypanel 是自托管服务器控制面板提供 Dashy 模板https://easypanel.io/docs/templates/dashy。该模板运行完整的 Docker 镜像因此包括 Node 服务端在内的全部功能状态检查、UI 保存配置等均可使用。注意Easypanel 模板锁定了旧版本3.3.1。部署完成后请将镜像标签改为lissy93/dashy:latest或近期 4.x 版本以获得当前版本。SaltboxAnsible 自动化安装Saltbox 是基于 Ansible 的服务器自动化项目将 Dashy 作为 sandbox 应用收录。Saltbox 配置完成后执行sb install sandbox-dashy即可完成安装详见 Saltbox 官方 Dashy 文档。部署后的通用配置要点源码级解析无论选择哪个平台部署完成后都建议对照以下要点核对环境它们直接决定 Dashy 4 的可用性。端口与宿主映射容器内部服务端口固定为 8080可通过PORT环境变量覆盖这在 server.js 中有明确逻辑const port process.env.PORT || (isDocker ? 8080 : 4000);——Docker 环境下默认 8080裸金属bare metal默认 4000宿主映射时保持容器端口为 8080即可。宿主端口如 4000、4444、8080可自由选择避免与已有服务冲突。配置目录挂载与文件权限挂载目录必须包含conf.yml且属主应匹配容器内node用户uid 1000。一个最小可用的配置可参考仓库中的 user-data/conf.yml它由pageInfo页面元信息、appConfig主题等应用设置与sections分区与条目数组三大部分构成。从服务端实现看services/endpoints/api/config-files.jsUSER_DATA_DIR环境变量决定配置目录位置REST API 会读取该目录下所有.yml/.yaml文件根配置conf.yml在写入时会用 src/utils/config/ConfigSchema.jsonJSON Schema做严格校验子页面则不做全量校验。通过 UI 保存配置时的备份行为Dashy 4 的在 UI 中保存配置功能依赖 Node 服务端services/endpoints/save-config.js。写入前服务端会自动把旧配置备份到config-backups/目录文件名形如conf-时间戳.backup.yml因此要求挂载目录对容器可写。相关可调环境变量USER_DATA_DIR配置目录默认./user-data/BACKUP_DIR备份目录默认在配置目录下的config-backupsDISABLE_CONFIG_BACKUPS设为true可关闭自动备份配置大小上限为 256 KBMAX_CONFIG_BYTES。这也解释了为什么基于静态构建的部署如 NixOS 的dashy-ui包会缺少这类服务端专属能力——详见 docs/deployment/self-hosted-os.md。健康检查Healthcheck官方 docker-compose.yml 与 Dockerfile 均内置健康检查实际执行逻辑在 services/healthcheck.js向/healthz发送请求返回 200 则退出码为 0健康否则为 1。镜像内置的检查默认每 5 分钟执行一次Compose 中也可自定义间隔例如healthcheck: test: [CMD, node, /app/services/healthcheck.js] interval: 1m30s timeout: 10s retries: 3 start_period: 30s在支持健康检查状态的平台如 Portainer上配置后可直接在面板中观察 Dashy 的运行状态。版本核对与升级由于多数第三方模板滞后安装后请务必核实版本通过容器镜像标签确认latest或 4.x 具体标签当前仓库版本为 4.6.5见 package.json进入 Dashy 界面后在设置/关于中查看版本号遇到异常行为时先排除是否仍是 3.x 旧版本这一因素——特别是配置挂载路径、UI 编辑器等 4.x 新增/变更的功能。选型小结平台安装方式需手动修正的点PortainerStacks 粘贴 Compose / 社区模板模板若挂/app/public改为/app/user-dataCoolify服务模板搜索同上1Panel官方应用商店镜像标签换为latest或 4.xRuntipi社区应用商店一般无需Cosmos Cloud官方市场配置挂载路径改为/app/user-dataCasaOS / ZimaOSBigBear 社区商店必须选 Dashy v4避开 3.3.1 条目Umbrel已停维护的社区商店建议改用 Docker 直装Easypanel官方模板镜像标签换为latest或 4.xSaltboxsb install sandbox-dashy按 Saltbox 文档配置通用原则只有三条镜像用 4.x、配置挂载到/app/user-data、容器端口保持 8080。如果部署后遇到问题可进一步查阅 Docker 部署文档 与 故障排查指南如需在具体操作系统TrueNAS SCALE、Proxmox、Unraid、Synology、NixOS、Kubernetes 等上部署参见 自托管操作系统部署文档。【免费下载链接】dashy A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!项目地址: https://gitcode.com/GitHub_Trending/da/dashy创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考