副标题基于 Hyper-V 虚拟机与 Ubuntu Docker 的“飞地”架构设计撰写时间2026年03月27日适用环境外网 Win10 内网 WinServer 2019 物理隔离 OpenClaw (OpenWebUI等) 前言在企业内网物理隔离的环境下既要保证服务的稳定性又要兼顾开发部署的便捷性是一个典型的“孤岛”运维场景。传统的 Windows 容器兼容性差而 WSL2 在 Server 2019 上配置复杂且不稳定。本文记录了一种**“Windows 宿主机 Hyper-V Linux 虚拟机 Docker 原生环境”**的最优解架构。我们将内网 Windows Server 2019 变为一个强大的虚拟化底座利用 Ubuntu 虚拟机为 OpenClaw 提供完美的 Linux 运行时环境。️ 第一部分核心架构设计在设计之初我们确立了以下技术栈以确保在无外网环境下依然能获得最佳的 Linux 容器体验。组件选型理由物理宿主机Windows Server 2019企业标准服务器系统自带 Hyper-V无需额外安装第三方虚拟机软件。虚拟化层Hyper-V (Generation 2)微软原生虚拟化性能损耗极低支持 UEFI 快速启动且在 Server 版本中支持最完善。客户机 OSUbuntu 22.04 LTS Server长期支持版本资源占用低无 GUIDocker 兼容性最好社区支持最广。运行时Docker Engine (Linux)原生 Linux Docker避免了 Windows 容器对 Linux 应用的兼容性黑洞。目标应用OpenClaw PG Redis标准的容器化 AI 应用栈。 第二部分外网机器准备工作 (Win10)由于内网完全断网所有依赖必须在 Win10 上预先下载并打包。1. 操作系统镜像准备下载文件ubuntu-22.04-live-server-amd64.iso来源Ubuntu 官方镜像站。安装 WSL | Microsoft Learn旧版 WSL 的手动安装步骤 | Microsoft Learn2. Docker 离线安装包构建不要试图在内网使用apt必须准备.deb离线包。操作步骤在 Win10 上安装Docker Desktop或使用一台联网的 Ubuntu 机器。访问 Docker 官方仓库下载以下核心包及其依赖注意必须匹配 Ubuntu 22.04 的架构docker-cedocker-ce-clicontainerd.iodocker-compose-pluginNVIDIA Container Toolkit关键依赖使用apt-rdepends或手动下载libc6,libseccomp2,pigz,xz-utils等基础依赖包。打包将所有.deb文件放入文件夹docker-debs。3. OpenClaw 镜像构建与导出为了避免在内网安装 Node.js 依赖和 Playwright 浏览器内核极其耗时且需要网络必须在外部构建好镜像。构建在 Win10 的 Docker Desktop 中构建 OpenClaw 镜像。docker build -t openclaw:v1 .导出# 导出应用镜像 docker save -o openclaw-image.tar openclaw:v1 # 导出依赖镜像 (Postgres Redis) docker pull postgres:15-alpine docker pull redis:7-alpine docker save -o db-images.tar postgres:15-alpine redis:7-alpine4. 资源包汇总 (DeployPackage)将以下文件刻录至移动硬盘或通过摆渡机传输ubuntu-22.04-live-server-amd64.isodocker-debs/(文件夹)openclaw-image.tardb-images.taropenclaw-source/(含docker-compose.yml和.env的源码文件夹)⚙️ 第三部分内网机器环境部署 (WinServer 2019)1. 启用 Hyper-V 角色以管理员身份运行 PowerShellInstall-WindowsFeature -Name Hyper-V -IncludeManagementTools -Restart重启后打开“Hyper-V 管理器”。2. 创建 Ubuntu 虚拟机 (Generation 2)代数第二代 (支持 UEFI启动快)。内存建议8GB - 16GB(OpenClaw 数据库内存占用较高)。网络配置 (关键)创建外部虚拟交换机绑定到服务器物理网卡。勾选“允许管理操作系统共享此网络适配器” (防止宿主机断网)。效果Ubuntu 将获得与宿主机同网段的 IP内网其他同事可直接通过 IP 访问 OpenClaw。硬盘动态扩展建议100GB(模型缓存和日志会占用空间)。3. 安装 Ubuntu Server启动虚拟机安装 ISO。网络建议配置为静态 IP(例如192.168.1.200)方便内网服务固定访问。软件选择务必勾选OpenSSH Server(方便后续使用 XShell/Putty 管理无需切窗口操作)。 第四部分Ubuntu 内 Docker 与服务部署1. 离线安装 Docker将docker-debs上传至 Ubuntu执行cd /path/to/docker-debs sudo dpkg -i *.deb若报依赖错误需补全缺失的.deb包。启动服务sudo systemctl enable --now docker sudo usermod -aG docker $USER # 重新登录生效2. 导入镜像上传openclaw-image.tar和db-images.tardocker load -i openclaw-image.tar docker load -i db-images.tar执行docker images验证是否加载成功。3. 启动服务上传openclaw-source修改配置端口映射确保docker-compose.yml中映射了 Web 端口如18789:18789。模型配置若内网部署了 Ollama需将LLM_BASE_URL指向宿主机或模型服务器的内网 IP。启动命令docker compose up -d⚠️ 第五部分关键避坑指南 (Troubleshooting)BIOS 设置确保物理服务器 BIOS 开启了VT-x / AMD-V虚拟化支持。如果虚拟机报错可能需要开启嵌套虚拟化虽然 Docker 不需要但有时会影响检测Set-VMProcessor -VMName UbuntuVM -ExposeVirtualizationExtensions $true内存不足预警Windows Server 2019 自身占用约 2-4GBUbuntu 约 1GBDocker 服务至少需要 4GB。建议若物理内存仅为 16GB建议在docker-compose.yml中为 PostgreSQL 和 OpenClaw 设置mem_limit防止 OOM (内存溢出) 导致服务崩溃。时间同步问题虚拟机时间容易漂移导致 API 请求签名失败。解决在 Ubuntu 中安装chrony并指向内网 NTP 服务器或在 Hyper-V 设置中关闭“时间同步集成服务”。防火墙策略Windows 防火墙确保放行 Ubuntu 虚拟机的通信端口。Ubuntu 防火墙 (UFW)若开启需放行 Docker 端口默认2376-2377,18789等。结语通过这种架构我们成功在内网 WinServer 2019 上构建了一个“Linux 原生”的 AI 服务环境。OpenClaw 现已稳定运行内网用户可通过浏览器直接访问这只“小龙虾”
内外网物理隔离的企业内网部署小龙虾 OpenClaw（1）：环境筑基篇
副标题基于 Hyper-V 虚拟机与 Ubuntu Docker 的“飞地”架构设计撰写时间2026年03月27日适用环境外网 Win10 内网 WinServer 2019 物理隔离 OpenClaw (OpenWebUI等) 前言在企业内网物理隔离的环境下既要保证服务的稳定性又要兼顾开发部署的便捷性是一个典型的“孤岛”运维场景。传统的 Windows 容器兼容性差而 WSL2 在 Server 2019 上配置复杂且不稳定。本文记录了一种**“Windows 宿主机 Hyper-V Linux 虚拟机 Docker 原生环境”**的最优解架构。我们将内网 Windows Server 2019 变为一个强大的虚拟化底座利用 Ubuntu 虚拟机为 OpenClaw 提供完美的 Linux 运行时环境。️ 第一部分核心架构设计在设计之初我们确立了以下技术栈以确保在无外网环境下依然能获得最佳的 Linux 容器体验。组件选型理由物理宿主机Windows Server 2019企业标准服务器系统自带 Hyper-V无需额外安装第三方虚拟机软件。虚拟化层Hyper-V (Generation 2)微软原生虚拟化性能损耗极低支持 UEFI 快速启动且在 Server 版本中支持最完善。客户机 OSUbuntu 22.04 LTS Server长期支持版本资源占用低无 GUIDocker 兼容性最好社区支持最广。运行时Docker Engine (Linux)原生 Linux Docker避免了 Windows 容器对 Linux 应用的兼容性黑洞。目标应用OpenClaw PG Redis标准的容器化 AI 应用栈。 第二部分外网机器准备工作 (Win10)由于内网完全断网所有依赖必须在 Win10 上预先下载并打包。1. 操作系统镜像准备下载文件ubuntu-22.04-live-server-amd64.iso来源Ubuntu 官方镜像站。安装 WSL | Microsoft Learn旧版 WSL 的手动安装步骤 | Microsoft Learn2. Docker 离线安装包构建不要试图在内网使用apt必须准备.deb离线包。操作步骤在 Win10 上安装Docker Desktop或使用一台联网的 Ubuntu 机器。访问 Docker 官方仓库下载以下核心包及其依赖注意必须匹配 Ubuntu 22.04 的架构docker-cedocker-ce-clicontainerd.iodocker-compose-pluginNVIDIA Container Toolkit关键依赖使用apt-rdepends或手动下载libc6,libseccomp2,pigz,xz-utils等基础依赖包。打包将所有.deb文件放入文件夹docker-debs。3. OpenClaw 镜像构建与导出为了避免在内网安装 Node.js 依赖和 Playwright 浏览器内核极其耗时且需要网络必须在外部构建好镜像。构建在 Win10 的 Docker Desktop 中构建 OpenClaw 镜像。docker build -t openclaw:v1 .导出# 导出应用镜像 docker save -o openclaw-image.tar openclaw:v1 # 导出依赖镜像 (Postgres Redis) docker pull postgres:15-alpine docker pull redis:7-alpine docker save -o db-images.tar postgres:15-alpine redis:7-alpine4. 资源包汇总 (DeployPackage)将以下文件刻录至移动硬盘或通过摆渡机传输ubuntu-22.04-live-server-amd64.isodocker-debs/(文件夹)openclaw-image.tardb-images.taropenclaw-source/(含docker-compose.yml和.env的源码文件夹)⚙️ 第三部分内网机器环境部署 (WinServer 2019)1. 启用 Hyper-V 角色以管理员身份运行 PowerShellInstall-WindowsFeature -Name Hyper-V -IncludeManagementTools -Restart重启后打开“Hyper-V 管理器”。2. 创建 Ubuntu 虚拟机 (Generation 2)代数第二代 (支持 UEFI启动快)。内存建议8GB - 16GB(OpenClaw 数据库内存占用较高)。网络配置 (关键)创建外部虚拟交换机绑定到服务器物理网卡。勾选“允许管理操作系统共享此网络适配器” (防止宿主机断网)。效果Ubuntu 将获得与宿主机同网段的 IP内网其他同事可直接通过 IP 访问 OpenClaw。硬盘动态扩展建议100GB(模型缓存和日志会占用空间)。3. 安装 Ubuntu Server启动虚拟机安装 ISO。网络建议配置为静态 IP(例如192.168.1.200)方便内网服务固定访问。软件选择务必勾选OpenSSH Server(方便后续使用 XShell/Putty 管理无需切窗口操作)。 第四部分Ubuntu 内 Docker 与服务部署1. 离线安装 Docker将docker-debs上传至 Ubuntu执行cd /path/to/docker-debs sudo dpkg -i *.deb若报依赖错误需补全缺失的.deb包。启动服务sudo systemctl enable --now docker sudo usermod -aG docker $USER # 重新登录生效2. 导入镜像上传openclaw-image.tar和db-images.tardocker load -i openclaw-image.tar docker load -i db-images.tar执行docker images验证是否加载成功。3. 启动服务上传openclaw-source修改配置端口映射确保docker-compose.yml中映射了 Web 端口如18789:18789。模型配置若内网部署了 Ollama需将LLM_BASE_URL指向宿主机或模型服务器的内网 IP。启动命令docker compose up -d⚠️ 第五部分关键避坑指南 (Troubleshooting)BIOS 设置确保物理服务器 BIOS 开启了VT-x / AMD-V虚拟化支持。如果虚拟机报错可能需要开启嵌套虚拟化虽然 Docker 不需要但有时会影响检测Set-VMProcessor -VMName UbuntuVM -ExposeVirtualizationExtensions $true内存不足预警Windows Server 2019 自身占用约 2-4GBUbuntu 约 1GBDocker 服务至少需要 4GB。建议若物理内存仅为 16GB建议在docker-compose.yml中为 PostgreSQL 和 OpenClaw 设置mem_limit防止 OOM (内存溢出) 导致服务崩溃。时间同步问题虚拟机时间容易漂移导致 API 请求签名失败。解决在 Ubuntu 中安装chrony并指向内网 NTP 服务器或在 Hyper-V 设置中关闭“时间同步集成服务”。防火墙策略Windows 防火墙确保放行 Ubuntu 虚拟机的通信端口。Ubuntu 防火墙 (UFW)若开启需放行 Docker 端口默认2376-2377,18789等。结语通过这种架构我们成功在内网 WinServer 2019 上构建了一个“Linux 原生”的 AI 服务环境。OpenClaw 现已稳定运行内网用户可通过浏览器直接访问这只“小龙虾”
