关于 Oriel
Oriel 是面向使用兼容容器引擎的开发者的浏览器 Docker 管理界面和 MCP 服务。它向 MCP 客户端提供经过验证的工具,并遮蔽机密、限制破坏性操作。
主要功能
- 01管理容器、镜像、卷、网络和 Compose
- 02查看容器详情并流式读取日志
- 03进入运行中容器的交互式终端
- 04遮蔽机密并限制破坏性操作
- 05跟踪 CPU、内存、磁盘和运行时间
适用场景
- 01通过检查信息和日志排查容器反复重启
- 02在浏览器界面管理 Compose 项目
- 03让 MCP 客户端执行受保护的 Docker 操作
MCP 相关
运行 `oriel mcp`,即可将 Oriel 用作管理 Docker 和 Colima 的 MCP 服务。它提供经过验证且已遮蔽机密的工具,破坏性操作需授权,并记录助手发起的工具调用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
docker run -i --rm ghcr.io/paradoxinfinite/oriel:0.7.0本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
ghcr.io/paradoxinfinite/oriel:0.7.0stdio工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
Oriel
AI 可安全操控的本地 Docker GUI。
通过简洁的浏览器界面管理容器、镜像、卷、网络和 Compose。也可以把工作交给 AI:任何 MCP 客户端(Claude、Cursor、本地大模型)都能使用与界面相同的工具,并采用相同的机密信息屏蔽和破坏性操作授权机制。它适用于 macOS 和 Linux 上的任何 Docker 引擎(Colima、Docker Engine、OrbStack、Podman 或远程守护进程)。这是 Docker Desktop 的免费开源替代方案,所有功能集成在一个约 13 MB 的二进制文件中,空闲时仅占用 15–30 MB 内存;不使用 Electron,无需账户,采用 Apache-2.0 许可证。
在线试用 ↗ · 在浏览器中体验完整界面,使用模拟数据,无需安装。
使用 AI 操控
将任意 MCP 客户端连接到 Oriel,然后用日常语言提出问题。它会调用与界面相同、经过验证且会屏蔽机密信息的工具,还能串联多个工具来真正解答问题,而不是只调用一个工具:
你:
api为什么一直重启?助手: 先读取
container.list、container.inspect,然后查看日志。 它因 137(OOM) 退出:容器内存上限为 256 MB,而 Node 堆内存超出了这个限制。请提高内存上限,或修复worker.js中的内存泄漏。
oriel mcp # stdio MCP server for Claude, Cursor, or a local LLM
二进制文件不包含任何模型;客户端需自行提供模型。读取操作随时可用,破坏性操作则始终需要先授权。设置与工具列表 ↓
安装
Homebrew(macOS 和 Linux):
brew install ParadoxInfinite/oriel/oriel
脚本(自动检测平台并验证校验和):
curl -fsSL https://raw.githubusercontent.com/ParadoxInfinite/oriel/main/install.sh | sh
添加 -s -- --edge 以跟踪预发布版本(优先获取最新构建),或添加 -s -- --uninstall 将其移除:
curl -fsSL https://raw.githubusercontent.com/ParadoxInfinite/oriel/main/install.sh | sh -s -- --edge
⚠️ **通过管道将脚本传给
sh,会在你的机器上运行来自互联网的代码。**请先阅读install.sh,再运行脚本;或者改为从 releases 下载二进制文件。
手动下载二进制文件、使用 Go 或从源码构建
从 releases 下载二进制文件(Apple Silicon 对应 oriel-darwin-arm64,Intel 对应 oriel-darwin-amd64,另有 oriel-linux-arm64 和 oriel-linux-amd64),然后运行 chmod +x。或者:
go install github.com/ParadoxInfinite/oriel@latest # with Go
make build # from source (builds + embeds the UI)
运行
./oriel # opens http://127.0.0.1:4321
参数:--port <n>(默认值为 4321)、--no-open。设置为登录时运行:./oriel service install(launchd / systemd;另有 status、uninstall)。
需要任何兼容 Docker Engine 的运行时和 docker CLI。Colima 提供一流支持(可启动和停止虚拟机);Docker Engine、OrbStack、Rancher/Docker Desktop、Podman 和远程守护进程也都适用(参见文档)。如需通过专用网络进行远程访问,请参阅文档;请先阅读安全说明。
功能特性
- **容器:**实时 CPU/内存、退出代码、批量操作、流式日志、完整检查。
- **浏览器内 Shell:**直接从容器详情抽屉打开交互式终端,进入任意正在运行的容器。
- **AI 控制(MCP):**任意 MCP 客户端都能通过同一套经过验证且会屏蔽机密的工具来控制 Docker/Colima,破坏性操作需先授权。了解更多 ↓
- **镜像:**通过注册表搜索拉取镜像、清理镜像、一键标记。
- **Compose:**管理堆栈,并发现和部署磁盘上的项目。
- **仪表板:**CPU 历史记录、内存、磁盘、运行时间/中断跟踪。
- 命令面板(
⌘K):模糊搜索并运行任意操作,或跳转到任意视图。 - **版本、主题和语言:**切换整个 UI(Studio,或添加你自己的版本)、浅色/深色/系统主题、自定义强调色,以及支持翻译的界面(内置英语;其他语言按需加载)。
- **轻量且实时:**约 15–30 MB 内存占用,一个 SSE 流(不轮询),通过校验和验证的自我更新。
对比
在 Mac 或 Linux 设备上运行容器的常见方式,以及 Oriel 的定位。(数据会变化,请将其视为快照。)
| Oriel | Docker Desktop | OrbStack | lazydocker | Portainer | |
|---|---|---|---|---|---|
| 许可证 | Apache-2.0,免费 | 专有(大型组织需付费) | 专有(商业用途需付费) | MIT,免费 | 免费(CE) |
| 界面 | 图形化 Web UI | 桌面应用 | 原生应用 | 终端(TUI) | Web UI(服务) |
| 资源占用 | 约 15–30 MB 内存,约 13 MB 二进制文件 | 高(约 3–4 GB VM) | 低(原生) | 低 | 容器,约 200–300 MB |
| 安装 | 单个静态二进制文件 | 安装程序 | 安装程序 | 单个二进制文件 | 运行容器 |
| 自带引擎 | Colima · Docker · OrbStack · Podman · 远程服务 | 捆绑引擎 | 捆绑引擎 | 任意 Docker socket | 任意 Docker socket |
| 本地运行,无需账户 | 是 | 账户/登录 | 账户 | 是 | 服务端 + 身份验证 |
| AI 控制(MCP) | 内置,设有安全防护 | MCP Toolkit(运行其他服务) | 否 | 否 | 否 |
这里列出的产品中,只有它能让 AI 直接控制,并且通过与 UI 相同的检查。相比 Docker Desktop / OrbStack,选择它无需付费许可证、捆绑 VM 或菜单栏应用;相比 lazydocker,它提供真正的图形界面,而非终端界面;相比 Portainer,它是供你自行运行的二进制文件,而不是需要部署并加以保护的服务。
完整对比(包括 Oriel 的不足之处,如 Windows、Kubernetes、多主机支持),请参阅在线演示中的详尽对比。
AI 控制(MCP)
oriel mcp 会将 Oriel 作为 Model Context Protocol 服务运行,因此 MCP 客户端(Claude Desktop、Claude Code、Cursor、本地大模型)可以通过日常语言以无头模式管理你的 Docker/Colima,无需 GUI。使用相同的工具和安全防护:
- 机密始终受到屏蔽。
container.inspect和container.logs会在数据到达模型前,将形似机密的值替换掉;MCP 客户端永远无法获取完全未经处理的环境变量或日志(“关闭”设置仅适用于本地 UI)。日志屏蔽会尽力处理自由格式文本。 - 破坏性操作默认锁定,直到你开启一个短暂的限时窗口(
oriel ai allow-destructive --for 15m)。读取操作始终可用;在你授权前,无法执行删除/清理操作。 - **每项操作都会记录。**审计日志会记录助手发起的每次工具调用:执行了什么、使用了哪些参数,以及执行时间(Settings → AI activity)。你自己的点击操作不会记录。
- **二进制文件中不包含模型。**模型由你的客户端提供,因此 Oriel 保持供应商中立。
让任意 MCP 客户端连接到它。安装 Oriel 后:
{ "mcpServers": { "oriel": { "command": "oriel", "args": ["mcp"] } } }
也可以不安装,通过已发布的镜像运行(Linux 主机;挂载 Docker socket):
{ "mcpServers": { "oriel": { "command": "docker", "args": ["run", "-i", "--rm", "-v", "/var/run/docker.sock:/var/run/docker.sock", "ghcr.io/paradoxinfinite/oriel"] } } }
Claude Code:claude mcp add oriel -- oriel mcp。设置、HTTP、作用域和完整工具列表,请参阅:docs/MCP.md。
版本与主题
UI 是基于稳定平台 SDK 的可替换插件:Studio(浅色/深色/跟随系统、自定义强调色)。重新为其配色,或加入你自己的版本(参见 docs/THEMES.md)。
安全
Oriel 开箱即用时没有登录功能,而驱动 Docker 实际上相当于拥有主机上的 root 权限。可选的 Bearer Token 可限制远程访问和 MCP-over-HTTP 访问(默认关闭),但安全的默认做法是仅在本地使用,或仅通过专用网络访问(如 Tailscale、ZeroTier、WireGuard)。绝不可通过公共互联网访问。 完整的信任模型见:SECURITY.md。
常见问题
Colima 有图形界面吗? 有。Colima 按设计仅提供命令行界面,而 Oriel 正是它一直缺少的浏览器 UI。它也可以驱动 Docker Engine、OrbStack、Podman 和远程守护进程。
可以免费替代 Docker Desktop 吗? 可以。采用 Apache-2.0 许可,没有许可费用,也无需账号。将其连接到任意兼容 Docker 的引擎即可。
AI 能管理我的容器吗? 可以。运行 oriel mcp,并将任意 MCP 客户端(Claude、Cursor、本地大模型)连接到它。它可以使用与 UI 相同的、经过验证且会屏蔽机密信息的工具;在你授权之前,破坏性操作始终处于锁定状态。
它与 lazydocker 有什么不同? lazydocker 是终端 UI;Oriel 是图形化浏览器 UI,提供仪表板、流式日志、镜像仓库搜索、Compose 发现和可换主题的版本。
资源占用和支持的平台? 约占用 15–30 MB 内存,二进制文件约 13 MB,不使用 Electron。支持 macOS(Apple Silicon + Intel)和 Linux(amd64 + arm64)。
开发
运行 make dev + make dev-web(Vite 热重载),以及 make test。请参阅 CONTRIBUTING.md。
许可
Apache-2.0 © Oriel 贡献者。请参阅 NOTICE。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。