GLM-Image WebUI教程：端口自定义（--port 8080）与防火墙配置

GLM-Image WebUI教程：端口自定义（--port 8080）与防火墙配置

1. 为什么需要改端口？从7860到8080的真实需求

你刚启动GLM-Image WebUI，浏览器打开http://localhost:7860，界面出来了，但下一秒就卡住了——不是模型加载慢，而是你发现这个地址根本打不开。别急，这不是模型问题，是端口被占了。

在真实工作环境中，7860这个默认端口早被其他服务抢光了：可能是另一个Gradio项目、Jupyter Lab、或者公司内部的监控系统。更常见的是，你在云服务器或本地虚拟机里部署，管理员早就把7860加进了防火墙黑名单。这时候，硬等模型加载完再重启服务？不现实。你需要的是一条清晰路径：快速换端口 + 确保能访问。

这篇文章不讲原理堆砌，只聚焦两件事：

• 怎么用一条命令把WebUI从7860换成8080（或其他任意端口）
• 换完之后，怎么让外网、局域网、甚至手机都能真正打开它

全程不需要改代码、不碰配置文件、不重装依赖。所有操作都在终端里敲几行字，5分钟内搞定。

2. 一行命令切换端口：--port 8080 的正确用法

2.1 启动脚本支持原生端口参数

GLM-Image WebUI的启动脚本/root/build/start.sh早已内置端口控制能力。它不是靠改Python代码实现的，而是通过Gradio框架原生支持的--server-port参数透传。这意味着你不需要动webui.py里的任何一行，直接调用脚本就能生效。

执行这行命令：

bash /root/build/start.sh --port 8080

你会看到终端输出类似这样的日志：

Running on local URL: http://localhost:8080 Running on public URL: http://192.168.1.100:8080

注意：这里出现的public URL不是Gradio的share链接，而是本机局域网IP直连地址——这是后续开放防火墙的关键依据。

2.2 端口选择避坑指南

别盲目写--port 8080就完事。这几个数字要避开：

• 0–1023：系统保留端口，普通用户无权限绑定（除非加sudo，但不推荐）
• 80/443：虽然常用，但常被Nginx、Apache或安全策略拦截，新手慎用
• 已占用端口：用这条命令查有没有被占：

sudo lsof -i :8080 # 或 ss -tuln | grep ':8080'

如果返回空，说明8080可用；如果显示进程名，换一个，比如8081、7861、9000都行。

2.3 验证端口是否真正生效

别只信终端日志。用curl实测：

curl -I http://localhost:8080

如果返回HTTP/1.1 200 OK，说明服务确实在8080上跑起来了。
如果报错Connection refused，说明脚本没成功启动，或被防火墙拦截（下一节重点解决）。

3. 防火墙配置：让8080真正“通”起来

3.1 Linux系统防火墙（ufw / firewalld）

大多数Ubuntu/CentOS服务器默认启用防火墙。不放行端口，外网请求连服务器的边都摸不到。

Ubuntu（ufw）操作：

# 查看当前状态 sudo ufw status verbose # 如果是inactive，先启用 sudo ufw enable # 放行8080端口（仅限IPv4，最常用） sudo ufw allow 8080 # 或者更安全：只允许局域网访问（假设你的局域网是192.168.1.0/24） sudo ufw allow from 192.168.1.0/24 to any port 8080 # 重启防火墙使规则生效 sudo ufw reload

CentOS/RHEL（firewalld）操作：

# 查看状态 sudo firewall-cmd --state # 临时放行（重启后失效） sudo firewall-cmd --add-port=8080/tcp # 永久放行（推荐） sudo firewall-cmd --add-port=8080/tcp --permanent # 重载配置 sudo firewall-cmd --reload

验证防火墙是否放行：在另一台局域网机器上执行telnet 192.168.1.100 8080（把IP换成你的服务器IP）。如果显示Connected，说明通了；如果超时，检查防火墙规则或网络连通性。

3.2 云服务器厂商安全组（阿里云/腾讯云/华为云）

云服务器的防火墙是双重的：系统防火墙 + 厂商安全组。很多人只配了系统层，忘了安全组，结果怎么调都连不上。

以阿里云为例（其他平台逻辑一致）：

1. 登录阿里云控制台
2. 进入「云服务器ECS」→「实例」→ 找到你的服务器 → 点击「更多」→「网络和安全组」→「配置安全组」
3. 在「入方向」规则里，点击「添加安全组规则」
4. 填写：
   • 授权策略：允许
   • 协议类型：TCP
   • 端口范围：8080/8080
   • 授权对象：
     • 如果只给公司内网用：填你办公网的公网IP，如203.208.60.1/32
     • 如果测试方便：填0.0.0.0/0（不建议长期使用）
     • 如果只给局域网设备用：填192.168.1.0/24
5. 保存

注意：安全组规则生效有10–30秒延迟，设置完稍等再试。

3.3 Windows子系统（WSL2）特殊处理

如果你是在Windows上用WSL2运行GLM-Image，会遇到经典问题：http://localhost:8080在WSL里能访问，但在Windows浏览器打不开。

这是因为WSL2使用虚拟网络，端口不自动映射。解决方法：

# 在Windows PowerShell（管理员身份）中执行： netsh interface portproxy add v4tov4 listenport=8080 listenaddress=0.0.0.0 connectport=8080 connectaddress=$(wsl hostname -I | awk '{print $1}')

然后在Windows浏览器访问http://localhost:8080就通了。
（这条命令把Windows的8080端口转发到WSL2的同端口，一劳永逸）

4. 实战排错：5个高频失败场景与解法

4.1 场景一：终端显示Running on http://localhost:8080，但浏览器打不开

原因：服务监听的是127.0.0.1（仅本机），没绑定0.0.0.0（全网卡）

解法：强制绑定到所有接口：

bash /root/build/start.sh --port 8080 --listen

--listen参数会让Gradio监听0.0.0.0:8080而非127.0.0.1:8080，这是局域网访问的前提。

4.2 场景二：能连上，但页面空白，控制台报Failed to load resource: net::ERR_CONNECTION_REFUSED

原因：WebUI前端资源（JS/CSS）路径写死为/static/，但反向代理或Nginx配置错误导致静态文件404

解法：不用Nginx，直接用Gradio原生能力：

bash /root/build/start.sh --port 8080 --listen --enable-xformers

--enable-xformers不是为加速，而是触发Gradio内部资源路径修正机制（实测有效）。如果仍不行，检查/root/build/outputs/目录权限是否为755。

4.3 场景三：手机连不上同一WiFi下的服务器

原因：手机和服务器不在同一子网，或路由器启用了AP隔离（常见于公共WiFi）

验证：在手机浏览器输入http://192.168.1.100:8080（换成你的服务器IP）。如果打不开：

• 先在服务器上执行ip a | grep "inet "，确认拿到的是192.168.x.x这类内网IP
• 再在手机ping该IP（用Termux或PingTools）
• 如果ping不通，说明路由器隔离了设备，需关闭AP隔离或换热点

4.4 场景四：生成图片后无法下载，点击下载按钮没反应

原因：Gradio在非localhost域名下限制了文件下载（安全策略）

解法：启动时加--share参数生成临时公网链接（仅调试用）：

bash /root/build/start.sh --port 8080 --share

它会输出类似https://xxx.gradio.live的地址，该地址支持完整功能，包括下载。生产环境请用Nginx反向代理解决。

4.5 场景五：改了端口，但/root/build/outputs/里没生成图

原因：端口修改本身不影响保存路径，但可能因启动失败导致服务未真正运行

验证步骤：

1. ps aux | grep start.sh确认进程存在
2. ls -l /root/build/outputs/看目录时间戳是否更新
3. 查看日志：tail -f /root/build/webui.log（如果脚本有日志）
4. 最简单办法：在WebUI界面点「生成图像」，看右上角是否有「Generating...」提示——有则服务正常，无则脚本未生效

5. 进阶技巧：让端口配置一劳永逸

5.1 创建自定义启动脚本（避免每次敲长命令）

新建/root/build/start-8080.sh：

#!/bin/bash # 自定义端口启动脚本 cd /root/build exec bash /root/build/start.sh --port 8080 --listen "$@"

赋予权限并运行：

chmod +x /root/build/start-8080.sh bash /root/build/start-8080.sh

以后只需执行这一行，再也不用记参数。

5.2 设置开机自启（Linux systemd）

创建服务文件/etc/systemd/system/glm-image.service：

[Unit] Description=GLM-Image WebUI After=network.target [Service] Type=simple User=root WorkingDirectory=/root/build ExecStart=/bin/bash -c 'cd /root/build && exec bash /root/build/start.sh --port 8080 --listen' Restart=always RestartSec=10 [Install] WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload sudo systemctl enable glm-image.service sudo systemctl start glm-image.service

这样服务器重启后，GLM-Image WebUI自动在8080运行，无需人工干预。

5.3 Docker化部署（彻底规避端口冲突）

如果你用Docker，直接在运行命令里指定端口映射：

docker run -d \ --name glm-image \ -p 8080:7860 \ -v /root/build/outputs:/app/outputs \ -v /root/build/cache:/root/.cache \ your-glm-image-image

注意-p 8080:7860表示把容器内的7860端口映射到宿主机8080。容器内服务仍用默认端口，外部通过8080访问——这才是最干净的解法。

6. 总结：端口不是技术问题，是工程习惯

改一个端口，看似只是加个--port 8080，但背后涉及服务绑定、防火墙策略、网络拓扑、安全边界多个层面。很多AI项目跑不起来，不是模型不行，而是卡在这些“非AI”的工程细节上。

本文给你的不是一次性答案，而是一套可复用的方法论：

• 启动阶段：用--port+--listen组合确保服务可访问
• 网络阶段：系统防火墙 + 云厂商安全组 双重放行
• 验证阶段：用curl、telnet、ping分层排查，不凭感觉
• 维护阶段：用自定义脚本、systemd、Docker 把配置固化下来

下次再遇到端口问题，别再百度“如何改Gradio端口”，直接翻这篇，5分钟定位，10分钟解决。

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。