5分钟部署个人仪表盘：Dashy极速上手指南
项目地址: https://gitcode.com/GitHub_Trending/da/dashy 你是否还在为浏览器标签混乱、常用服务入口分散而烦恼？作为一款自托管的个人仪表盘（Dashboard），Dashy能帮你统一管理所有服务链接、监控系统状态、自定义界面主题，让工作效率提升300%。本文将带你通过3个简单步骤，在5分钟内完成从部署到配置的全流程。
准备工作：环境检查与资源准备
部署Dashy前需确认环境满足以下要求：
- Docker环境：推荐使用Docker Compose管理容器（官方安装指南）
- 服务器资源：最低1GB内存、1GB存储空间（树莓派3+及以上设备兼容）
- 网络访问：确保8080端口未被占用，或准备自定义端口映射
项目核心文件结构：
步骤1：一键部署Dashy服务
Docker快速启动
通过以下命令拉取最新镜像并启动容器：
docker run -d \
-p 8080:8080 \
-v ~/dashy-conf.yml:/app/user-data/conf.yml \
--name my-dashboard \
--restart=always \
lissy93/dashy:latest
参数说明：
-v：挂载本地配置文件（首次运行可省略，使用默认配置）--restart=always：实现系统重启后自动恢复服务
验证部署状态
访问http://服务器IP:8080，出现以下界面表示部署成功： 
步骤2：基础配置与个性化设置
配置文件结构解析
Dashy使用YAML格式配置文件，核心结构包含3部分：
pageInfo: # 页面元信息（标题、描述、导航链接）
appConfig: # 应用设置（主题、语言、状态检查）
sections: # 功能区块（服务链接、小部件、分类）
完整配置指南见：docs/configuring.md
快速添加服务链接
编辑user-data/conf.yml，添加常用服务：
sections:
- name: 开发工具
icon: fas fa-code
items:
- title: GitHub
url: https://github.com
icon: fab fa-github
statusCheck: true # 启用状态监控
- title: Jenkins
url: http://192.168.1.100:8080
icon: favicon # 自动获取网站图标
主题切换与自定义
通过UI设置（右上角⚙️图标）可即时切换25+内置主题：
- 深色主题：
dark、dracula、midnight - 浅色主题：
light、minimal、pastel - 高对比度：
high-contrast、neon
自定义主题示例（修改appConfig.customColors）：
appConfig:
theme: custom
customColors:
primary: '#4CAF50' # 主色调：绿色
background: '#1E1E1E' # 背景色：深灰
curve-factor: 12px # 圆角弧度
步骤3：高级功能与最佳实践
状态监控与告警
启用服务健康检查，实时显示在线状态：
appConfig:
statusCheck: true # 全局启用
statusCheckInterval: 300 # 检查间隔(秒)
sections:
- items:
- title: NAS服务
url: http://192.168.1.200
statusCheck: true # 单独启用
statusCheckAcceptCodes: 401 # 接受未授权状态码
多页面与工作区
创建分类页面管理不同场景：
pages:
- name: 工作区
path: ./workspace.yml
- name: 家庭网络
path: ./home-network.yml
切换到工作区视图（快捷键Alt+W）可同时打开多个服务： 
数据备份与迁移
通过UI导出配置（配置→导出）或手动备份：
# 容器内配置文件路径
docker cp my-dashboard:/app/user-data/conf.yml ~/dashy-backup.yml
部署问题排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 8080端口冲突 | 端口被占用 | 修改映射 -p 8088:8080 |
| 配置不生效 | 文件权限错误 | 检查挂载路径权限 chmod 644 ~/dashy-conf.yml |
| 中文显示乱码 | 字体缺失 | 挂载自定义字体到 /app/public/fonts/ |
更多问题参见：docs/troubleshooting.md
下一步探索
- ** widget组件 **：添加天气、系统监控等小部件（文档）
- ** 认证保护 **：配置密码登录或OAuth集成（文档）
- ** 自定义CSS **：通过
appConfig.customCss注入样式代码 - ** 多语言支持 **：设置
appConfig.language: zh-CN启用中文界面
现在，你的个人仪表盘已投入使用！访问项目GitHub获取最新更新，或分享你的配置到展示区。
提示：定期执行
docker pull lissy93/dashy获取功能更新，使用docker logs my-dashboard查看运行日志。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
