Gradio 启动 share 链接时提示缺少 frpc 文件怎么排查【免费下载链接】gradioBuild and share delightful machine learning apps, all in Python. Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/gr/gradio当你用demo.launch(shareTrue)给 Gradio 应用生成公网分享链接时正常情况下终端会打印一条以* Running on public URL:开头的地址形如https://xxxxx.gradio.live。但如果在首次创建分享链接时终端没有输出公网地址而是打印出类似下面的提示Could not create create share link. Missing file: /Users/.../frpc_darwin_arm64_v0.3. Please check your internet connection. This can happen if your antivirus software blocks the download of this file. You can install manually by following these steps: 1. Download this file: https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_darwin_arm64 2. Rename the downloaded file to: frpc_darwin_arm64_v0.3 3. Move the file to this location: /Users/...以上为 官方指南 中给出的文档示例实际路径、文件名和下载地址以你终端中打印的内容为准。这就是本文要处理的问题frpc 客户端文件缺失导致分享链接创建失败。下面按“理解机制 → 定位错误 → 手动安装 → 验证”的顺序给出排查路径。为什么会缺少 frpc 文件Gradio 的 share 链接由 Fast Reverse ProxyFRP实现launch(shareTrue)时Gradio 会在首次创建分享链接时自动下载一个 frpc 客户端二进制文件到本地由它和 Gradio 的 Share Server 建立 TLS 隧道把本地应用暴露为xxxxx.gradio.live域名。相关实现见 gradio/tunneling.py。从这份源码可以确认三个关键事实它们决定了排查方式二进制文件名由平台和 CPU 架构决定。文件名格式为frpc_{系统}_{架构}_v{版本}当前版本为0.3例如frpc_darwin_arm64_v0.3、frpc_windows_amd64.exe、frpc_linux_amd64x86_64对应amd64aarch64对应arm64。存放目录是$HF_HOME/gradio/frpc/HF_HOME由huggingface_hub决定。错误提示里的Move the file to this location就是由这段路径拼接出来的。下载来源是 CDNhttps://cdn-media.huggingface.co/frpc-gradio-0.3/文件名。下载后 Gradio 会校验 SHA-256 校验和校验和不匹配会抛出另一种错误见下文“先分清是哪一种错误”。所以“缺少 frpc 文件”意味着自动下载这一步没有成功文件没有落到上述目录中。文档指出的典型原因是杀毒软件拦截了下载尤其是 Windows Defender见 官方指南的 Troubleshooting 一节其次是网络问题导致下载失败。先分清是哪一种错误Missing file只是几种 share 链接创建失败信息中的一种。gradio/blocks.py 中的错误处理分支显示失败时终端会打印以下四类信息之一对应不同排查方向终端提示含义处理方向Could not create share link. Missing file: ...frpc 文件不在本地下载未成功按本文下文手动安装Could not create share link. Checksum mismatch for file: ...文件已下载但校验和不匹配文件可能不完整或被篡改删除该文件让其重新下载或手动下载完整文件Could not create share link. Please check your internet connection or our status page: https://status.gradio.app.文件已存在但隧道连接 Share Server 失败检查网络并查看 Gradio 状态页frpc 日志附带Could not create share URL. Please check the appended log from frpc for more information:frpc 已启动但建隧道失败阅读附带的 frpc 日志定位只有第一类属于“缺少 frpc 文件”后几类说明文件本身已经到位不要走手动安装流程。另外注意一个边界如果平台不受支持frpc-gradio-0.3的 CDN 会返回 403此时 Gradio 会提示“this platform is incompatible”并建议创建 GitHub issue 上报你的平台信息platform.uname()这也不属于缺少文件的情况。手动安装 frpc 文件错误提示里已经给出了针对你机器的三步操作照着做即可下载文件浏览器打开提示中第 1 步给出的下载地址格式为https://cdn-media.huggingface.co/frpc-gradio-0.3/frpc_系统_架构Windows 为.exe文件。这个地址和下面的目标文件名、目标目录都可以直接从终端提示里复制不需要自己拼接。重命名把下载的文件重命名为提示中第 2 步给出的文件名格式为frpc_系统_架构_v0.3。例如下载的是frpc_darwin_arm64要改名为frpc_darwin_arm64_v0.3。移动到目标目录把文件放到提示中第 3 步给出的位置即$HF_HOME/gradio/frpc/下的完整路径。如果该目录尚不存在手动创建它。这一步需要对该目录有写权限目录只读时移动会失败。操作要点文件名必须与提示完全一致包括_v0.3版本后缀目录必须与提示完全一致两者都来自 gradio/tunneling.py 中按你的系统实时计算出的路径终端里打印的就是当前机器的实际值。验证是否修复手动放好文件后重新运行你的启动脚本即重新执行demo.launch(shareTrue)对应的程序判断标准就是终端输出成功终端打印* Running on public URL: https://xxxxx.gradio.live文档示例中的域名格式并且 Gradio 会附带一条提示说明该分享链接是临时的、最多持续约 1 周best effort如需永久托管可运行gradio deploy部署到 Hugging Face Spaces。仍报Missing file检查文件名大小写、版本后缀和所在目录是否与提示完全一致。报Checksum mismatch说明文件内容有问题按上面表格中的方向重新获取文件。手动安装无效时的进一步排查如果文件放对了仍无法创建分享链接按 官方指南 的说法依次考虑杀毒软件拦截这是文档点名的最常见原因。如果杀毒软件反复拦截该文件需要把你的杀毒软件对该文件加白名单指南中给出的操作对象是 Windows Defender否则 share 链接无法使用。Share Server 本身不可用官方 Gradio Share Server 托管在gradio.live可能偶尔宕机。此时终端提示会指引你查看状态页https://status.gradio.app/即上面表格第三类错误。如果状态页显示官方服务故障等待官方修复即可无需重复本地操作。改用自建 Share Server文档说明官方分享链接存在 72 小时超时企业部署或需要自定义域名、额外安全措施时可以自建 FRP server。对自建 serverlaunch()通过share_server_address格式为host:port和share_server_tls_certificate两个参数指定地址与证书share_server_protocol默认为http需要 https 时要显式设置参数说明见 gradio/blocks.py。这条路径可以绕开官方 server 的可用性问题但属于另一种部署形态不是本错误的必要处理步骤。适用边界本文只针对“终端提示Could not create share link. Missing file: ...”这一种现象文件已存在但建隧道失败的情况frpc 日志类错误应按日志内容另行排查。手动安装的目录依赖环境变量HF_HOME由huggingface_hub常量提供如果你自定义过HF_HOME以终端提示中打印的实际路径为准。官方 share 链接为临时链接最多 1 周best effort且存在 72 小时超时需要长期对外提供应用时应考虑部署方案而非依赖 share 链接。【免费下载链接】gradioBuild and share delightful machine learning apps, all in Python. Star to support our work!项目地址: https://gitcode.com/GitHub_Trending/gr/gradio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考