当前位置：首页 > news >正文

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

news 2026/5/12 12:31:48

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 或局域网下，打开浏览器输入该地址即可进入操作界面。

实际测试验证流程

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

在运行 FaceFusion 的主机上执行：
bash ipconfig # Windows ifconfig # Linux/macOS
找到当前网络的 IP 地址（通常是192.168.x.x或10.x.x.x开头）。
在另一台设备（如手机）上连接相同 Wi-Fi。
打开浏览器，输入：
http://<主机IP>:<端口>
例如：http://192.168.31.100:7861
如果能看到 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 资源

建议防护措施：

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