方案一：Docker Compose
Glance 官方镜像glanceapp/glance是多架构 manifest，原生支持 linux/arm64，无需手动编译镜像。
1、安装 docker & docker‑compose
sudo apt update
下载compose v2二进制
sudo curl -L “https://github.com/docker/compose/releases/download/v2.32.4/docker-compose-$(uname -s)-$(uname -m)” -o /usr/local/bin/docker-compose
添加可执行权限
sudo chmod +x /usr/local/bin/docker-compose
docker-compose version
#校验是否安装成功
将当前用户加入docker组，避免每次sudo
sudo usermod -aG docker $USER
验证
docker info
2、一键拉取官方模板目录（官方推荐方式）
mkdir -p ~/glance && cd ~/glance
#科学上网
curl -sL https://github.com/glanceapp/docker-compose-template/archive/refs/heads/main.tar.gz -o main.tar.gz
tar -xzf main.tar.gz --strip-components 2
执行完成后目录结构：
~/glance/
├─ docker-compose.yml
├─ .env
├─ config/
│ ├─ glance.yml # 全局配置、页面定义
│ └─ home.yml # home页面部件配置
└─ assets/
└─ user.css # 自定义CSS
3、拉取镜像
给 Docker 守护进程配置代理
1.创建 docker 代理目录
sudo mkdir -p /etc/systemd/system/docker.service.d
2.新建代理配置文件
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
写入下面内容，地址就是你本机代理：
[Service]
Environment=“HTTP_PROXY=http://代理ip”
Environment=“HTTPS_PROXY=http://代理ip”
Environment=“NO_PROXY=localhost,127.0.0.1,.docker.internal”
3.重载 systemd 并重启 docker
sudo systemctl daemon-reload
sudo systemctl restart docker
4.验证 docker 是否识别代理
sudo docker info
5.更新 Glance 版本
cd ~/glance
docker-compose pull
启动服务
Host 网络方案（不需要改 daemon.json）
1.不用 ports，在/glance/docker-compose.yml 文件中删除“port”行，并添加以下设置：
network_mode: host
2.要修改 glance.yml 里面服务端口，避开主机 8080 占用，在/glance/config/glance.yml 文件中server段添加：
host: 0.0.0.0
port: 9000
#自行设置一个未被占用的端口
启动服务
docker-compose up -d
查看日志排错：
docker-compose logs -f glance
常见 ARM/Docker 问题：
- 如果出现请求超时：板卡 DNS 使用 Pi‑hole/AdGuard，调高 DNS 速率限制；
- DarkReader 浏览器插件会打乱市场组件布局，浏览器关闭该站点的深色模式。
板可以正常访问，报错是各个海外组件拉取数据失败（网络原因，不是程序崩溃）,Reddit / Youtube / Twitch：connection reset / timeout 国内网络直连海外站点被重置、超时。 这些都是挂件数据源访问失败，不影响 Glance 面板本身打开。
方案二：二进制直接部署（无 Docker，适合算力板资源紧张场景，systemd 开机自启）
官方提供linux‑arm64预编译二进制，单文件，小于 20MB，Go 编译无依赖。
1、下载最新 arm64 二进制
访问：Release v0.8.6 · glanceapp/glance · GitHub 找到
glance-linux-arm64.tar.gz
创建安装目录
sudo mkdir -p /opt/glance
cd /opt/glance
下载（替换为最新release版本号，示例v0.8.6）
sudo wget https://github.com/glanceapp/glance/releases/download/v0.8.6/glance-linux-arm64.tar.gz
sudo tar -zxvf glance-linux-arm64.tar.gz
获取默认配置模板
sudo wget https://raw.githubusercontent.com/glanceapp/glance/main/docs/glance.yml
目录：/opt/glance/，包含二进制glance和配置glance.yml
测试直接运行一次：
sudo ./glance --config ./glance.yml
浏览器访问 http://127.0.0.1:8080，确认页面正常，Ctrl+C停止
2、配置 systemd 实现开机自启
新建 systemd 服务文件
sudo nano /etc/systemd/system/glance.service
粘贴下面内容：
[Unit]
Description=Glance Dashboard
After=network.target
[Service]
User=root
WorkingDirectory=/opt/glance
ExecStart=/opt/glance/glance --config /opt/glance/glance.yml
Restart=on-failure
[Install]
WantedBy=multi-user.target
保存退出（nano：Ctrl+O回车保存，Ctrl+X退出）
生效并启动：
sudo systemctl daemon-reload
sudo systemctl enable glance
sudo systemctl start glance
查看状态
systemctl status glance
访问：http://板卡IP:8080
查看日志：
journalctl -u glance -f
更新版本：停止服务，下载新版 tar.gz 覆盖二进制文件，重启 systemd 服务即可。
简单配置说明
配置文件是 YAML 格式：
- docker 部署：
~/glance/config/glance.yml - 二进制部署：
/opt/glance/glance.yml
yaml 缩进严格，使用空格，禁止 tab；常见报错
cannot unmarshal !!map into []glance.page，是嵌套配置多写了pages:字段，删掉嵌套内 pages 即可。
常用排错清单
- 网页打不开：防火墙放行 8080 端口
sudo ufw allow 8080/tcp - RSS、hacker‑news 部件加载超时：检查板卡网络 DNS，很多 ARM 板卡 DNS 解析问题
- 布局错乱：浏览器关闭 Dark‑Reader 插件对此站点的作用
- YAML 解析报错：核对缩进，复制官方示例片段对比