Sign inSign up

ovitor/solarpanel-v3

By ovitor

•Updated 43 minutes ago

轻量自托管导航面板。Go 纯后端 · 零 CGO 单二进制 · 内嵌前端 · 三架构

Image
Networking
1

2.7K

ovitor/solarpanel-v3 repository overview

轻量自托管导航页面板。Go 纯后端 · 零 CGO 单二进制 · 前端内嵌 · 三架构 Docker 镜像约 14MB。

⁠🚀 快速开始

⁠方式一:Docker(推荐)

镜像 ovitor/solarpanel-v3:latest,支持 linux/amd64 · linux/arm64 · linux/arm/v7。

⁠docker run
docker run -d \
  --name solarpanel-v3 \
  --restart unless-stopped \
  -p 10086:10086 \
  -v $(pwd)/data:/app/data \
  -v /:/host:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e SERVER_PORT=10086 \
  -e NAS_HOST_ROOT=/host \
  -e DOCKER_SOCKET=/var/run/docker.sock \
  ovitor/solarpanel-v3:latest

后两个挂载仅用于 NAS 运行状态面板(读取宿主 /proc、/sys、存储池与容器数据)。不需要该功能时删掉 -v /:/host:ro、-v /var/run/docker.sock:... 与两个 -e 即可,面板会自动隐藏。

Windows PowerShell:

docker run -d --name solarpanel-v3 --restart unless-stopped -p 10086:10086 -v ${PWD}/data:/app/data -v /:/host:ro -v /var/run/docker.sock:/var/run/docker.sock -e SERVER_PORT=10086 -e NAS_HOST_ROOT=/host -e DOCKER_SOCKET=/var/run/docker.sock ovitor/solarpanel-v3:latest
⁠本地构建
git clone https://github.com/Ozero-top/SolarPanel-v3.git
cd SolarPanel-v3
docker build -t solarpanel-v3:local .
docker run -d --name solarpanel-v3 -p 10086:10086 -v $(pwd)/data:/app/data solarpanel-v3:local
⁠docker compose
services:
  solarpanel:
    image: ovitor/solarpanel-v3:latest   # 本地构建改成 build: .
    container_name: solarpanel-v3
    restart: unless-stopped
    ports:
      - "10086:10086"
      # - "18443:18443"                  # HTTPS_PORT 非空时启用
    volumes:
      - ./data:/app/data
      - /:/host:ro                              # NAS 监控:宿主 /proc、/sys、存储池
      - /var/run/docker.sock:/var/run/docker.sock   # NAS 监控:容器列表与占用
    environment:
      - TZ=Asia/Shanghai
      - SERVER_PORT=10086
      - NAS_HOST_ROOT=/host
      - DOCKER_SOCKET=/var/run/docker.sock
      # - HTTPS_PORT=18443               # 启用内置自签名 HTTPS
    # NAS 监控需要「整机网卡」口径时改用 host 网络(ports 映射会失效,直接访问 10086):
    # network_mode: host
docker compose up -d          # 启动
docker compose logs -f        # 查看日志
docker compose down           # 停止
docker compose up -d --build  # 重新构建

启动后访问 http://localhost:10086⁠。数据目录 ./data/ 自动创建,包含 solarpanel.db 与 uploads/。

镜像内未声明 VOLUME,挂载到 /app/data 即持久化;不挂载则重建容器后数据随之丢失。

⁠ARM 设备 / OpenWrt 系(iStoreOS · ImmortalWrt)

适用于 iStoreOS、ImmortalWrt 与带 Docker 的原生 OpenWrt(ARMv7 / ARM64),镜像会按设备架构自动匹配。先在「应用商店 / 软件包」中安装 Docker(iStoreOS 为「iStore 应用商店 → Docker」),再执行:

docker run -d --name solarpanel-v3 --restart unless-stopped \
  -p 10086:10086 \
  -v /volume1/docker/solarpanel/data:/app/data \
  -v /:/host:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e NAS_HOST_ROOT=/host -e DOCKER_SOCKET=/var/run/docker.sock \
  ovitor/solarpanel-v3:latest
  • 数据目录按设备实际存储位置填写,例如 /mnt/sda1/docker/solarpanel/data 或 /overlay/docker/solarpanel/data
  • 面板会自动识别 OpenWrt 系系统名与 /overlay 可用容量;不需要容器列表时可去掉 docker.sock 挂载与 DOCKER_SOCKET
  • 需要整机网速口径时追加 --network host 并去掉 -p 10086:10086,直接访问 http://设备IP:10086
  • 低配设备(内存 ≤ 512MB)建议把后台「刷新间隔」调到 5~10 秒,减少采集开销

Tag summary

Content type

Image

Digest

sha256:b20bad6dd…

Size

10.8 MB

Last updated

43 minutes ago

docker pull ovitor/solarpanel-v3