在WSL2中配置Recraft镜像：解决网络延迟的绝佳方案-人工智能-PHP中文网

镜像网络模式可根本解决wsl2中recraft服务的网络延迟问题，其通过共享宿主机网络命名空间和ip地址，消除nat转发开销并实现localhost双向互通。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在wsl2中配置recraft镜像：解决网络延迟的绝佳方案

如果您在WSL2中运行Recraft相关服务或镜像时遭遇显著网络延迟，尤其是连接建立缓慢、API响应卡顿或Docker容器间通信异常，则问题很可能源于WSL2默认NAT网络模式与IPv6优先策略、DNS解析路径及端口绑定行为的多重不匹配。以下是解决此问题的步骤：

一、启用WSL2镜像网络模式

镜像网络模式（Mirrored Mode）使WSL2与Windows宿主机共享同一网络命名空间和IP地址，消除NAT层转发开销，并让localhost双向互通成为可能，是解决Recraft服务延迟的根本性配置。

1、按下 Win + R，输入 %USERPROFILE% 并回车，进入当前用户根目录。

2、在该目录下新建或编辑名为 .wslconfig 的纯文本文件（注意开头为英文点号，无扩展名）。

3、将以下内容完整粘贴并保存：

[experimental]
networkingMode=mirrored
dnsTunneling=true
firewall=true
autoProxy=true
[wsl2]
memory=6GB
swap=2GB

4、以管理员身份打开PowerShell，执行 wsl --shutdown 强制终止所有WSL实例。

5、重新启动您的Linux发行版（如Ubuntu），运行 ip addr show eth0，确认其获取的IPv4地址与Windows宿主机 ipconfig 中的IPv4地址完全一致。

二、强制客户端使用IPv4地址访问

当Recraft服务运行于WSL2 Docker中，而Windows客户端（如Postman、Navicat或前端应用）通过localhost连接时，Windows会因RFC 6724标准优先解析为::1（IPv6回环），但Docker容器默认仅监听0.0.0.0（IPv4），导致TCP连接超时约10秒后才回退至IPv4。直接指定IPv4地址可绕过该解析延迟。

1、在Windows命令提示符中执行 ipconfig，记录“无线局域网适配器”或“以太网适配器”下的IPv4地址（例如 192.168.1.105）。

2、在Recraft服务配置或客户端连接字符串中，将 localhost 或 127.0.0.1 替换为该IPv4地址（如 192.168.1.105:3000）。

3、若Recraft依赖环境变量（如RECAST_API_URL），请在Windows系统或启动脚本中更新该变量值。

三、禁用WSL2 IPv6协议栈

在镜像模式已启用的前提下，若仍观察到IPv6解析尝试引发延迟，可从内核参数层面禁用IPv6，彻底规避协议协商过程。该操作不影响镜像模式功能，且兼容绝大多数Recraft组件。

1、编辑同一 .wslconfig 文件，在 [wsl2] 区块下方新增一行：

Recraft

Recraft是一款AI设计工具，专注于生成矢量图形、图标和品牌视觉素材。不同于常见图像生成模型，它支持用户对元素进行精细编辑与缩放，输出专业级可商用设计。用户可通过文字描述快速生成多风格一致性作品，并自动适配不同尺寸与格式，适用于Logo、海报、包装等场景。Recraft降低了专业设计门槛，赋能营销人员、创业者及设计师高效完成高质量视觉创作。

下载

kernelCommandLine=ipv6.disable=1

2、保存文件后，在PowerShell中再次执行 wsl --shutdown。

3、重启WSL2发行版，运行 cat /proc/sys/net/ipv6/conf/all/disable_ipv6，返回值为 1 即表示生效。