Face Analysis WebUI 使用 Gradio share 开启远程临时链接调试

只需添加 share=True 参数即可：

demo.launch(server_name="0.0.0.0", server_port=7860, share=True)

注意两个关键点：

• server_name="0.0.0.0" 必须保留，否则 share 无法正确绑定本地服务；
• 不要同时设置 inbrowser=True，它会干扰 share 的链接生成逻辑。

保存后，用任意方式重启服务（比如运行 bash /root/build/start.sh），终端将输出类似以下内容：

Running on local URL: http://0.0.0.0:7860 
Running on public URL: https://yourname-abcd1234.gradio.live 
This share link expires in 72 hours.

复制最后一行的链接，发给他人即可。首次使用时，Gradio 会自动弹出浏览器打开本地地址，并在控制台打印公共链接——整个过程无需注册账号，也无需登录。

3.2 方式二：通过启动脚本传参（免改代码，适合多环境切换）

如果你不想动 app.py，可以改造 /root/build/start.sh。原脚本可能是：

#!/bin/bash
/opt/miniconda3/envs/torch27/bin/python /root/build/app.py

改为支持命令行参数的形式：

#!/bin/bash
if [ "$1" = "share" ]; then
    SHARE_FLAG="--share"
fi
/opt/miniconda3/envs/torch27/bin/python /root/build/app.py $SHARE_FLAG

然后启动时加参数：

bash /root/build/start.sh share

此时 app.py 需要做一点适配：在文件顶部加入参数解析逻辑（只需 5 行）：

import argparse
parser = argparse.ArgumentParser()
parser.add_argument("--share", action="store_true", help="Enable Gradio share link")
args = parser.parse_args()

再把 launch() 调用改成：

kwargs = {"server_name": "0.0.0.0", "server_port": 7860}
if args.share:
    kwargs["share"] = True
demo.launch(**kwargs)

这种方式的好处是：同一份代码，bash start.sh 启本地，bash start.sh share 启共享，切换零成本。

3.3 方式三：命令行临时覆盖（最快验证，不持久）

如果你只是想立刻试一下 share 是否生效，连脚本都不想改，可以用 Python 的 -c 参数直接覆盖启动逻辑：

/opt/miniconda3/envs/torch27/bin/python -c "
import sys
sys.path.insert(0, '/root/build')
from app import demo
demo.launch(server_name='0.0.0.0', server_port=7860, share=True)
"

优点：秒级验证，适合排查'为什么我的 share 不出现'类问题。 ❌ 缺点：每次都要敲命令，无法写入日志或做复杂配置。

4. share 链接常见问题与解决方案

4.1 '终端没输出 share 链接'，可能原因与修复

这是最常被问的问题。请按顺序检查以下五点：

1. 是否误用了 server_name="127.0.0.1" share=True 要求服务必须监听 0.0.0.0，否则中继无法建立连接。确认 launch() 中 server_name 值为 "0.0.0.0"，而非 "127.0.0.1" 或 "localhost"。

2. Python 进程是否被其他程序占用端口 netstat -tuln | grep :7860 查看端口占用。若被占，可在 launch() 中换端口：server_port=7861。

3. 是否在 Docker 容器中运行且未暴露端口 如果你用 Docker 启动，确保运行命令包含 -p 7860:7860，否则本地服务虽启动，但 Gradio 中继无法访问。

4. Gradio 版本是否 ≥ 4.30.0 旧版本 share 功能不稳定或缺失：

   pip show gradio | grep Version
   

   升级命令：

   pip install --upgrade gradio
   

5. 网络是否可达 Gradio 服务 在终端执行：

   curl -I https://gradio.live
   

   若返回 HTTP/2 200，说明网络通畅；若超时或拒绝连接，请检查代理设置或企业防火墙策略。

4.2 '链接打不开/白屏/加载失败'，怎么办？

• 首次访问慢是正常的：Gradio 需要预热模型、加载依赖，首次打开可能需 20–40 秒，请耐心等待。
• 图片上传失败：share 链接默认限制单文件 ≤ 10MB。若你传高清证件照失败，可在 launch() 中加参数：max_file_size="5mb"（注意单位是字符串）。
• 中文路径报错：确保所有图片文件名、路径不含中文或空格，Gradio 对非 ASCII 字符兼容性较弱。

4.3 如何延长 share 链接有效期？

官方默认 72 小时，不可手动延长。但有两个实用技巧：

• 用 ngrok 做长期替代：若需稳定链接，可放弃 share，改用 ngrok http 7860，它提供免费子域名且可自定义，只是需要注册账号。

• 定时自动重启：写个 cron 任务，每 60 小时重启一次服务，生成新链接：

  # 编辑 crontab
  crontab -e
  # 添加一行（每天凌晨 2 点重启）
  0 2 * * * bash /root/build/start.sh share > /dev/null 2>&1
  

5. 安全边界与使用建议

5.1 share 的安全模型：你知道数据去哪了吗？

Gradio share 链接的数据流路径如下： 你的浏览器 → Gradio 中继服务器（HTTPS）→ 你的本地 localhost:7860（HTTP）

这意味着：

• 所有上传的图片、返回的标注结果，均经过 Gradio 服务器中转；
• Gradio 官方声明'不会存储用户数据'，但其隐私政策明确指出'中继过程中可能短暂缓存请求体'；
• 本地服务仍运行在 HTTP（非 HTTPS），因此切勿在 share 模式下处理真实身份信息、医疗影像、未脱敏监控画面等高敏数据。

安全建议清单：

• 仅用 share 传输合成图、示例图、模糊化人脸图；
• 分析前手动用 OpenCV 对图像做 cv2.blur(img, (15,15)) 处理，既保留关键点结构，又消除身份特征；
• 在 app.py 中增加简易水印：cv2.putText(img, "GRADIO_SHARE_DEMO", ...)，避免截图外泄时被误认为正式产出。

5.2 更进一步：为 share 链接加访问密码

Gradio 原生不支持 share 链接设密码，但你可以用 auth 参数为整个界面加一层基础认证（即使 share 开启，也需输入账号密码）：

demo.launch(
    server_name="0.0.0.0",
    server_port=7860,
    share=True,
    auth=("demo", "face2024") # 用户名/密码
)

此时，无论通过 localhost:7860 还是 xxx.gradio.live 访问，都需输入 demo / face2024。密码明文写在代码里不安全？那就用环境变量：

import os
auth_user = os.getenv("GRADIO_USER", "demo")
auth_pass = os.getenv("GRADIO_PASS", "face2024")
demo.launch(..., auth=(auth_user, auth_pass))

启动时：

GRADIO_USER=admin GRADIO_PASS=mysecurepwd bash /root/build/start.sh share

6. 总结：让调试回归'所见即所得'的本质

Gradio 的 share=True 功能，本质上是在工程效率与用户体验之间划出的一条聪明分界线。它不试图替代 Nginx、Caddy 或云厂商的负载均衡，而是专注解决那个最原始、最频繁的诉求：'我改了一行代码，你能马上看到效果吗？'

回顾本文要点：

• share 链接是 Gradio 官方提供的加密中继服务，无需配置网络，开箱即用；
• 修改 app.py 中的 launch() 参数是最直接的方式，配合 server_name="0.0.0.0" 是成功前提；
• 遇到'没链接'问题，优先查网络、版本、server_name、端口、Docker 暴露设置；
• 它不是生产方案，但却是调试阶段的'时间压缩器'——省下的每一分钟，都让你离交付更近一步；
• 安全是底线：不传敏感图、加基础认证、必要时加水印，让分享变得安心。

下次当你再次面对一张待分析的人脸图片，不必再纠结'怎么让别人看到'，只需加一个参数，复制一个链接，点击发送——真正的智能，往往藏在最简单的交互里。