[{"data":1,"prerenderedAt":430},["ShallowReactive",2],{"\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fnetwork_workarounds":3,"surround-\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fnetwork_workarounds":416},{"id":4,"title":5,"avatar":6,"banner":6,"body":7,"category":6,"desc":409,"description":44,"extension":410,"links":6,"meta":411,"navigation":6,"path":412,"seo":413,"stem":414,"__hash__":415},"docs\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fnetwork_workarounds.md","网络问题解决方案",null,{"type":8,"value":9,"toc":400},"minimark",[10,18,23,27,130,140,143,146,246,253,259,262,265,318,334,359,362,388,396],[11,12,14],"h2",{"id":13},"下载-huggingface-模型",[15,16,17],"strong",{},"下载 Huggingface 模型",[19,20,22],"h3",{"id":21},"镜像站点hf-mirror","镜像站点（HF-Mirror）",[24,25,26],"p",{},"要通过镜像站点下载 Huggingface 模型，可以按照以下步骤进行操作：",[28,29,31,35,38,67,70,81,84,87],"steps",{"level":30},"4",[32,33,34],"h4",{"id":34},"安装依赖项",[24,36,37],{},"运行以下命令安装必要的依赖项：",[39,40,45],"pre",{"className":41,"code":42,"language":43,"meta":44,"style":44},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pip install -U huggingface_hub\n","bash","",[46,47,48],"code",{"__ignoreMap":44},[49,50,53,57,61,64],"span",{"class":51,"line":52},"line",1,[49,54,56],{"class":55},"sBMFI","pip",[49,58,60],{"class":59},"sfazB"," install",[49,62,63],{"class":59}," -U",[49,65,66],{"class":59}," huggingface_hub\n",[32,68,69],{"id":69},"设置环境变量",[24,71,72,73,76,77,80],{},"将环境变量 ",[46,74,75],{},"HF_ENDPOINT"," 设置为 ",[46,78,79],{},"https:\u002F\u002Fhf-mirror.com","。",[32,82,83],{"id":83},"下载模型或数据集",[24,85,86],{},"使用 huggingface-cli 下载模型或数据集。例如：",[88,89,90,119],"ul",{},[91,92,93,94],"li",{},"下载模型：",[39,95,97],{"className":41,"code":96,"language":43,"meta":44,"style":44},"huggingface-cli download --resume-download gpt2 --local-dir gpt2\n",[46,98,99],{"__ignoreMap":44},[49,100,101,104,107,110,113,116],{"class":51,"line":52},[49,102,103],{"class":55},"huggingface-cli",[49,105,106],{"class":59}," download",[49,108,109],{"class":59}," --resume-download",[49,111,112],{"class":59}," gpt2",[49,114,115],{"class":59}," --local-dir",[49,117,118],{"class":59}," gpt2\n",[91,120,121,122],{},"下载数据集：",[39,123,128],{"className":124,"code":126,"language":127},[125],"language-text","huggingface-cli download --repo-type dataset --resume-download wikitext --local-dir wikitext\n","text",[46,129,126],{"__ignoreMap":44},[24,131,132,133,80],{},"获取更详细的说明和其他方法，请参见 ",[134,135,139],"a",{"href":136,"rel":137},"https:\u002F\u002Fhf-mirror.com\u002F",[138],"nofollow","此链接",[19,141,142],{"id":142},"其他来源",[24,144,145],{},"某些地区仍可能无法访问部分模型。在这种情况下，可以使用 modelscope：",[28,147,148,152,154,168,171,174],{"level":30},[32,149,151],{"id":150},"安装-modelscope","安装 ModelScope",[24,153,37],{},[39,155,157],{"className":41,"code":156,"language":43,"meta":44,"style":44},"pip install modelscope[framework]\n",[46,158,159],{"__ignoreMap":44},[49,160,161,163,165],{"class":51,"line":52},[49,162,56],{"class":55},[49,164,60],{"class":59},[49,166,167],{"class":59}," modelscope[framework]\n",[32,169,83],{"id":170},"下载模型或数据集-1",[24,172,173],{},"使用 modelscope 下载模型或数据集。例如：",[88,175,176,214],{},[91,177,93,178],{},[39,179,181],{"className":41,"code":180,"language":43,"meta":44,"style":44},"modelscope download --model 'Qwen\u002FQwen2-7b' --local_dir 'path\u002Fto\u002Fdir'\n",[46,182,183],{"__ignoreMap":44},[49,184,185,188,190,193,197,200,203,206,208,211],{"class":51,"line":52},[49,186,187],{"class":55},"modelscope",[49,189,106],{"class":59},[49,191,192],{"class":59}," --model",[49,194,196],{"class":195},"sMK4o"," '",[49,198,199],{"class":59},"Qwen\u002FQwen2-7b",[49,201,202],{"class":195},"'",[49,204,205],{"class":59}," --local_dir",[49,207,196],{"class":195},[49,209,210],{"class":59},"path\u002Fto\u002Fdir",[49,212,213],{"class":195},"'\n",[91,215,121,216],{},[39,217,219],{"className":41,"code":218,"language":43,"meta":44,"style":44},"modelscope download --dataset 'Tongyi-DataEngine\u002FSA1B-Dense-Caption' --local_dir '.\u002Flocal_dir'\n",[46,220,221],{"__ignoreMap":44},[49,222,223,225,227,230,232,235,237,239,241,244],{"class":51,"line":52},[49,224,187],{"class":55},[49,226,106],{"class":59},[49,228,229],{"class":59}," --dataset",[49,231,196],{"class":195},[49,233,234],{"class":59},"Tongyi-DataEngine\u002FSA1B-Dense-Caption",[49,236,202],{"class":195},[49,238,205],{"class":59},[49,240,196],{"class":195},[49,242,243],{"class":59},".\u002Flocal_dir",[49,245,213],{"class":195},[24,247,132,248,80],{},[134,249,252],{"href":250,"rel":251},"https:\u002F\u002Fmodelscope.cn\u002Fdocs\u002Fhome",[138],"官方文档",[11,254,256],{"id":255},"使用-poetry",[15,257,258],{},"使用 Poetry",[19,260,261],{"id":261},"安装过程中的网络错误",[24,263,264],{},"在某些地区使用 \"poetry install\" 可能会遇到网络错误，可以按照以下步骤解决：",[28,266,267,270,277,307,311],{"level":30},[32,268,269],{"id":269},"更新配置",[24,271,272,273,276],{},"在 ",[46,274,275],{},"pyproject.toml"," 文件中添加以下配置以使用镜像源：",[39,278,282],{"className":279,"code":280,"language":281,"meta":44,"style":44},"language-toml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","[[tool.poetry.source]]\nname = \"mirrors\"\nurl = \"https:\u002F\u002Fmirrors.tuna.tsinghua.edu.cn\u002Fpypi\u002Fweb\u002Fsimple\u002F\"\npriority = \"primary\"\n","toml",[46,283,284,289,295,301],{"__ignoreMap":44},[49,285,286],{"class":51,"line":52},[49,287,288],{},"[[tool.poetry.source]]\n",[49,290,292],{"class":51,"line":291},2,[49,293,294],{},"name = \"mirrors\"\n",[49,296,298],{"class":51,"line":297},3,[49,299,300],{},"url = \"https:\u002F\u002Fmirrors.tuna.tsinghua.edu.cn\u002Fpypi\u002Fweb\u002Fsimple\u002F\"\n",[49,302,304],{"class":51,"line":303},4,[49,305,306],{},"priority = \"primary\"\n",[32,308,310],{"id":309},"重新配置-poetry","重新配置 Poetry",[24,312,313,314,317],{},"在终端中运行 ",[46,315,316],{},"poetry lock"," 命令，使用新的镜像源重新配置 Poetry。",[24,319,320,323,324,326,327,329,330,333],{},[15,321,322],{},"提示：","\n注意 ",[46,325,316],{}," 会修改 ",[46,328,275],{}," 和 ",[46,331,332],{},"poetry.lock"," 文件。为避免提交不必要的更改：",[88,335,336,347],{},[91,337,338,339,342,343,346],{},"方案一：成功执行 ",[46,340,341],{},"poetry install"," 后，使用 ",[46,344,345],{},"git reset --hard HEAD"," 还原到 Git HEAD 节点。",[91,348,349,350,353,354,329,356,358],{},"方案二：执行 ",[46,351,352],{},"git add"," 时，排除 ",[46,355,275],{},[46,357,332],{}," 文件，仅添加其他文件。",[24,360,361],{},"以后在添加或移除依赖包时，可以使用如下命令：",[39,363,365],{"className":41,"code":364,"language":43,"meta":44,"style":44},"poetry add \u003Clib_name>\n",[46,366,367],{"__ignoreMap":44},[49,368,369,372,375,378,381,385],{"class":51,"line":52},[49,370,371],{"class":55},"poetry",[49,373,374],{"class":59}," add",[49,376,377],{"class":195}," \u003C",[49,379,380],{"class":59},"lib_nam",[49,382,384],{"class":383},"sTEyZ","e",[49,386,387],{"class":195},">\n",[24,389,390,391,80],{},"更多命令和说明，请参见 ",[134,392,395],{"href":393,"rel":394},"https:\u002F\u002Fpython-poetry.org\u002Fdocs\u002Fcli\u002F",[138],"Poetry CLI 官方文档",[397,398,399],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}",{"title":44,"searchDepth":291,"depth":291,"links":401},[402,406],{"id":13,"depth":291,"text":17,"children":403},[404,405],{"id":21,"depth":297,"text":22},{"id":142,"depth":297,"text":142},{"id":255,"depth":291,"text":258,"children":407},[408],{"id":261,"depth":297,"text":261},"以下是一些在开发过程中可能遇到的网络问题的应对方案。","md",{},"\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fnetwork_workarounds",{"title":5,"description":44},"cn\u002Fopen_source\u002Fbest_practice\u002Fnetwork_workarounds","nHwU3Yzu_MF_GGpkX-krcCSZ87Du1cP8RUOuFmr7Z-M",[417,424],{"title":418,"path":419,"stem":420,"icon":421,"framework":6,"module":6,"class":422,"target":-1,"active":423,"defaultOpen":423,"children":-1,"description":-1},"性能调优","\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fperformance_tuning","open_source\u002Fbest_practice\u002Fperformance_tuning","i-ri-speed-line",[],false,{"title":425,"path":426,"stem":427,"icon":428,"framework":6,"module":6,"class":429,"target":-1,"active":423,"defaultOpen":423,"children":-1,"description":-1},"常见错误与解决方案","\u002Fcn\u002Fopen_source\u002Fbest_practice\u002Fcommon_errors_solutions","open_source\u002Fbest_practice\u002Fcommon_errors_solutions","i-ri-error-warning-line",[],1774339752613]