概述

OpenHands is an open-source AI-driven development agent. It writes, reviews, and tests code. Important: Requires access to the Docker socket to spin up isolated execution environments. Pre-configured for local Ollama use.

要求

A reachable Ollama instance (or any OpenAI-compatible LLM endpoint) configured via the LLM_* variables. Defaults assume Ollama running on the Unraid host, reachable via host.docker.internal.

运行时参数

网络用户界面: http://[IP]:[PORT:3000]/
网络: bridge
外壳: sh
特权: false
额外参数: --add-host host.docker.internal:host-gateway

模板配置

WebUIPorttcp

OpenHands web interface

目标: 3000
默认值: 3000
价值: 3000

Config DirectoryPathrw

Persistent OpenHands configuration and state

目标: /.openhands
默认值: /mnt/user/appdata/openhands
价值: /mnt/user/appdata/openhands

Workspace DirectoryPathrw

Working directory exposed to the agent

目标: /workspace
默认值: /mnt/user/ai-workspace
价值: /mnt/user/ai-workspace

Docker SocketPathrw

Required so OpenHands can spawn isolated sandbox containers

目标: /var/run/docker.sock
默认值: /var/run/docker.sock
价值: /var/run/docker.sock

Sandbox VolumesVariable

Host:container mount(s) injected into every sandbox container the agent spins up. Must match the Workspace Directory mapping.

目标: SANDBOX_VOLUMES
默认值: /mnt/user/ai-workspace:/workspace:rw
价值: /mnt/user/ai-workspace:/workspace:rw

LLM API KeyVariable

API key for the LLM backend. For Ollama any non-empty value works (e.g. 'ollama').

目标: LLM_API_KEY
默认值: ollama
价值: ollama

LLM ModelVariable

LiteLLM-style model string. Default targets Ollama with qwen2.5-coder:14b.

目标: LLM_MODEL
默认值: ollama/qwen2.5-coder:14b
价值: ollama/qwen2.5-coder:14b

LLM Base URLVariable

Base URL of the LLM endpoint. Default reaches Ollama on the Unraid host via host.docker.internal. For a remote/LAN Ollama use http://host:11434. Leave blank for hosted providers (OpenAI/Anthropic/etc.) that use their own endpoints.

目标: LLM_BASE_URL
默认值: http://host.docker.internal:11434
价值: http://host.docker.internal:11434

LLM Embedding ModelVariable

Embedding model used for memory/context. 'local' uses the bundled embedding model.

目标: LLM_EMBEDDING_MODEL
默认值: local
价值: local

类别

Tools > Utilities Utilities Productivity Development

链接

模板支持登记处 Pro连接

详细信息

存储库

docker.openhands.dev/openhands/openhands:1.7

登记处

https://docker.openhands.dev/openhands/openhands

最后更新2026-06-02

初见2026-05-14

在Unraid 上运行 OpenHands 。

OpenHands 已被列入Unraid OS 的社区应用程序。探索Unraid ，构建灵活的家庭服务器、NAS 或家庭实验室。

探索Unraid OS