企业官网建设流程全解析

Hestia（Project Hestia）是一款基于网格布局（Grid）的模块化自托管仪表盘，纯 HTML、CSS、JavaScript 构建，无需数据库和复杂后端，3 分钟即可在自己的服务器或 NAS 上跑起来。本 Hestia 部署教程带你从零完成三大关键步骤：Docker 一键部署、静态服务器直接运行、API 集成代理配置，快速拥有一个 Homelab 可视化主界面。

为什么选择 Hestia 仪表盘？✨

• 零后端、零数据库：配置保存在浏览器localStorage，图片存 IndexedDB，部署即一个静态页面
• 拖拽式网格系统：基于 View Transitions API 的丝滑动画，布局自动保存
• 深度主题定制：支持 Dracula、Nord、Monokai 等 Base16 配色，间隙/圆角/阴影全可调
• Homelab 集成：内置 Nginx 反代，自动解决 Glances、Pi-hole、Deluge、Jellyfin 的 CORS 跨域问题

内置应用一览：

部署前准备 📋

• 一台支持Docker的服务器或 NAS（推荐方式）
• 或任意可运行静态文件的 Web 服务器
• 规划一个访问端口（本文示例为8080）

方式一：Docker 部署 Hestia（推荐 3 分钟搞定）🐳

Docker 镜像基于nginx:alpine（见 Dockerfile），自带反代配置，是体验 API 集成的最佳方式。

第 1 步：克隆代码

git clone https://gitcode.com/gh_mirrors/he/hestia-core cd hestia-core

第 2 步：构建并运行容器

docker build -t hestia-core . docker run -d -p 8080:80 --name hestia hestia-core

第 3 步：打开浏览器

访问http://localhost:8080，看到 Hestia 仪表盘界面即部署成功 🎉

方式二：静态服务器直接运行（最简单）⚡

Hestia 是纯原生 JavaScript，任何静态 Web 服务器都能跑：

cd hestia-core python3 -m http.server 8000

然后访问http://localhost:8000。

⚠️ 注意：没有 Docker 内置的 Nginx 反代时，Deluge、Pi-hole 等外部 API 可能因 CORS 策略被浏览器拦截，导致组件显示不出数据。只展示天气、时钟等基础应用则完全不受影响。

配置 API 集成：修改 Nginx 反代 default.conf ⚙️

Docker 方式通过 default.conf 内置了三条内部代理：

重要：构建镜像前，请先编辑 default.conf，把proxy_pass的目标改成你的真实服务地址，例如：

• proxy_pass https://pihole;→ 你的 Pi-hole 地址
• proxy_pass http://deluge:8112/;→ 你的 Deluge 地址
• proxy_pass http://jellyfin:8096/;→ 你的 Jellyfin 地址

快速上手：3 步玩转仪表盘 🖱️

1. 点击顶栏➕按钮添加应用，选择组件并填写配置
2. 点击✏️ 编辑布局，自由拖拽、缩放卡片，松手自动保存
3. 打开⚙️ 设置面板：换主题配色、调网格间距、改标题字体

想展示自己喜欢的图片？添加 Image Frame 相框组件，上传或填 URL 即可，效果类似下图：

数据备份：一键导出/导入布局 💾

在设置面板中：

• 下载：将整套主题 + 网格布局导出为 JSON 文件，方便备份或分享给朋友
• 上传：从 JSON 文件恢复整套配置

⚠️分享前务必检查 JSON 内容：导出包含全部应用配置，可能含 API Key、IP 地址、密码等敏感信息（项目已内置部分清洗逻辑，但仍需人工确认）。

常见问题 FAQ ❓

端口 8080 被占用怎么办？修改映射端口即可：docker run -d -p 9000:80 --name hestia hestia-core，然后访问http://localhost:9000。

集成组件不显示数据？多半是 CORS 问题——请改用 Docker 部署，或自行添加反向代理。

如何开发自己的组件？Hestia 采用简单的类继承系统：在js/apps/下新建文件继承BaseApp，再在 js/apps/appIndex.js 中引入即可，完整示例见 README.md 的 Developer Guide 章节。

小结 🎯

• 只要基础展示→ 方式二静态运行，1 条命令启动
• 要接 Glances / Pi-hole / Jellyfin→ 方式一 Docker 部署 + 修改 default.conf
• 配置保存在本地，记得定期用设置面板导出 JSON 备份

Hestia 用 3 分钟就能让你的 Homelab 有一个美观、可完全定制的自托管仪表盘主界面。祝你部署愉快！🔥