obebete/winbox

Winbox Docker镜像

镜像概述和主要用途

该Docker镜像允许用户在浏览器中运行Mikrotik的Winbox工具，无需在本地安装客户端。通过整合KasmVNC和Wine环境，实现了Winbox在容器中的运行，并通过Web界面提供访问能力，方便用户随时随地管理Mikrotik设备。

核心功能和特性

• 浏览器访问：通过KasmVNC技术，在任何浏览器中访问Winbox，无需安装额外软件
• 持久化配置：支持挂载卷保存Wine初始配置和Winbox会话数据，减少重复配置时间
• TLS支持：可自定义TLS证书，替代自动生成的证书，增强访问安全性
• 跨平台兼容：基于Docker容器化，可在Linux、macOS、Windows等支持Docker的系统上运行

使用场景和适用范围

• 需要远程管理Mikrotik设备但无法安装Winbox客户端的场景
• 多平台环境下（如Linux服务器、macOS工作站）需要使用Winbox的用户
• 临时或移动设备上需要快速访问Winbox的场景
• 希望集中管理Winbox配置和会话的团队环境

详细使用方法和配置说明

Docker部署

基本运行命令

sh
docker run -d --shm-size=512m -p 6901:6901 -e VNC_PW=password -v winbox_wine:/home/kasm-user/.wine ghcr.io/obeone/winbox:latest

参数说明：

• --shm-size=512m：设置共享内存大小，确保图形界面流畅运行
• -p 6901:6901：映射容器的6901端口到主机，用于Web访问
• -e VNC_PW=password：设置VNC访问密码（替换password为自定义密码）
• -v winbox_wine:/home/kasm-user/.wine：挂载卷保存Wine配置和Winbox会话数据

访问方式

运行容器后，通过以下方式访问：

• 地址：https://localhost:6901
• 用户名：kasm_user
• 密码：设置的VNC_PW值（示例中为password）

TLS证书配置

如需使用自定义TLS证书（替代自动生成的证书），可挂载PEM格式证书到容器的/config/private-cert.pem路径：

sh
docker run -d --shm-size=512m -p 6901:6901 -e VNC_PW=password -v winbox_wine:/home/kasm-default-profile/.wine -v LOCAL_PEM_PATH:/config/private-cert.pem:ro ghcr.io/obeone/winbox:latest

注意：LOCAL_PEM_PATH需替换为本地证书文件的实际路径，:ro表示只读挂载。

Kubernetes部署（Helm）

该镜像提供Helm Chart支持，详细部署文档请参考：https://github.com/obeone/charts

截图

登录界面

!https://raw.githubusercontent.com/obeone/winbox-docker/main/docs/screenshots/login.png

主界面

!https://raw.githubusercontent.com/obeone/winbox-docker/main/docs/screenshots/main.png