![Gemini_Generated_Image_tu99o2tu99o2tu99.png](/static/img/d92fc86d18c2c004c17b6f4b705190b6.Gemini_Generated_Image_tu99o2tu99o2tu99.webp)

旁路由这东西好用，但也容易把家里网络折腾到全员断网。我把 OpenWrt 放进 Docker 里跑，尽量在保留原系统稳定性的同时，把去广告、代理和网关能力接进 HomeLab。



在 ARM 开发板（例如 Orange Pi 3B）上搭建 HomeLab 时，通常会同时运行多个服务容器，为了给局域网提供额外的网络接管、去广告等功能，同时又不破坏开发板原有的 Ubuntu 系统生态，使用 Docker 部署 OpenWrt 旁路由是兼顾性能与灵活性的最佳方案。

本文将详细记录利用 Docker 的 MacVLAN 网络，在 ARM64 架构下部署 OpenWrt 的全过程，以及配置出错后的“一秒重置”技巧。

## 环境准备与网络规划

部署前，需先确认当前局域网的基础网络信息。以下配置以常见的家庭网络环境为例：

* **物理网卡名称**：`eth0`
* **局域网网段**：`192.168.124.0/24`
* **主路由（网关）IP**：`192.168.124.1`
* **OpenWrt 规划 IP**：`192.168.124.100`（需确保未被占用）

## 部署流程

### 1. 开启物理网卡混杂模式

要让 Docker 容器拥有与宿主机同网段的独立 IP，必须借助 MacVLAN 网络。前提是物理网卡必须开启混杂模式（Promiscuous Mode），以允许网卡接收目标 MAC 地址非本机的流量。

执行以下命令开启：

```bash
sudo ip link set eth0 promisc on

```

### 2. 创建 Docker MacVLAN 网络

创建一个名为 `macnet` 的网络，将网段与网关与主路由对齐。

```bash
docker network create -d macvlan \
  --subnet=192.168.124.0/24 \
  --gateway=192.168.124.1 \
  -o parent=eth0 macnet

```

> **避坑指南**：如果执行时提示 `invalid pool request: Pool overlaps with other one on this address space`，说明当前 Docker 中存在冲突的网段配置。执行 `docker network prune` 清除未使用过的网络即可解决。

### 3. 拉取并运行 OpenWrt 容器

针对 ARM64 (aarch64) 架构，推荐使用国内维护的 `sulinggg/openwrt:armv8` 镜像，内置了丰富的常用网络与系统插件。

```bash
docker run --restart always --name openwrt -d \
  --network macnet \
  --privileged \
  sulinggg/openwrt:armv8 /sbin/init

```

### 4. 配置固定 IP

容器启动后，默认的网络配置通常无法直接与现有局域网互通，需要进入容器修改静态 IP。

进入容器终端：

```bash
docker exec -it openwrt bash

```

编辑网络配置文件：

```bash
vi /etc/config/network

```

找到 `config interface 'lan'` 块，按 `i` 键进入编辑模式，修改对应的网段信息：

```text
config interface 'lan'
    option type 'bridge'
    option ifname 'eth0'
    option proto 'static'
    option ipaddr '192.168.124.100'  # 规划的旁路由 IP
    option netmask '255.255.255.0'
    option gateway '192.168.124.1'   # 主路由 IP
    option dns '192.168.124.1'       

```

修改完成后，按 `Esc` 键，输入 `:wq` 保存并退出。

重启容器内的网络服务使配置生效：

```bash
/etc/init.d/network restart

```

### 5. 访问后台

配置生效后，在浏览器中访问 `http://192.168.124.100` 即可进入 ImmortalWrt 登录界面（默认账号为 `root`，密码为 `password` 或留空）。

---

## 进阶技巧：容器备份与一键复原

在折腾 OpenWrt 插件时，极易因设置不当导致网络崩溃。Docker 部署的最大优势在于“试错成本极低”。在完成上述基础网络配置并成功登录后台后，建议立刻将当前状态“存档”。

在宿主机终端执行打包命令：

```bash
docker commit openwrt my-openwrt:v1

```

此后，如果 OpenWrt 被玩坏，只需强行删除容器：

```bash
docker rm -f openwrt

```

然后使用刚刚保存的镜像重新运行即可“满血复活”，省去了重新进入终端修改网络配置的步骤：

```bash
docker run --restart always --name openwrt -d \
  --network macnet \
  --privileged \
  my-openwrt:v1 /sbin/init

```

Docker 部署 OpenWrt 旁路由

![Gemini_Generated_Image_u7ocq8u7ocq8u7oc.png](/static/img/d19761dc5c35bc836ce3d199b5642a01.Gemini_Generated_Image_u7ocq8u7ocq8u7oc.webp)

OpenClaw 真正跑起来以后，才发现部署不是只有一个 docker compose。换源、运行环境、配置文件和启动顺序都要理清楚，这篇把 Linux 完整体部署流程重新梳了一遍。



# 一、 Ubuntu 镜像源设置

在一台全新的 Ubuntu 虚拟机上，首先要替换国内软件源以保证下载速度。

## 1. 备份原始文件
```bash
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak

```

## 2. 一键替换为阿里云源

使用 `sed` 命令一键把官方域名替换为阿里云域名：

```bash
sudo sed -i 's/cn.archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list.d/ubuntu.sources
sudo sed -i 's/security.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list.d/ubuntu.sources

```

## 3. 更新系统索引

换完源后，刷新系统仓库：

```bash
sudo apt update

```

---

# 二、 (可选) 安装 Tailscale 实现内网穿透

如果没有公网 IP，强烈建议使用 Tailscale 打通局域网限制，方便随时随地访问控制台。

1. **一键安装 Tailscale**

```bash
curl -fsSL https://tailscale.com/install.sh | sh

```

2. **使用密钥直接静默登录** (请将 `tskey-...` 替换为实际的专属 Auth Key)

```bash
sudo tailscale up --authkey=tskey-au-xxxxxxxxxxxxx

```

3. **查看内网 IP**
执行以下命令，获取分配给这台虚拟机的 `100.x.x.x` 专属内网 IP：

```bash
tailscale ip -4

```

---

# 三、 OpenClaw 本体安装与核心配置

## 1. 跑官方一键安装脚本

该脚本会自动拉取代码、配置 Node.js 环境并初始化工作空间：

```bash
curl -sSL https://openclaw.ai/install.sh | bash

```

## 2. 刷新环境变量

让系统识别刚刚安装的 `openclaw` 命令：

```bash
source ~/.bashrc && source ~/.profile

```

## 3. 优化 NPM 网络环境

由于后续需要安装各种插件，建议把 npm 的源换成国内镜像（淘宝/阿里云维护）：

```bash
npm config set registry https://registry.npmmirror.com

```

## 4. 修改底层网络绑定 (极其重要)

执行 `nano ~/.openclaw/openclaw.json` 打开配置文件，找到 `bind` 字段，进行如下修改：

```json
"bind": "lan" 

```

> **为什么要改写成 lan？**
> 因为在 OpenClaw 的新逻辑里，`lan` 模式会自动把服务绑定到所有网卡（等同于以前的 `0.0.0.0`），这样通过 Tailscale 穿透进来的流量才能正常访问控制台。

修改后重启网关：

```bash
openclaw gateway restart

```

## 5. 添加信任域名 (CORS 跨域配置)

如果配置了专属域名，需要将其加入白名单：

```bash
openclaw config set gateway.controlUi.allowedOrigins '["https://chat.zym588.me"]'

```

执行完后，再次重启网关：

```bash
openclaw gateway restart

```

---

# 四、 解决控制台 Token 报错与设备验证

在重启或者更换域名后访问网页控制台，往往会报错 `gateway token mismatch`（令牌不匹配）。这通常是因为浏览器缓存了旧的 Token。

**操作步骤：**

1. 在服务器终端输入以下命令获取新 Token：

```bash
openclaw dashboard --no-open

```

2. 终端会输出一个类似 `http://127.0.0.1:18789/#token=xxxxxx` 的链接。
3. 提取出 `#token=` 后面那一长串字符复制下来。
4. 回到报错的网页，点击左侧菜单底部的 **设置 (Settings)**，找到填写 **Token (令牌)** 的输入框。
5. 将复制的新字符粘贴进去，点击 **连接 (Connect)**。

**处理新设备拦截：**
连接成功后如果被系统拦截并提示设备未授权，需回到终端执行：

```bash
# 1. 查看当前待审批的设备请求
openclaw devices list

# 2. 批准该设备接入（替换下方括号内为列表中实际显示的设备 ID）
openclaw devices approve [设备ID]

```

---

# 五、 安装与配置企业微信插件

为了在手机微信上直接与 AI 对话，需要接入企业微信渠道。

1. **安装专属插件**

```bash
openclaw plugins install @wecom/wecom-openclaw-plugin

```

安装完成后启动网关：

```bash
openclaw gateway start

```

2. **添加渠道交互向导**
在终端中输入以下命令：

```bash
openclaw channels add

```

* 在 select channel 步骤，选择 `WeCom (企业微信)`。
* 进入企业微信管理后台，创建机器人应用，获取并输入机器人的 **Bot ID** 和 **Secret**。
* 一路回车，最后选择 `finish`。

3. **双向配对授权**

* 返回企业微信手机端，向刚刚创建的机器人发送任意消息。机器人会回复一串包含配对码的信息。
* 在服务器终端中，执行最终配对命令完成授权绑定：

```bash
openclaw pairing approve wecom [在此处填入自定义的设备名称]

```

---

# 六、 接入大模型 API (以讯飞星火为例)

千万不要在网页端 UI 进行自定义大模型的配置（容易触发 JSON 格式 Bug）。必须使用命令行的交互工具。

在终端执行：

```bash
openclaw configure

```

根据屏幕提示依次选择：

1. 选中 **`Model`** (模型) 并回车继续。
2. 核心避坑：当询问 Model/auth provider 时，**绝对不要选 OpenAI**，向下翻阅，选择 **`Custom Provider (Any OpenAI or Anthropic compatible endpoint)`**。
3. 协议选择 **`OpenAI`**。

接着按顺序填入以下参数：

* **Base URL**: 粘贴 `https://maas-coding-api.cn-huabei-1.xf-yun.com/v2`
* **API Key**: 粘贴星火大模型的专属密钥
* **Model ID**: 输入 `astron-code-latest`

一路回车保存，配置完成！

linux部署完全体openclaw

![Gemini_Generated_Image_i60oeji60oeji60o.png](/static/img/d9c7a2fb9a482e192979a34c8bbead3e.Gemini_Generated_Image_i60oeji60oeji60o.webp)

偶尔需要一个临时 Windows 环境，不一定非得开虚拟机。这里用 Docker + KVM + noVNC 搭了一个能在浏览器里访问的 Windows 实例，适合测试和远程临时操作。



利用 `dockurr/windows` 项目，我们可以将底层虚拟机（KVM）和网页前端显示（noVNC）完美封装进一个 Docker 容器中。只需一行命令，即可在浏览器里获得极其顺滑的原生 Windows 桌面体验。

## 🛠️ 第一阶段：环境准备

1. **硬件要求**：x86_64 架构的 CPU（极空间、主流 NAS 或普通 PC 均可）。
2. **KVM 硬件加速**：宿主机必须支持并开启 KVM。这是保证 Windows 运行流畅度媲美原生机的核心。
3. **存储规划**：新建一个专用的工程目录，并在其中准备好数据持久化文件夹。

```bash
# 创建工程主目录
mkdir -p /root/docker-windows
cd /root/docker-windows

# 创建存放数据和系统镜像的子目录（极其关键）
mkdir -p ./data

```

## 📦 第二阶段：准备纯净的原版镜像（强烈推荐）

虽然容器支持全自动联网下载系统，但受限于国内网络环境。**直接使用本地原版镜像（离线安装）是最稳妥、最高效的方案。**

推荐系统版本：**Windows 10 Enterprise LTSC 2021**（极度精简，无广告，无强制更新，最适合持久化挂机）。

1. 提前下载好 LTSC 2021 的原版 `.iso` 镜像文件。
2. 将下载好的镜像**重命名为全小写的 `custom.iso**`。
3. 将 `custom.iso` 放入刚才创建的 `data` 目录中。

**最终的文件绝对路径结构应严格如下：**
`/root/docker-windows/data/custom.iso`

## ⚙️ 第三阶段：编写核心配置文件

在工程主目录（`/root/docker-windows`）下，新建 `docker-compose.yml` 文件并填入以下参数：

```yaml
version: "3"
services:
  windows:
    image: dockurr/windows
    container_name: browser-windows
    devices:
      - /dev/kvm          # 开启 KVM 硬件虚拟化加速（性能核心）
    cap_add:
      - NET_ADMIN         # 赋予网络管理权限
    ports:
      - 8006:8006         # 浏览器访问的映射端口
      - 3389:3389         # (可选) 暴露原生 RDP 端口供后续进阶使用
    environment:
      VERSION: "win10"    # 系统版本标签
      RAM_SIZE: "8G"      # ⚠️ 关键：安装期间分配 8G 内存防溢出，装完后可改为 4G
      CPU_CORES: "4"      # 分配的核心数
      DISK_SIZE: "64G"    # 虚拟 C 盘的大小上限（动态扩容）
    volumes:
      - ./data:/storage   # 映射数据目录，实现系统盘持久化和读取 custom.iso
    stop_grace_period: 2m
    restart: unless-stopped

```

## 🚀 第四阶段：一键起飞与避坑指南

确认 `custom.iso` 已经稳稳躺在 `data` 目录里，且 `docker-compose.yml` 准备就绪后，执行启动命令：

```bash
docker-compose up -d

```

### 🎮 开始体验

打开任意浏览器，输入 `http://你的宿主机IP:8006`。
你将看到系统自动跳过漫长的网络下载，直接读取本地 `custom.iso`，并开始执行全自动、无人值守的 Windows 安装流程。安装完成后，一个干净的 Windows 桌面就会呈现在网页中！

用docker快速部署windows

![Gemini_Generated_Image_o8z8u6o8z8u6o8z8.png](/static/img/4980a4e480679d613bc5847ecc37a78e.Gemini_Generated_Image_o8z8u6o8z8u6o8z8.webp)

黑底白字能用，但天天 SSH、跑 Docker、敲命令时，终端顺眼一点真的很重要。这篇把 Windows Terminal、字体、主题和常用工具整理成一套更舒服的命令行环境。



每天折腾代码、通过 SSH 管理服务器或是跑 Docker 容器时，如果还要面对 Windows 系统自带那个老旧、简陋的 `cmd` 黑框，心情难免有些枯燥。

其实，只需要简单的几步改造，Windows 的命令行也能拥有不输 macOS 和 Linux 的超高颜值与极客体验。今天分享一套直接将颜值和效率双双拉满的终极改造方案，并教你避开常见的配置深坑。

## 零阶段：打好地基，升级 PowerShell 7

在开始美化之前，**强烈建议抛弃系统自带的蓝底 Windows PowerShell 5.1**。老版本不仅性能落后，还会对许多现代工具产生兼容性报错。我们需要升级到微软开源的最新版 **PowerShell 7**。

官方下载地址：https://learn.microsoft.com/zh-cn/powershell/

或者打开你当前的终端，运行以下命令一键安装：
```powershell
winget install --id Microsoft.PowerShell --source winget
```

*💡 进阶小贴士：如果 `winget` 下载 GitHub 资源很慢，可以输入 `winget settings`，在 JSON 配置文件中加入 `"network": { "downloader": "wininet" }`，这样它就能完美配合你的系统代理进行高速下载。*

安装完成后，重启终端。你会在下拉菜单中看到一个**黑色图标**的 `PowerShell`。进入终端设置，将其设为**默认配置文件**。

## 第一阶段：换个好看的“皮囊” (Windows Terminal)

改用微软官方出品的现代化终端 **Windows Terminal**。它不仅支持多标签页，更重要的是支持 GPU 硬件加速。如果你的机箱里有强劲的显卡，满屏滚动日志时它的文字渲染会极其丝滑。

**开启高颜值“毛玻璃”效果：**

1. 点击顶部下拉箭头，进入 **“设置”**。
2. 在左侧找到 **“配置文件” -> “PowerShell”**。
3. 进入 **“外观”** 选项卡，向下滚动找到 **“透明度”**。
4. 打开 **“启用亚克力材质”**，并将背景不透明度调整至 **70% 左右**，点击保存。

现在拖动一下窗口，背景隐约透出桌面的色彩，高级感瞬间拉满。

## 第二阶段：注入“灵魂” (Oh My Posh)

接下来我们要把单调的提示符变成带有彩色区块、运行耗时统计、以及 Git 状态仪表盘的炫酷样式。

### 1. 安装 Oh My Posh 与极客字体

在终端中运行：

```powershell
winget install JanDeDobbeleer.OhMyPosh -s winget
```

为了防止各种炫酷图标（如文件夹、闪电、语言 Logo）变成方块乱码，我们需要安装 Nerd Font：

```powershell
oh-my-posh font install
```

在弹出的列表中，推荐选择 **`Meslo`** 或 **`FiraCode`**。安装后，回到 Terminal 的 **“设置” -> “默认值” -> “外观”** 中，将“字体”修改为你刚下载的 Nerd 字体。

## 第三阶段：武装到牙齿的 Rust 现代神器

除了好看，我们还要好用。把古老的系统命令替换成性能更强、颜值更高的现代版本（大多基于 Rust 编写）：

* **`lsd` (替代 `ls` / `dir`)**：带有彩色图标的文件列表，目录结构一目了然。
* **`zoxide` (替代 `cd`)**：支持“智能瞬移”的目录跳转工具。去过一次的目录，下次只需打前几个字母即可直达。
* **`bat` (替代 `cat`)**：自带代码语法高亮和 Git 修改标记的文件查看器。
* **`btop`**：极客必备的性能仪表盘。如果你的电脑配置了多核 CPU 和强劲 GPU，看着它动态渲染的性能折线图，绝对是一种视觉享受。

**一键安装以上神器：**

```powershell
winget install lsd ajeetdsouza.zoxide sharkdp.bat btop
```

## 第四阶段：给终端加上“读心术”与终极配置

最后，我们需要安装 **PSReadLine**（用于根据历史记录进行灰字智能补全），并将所有工具整合到 PowerShell 的启动配置文件中。

**更新模块：**

```powershell
Install-Module PSReadLine -Force -SkipPublisherCheck -Scope CurrentUser
```


在终端输入以下命令打开配置本：

```powershell
notepad $PROFILE
```

*(如果提示找不到文件，先运行 `New-Item -Type File -Force $PROFILE`)*

将以下经过实战检验的**“无错版”代码**完整粘贴进去并保存：

```powershell
# 1. 初始化提示符美化 (统一使用 powershell 即可完美兼容)
oh-my-posh init powershell | Invoke-Expression

# 2. 引入 PSReadLine 开启智能补全
Import-Module PSReadLine
Set-PSReadLineOption -PredictionSource History
Set-PSReadLineKeyHandler -Key UpArrow -Function HistorySearchBackward
Set-PSReadLineKeyHandler -Key DownArrow -Function HistorySearchForward

# 3. 初始化现代目录跳转工具 zoxide
# ⚠️ 避坑指南：必须加入 Out-String，否则多行代码通过管道符传递给 PS7 时会报缺失大括号的语法错误！
if (Get-Command zoxide -ErrorAction SilentlyContinue) {
    zoxide init powershell | Out-String | Invoke-Expression
}

# 4. 强制替换系统默认别名
# ⚠️ 避坑指南：系统默认将 ls 保护了起来，必须使用 -Force 参数进行强制覆盖
Set-Alias -Name ls -Value lsd -Force
Set-Alias -Name cat -Value bat -Force

# 5. 系统监控快捷别名
function top { btop }
```

## 结语

保存配置文件并彻底重启一次终端。一番折腾下来，一个兼具高颜值和极高生产力的现代化 Windows 终端就打造完成了。敲代码不仅是脑力劳动，视觉上的愉悦同样能大幅提升折腾技术的乐趣。快去给你的命令行“洗个澡”吧！