Skip to content

[minimax-docx] 部署问题:api.nuget.org 在沙盒/内网环境下无法访问,导致安装失败 #23

@PangTianHua

Description

@PangTianHua

问题描述

在 minimax-docx skill 的部署过程中,setup.sh 脚本会执行 ,需要从 下载 等 NuGet 包。

在某些受限网络环境(沙盒、内网)中, 域名会被 DNS 劫持到私有地址(如 ),导致 NuGet 包下载失败, 永远无法完成,进而安装脚本报 "Status: NOT READY"。

错误日志

受影响场景

  • OpenClaw 的 exec 沙盒环境(Sandbox):DNS 被劫持,api.nuget.org → 172.19.0.x
  • Claude Code(运行在相同基础设施上):同样无法访问 api.nuget.org
  • 任何使用相同沙盒 DNS 的 AI Agent 环境

即使终端用户的 VPN 正常,也无法绕过沙盒层的 DNS 劫持。

建议解决方案

方案一:提供 NuGet 国内镜像配置选项

在 中添加国内镜像源(如 nuget.org 的 Azure 中国镜像或其他可靠镜像),让用户在网络受限环境下可以选择替代源:

方案二:预先打包依赖(离线安装)

将 等核心依赖包预先下载好,放在 skill 仓库的 或 目录下:

setup.sh 检测到离线包存在时,优先使用本地包:

方案三:使用 Node.js 替代 .NET(文档生成场景)

对于纯文档生成场景(DOCX/Word),可以提供一套 Node.js + docx 的纯 JS 实现,不依赖 .NET 和 NuGet,彻底规避网络问题:

目前测试下来,Node.js + cnpm 的方案在沙盒环境中完全可用,已成功生成 Word 文档。

环境信息

复现步骤

  1. 在网络受限的沙盒环境中
  2. 执行 ============================================
    minimax-docx Setup & Initialization
    2026-03-25 23:32:57
    ============================================
    Platform: macos (arm64), Package Manager: brew

�[0;34m=== Checking .NET SDK ===�[0m
�[0;34m[INFO]�[0m Installing .NET SDK...
==> Fetching downloads for: dotnet-sdk
==> Installing Cask dotnet-sdk
==> Running installer for dotnet-sdk with sudo (which may request your password)...
==> Purging files for version 10.0.201 of Cask dotnet-sdk
3. 观察 阶段失败,报 NU1301 错误

影响范围

所有在受限网络环境下(企业内网、AI Agent 沙盒等)安装 minimax-docx 的用户都会遇到此问题。这是一个高优先级的基础设施问题。

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions