news 2026/6/10 15:18:51

FaceFusion局域网访问与端口设置方法

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
FaceFusion局域网访问与端口设置方法

FaceFusion局域网访问与端口设置方法

在使用FaceFusion这类基于 Web UI 的 AI 工具时，很多用户都会遇到一个常见需求：希望不仅能在本机访问，还能通过局域网中的其他设备（如手机、平板或另一台电脑）远程操作界面。这对于视频创作者、团队协作场景或嵌入式部署尤为实用。

然而，默认情况下，FaceFusion 启动后仅绑定本地回环地址127.0.0.1，这意味着只有运行程序的主机本身可以访问 Web 界面，局域网内其他设备无法连接。此外，其默认端口为7860，若该端口被占用或需要统一管理服务端口，也需要自定义配置。

本文将详细介绍如何让FaceFusion 支持局域网访问并修改默认端口，帮助你灵活部署这一强大的人脸替换与增强工具。

为什么默认无法从局域网访问？

当你启动 FaceFusion 时，控制台通常会输出类似如下信息：

Running on local URL: http://127.0.0.1:7860 To create a public link, set `share=True` in `launch()`.

其中提示“设置share=True可创建公开链接”——这其实是 Gradio 框架的原始提示语，并不完全适用于所有项目场景。

  • share=True是 Gradio 提供的一种穿透内网的方式，会生成一个临时公网域名（如xxx.gradio.app），适合对外演示，但存在速度慢、不稳定、隐私泄露风险等问题。
  • 更安全高效的方案是：启用局域网访问（LAN access）并指定端口，使同一网络下的设备可通过http://你的IP:端口直接访问。

遗憾的是，FaceFusion 当前并未提供命令行参数或配置文件来直接设置 host 和 port，但我们可以通过环境变量方式绕过限制。

解决方案：通过环境变量配置 Host 与 Port

FaceFusion 使用 Gradio 作为前端框架，而 Gradio 支持通过环境变量控制服务器行为。我们只需在启动前设置两个关键变量即可实现目标：

✅ 步骤一：设置监听地址为0.0.0.0

export GRADIO_SERVER_NAME="0.0.0.0"

说明：
默认值为127.0.0.1，表示只允许本机访问。
设置为0.0.0.0表示监听所有可用网络接口，局域网设备便可访问。

✅ 步骤二：设置自定义端口（可选）

export GRADIO_SERVER_PORT="7861"

说明：
默认端口为7860。如果你同时运行多个 Gradio 应用（如 Stable Diffusion、FaceFusion 等），建议错开端口避免冲突。
可根据需要更改为任意未被占用的端口号，例如8080、9999等。

✅ 步骤三：正常启动 FaceFusion

设置完环境变量后，再执行原来的启动命令即可：

python run.py

此时观察控制台输出：

Running on local URL: http://0.0.0.0:7861 Running on public URL: http://<你的局域网IP>:7861

你会看到不仅显示了本地地址，还提示了一个“public URL”——这就是你在局域网中其他设备上可访问的地址。

例如：

http://192.168.31.100:7861

只要你的手机、平板和运行 FaceFusion 的机器处于同一 Wi-Fi 或局域网下，打开浏览器输入该地址即可进入操作界面。

实际测试验证流程

为了确保配置生效，请按以下步骤验证：

  1. 在运行 FaceFusion 的主机上执行：
    bash ipconfig # Windows ifconfig # Linux/macOS
    找到当前网络的 IP 地址（通常是192.168.x.x或10.x.x.x开头）。

  2. 在另一台设备（如手机）上连接相同 Wi-Fi。

  3. 打开浏览器，输入：
    http://<主机IP>:<端口>
    例如：http://192.168.31.100:7861

  4. 如果能看到 FaceFusion 的 Web 界面，说明配置成功！

⚠️ 注意事项：
- 防火墙可能阻止外部访问。请确认系统防火墙已放行对应端口（如 Windows Defender、ufw、iptables 等）。
- 某些公司/校园网络可能存在策略限制，导致无法互通。

如何永久保存配置？（推荐做法）

每次启动前手动输入export命令显然不够方便。以下是几种持久化配置方式：

方法一：写入 Shell 配置文件（Linux/macOS 用户）

编辑你的 shell 配置文件（根据所用终端选择）：

nano ~/.bashrc # Bash 用户 nano ~/.zshrc # Zsh 用户（macOS 默认）

在文件末尾添加：

# FaceFusion LAN Access Settings export GRADIO_SERVER_NAME="0.0.0.0" export GRADIO_SERVER_PORT="7861"

保存后刷新配置：

source ~/.bashrc # 或 source ~/.zshrc

此后每次新开终端都会自动加载这些设置。

方法二：封装启动脚本（跨平台通用）

创建一个启动脚本，集中管理环境变量和执行命令。

Linux/macOS：start_facefusion.sh
#!/bin/bash export GRADIO_SERVER_NAME="0.0.0.0" export GRADIO_SERVER_PORT="7861" python run.py

赋予执行权限：

chmod +x start_facefusion.sh

以后直接运行：

./start_facefusion.sh
Windows：start_facefusion.bat
@echo off set GRADIO_SERVER_NAME=0.0.0.0 set GRADIO_SERVER_PORT=7861 python run.py

双击即可一键启动，无需 PowerShell 手动设置。

Docker 用户特别说明

如果你使用的是FaceFusion 镜像（如通过 Docker 部署），上述环境变量同样适用，但需在运行容器时传入。

示例：Docker CLI 方式启动

docker run -d \ --name facefusion \ -p 7861:7860 \ -e GRADIO_SERVER_NAME=0.0.0.0 \ -e GRADIO_SERVER_PORT=7860 \ -v /path/to/input:/workspace/input \ -v /path/to/output:/workspace/output \ facefusion/facefusion:latest

🔍 关键点解析：
--p 7861:7860：将宿主机 7861 映射到容器内部 7860 端口
--e GRADIO_SERVER_NAME=0.0.0.0：允许外部访问
--e GRADIO_SERVER_PORT=7860：Gradio 在容器内仍监听 7860

启动后，在浏览器中访问：

http://<Docker主机IP>:7861

即可使用 FaceFusion 的完整功能。

使用 docker-compose.yml（推荐用于复杂部署）

version: '3' services: facefusion: image: facefusion/facefusion:latest container_name: facefusion ports: - "7861:7860" environment: - GRADIO_SERVER_NAME=0.0.0.0 - GRADIO_SERVER_PORT=7860 volumes: - ./input:/workspace/input - ./output:/workspace/output restart: unless-stopped

然后运行：

docker-compose up -d

一切就绪后，即可享受高效的人脸交换体验。

安全提醒：开放局域网访问的风险

虽然开启0.0.0.0带来了便利，但也带来一定安全隐患：

风险说明
局域网嗅探同一网络下恶意用户可能尝试访问你的服务
数据暴露输入/输出路径若包含敏感图像，可能被他人查看
资源滥用其他设备可能大量提交任务，耗尽 GPU/CPU 资源

建议防护措施：

  1. 仅限可信网络使用：不要在公共 Wi-Fi 下开启 LAN 访问。
  2. 配合身份验证：未来可考虑使用 Gradio 的auth参数添加登录密码：
    python demo.launch(auth=("admin", "password123"))
  3. 关闭不必要的服务：使用完毕后及时终止进程。
  4. 使用反向代理 + HTTPS：生产环境中建议结合 Nginx、Caddy 等做安全加固。

总结

FaceFusion 作为新一代高精度人脸替换工具，在影视制作、内容创作等领域展现出强大潜力。为了让其更好地融入多设备协同工作流，掌握局域网访问与端口设置技巧是必不可少的一环。

本文核心要点回顾：

✅ 利用GRADIO_SERVER_NAME=0.0.0.0开启局域网访问
✅ 使用GRADIO_SERVER_PORT自定义端口以避免冲突
✅ 通过 Shell 脚本或 Docker 环境变量实现配置持久化
✅ 注意网络安全，合理部署以防信息泄露

只要简单设置几个环境变量，就能让你的 FaceFusion 成为局域网内的共享服务节点，极大提升使用灵活性与协作效率。

参考资料

  • Gradio · Configuration · Environment Variables
  • FaceFusion GitHub 仓库
  • Docker 文档 - Environment variables
  • Running on local URL but can’t access from outside - Answer Overflow

📌小贴士：
如果你正在开发自动化流程或集成 FaceFusion 到自有系统中，也可以考虑调用其 API 模式（需启用--api参数），实现无界面批处理，进一步释放生产力。

如有更多部署问题，欢迎留言交流！

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/6/10 14:14:02

ACE-Step+cpolar：低门槛音乐创作与远程协作新体验

ACE-Step cpolar&#xff1a;让音乐创作不再受限于设备与距离 你有没有过这样的经历&#xff1f;深夜灵感突现&#xff0c;哼出一段旋律&#xff0c;却苦于不会编曲、不懂乐理&#xff0c;只能眼睁睁看着它溜走。又或者&#xff0c;你终于用AI生成了一首满意的demo&#xff0c…

作者头像 李华
网站建设 2026/6/8 10:34:55

Anything-LLM + Ollama：支持哪些开源模型？

Anything-LLM Ollama&#xff1a;支持哪些开源模型&#xff1f; 在智能知识管理快速演进的今天&#xff0c;一个现实问题摆在面前&#xff1a;通用大模型虽然能聊万物&#xff0c;却对你的内部文档一无所知&#xff1b;而训练专属模型成本高、周期长&#xff0c;难以跟上业务…

作者头像 李华
网站建设 2026/6/10 12:34:55

LobeChat本地安装指南：从Node.js到启动

LobeChat 本地部署实战&#xff1a;从环境搭建到流畅运行 在 AI 对话应用遍地开花的今天&#xff0c;一个干净、安全、可完全掌控的聊天界面成了不少开发者和极客用户的刚需。市面上虽然不乏优秀的闭源产品&#xff0c;但数据外传的风险始终让人难以彻底安心。这时候&#xff…

作者头像 李华
网站建设 2026/6/9 15:48:32

1.1 万字长文，彻底搞懂 Function Calling：从入门到精通

1.1 万字长文&#xff0c;彻底搞懂 Function Calling&#xff1a;从入门到精通 导语&#xff1a;当大型语言模型&#xff08;LLM&#xff09;遇上真实世界&#xff0c;会碰撞出怎样的火花&#xff1f;如果说 LLM 是一个拥有渊博知识的大脑&#xff0c;那么 Function Calling 就…

作者头像 李华
网站建设 2026/6/9 16:44:55

Facebook的广告回报率

Facebook广告一直是小型企业的常见营销策略&#xff0c;原因不言而喻&#xff0c;因为它已经证明在所有社交广告平台中提供了最高的投资回报率。 Facebook每月活跃用户超过30亿&#xff0c;意味着有无尽的机会可以触及你想要的目标受众。更重要的是&#xff0c;Facebook广告通…

作者头像 李华
网站建设 2026/6/9 18:59:02

腾讯混元开源HunyuanVideo-Foley：实现声画合一的AI音效革命

腾讯混元开源HunyuanVideo-Foley&#xff1a;实现声画合一的AI音效革命 在短视频日均产量突破千万条的今天&#xff0c;一个令人尴尬的事实是&#xff1a;大多数AI生成视频依然“沉默无声”。即便画面流畅、构图精美&#xff0c;一旦缺少匹配的声音细节——脚步踩在石板上的清…

作者头像 李华