Sign inSign up

jasonxtt/rosboard

By jasonxtt

•Updated 5 days ago

rosboard

Image
0

585

jasonxtt/rosboard repository overview

⁠rosboard

RouterOS(MikroTik)监控与策略路由管理面板。单静态二进制 + 内嵌 Web UI,无外部依赖。

⁠快速开始(推荐宿主网络)

首次访问 http://<宿主机>:8080 进入初始化引导:创建管理员 → 填写 RouterOS 地址与凭据(表单预填 10.0.0.1,按你的实际地址修改)→ 把自动生成的接入脚本粘贴到 RouterOS Terminal。引导中填写的 RouterOS 通常是局域网地址,宿主网络下直接可达,也无需端口映射:

mkdir -p /opt/rosboard-docker && chown 1000:1000 /opt/rosboard-docker
docker run -d --name rosboard \
  --network host \
  -v /opt/rosboard-docker:/var/lib/rosboard \
  --restart unless-stopped \
  jasonxtt/rosboard:latest

⁠docker-compose 示例

services:
  rosboard:
    image: jasonxtt/rosboard:latest      # 建议生产固定版本,如 jasonxtt/rosboard:v0.2.7
    container_name: rosboard
    network_mode: host                   # 推荐宿主网络:引导里填写的 RouterOS 局域网地址直接可达
    environment:
      - ROSBOARD_PORT=8080               # Web UI 端口,默认 8080;不写即默认
    volumes:
      - /opt/rosboard-docker:/var/lib/rosboard   # 配置 + 数据全在这里
    restart: unless-stopped

桥接网络(端口映射)模式:

services:
  rosboard:
    image: jasonxtt/rosboard:latest
    ports:
      - "8080:8080"                      # 改:8080"),容器内仍是 8080
    environment:
      - ROSBOARD_ROUTEROS_BASE_URL=http://192 显式指定容器可达的 RouterOS 地址
    volumes:
      - /opt/rosboard-docker:/var/lib/rosboar
    restart: unless-stopped

⁠路径 / 端口 / 环境变量

项说明
数据卷/var/lib/rosboard:config.yamlata/(SQLite 数据库)。bind mount 需 chown1000:1000`(容器以非 root UID 1000 运行),命名卷无需处理
端口ROSBOARD_PORT 环境变量,默认 8080ARD_LISTEN_ADDRESS(优先级更高)
RouterOS首跑引导里填写即可;也可用环境变量 ROSBOARD_ROUTEROS_BASE_URL / USERNAME / PASSWORD 预置

⁠重启行为

  • 保存设备/修改关键配置后程序会自动重启进程:镜像内 entrypoint 会立即自动拉起(v0.2.7+),UI 自动恢复,无需任何手动操作
  • 建议始终带 --restart unless-stopped(compose 示例已带):额外覆盖进程崩溃自愈和 Docker 守护进程重启后自动拉起两种情况
  • docker stop 走 SIGTERM 优雅关停

⁠升级

应用内在线更新在容器中已禁用,升级方式:

docker compose pull && docker compose up -d

配置与数据都在卷里,容器重建后直接恢复。

⁠常用运维命令

docker exec rosboard rosboard version                          # 查看版本/构建信息
docker exec -it rosboard rosboard admin reset-password -config /var/lib/rosboard/config.yaml   # 重置管理员密码
docker logs -f rosboard                                        # 日志

Tag summary

Content type

Image

Digest

sha256:75f355125…

Size

11.7 MB

Last updated

5 days ago

docker pull jasonxtt/rosboard