【笔记】ComfyUI 启动时端口被占用（PermissionError [winerror 10013]）解决方案

ComfyUI 启动时端口被占用（PermissionError [winerror 10013]）解决方案

适用于 Windows 系统（尤其是 ComfyUI Portable 版和源代码部署版），常见端口：8188、8189 等。

ComfyUI 版本: v0.6.0（源代码部署最新版）

症状

启动 ComfyUI 时控制台报错：

复制代码

PermissionError: [Errno 13] error while attempting to bind on address ('127.0.0.1', 8188): [winerror 10013] 以一种访问权限不允许的方式做了一个访问套子套接字的尝试。

即使 netstat 查不到占用，依然报错。

原因分类及解决方法

真正被其他进程占用 （最常见）
- 操作：
  复制代码
```
netstat -ano | findstr :8188
```
  输出类似 TCP 127.0.0.1:8188 0.0.0.0:0 LISTENING 12345
- 解决：
  复制代码
```
taskkill /PID 12345 /F
```
  （替换为实际 PID，也有可能查不到占用，解决方案请往下看）

Windows 系统预留端口范围（Hyper-V / WSL2 / Docker 导致）
- 检查：
  复制代码
```
netsh int ipv4 show excludedportrange protocol=tcp
```
  如果目标端口（如 8188）落在某个范围（如 8126-8225）内，就是这个原因。
- 快速解决（推荐）：
  
  换一个不在预留范围内的端口，例如：
  - 8080
  - 8180
  - 8888（最常用）
  - 9000
  - 9999
    修改启动 bat 文件（例如 run_nvidia_gpu.bat）：
    
    .\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --listen --port 8888
  浏览器访问：http://127.0.0.1:8888
- 彻底解决（不建议/一般重启或重新指定端口也可以解决）：
  
  关闭导致端口预留的功能（需重启电脑）：
  1. Win + R → optionalfeatures
  2. 取消勾选：
    - Hyper-V（所有子选项）
    - 适用于 Linux 的 Windows 子系统
    - 虚拟机平台
  3. 重启后预留范围消失，可继续用 8188
权限或安全软件拦截
- 解决：
  - 右键启动 bat 文件 → 以管理员身份运行
  - 临时关闭杀毒软件（360、火绒、Windows Defender 等）
  - 将 ComfyUI 文件夹加入杀毒白名单
旧 ComfyUI 进程残留
- 任务管理器 → 详情 → 结束所有 python.exe 或 python_embeded 相关进程
启动参数冲突
- 先去掉 --listen 测试（只本地访问）：
  复制代码
```
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --port 8888
```
  成功后再加回来

小贴士

如果你不需要 WSL2、Docker Desktop 或 Hyper-V，关闭它们是最干净的解决方式。
端口换成 8888 或其他端口号后，几乎不会再遇到这个问题，如再遇到也只用灵活处理即可。

记下来，下次直接换端口或杀进程，1 分钟解决问题！祝你使用愉快～

【笔记】ComfyUI 启动时端口被占用（PermissionError [winerror 10013]）解决方案

ComfyUI 启动时端口被占用（PermissionError [winerror 10013]）解决方案

症状

原因分类及解决方法

推荐的永久配置（最稳定）

小贴士