终极指南：glance跨平台部署 - Windows/macOS/Linux全系统支持
项目地址: https://gitcode.com/GitHub_Trending/gla/glance 你是否还在为跨平台部署个人仪表盘而烦恼？本文将帮助你在Windows、macOS和Linux系统上快速部署glance，实现个人数据聚合中心的无缝搭建。读完本文，你将获得全系统部署方案、主题配置技巧以及常见问题解决方案，让你的自托管仪表盘即刻上线。
什么是glance？
glance是一款自托管仪表盘（Self-hosted dashboard），能够将各类信息源聚合到统一界面。无论是RSS订阅、社交媒体动态还是系统监控数据，都能通过高度可定制的 widgets 实现可视化展示。其轻量级设计确保低资源占用，同时支持响应式布局，完美适配桌面与移动设备。
核心优势：
- 支持20+种信息源widgets（RSS、Docker容器、天气、TODO等）
- 全平台部署支持（Windows/macOS/Linux/Docker）
- 丰富主题系统与自定义CSS
- 移动端优化界面
部署前准备
系统要求
| 系统 | 最低配置 | 推荐配置 |
|---|---|---|
| Windows | Windows 10+，2GB RAM | Windows 10+，4GB RAM |
| macOS | macOS 10.15+，2GB RAM | macOS 12+，4GB RAM |
| Linux | Ubuntu 20.04+，2GB RAM | Ubuntu 22.04+，4GB RAM |
| Docker | Docker 20.10+，2GB RAM | Docker 24+，4GB RAM |
网络要求
- 开放8080端口（默认，可自定义）
- 需访问互联网获取widgets数据（如天气、新闻等）
多平台部署方案
Docker容器化部署（推荐）
Docker部署适用于所有操作系统，通过容器化确保环境一致性。执行以下命令一键部署：
mkdir glance && cd glance && curl -sL https://gitcode.com/GitHub_Trending/gla/glance/-/archive/main/glance-main.tar.gz | tar -xzf - --strip-components 2
编辑配置文件：
docker-compose.yml：修改端口映射（默认8080）config/home.yml：配置首页widgets布局config/glance.yml：设置主题和额外页面
启动服务：
docker compose up -d
Linux系统部署
二进制安装
- 下载对应架构的二进制文件：
wget https://gitcode.com/GitHub_Trending/gla/glance/releases/latest/download/glance-linux-amd64.tar.gz
tar -xzf glance-linux-amd64.tar.gz
- 创建配置文件：
wget https://gitcode.com/GitHub_Trending/gla/glance/raw/main/docs/glance.yml
- 启动服务：
./glance --config glance.yml
Systemd服务配置
创建服务文件 /etc/systemd/system/glance.service：
[Unit]
Description=Glance Dashboard
After=network.target
[Service]
User=ubuntu
WorkingDirectory=/opt/glance
ExecStart=/opt/glance/glance --config glance.yml
Restart=always
[Install]
WantedBy=multi-user.target
启用并启动服务：
sudo systemctl enable glance
sudo systemctl start glance
Windows系统部署
- 下载Windows版二进制包：
Invoke-WebRequest -Uri "https://gitcode.com/GitHub_Trending/gla/glance/releases/latest/download/glance-windows-amd64.zip" -OutFile "glance.zip"
Expand-Archive -Path glance.zip -DestinationPath C:\glance
- 创建配置文件：
cd C:\glance
Invoke-WebRequest -Uri "https://gitcode.com/GitHub_Trending/gla/glance/raw/main/docs/glance.yml" -OutFile "glance.yml"
- 双击
glance.exe启动，访问 http://localhost:8080 即可使用。
macOS系统部署
- 使用Homebrew安装（需先安装Homebrew）：
brew tap GitHub_Trending/gla
brew install glance
- 创建配置文件：
mkdir -p ~/.config/glance
curl -o ~/.config/glance/glance.yml https://gitcode.com/GitHub_Trending/gla/glance/raw/main/docs/glance.yml
- 启动服务：
glance --config ~/.config/glance/glance.yml
主题配置与个性化
glance提供12种预设主题，支持一键切换。编辑 glance.yml 文件配置主题：
主题示例：Dracula
theme:
background-color: 231 15 21
primary-color: 265 89 79
contrast-multiplier: 1.2
positive-color: 135 94 66
negative-color: 0 100 67
主题示例：Catppuccin Latte（浅色）
theme:
light: true
background-color: 220 23 95
primary-color: 220 91 54
positive-color: 109 58 40
更多主题可参考 官方主题文档，包含Gruvbox、Teal City等深色主题，以及Peachy、Zebra等浅色主题。
移动设备访问
glance针对移动设备做了专门优化，通过响应式布局自动适配屏幕尺寸。在移动浏览器中访问部署地址即可：
常见问题解决
1. 端口冲突
修改配置文件 glance.yml 中的服务器端口：
server:
port: 8081 # 更换为未占用端口
2. Widgets无法加载
检查网络连接或配置缓存策略：
- type: rss
cache: 1h # 延长缓存时间至1小时
feeds:
- url: https://example.com/rss.xml
3. 主题显示异常
禁用浏览器深色模式扩展（如Dark Reader），或在配置中强制指定主题：
theme:
disable-picker: true # 禁用主题切换器
background-color: 225 14 15 # 强制使用Teal City主题
配置示例：打造个性化首页
以下是包含天气、新闻和Docker监控的首页配置（config/home.yml）：
name: Home
columns:
- size: small
widgets:
- type: weather
location: Shanghai, China
units: metric
- type: todo
items:
- [ ] 完成glance部署文档
- [x] 配置Docker容器监控
- size: full
widgets:
- type: rss
feeds:
- url: https://www.techcrunch.com/rssfeeds
- type: docker-containers
hide-stopped: true
- size: small
widgets:
- type: clock
format: 24h
- type: markets
markets:
- symbol: BTC-USD
name: Bitcoin
- symbol: AAPL
name: Apple
结语
通过本文介绍的部署方案，你已掌握在Windows、macOS和Linux系统上搭建glance仪表盘的完整流程。无论是作为个人信息中心、开发监控面板还是家庭服务器仪表盘，glance的高可定制性都能满足你的需求。
后续可探索：
立即访问 http://localhost:8080 开始使用你的个性化仪表盘吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
