# Docker 更换国内源教程
Docker 默认使用国外官方源，下载镜像时速度较慢，甚至出现超时失败。本教程适配 Windows、macOS、Linux 三大系统，教你更换国内优质镜像源，解决下载慢问题，同时附上源的优先级、测试方法及常见问题排查。

## 一、前置准备
- 已安装 Docker Desktop（Windows/macOS）或 Docker Engine（Linux），且能正常启动。
- 确认网络通畅，能访问国内镜像源服务器（如阿里云、网易、科大等）。
- Linux 系统需具备 root 权限（或 sudo 权限），Windows/macOS 需以管理员身份操作 Docker。



## 二、常用国内优质 Docker 源
优先选择稳定、更新及时的源，以下是主流国内源（任选其一或组合使用）：
- 阿里云 Docker 镜像源（推荐）：https://docker.mirrors.aliyun.com
- 网易云 Docker 镜像源：https://hub-mirror.c.163.com
- 科大镜像源：https://docker.mirrors.ustc.edu.cn
- 腾讯云 Docker 镜像源：https://mirror.ccs.tencentyun.com
- 华为云 Docker 镜像源：https://mirrors.huaweicloud.com/docker/

注意：部分源可能存在临时维护，若更换后无法使用，可切换至其他源。

:::tip{title="提示"}
提示 本网站已搭建自动生成配置文件的程序自动获取最新国内可用源可前往[ docker配置文件](https://blog.suhm.top/c/dockerconfig)进行配置。
:::

## 三、分系统更换教程
### 3.1 Windows 系统（Docker Desktop）
1. 打开 Docker Desktop，点击右上角「设置」（齿轮图标）。
2. 在左侧菜单中找到「Docker Engine」，点击进入配置页面。
3. 在配置文件中，找到 `registry-mirrors` 字段，添加国内源地址（格式如下），多个源用逗号分隔：

```json
 {
  "registry-mirrors": [
    "https://docker.mirrors.aliyun.com",
    "https://hub-mirror.c.163.com"
  ],
  "insecure-registries": [],
  "debug": false,
  "experimental": false,
  "features": {
    "buildkit": true
  }
}
```
4. 点击右下角「Apply & Restart」，等待 Docker 重启完成，源更换生效。

### 3.2 macOS 系统（Docker Desktop）
1. 打开 Docker Desktop，点击顶部菜单栏「Docker」→「设置」。
2. 选择左侧「Docker Engine」，进入配置界面（与 Windows 操作一致）。
3. 在 `registry-mirrors` 中添加国内源，保存配置并重启 Docker 即可。

### 3.3 Linux 系统（Ubuntu/Debian/CentOS 通用）
Linux 系统通过修改 Docker 配置文件 `/etc/docker/daemon.json` 实现换源，步骤如下：
1. 打开终端，执行命令创建/编辑配置文件（若文件不存在则自动创建）：
        sudo vim /etc/docker/daemon.json
2. 按 `i` 进入编辑模式，添加以下内容（替换为你选择的国内源）：
```json
 {
  "registry-mirrors": [
    "https://docker.mirrors.aliyun.com",
    "https://hub-mirror.c.163.com"
  ],
  "insecure-registries": [],
  "debug": false,
  "experimental": false,
  "features": {
    "buildkit": true
  }
}
```
3. 按 `Esc`，输入 `:wq` 保存并退出编辑。
4. 重启 Docker 服务，使配置生效：# 重启 Docker 服务
sudo systemctl restart docker
# 查看 Docker 状态，确认重启成功
sudo systemctl status docker

## 四、验证源是否更换成功
无论哪种系统，更换源后可通过以下命令验证，确认镜像源已生效：
docker info
执行命令后，找到「Registry Mirrors」字段，若显示你配置的国内源地址，说明更换成功。

## 五、注意事项
- 若配置多个源，Docker 会按顺序优先使用第一个源，若第一个源不可用，自动切换至下一个。
- 配置时注意 JSON 格式正确，逗号、引号不能遗漏，否则 Docker 无法正常启动（可通过 `sudo systemctl status docker` 查看错误日志）。
- 部分私有镜像仓库（如公司内部仓库），需在 `insecure-registries` 中添加仓库地址，否则无法拉取镜像。
- 若更换源后仍下载缓慢，可尝试清除 Docker 缓存：`docker system prune -a`（谨慎执行，会删除未使用的镜像、容器等）。

## 六、常见问题排查
### 6.1 Docker 重启失败
原因：配置文件 `daemon.json` 格式错误（如逗号缺失、引号不匹配）。
解决：重新编辑配置文件，检查 JSON 格式，确保无误后再次重启。

### 6.2 验证时未显示配置的源
原因：未重启 Docker 服务，或配置文件路径错误（Linux 需确保路径为 `/etc/docker/daemon.json`）。
解决：重启 Docker 服务，重新执行 `docker info` 验证。

### 6.3 下载镜像仍超时
原因：所选源临时维护，或网络存在限制。
解决：切换至其他国内源，或检查网络连接，关闭防火墙/代理后重试。

## 七、总结
更换 Docker 国内源是解决镜像下载慢的关键操作，不同系统操作流程基本一致，核心是修改 Docker 引擎的镜像源配置，重启后即可生效。建议优先选择阿里云、科大等稳定源，确保镜像下载流畅。

Docker 更换国内源教程

本文整理 Windows/macOS 安装 Node.js、配置 npm 国内镜像、使用 cnpm 及常见问题解决方案，用于提升包下载速度。



## 一、Node.js 安装
### 1.1 Windows 系统
1. 访问 [nodejs.org](https://nodejs.org/)，下载 **LTS 版本**
2. 双击安装包，按提示完成安装
3. 验证安装
```bash
node -v
npm -v
```

### 1.2 macOS 系统
#### 方法一：官网安装
1. 下载 `.pkg` 安装包并双击安装
2. 验证版本
```bash
node -v
npm -v
```

#### 方法二：Homebrew 安装
```bash
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node
```

---

## 二、npm 国内源配置
### 2.1 配置淘宝镜像（推荐）
1. 临时使用
```bash
npm --registry https://registry.npmmirror.com install 包名
```

2. 永久配置
```bash
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry
```

3. .npmrc 文件配置（推荐）
```bash
echo "registry=https://registry.npmmirror.com" > .npmrc
```

### 2.2 安装并使用 cnpm
```bash
# 全局安装 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

# 使用 cnpm 安装包
cnpm install 包名

# 查看版本
cnpm -v
```

---

## 三、常用国内镜像源
- 淘宝镜像：`https://registry.npmmirror.com`
- 华为云镜像：`https://mirrors.huaweicloud.com/repository/npm/`
- 腾讯云镜像：`http://mirrors.cloud.tencent.com/npm/`

---

## 四、常见问题解决
### 4.1 下载速度慢
1. 确认已配置国内镜像
2. 清除 npm 缓存
```bash
npm cache clean -f
```

### 4.2 安装包失败
1. 清除缓存
```bash
npm cache clean -f
```

2. 删除依赖与锁文件
```bash
# macOS/Linux
rm -rf node_modules package-lock.json

# Windows
rd /s /q node_modules
del package-lock.json
```

3. 重新安装
```bash
npm install
```

---

## 五、总结
完成配置后可实现：
- Windows/macOS 成功安装 Node.js
- npm 永久切换国内镜像加速下载
- 使用 cnpm 替代 npm 快速安装依赖
- 解决下载慢、安装失败等常见问题

Nodejs安装与配置

## OpenClaw 配置文件 JSON 格式验证命令

### 用途
在修改 `~/.openclaw/openclaw.json` 配置文件后，快速验证 JSON 格式是否正确，避免因格式错误导致 OpenClaw Gateway 启动失败。

### 命令

```bash
python3 -c "import json; json.load(open('路径'))" && echo "JSON OK"
```


## 批量提取文华TYPES目录下所有 .XTRD 文件中的麦语言代码

```python
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
批量提取文华TYPES目录下所有 .XTRD 文件中的麦语言代码
用法：python extract_all_types.py [源目录] [输出目录]
若不指定参数，默认源目录为当前目录，输出目录为当前目录下的 WH8_MQL
"""

import os
import re
import sys

def extract_code_from_xtrd(file_path: str) -> str:
    """从 .XTRD 文件中提取 <CODE> 标签内的代码"""
    try:
        # 尝试用 GBK 编码读取（文华默认中文编码）
        with open(file_path, 'r', encoding='gbk', errors='ignore') as f:
            content = f.read()
    except Exception as e:
        print(f"❌ 读取文件失败 {file_path}: {e}")
        return None

    # 正则匹配 <CODE>...</CODE>，支持多行和空白
    match = re.search(r'<CODE>\s*(.*?)\s*</CODE>', content, re.DOTALL)
    if not match:
        # 有些文件可能没有 CODE 标签，跳过
        return None

    code = match.group(1).strip()
    # 处理可能存在的 HTML 实体（极少情况）
    code = code.replace('&lt;', '<').replace('&gt;', '>').replace('&amp;', '&')
    return code


def process_directory(src_dir: str, dst_dir: str):
    """递归处理目录，保持文件夹结构"""
    if not os.path.isdir(src_dir):
        print(f"❌ 源目录不存在: {src_dir}")
        return

    count = 0
    for root, dirs, files in os.walk(src_dir):
        # 计算相对路径
        rel_path = os.path.relpath(root, src_dir)
        if rel_path == '.':
            target_dir = dst_dir
        else:
            target_dir = os.path.join(dst_dir, rel_path)

        # 确保目标目录存在
        os.makedirs(target_dir, exist_ok=True)

        for file in files:
            if not file.lower().endswith('.xtrd'):
                continue

            src_file = os.path.join(root, file)
            code = extract_code_from_xtrd(src_file)

            if code is None:
                print(f"⚠️ 跳过（无CODE标签）: {rel_path}/{file}")
                continue

            # 生成输出文件名：去掉 .XTRD 后缀，加上 .mql
            base_name = file[:-5] if file.lower().endswith('.xtrd') else file
            safe_name = re.sub(r'[\\/*?:"<>|]', '_', base_name)
            out_file = os.path.join(target_dir, f"{safe_name}.mql")

            with open(out_file, 'w', encoding='utf-8') as f:
                f.write(code)

            count += 1
            print(f"✅ 已提取: {rel_path}/{safe_name}.mql")

    print(f"\n🎉 提取完成！共处理 {count} 个文件，保存至: {dst_dir}")


if __name__ == '__main__':
    # 默认源目录为当前脚本所在目录，输出为同级 WH8_MQL
    default_src = os.getcwd()
    default_dst = os.path.join(default_src, 'WH8_MQL')

    if len(sys.argv) >= 3:
        src = sys.argv[1]
        dst = sys.argv[2]
    elif len(sys.argv) == 2:
        src = sys.argv[1]
        dst = os.path.join(os.path.dirname(src), 'WH8_MQL')
    else:
        src = default_src
        dst = default_dst

    print(f"📂 源目录: {src}")
    print(f"📁 输出目录: {dst}")
    print("-" * 50)
    process_directory(src, dst)
```

服务器测试脚本合集

# OpenClaw 网关 token mismatch 问题解决文档

## 问题现象

执行 `openclaw devices list` 或其他 CLI 命令时，报错：

```
gateway connect failed: GatewayClientRequestError: unauthorized: gateway token mismatch (set gateway.remote.token to match gateway.auth.token)
```

同时网关日志显示 `reason=token_mismatch`。



## 环境信息

- OpenClaw 版本：2026.4.8
- 安装方式：全局 npm 安装
- 配置文件路径：`~/.openclaw/openclaw.json`
- 网关绑定模式：`loopback` 或 `lan`

## 根本原因

1. **配置缺少 `gateway.remote.token` 字段**  
   OpenClaw 网关在 `bind: loopback` 或 `lan` 模式下，**强制要求 CLI 连接时提供 `remote.token`**，且必须与 `auth.token` 相同。即使只有本地回环连接也不例外。

2. **token 中含有特殊字符**  
   原 token 为 `@&4gEgw6@DEWTT`，其中的 `@` 和 `&` 可能在 WebSocket 握手或 CLI 参数传递时被错误解析/编码，导致服务端收到的 token 与预期不符。

3. **CLI 未自动读取 `remote.token`**  
   即使配置文件正确添加了 `remote.token`，CLI 命令（如 `devices list`）默认仍不发送该 token，需要显式传递或通过环境变量指定。

4. **旧网关进程未完全停止**  
   修改配置后未重启网关，或 systemd 服务仍在后台运行，导致新配置未生效。

## 解决步骤

### 1. 修改配置文件，添加 `remote.token`

编辑 `~/.openclaw/openclaw.json`，在 `gateway` 对象中增加 `remote` 块：

```json
"gateway": {
  "auth": {
    "token": "你的token",
    "mode": "token"
  },
  "remote": {
    "token": "你的token"      // 必须与 auth.token 完全相同
  },
  "bind": "loopback",         // 或 "lan"
  "port": 18789
}
```

**注意 JSON 逗号位置**：`auth` 块后要有逗号，`remote` 块后也要有逗号（除非是最后一个属性）。

### 2. 将 token 改为纯数字或简单字符串（避免特殊字符）

推荐使用仅包含字母数字的 token，例如 `3283261937` 或 `mySecret123`。  
修改后同步更新 `auth.token` 和 `remote.token`。

### 3. 完全停止旧网关进程

```bash
openclaw gateway stop
pkill -9 -f openclaw
rm -f ~/.openclaw/gateway.pid          # 删除可能残留的锁文件
# 如果存在 systemd 用户服务，也停止它
systemctl --user stop openclaw-gateway.service
```

### 4. 验证配置文件格式与内容

```bash
# 检查 token 是否已正确写入
grep '"token"' ~/.openclaw/openclaw.json

# 验证 JSON 格式
python3 -c "import json; json.load(open('/home/aigc/.openclaw/openclaw.json'))" && echo "OK"
```

### 5. 重新启动网关（前台运行，便于观察）

```bash
openclaw gateway --verbose
```

等待输出 `[gateway] ready` 和 `Gateway listening...`。**保持此终端运行**。

### 6. 测试 CLI 命令

在**另一个终端**中执行：

```bash
# 方法一：显式传递 token（最可靠）
openclaw devices list --token "你的token"

# 方法二：使用环境变量（变量名可能因版本而异）
export OPENCLAW_GATEWAY_TOKEN="你的token"
export OPENCLAW_REMOTE_GATEWAY_TOKEN="你的token"
openclaw devices list

# 方法三：若 token 为纯数字且配置正确，有时可直接运行
openclaw devices list
```

成功时输出设备列表（可能为空），不再报 token mismatch。

### 7. （可选）将 token 写入环境变量以简化后续使用

将以下两行添加到 `~/.bashrc` 或 `~/.zshrc`：

```bash
export OPENCLAW_GATEWAY_TOKEN="你的token"
export OPENCLAW_REMOTE_GATEWAY_TOKEN="你的token"
```

之后重新登录或执行 `source ~/.bashrc`，即可直接运行 `openclaw devices list` 而无需每次指定 `--token`。

## 验证成功的标志

- `openclaw devices list` 正常返回设备列表（可能为空）。
- `openclaw dashboard` 能正常打开 Web 界面。
- 网关日志中不再出现 `unauthorized` 或 `token_mismatch`。

## 常见误区与注意事项

| 误区 | 正确做法 |
|------|----------|
| 只设置 `auth.token`，忽略 `remote.token` | 无论 `bind` 值如何，都同时设置两者且保持一致 |
| 修改配置后不重启网关 | 必须完全停止旧进程（包括 systemd 服务）再启动 |
| token 中包含 `@`、`&`、`#` 等特殊字符 | 尽量使用字母数字，或确保在 CLI 中用双引号包裹并正确转义 |
| 依赖 CLI 自动读取 `remote.token` | 当前版本 CLI 不会自动读取，需用 `--token` 或环境变量 |
| 使用 `CLAW_GATEWAY_TOKEN` 环境变量 | 官方文档推荐 `OPENCLAW_GATEWAY_TOKEN`（注意前缀） |

## 附录：最小可用配置示例

```json
{
  "gateway": {
    "auth": { "token": "3283261937", "mode": "token" },
    "remote": { "token": "3283261937" },
    "bind": "loopback",
    "port": 18789
  }
}
```

## 参考链接

- [OpenClaw Gateway 配置参考](https://docs.openclaw.ai/gateway/configuration-reference)
- [OpenClaw 配置示例](https://docs.openclaw.ai/zh-CN/gateway/configuration-examples)

---

**文档版本**：1.0  
**最后更新**：2026-04-08  
**适用 OpenClaw 版本**：2026.4.8 及以上

OpenClaw 网关 token mismatch 问题解决文档

# Ubuntu UFW 端口转发教程：38080 ↔ 8080 内外映射

## 适用场景

服务器厂商限制 8080 端口不可对外暴露，需实现：

1. 外部用户通过 `38080` 端口访问服务
2. 实际服务运行在本机 `8080` 端口
3. 内部访问 8080 时自动走 38080 出口
4. 8080 不对外暴露，满足安全合规要求



## 一、环境说明

- 系统：Ubuntu / Debian（使用 UFW 防火墙）
- 内部服务端口：8080
- 对外映射端口：38080
- 依赖：需要 sudo 或 root 权限

## 二、前置检查与基础配置

### 1. 查看防火墙状态

```bash
sudo ufw status
```

若出现 `ERROR: problem running ip6tables`，关闭 IPv6：

```bash
sudo sed -i 's/IPV6=yes/IPV6=no/' /etc/default/ufw
sudo ufw reload
```

### 2. 开启内核 IP 转发（必须）

```bash
echo "net.ipv4.ip_forward=1" | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
```

## 三、配置端口转发规则

### 1. 清空现有混乱/重复 NAT 规则

```bash
sudo iptables -t nat -F
sudo iptables -t nat -X
sudo ufw reload
```

### 2. 添加两条核心转发规则

```bash
# 外部访问 38080 → 转发到内部 8080
sudo iptables -t nat -A PREROUTING -p tcp --dport 38080 -j REDIRECT --to-port 8080

# 内部访问 8080 → 转发到 38080 出口
sudo iptables -t nat -A OUTPUT -p tcp --dport 8080 -j REDIRECT --to-port 38080
```

### 3. 防火墙放行 38080 端口

```bash
sudo ufw allow 38080/tcp
sudo ufw reload
```

## 四、验证配置是否生效

### 1. 查看 NAT 转发规则

```bash
sudo iptables -t nat -L -n
```

**正常输出示例**：

```bash
Chain PREROUTING (policy ACCEPT)
REDIRECT   tcp  --  0.0.0.0/0    0.0.0.0/0    tcp dpt:38080 redir ports 8080

Chain OUTPUT (policy ACCEPT)
REDIRECT   tcp  --  0.0.0.0/0    0.0.0.0/0    tcp dpt:8080 redir ports 38080
```

### 2. 检查 8080 端口是否有服务监听

```bash
sudo ss -tulpn | grep 8080
```

有输出表示服务正常运行，无输出则需先启动服务。

### 3. 连通性测试

```bash
# 测试内部 8080 → 38080 转发
curl localhost:8080

# 测试外部映射 38080 → 8080
curl localhost:38080
```

两条命令均能正常返回内容，说明转发生效。

## 五、规则持久化（防止重启失效）

### 1. 安装持久化工具

```bash
sudo apt update
sudo apt install -y iptables-persistent
```

### 2. 保存当前 iptables 规则

```bash
sudo netfilter-persistent save
```

规则将自动在开机时加载。

## 六、最终实现效果

1. **外部访问**：`服务器公网IP:38080` → 自动转发到内部 8080 服务
2. **内部访问**：访问 `localhost:8080` → 自动走 38080 端口
3. **安全合规**：8080 端口不对外暴露，符合厂商限制
4. **内外互通**：内部、外部均可正常使用服务

## 七、常见问题排查

### 1. curl: (7) Failed to connect

**原因**：8080 端口没有服务在运行。

**解决**：先启动你的 Web/AI/应用服务，再测试端口。

### 2. 规则重复、多余

**解决**：重新清空规则并添加：

```bash
sudo iptables -t nat -F PREROUTING OUTPUT
```

### 3. 外部浏览器无法访问

**原因**：云服务器安全组 / 厂商上层防火墙未放行 38080。

**解决**：去控制台安全组开放 TCP 38080 入方向。

### 4. 重启服务器后失效

**解决**：执行第五章规则持久化步骤，保存 iptables 规则。